スマレジ取引データとレシートローラー取引データのマッピング
スマレジ Platform API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、タイムゾーンと冪等性の扱い、出典(Source)の区別など、内部仕様を理解したい開発者・運用担当者向けに整理しています。
Square 取引データとレシートローラー取引データのマッピング
Square Payment API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、OAuth トークンの自動リフレッシュ、Webhook と手動同期の違い、冪等性とタイムゾーンの扱いなど、内部仕様を理解したい開発者・運用担当者向けに整理しています。
Square スタッフデータとレシートローラースタッフデータのマッピング
Square Team Member がレシートローラーのスタッフデータ(StaffDto)にどう関連付けられるかを説明します。手動リンクの運用方法、取引データの担当者解決ロジック、Team Member API の主要フィールドまでまとめています。
スマレジのPOS連携設定
スマレジとレシートローラーの POS 連携設定手順です。スマレジ アプリマーケットから「レシートローラーリンク」をインストールし、スマレジのアカウントでログインして、POS 設定画面の「スマレジと連携する」ボタンから店舗・端末(レジ)を選ぶだけで連携が完了します。連携後の取引データの同期方法や、複数店舗・複数端末の扱い方も説明します。
AIによる売上予測
月末売上・取引数の線形ペース予測と、主力商品(上位5品)の14日先までの需要予測(曜日季節性+安全係数20%)。信頼度3段階判定、API・MCP経由の取得、商品別売上分析のAIナラティブとの組み合わせも解説します。
電子レシート導入のメリット
電子レシートを導入することで店舗が得られるメリットを、コスト削減・インボイス対応・顧客データ活用の観点から説明します。
SquareのPOS連携設定
SquareのPOSをレシートローラーと連携する手順を説明します。OAuth認証で簡単に接続でき、会計データがリアルタイムで同期されます。
来店客分析
来店客分析の使い方。期間プリセット、4つのサマリーカード(取引件数・会員紐付け率・ピーク時間帯・最も忙しい曜日)、時間帯×曜日ヒートマップ、時間帯別/曜日別グラフ、過去12ヶ月の新規/リピート/匿名の積み上げ推移までを店舗運営の視点で解説します。
販売トレンド分析
販売トレンド分析の使い方。過去6・12・24ヶ月の期間切り替え、8種類のトレンド棒グラフ、前年同月比(YoY)、複数店舗を重ね合わせる比較表示、異常値の自動検出、前月比インサイトの自動生成までを店舗運営の視点で解説します。
ビジネスアカウントを閉じる
ビジネスアカウントを閉じる(退会)ための手順と削除される内容、Stripe ご契約の扱い、関係者への影響を説明します。オーナー権限を持つ方のみ実行できます。
スマレジ商品データとレシートローラー商品データのマッピング
スマレジの商品マスタがレシートローラーの商品マスタ(ProductDto)にどう変換されるかをフィールド単位で説明します。商品コード・商品名・カテゴリ・価格・原価・税率の対応関係と、Smaregi 固有の挙動をまとめています。
顧客別の購入履歴(POS連携)
CRM の顧客詳細画面から、お客様ごとの購入履歴をレシート単位で確認できます。POSレジから発行されたレシートが、会員番号やお客様のプロフィールに基づいて自動でひも付けられます。本記事では、購入履歴の見方、表示される条件、紙レシートとの違い、プライバシーの考え方、API 経由でのアクセスをご案内します。
POS連携のトラブルシューティング
POSとの連携で発生する典型的なトラブルとその解決方法をまとめます。取引が取り込まれない、QRが動作しない、配信が届かない、などの症状別に説明します。
売上ダッシュボード
店舗の主要 KPI、過去12ヶ月のトレンドグラフ、自動生成のビジネスインサイト、商品別売上分析(全店舗)への導線を1画面で確認できる売上ダッシュボードの使い方。
スマレジスタッフデータとレシートローラースタッフデータのマッピング
スマレジのスタッフマスタがレシートローラーのスタッフデータ(StaffDto)にどう変換されるかをフィールド単位で説明します。staffName の姓・名分割ロジック、staffCode → EmployeeNumber、displayFlag による非表示スタッフのスキップなどをまとめています。
スマレジ連携 — 全体像と始め方
スマレジとレシートローラーの連携の全体像、必要なもの、3 ステップの概要、次に読むべき詳細記事をまとめた最初の 1 枚です。
EC連携の全体像
レシートローラーのEC連携の全体像。B2B EC・外部ECプラットフォーム連携・商品フィードの3つの柱と使い分けを解説します。
電子レシートの発行
電子レシートが消費者に届くまでの流れと、QRコード・LINEミニアプリ・ストアアプリなどの発行方法を説明します。
POSとの連携
レシートローラーと連携できるPOSシステムの概要と、接続方法を説明します。Square・スマレジに対応しています。