スマレジ取引データとレシートローラー取引データのマッピング
スマレジ Platform API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、タイムゾーンと冪等性の扱い、出典(Source)の区別など、内部仕様を理解したい開発者・運用担当者向けに整理しています。
Square 取引データとレシートローラー取引データのマッピング
Square Payment API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、OAuth トークンの自動リフレッシュ、Webhook と手動同期の違い、冪等性とタイムゾーンの扱いなど、内部仕様を理解したい開発者・運用担当者向けに整理しています。
電子レシートの発行
電子レシートが消費者に届くまでの流れと、QRコード・LINEミニアプリ・ストアアプリなどの発行方法を説明します。
スタッフの権限
レシートローラーのスタッフロールの権限を詳しく説明します。レジ担当・現場スタッフ向けの最小権限ロールで、当日取引の確認とレシート発行のみに限定されています(フリープランから利用可)。
EC連携の全体像
レシートローラーのEC連携の全体像。B2B EC・外部ECプラットフォーム連携・商品フィードの3つの柱と使い分けを解説します。
Square スタッフデータとレシートローラースタッフデータのマッピング
Square Team Member がレシートローラーのスタッフデータ(StaffDto)にどう関連付けられるかを説明します。手動リンクの運用方法、取引データの担当者解決ロジック、Team Member API の主要フィールドまでまとめています。
スマレジのPOS連携設定
スマレジとレシートローラーの POS 連携設定手順です。スマレジ アプリマーケットから「レシートローラーリンク」をインストールし、スマレジのアカウントでログインして、POS 設定画面の「スマレジと連携する」ボタンから店舗・端末(レジ)を選ぶだけで連携が完了します。連携後の取引データの同期方法や、複数店舗・複数端末の扱い方も説明します。