スマレジ取引データとレシートローラー取引データのマッピング
スマレジ Platform API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、タイムゾーンと冪等性の扱い、出典（Source）の区別など、内部仕様を理解したい開発者・運用担当者向けに整理しています。
スマレジ連携 — 全体像と始め方
スマレジとレシートローラーの連携の全体像、必要なもの、3 ステップの概要、次に読むべき詳細記事をまとめた最初の 1 枚です。
スマレジ・Square の売上とお客様の紐づけ
スマレジ・Square の売上がレシートローラーのお客様と紐づく仕組みをご案内します。会員・顧客情報は POS と同期されません。紐づいた売上は購入履歴や来店回数に反映されます。
スマレジのPOS連携設定
スマレジとレシートローラーの POS 連携設定手順です。スマレジ アプリマーケットから「レシートローラーリンク」をインストールし、スマレジのアカウントでログインして、POS 設定画面の「スマレジと連携する」ボタンから店舗・端末（レジ）を選ぶだけで連携が完了します。連携後の取引データの同期方法や、複数店舗・複数端末の扱い方も説明します。
POSとの連携
スマレジ・Square とレシートローラーを連携する手順です。連携すると取引が自動で取り込まれ、取引一覧・売上レポート・デジタルレシートが使えるようになります。
スマレジ商品データとレシートローラー商品データのマッピング
スマレジの商品マスタがレシートローラーの商品マスタ（ProductDto）にどう変換されるかをフィールド単位で説明します。商品コード・商品名・カテゴリ・価格・原価・税率の対応関係と、Smaregi 固有の挙動をまとめています。
スマレジ会員データとレシートローラー顧客データのマッピング
スマレジの会員マスタがレシートローラーの顧客データ（CrmCustomerDto）にどう変換されるかをフィールド単位で説明します。会員番号・氏名・連絡先・住所・誕生日の対応関係、電話番号の優先順位、Webhook 経由の同期タイミングまでまとめています。
POSマネージャーの権限
POSマネージャーは、POS連携・プリンタ・レシートのデザイン・取引QRを任せるロールです。できること・できないことと、割り当てできるプラン（スタータープラン以上）をまとめています。
レシートローラー会員番号の自動発番設定
レシートローラーでは、お客様の会員番号を「プレフィックス-連番」の形式で自動発番します。会員番号の形式、プレフィックスと桁数（4〜12桁）の設定、発番のタイミング、形式を変えたときの扱いをご案内します。
顧客別の購入履歴（POS連携）
顧客管理の顧客詳細画面で、お客様ごとの購入履歴（直近30件）をレシート単位で確認できます。POSレジから発行されたレシートが会員番号をもとに自動でひも付けられます。本記事では、購入履歴の見方、表示される条件、紙レシートとの違い、プライバシーの考え方、API 経由でのアクセスをご案内します。
レシートの消費税表示とインボイス登録番号
デジタルレシートには、店舗のインボイス登録番号と、税率ごと（10%・8%）の対象金額・消費税額が表示されます。メール・LINE・QRコードから開くレシートページのどれで受け取っても同じです。設定方法と表示される場所、同じ画面で設定する「お客様による領収書の発行」について説明します。
レシートがお客様に届く仕組み
デジタルレシートは、お客様がQRコードを読み取って選んだLINE・メールなどに届きます。会員としてお会計したお客様が同意すると、次からは会計のたびに自動で届きます。それぞれの届き方と、自動配信の条件・止め方を説明します。
ストアアプリプラットフォームとは
ストアアプリプラットフォームは、店舗様ごとに Web・iOS・Android・LINEミニアプリの4チャネルで動く自社ブランドのアプリを発行できる機能です。共通の管理画面（CMS）から、Apple Wallet / Google Wallet 会員証、プッシュ通知、独自ドメイン、会員番号の自動発番と POS との双方向同期までを一括で運用いただけます。本記事では概要と提供チャネル、できることの全体像、始め方をご案内します。
プリンター・レシートの管理
店舗ページの「プリンター・レシート」から、店舗のサーマルプリンターの確認、POS端末との接続、デジタルレシートの見た目のカスタマイズを行う方法を説明します。
店舗アカウントの作成
レシートローラーを店舗で使い始めるまでの手順です。アカウントの作成、店舗アカウントの開設、業態の選択、最初に始める機能の選び方を説明します。
レシートデザイン
店舗ごとに、デジタルレシートに載せるロゴ・会社名・表示項目・お店からのお知らせを設定する方法を説明します。ここでの設定は、お客様が発行する領収書にも使われます。
Apple Wallet・Google Wallet 会員証の概要
レシートローラーのストアアプリプラットフォームでは、店舗様のオリジナル会員証を Apple Wallet と Google Wallet の両方で発行できます。本記事では、Wallet 会員証の概要、お客様にとってのメリット、店舗様のオペレーション、何が表示されるか、POS との連携、設定の流れまでをご案内します。
POS連携のトラブルシューティング
POS連携でよくあるトラブルと対処方法を、取引が取り込まれない、QRコードでレシートが表示されない、売上が合わない、端末を追加できない、メールのレシートが届かない、などの症状ごとに説明します。