Square 取引データとレシートローラー取引データのマッピング
Square Payment API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、OAuth トークンの自動リフレッシュ、Webhook と手動同期の違い、冪等性とタイムゾーンの扱いなど、内部仕様を理解したい開発者・運用担当者向けに整理しています。
Square 商品データとレシートローラー商品データのマッピング
Square Catalog の商品データがレシートローラーの商品マスタ(ProductDto)にどう変換されるかをフィールド単位で説明します。Item / Variation / Category の関係、価格通貨の正規化、再同期時の挙動までまとめています。
会員証デザイン編集(ランク別カラー・ロゴ・ライブプレビュー)
Wallet 会員証のデザイン編集画面では、ランクごとに背景色・ロゴ・テキスト色をライブプレビューを見ながら編集できます。本記事では、編集画面の使い方、ランクごとのデザイン管理、ロゴ画像の推奨スペック、デザイン公開後の既存カードへの反映、見やすいカラー設計のヒントをご案内します。
Square 顧客データとレシートローラー顧客データのマッピング
Square Customer Directory がレシートローラーの顧客データ(CrmCustomerDto)にどう変換されるかをフィールド単位で説明します。given_name / family_name の対応、住所の分解ロジック、reference_id の扱いまでまとめています。
スマレジスタッフデータとレシートローラースタッフデータのマッピング
スマレジのスタッフマスタがレシートローラーのスタッフデータ(StaffDto)にどう変換されるかをフィールド単位で説明します。staffName の姓・名分割ロジック、staffCode → EmployeeNumber、displayFlag による非表示スタッフのスキップなどをまとめています。
スマレジのPOS連携設定
スマレジとレシートローラーの POS 連携設定手順です。スマレジ アプリマーケットから「レシートローラーリンク」をインストールし、スマレジのアカウントでログインして、POS 設定画面の「スマレジと連携する」ボタンから店舗・端末(レジ)を選ぶだけで連携が完了します。連携後の取引データの同期方法や、複数店舗・複数端末の扱い方も説明します。
Apple Wallet・Google Wallet 会員証の概要
レシートローラーのストアアプリプラットフォームでは、店舗様のオリジナル会員証を Apple Wallet と Google Wallet の両方で発行できます。本記事では、Wallet 会員証の概要、お客様にとってのメリット、店舗様のオペレーション、何が表示されるか、POS との連携、設定の流れまでをご案内します。