ネイティブモバイルアプリ向けガイド: 複数ビジネスアカウントアクセスと OAuth フロー
Android / iOS のネイティブアプリ向け実装ガイド。アプリ登録時に「認可時に1つのビジネスアカウントへトークンを紐付ける」をオフにすると、user-scoped OAuth トークンが発行されます。/api/v1/me/organizations + ?organizationId= パターンで複数ビジネスアカウントを横断アクセスできます。
店舗内メディアディスプレイAPI（Display API）の使い方
レシートローラーの店舗内 Android ディスプレイ向け API（/api/v1/displays/*）の概要とペアリング・ハートビート・プレイリスト取得・再生実績報告の手順をまとめます。Android キオスクや店舗サイネージ端末でメディアループを再生するアプリを実装するための入門ガイドです。
SLA・稼働率と障害時の確認手順
レシートローラーAPIの稼働率目標、ステータスページの確認方法、障害発生時の切り分け手順、サポートエスカレーションの流れを解説します。
在庫管理API（Inventory / WMS API）の使い方
レシートローラーの在庫管理API（Inventory / WMS API）の実装ガイドです。ロケーション単位の在庫照会・調整・移動履歴の取得方法、必要な OAuth スコープ、Shopify 連携時の自動反映、MCP ツール（wms_get_stock / wms_adjust_stock など）からの利用方法を解説します。
アプリを新規作成する
レシートローラーの開発者ポータルで新しいアプリ（OAuthクライアント）を登録する具体的な手順を説明します。入力項目・バリデーション・作成後のクレデンシャル表示・よくあるエラーまでをカバーします。
リクエストとレスポンスの基本（JSON）
レシートローラーAPIのリクエスト形式、必須ヘッダー、レスポンス構造、ページネーション、フィルタリング、日時形式の規則を解説します。
アクセス制御と監査ログ
レシートローラー連携アプリ運用におけるアクセス制御の設計、最小権限、監査ログの取り方、定期レビューの実施方法を解説します。
PosTransactionDto 仕様 — 取引データのフィールドリファレンス
レシートローラーが扱う取引データの正規モデル PosTransactionDto の全フィールドを解説します。識別子・日時・金額・明細・支払い・スタッフ・ステータス・CRM 連携の各カテゴリーごとに、フィールド名・型・意味・各 POS ベンダーからの埋め方をまとめた、開発者および外部システム連携担当者向けのリファレンスです。スマレジ・Square 双方のマッピング記事からも参照されます。
エンドポイントとバージョニング
レシートローラーAPIのベースURL、バージョニング方針、廃止予告の流れ、現行バージョンの確認方法を解説します。
予約管理API（Reservations API）の使い方
レシートローラーの予約管理API（/api/v1/reservations）のガイドです。予約のCRUD・ステータス更新、予約枠（スロット）の取得・作成・一括生成、店舗レイアウトに登録された席（テーブル・個室・カウンター）の取得、予約統計までを解説します。
アプリケーション登録とは
レシートローラーのアプリケーション登録の概念を説明します。OAuthクライアントとしてアプリを登録することで、クライアントID・シークレット・リダイレクトURIが発行され、API・Webhook連携を始められます。
403/401が返る（権限・スコープ）
API呼び出しで401や403が返るときの原因切り分け。トークン無効・スコープ不足・店舗アクセス権なし・User系審査未通過などの典型ケースを解説します。
営業時間API（Business Hours API）の使い方
レシートローラーの営業時間API（/api/v1/stores/{storeId}/business-hours）のガイドです。曜日ごとの営業時間の取得・更新、特例営業日（臨時休業・営業時間変更）の登録、店舗の就業可能時間（シフト作成時の上限となる業務時間）の設定、現在営業中かどうかの判定までを解説します。
サポートへの問い合わせ（技術連携）
レシートローラー開発者向けサポートの種類、問い合わせ前のチェックリスト、効率的に解決を進めるための情報添付テンプレートを解説します。
CrmCustomerDto リファレンス
レシートローラーの顧客マスタである CrmCustomerDto の全フィールドを解説します。POS（スマレジ・Square）から取り込まれた顧客情報がこのモデルに正規化されます。
商品管理API（Products API）の使い方
レシートローラーの商品管理API（/api/v1/products）でビジネスアカウント配下の商品をCRUD操作するためのガイドです。Android／iOSアプリやサーバー連携でPIM（商品マスター）を読み書きする際の入門記事です。
ビジネスアカウント・店舗・POS端末の一覧を取得する
レシートローラーのモバイルアプリ／サーバーアプリから、ユーザーが所属するビジネスアカウント、その配下の店舗、各店舗のPOS端末をREST APIで一覧する手順をまとめます。
リダイレクトURLの設定
レシートローラーの開発者ポータルで設定するリダイレクトURI（コールバックURL）の役割、登録ルール、開発・本番環境の使い分け、よくあるエラーと対処方法を解説します。
売上実績API（Sales API）の使い方
レシートローラーの売上実績API（/api/v1/sales/*）の概要と、ビジネスアカウント・店舗・POS端末・期間でのフィルタ方法をまとめます。実際のレスポンス構造（KpiValue 入れ子型）と averageTicket・トークン有効期限（8時間）まで網羅した、Android／iOS のモバイルアプリやサーバー連携で 売上ダッシュボードを実装するための入門ガイドです。
利用開始までの流れ
レシートローラーの開発者ポータル利用開始までの流れを説明します。店舗ユーザーとして登録し、スタータープラン以上であれば、別途の開発者申請なしですぐにアプリ登録とAPI実装を始められます。