スマレジ連携 — 全体像と始め方
スマレジとレシートローラーの連携の全体像、必要なもの、3 ステップの概要、次に読むべき詳細記事をまとめた最初の 1 枚です。
スマレジ取引データとレシートローラー取引データのマッピング
スマレジ Platform API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、タイムゾーンと冪等性の扱い、出典（Source）の区別など、内部仕様を理解したい開発者・運用担当者向けに整理しています。
Square スタッフデータとレシートローラースタッフデータのマッピング
Square Team Member がレシートローラーのスタッフデータ（StaffDto）にどう関連付けられるかを説明します。手動リンクの運用方法、取引データの担当者解決ロジック、Team Member API の主要フィールドまでまとめています。
Square 顧客データとレシートローラー顧客データのマッピング
Square Customer Directory がレシートローラーの顧客データ（CrmCustomerDto）にどう変換されるかをフィールド単位で説明します。given_name / family_name の対応、住所の分解ロジック、reference_id の扱いまでまとめています。
スマレジスタッフデータとレシートローラースタッフデータのマッピング
スマレジのスタッフマスタがレシートローラーのスタッフデータ（StaffDto）にどう変換されるかをフィールド単位で説明します。staffName の姓・名分割ロジック、staffCode → EmployeeNumber、displayFlag による非表示スタッフのスキップなどをまとめています。
スマレジ商品データとレシートローラー商品データのマッピング
スマレジの商品マスタがレシートローラーの商品マスタ（ProductDto）にどう変換されるかをフィールド単位で説明します。商品コード・商品名・カテゴリ・価格・原価・税率の対応関係と、Smaregi 固有の挙動をまとめています。
Apple Wallet・Google Wallet 会員証の概要
レシートローラーのストアアプリプラットフォームでは、店舗様のオリジナル会員証を Apple Wallet と Google Wallet の両方で発行できます。本記事では、Wallet 会員証の概要、お客様にとってのメリット、店舗様のオペレーション、何が表示されるか、POS との連携、設定の流れまでをご案内します。
スマレジのPOS連携設定
スマレジとレシートローラーの POS 連携設定手順です。スマレジ アプリマーケットから「レシートローラーリンク」をインストールし、スマレジのアカウントでログインして、POS 設定画面の「スマレジと連携する」ボタンから店舗・端末（レジ）を選ぶだけで連携が完了します。連携後の取引データの同期方法や、複数店舗・複数端末の扱い方も説明します。