APIリファレンスとドキュメントの見方
レシートローラーの開発者向けドキュメントの構成と使い分けを説明します。開発者ヘルプ・APIトップページ・SwaggerベースのAPIリファレンス・開発者コミュニティの4つの入り口と、AIアシスタントやコード生成ツールで使えるOpenAPI仕様（openapi/v1.json）の取得方法を案内します。
ProductDto リファレンス
レシートローラーの商品マスタ（PIM）である ProductDto の全フィールドを解説します。POS（Square）からの商品カタログ同期、原価・店舗別価格・バリエーション・プレオーダーなどの構造をまとめています。
CrmCustomerDto リファレンス
レシートローラーの顧客マスタである CrmCustomerDto の全フィールドを解説します。POS（スマレジ・Square）から取り込まれた顧客情報がこのモデルに正規化されます。
StaffDto リファレンス
レシートローラーのスタッフ（従業員）マスタである StaffDto の全フィールドを解説します。POS（Square Team / スマレジ）との関連付け、店舗アサイン、雇用形態などの構造をまとめています。
PosTransactionDto 仕様 — 取引データのフィールドリファレンス
レシートローラーが扱う取引データの正規モデル PosTransactionDto の全フィールドを解説します。識別子・日時・金額・明細・支払い・スタッフ・ステータス・CRM 連携の各カテゴリーごとに、フィールド名・型・意味・各 POS ベンダーからの埋め方をまとめた、開発者および外部システム連携担当者向けのリファレンスです。スマレジ・Square 双方のマッピング記事からも参照されます。
購買・レシートデータ連携
レシートローラーが扱う購買・レシートデータの構造、取得方法、関連スコープ、Webhook、よくあるユースケースを解説します。
代表的なAPI例
レシートローラーAPIの代表的なエンドポイントの呼び出し例（レシート取得・店舗一覧・商品作成・Webhook登録）をcurlコマンドで紹介します。
在庫管理API（Inventory / WMS API）の使い方
レシートローラーの在庫管理API（Inventory / WMS API）の実装ガイドです。ロケーション単位の在庫照会・調整・移動履歴の取得方法、必要な OAuth スコープ、Shopify 連携時の自動反映、MCP ツール（wms_get_stock / wms_adjust_stock など）からの利用方法を解説します。
Webhookの概要
レシートローラーのWebhookで配信される主要なイベント種別、ポーリングではなくWebhookを使うべき理由、配信形式（HTTPS POST + JSON）、配信保証の考え方を解説します。
エンドポイントとバージョニング
レシートローラーAPIのベースURL、バージョニング方針、廃止予告の流れ、現行バージョンの確認方法を解説します。