リクエストとレスポンスの基本（JSON）
レシートローラーAPIのリクエスト形式、必須ヘッダー、レスポンス構造、ページネーション、フィルタリング、日時形式の規則を解説します。
開発者向けヘルプ目次
レシートローラー開発者向けヘルプ目次です。開発者申請、アプリケーション登録、OAuth認証とスコープ、実装ガイド（ウォレットアプリ・店舗向けWebhook・Survey API）、データ領域別ガイド、運用とセキュリティ、コミュニティ、トラブルシューティングまでをまとめています。
取引一覧API（Transactions API：POS＋OMS統合フィード）の使い方
レシートローラーのTransactions APIは、レジ売上（PosTransactions）と販売管理注文（OmsOrders）を1つのフィードに統合した読み取り専用APIです。Android／iOSアプリで「ビジネスアカウント全体の取引」を一覧表示する際の入り口になります。
本番運用のベストプラクティス
レシートローラー連携アプリを本番運用するためのベストプラクティス（環境分離、監視、デプロイ、障害対応、ドキュメント整備）を解説します。
トークンが取得できない（認証エラー）
アクセストークンが取得できないときの原因切り分け。invalid_client、invalid_grant、redirect_uri_mismatch などの代表的エラーと対処を解説します。
店舗向け：自社アプリでデジタルレシートを発行・Webhookで通知するガイド
店舗・ブランドが自社アプリでデジタルレシートをお客様に発行し、Webhookでリアルタイム通知を受け取るまでの手順を解説します。アプリ登録・OAuth・Webhook設定・署名検証をカバーします。
再送・順序・冪等性の設計
レシートローラーWebhookの再送ポリシー、配信順序が保証されない理由、event_idを使った冪等性の実装、デッドレターの扱い、よくあるアンチパターンを解説します。
購買・レシートデータ連携
レシートローラーが扱う購買・レシートデータの構造、取得方法、関連スコープ、Webhook、よくあるユースケースを解説します。
商品管理API（Products API）の使い方
レシートローラーの商品管理API（/api/v1/products）でビジネスアカウント配下の商品をCRUD操作するためのガイドです。Android／iOSアプリやサーバー連携でPIM（商品マスター）を読み書きする際の入門記事です。
Webhookの概要
レシートローラーのWebhookで配信される主要なイベント種別、ポーリングではなくWebhookを使うべき理由、配信形式（HTTPS POST + JSON）、配信保証の考え方を解説します。
PosTransactionDto 仕様 — 取引データのフィールドリファレンス
レシートローラーが扱う取引データの正規モデル PosTransactionDto の全フィールドを解説します。識別子・日時・金額・明細・支払い・スタッフ・ステータス・CRM 連携の各カテゴリーごとに、フィールド名・型・意味・各 POS ベンダーからの埋め方をまとめた、開発者および外部システム連携担当者向けのリファレンスです。スマレジ・Square 双方のマッピング記事からも参照されます。
エンドポイントとバージョニング
レシートローラーAPIのベースURL、バージョニング方針、廃止予告の流れ、現行バージョンの確認方法を解説します。
在庫データ連携
レシートローラーの在庫データの構造、複数倉庫管理、入出庫履歴、Webhookによるリアルタイム同期、WMS連携パターンを解説します。
在庫管理API（Inventory / WMS API）の使い方
レシートローラーの在庫管理API（Inventory / WMS API）の実装ガイドです。ロケーション単位の在庫照会・調整・移動履歴の取得方法、必要な OAuth スコープ、Shopify 連携時の自動反映、MCP ツール（wms_get_stock / wms_adjust_stock など）からの利用方法を解説します。
商品マスター（PIM）・カテゴリデータ
レシートローラーの商品マスター（PIM）・カテゴリ・バリエーションのデータ構造、CRUD操作、SKU管理、ECとの同期パターンを解説します。
利用できるデータ領域
レシートローラーの開発者ポータルから取得できるデータ領域を一覧で説明します。取引・商品・在庫・受注・顧客・クーポン・SNS・広告・個人ユーザーデータなど、各領域に含まれる内容と取得方法、必要なスコープをまとめています。
ネイティブモバイルアプリ向けガイド: 複数ビジネスアカウントアクセスと OAuth フロー
Android / iOS のネイティブアプリ向け実装ガイド。アプリ登録時に「認可時に1つのビジネスアカウントへトークンを紐付ける」をオフにすると、user-scoped OAuth トークンが発行されます。/api/v1/me/organizations + ?organizationId= パターンで複数ビジネスアカウントを横断アクセスできます。
リダイレクトURLの設定
レシートローラーの開発者ポータルで設定するリダイレクトURI（コールバックURL）の役割、登録ルール、開発・本番環境の使い分け、よくあるエラーと対処方法を解説します。
監視と失敗時の対応
レシートローラーWebhookの配信履歴の見方、監視すべき指標とアラート設計、デッドレターの再配信、よくある障害パターンと復旧手順を解説します。