スマレジ販売オプション

アプリ概要

「スマレジ販売オプション」は、スマレジ POS システムと連携し、 販売データの一括登録・売上分析・インセンティブ計算を効率化するWebアプリケーションです。

スマレジアカウントでログインするだけで利用でき、専用ソフトのインストールは不要です。

このアプリはスマレジのパブリックアプリとして動作します。ご利用にはスマレジのアカウントが必要です。

主な機能

🧾

① 販売一括登録

スプレッドシート形式で複数商品を入力し、スマレジに一括で販売登録。複数伝票を一度に作成できます。

📊

② CSV 結合・ダウンロード

取引履歴CSVと商品一覧CSVを商品コードで結合して一覧表示。CSV・Excel形式でダウンロードできます。

💰

③ インセンティブ集計

店舗別に売上・粗利・インセンティブを集計。計算式をJavaScript式で自由に設定できます。

🏷️

④ 取引タグ管理

販売登録時に使用する取引タグの候補をカスタマイズして保存できます（サーバー側に保存）。

ログイン方法

ログイン画面を開く システム管理者から案内されたURLにアクセスします。ログイン画面が表示されます。

「スマレジでログイン」ボタンをクリック スマレジの認証画面に移動します。

スマレジアカウントで認証 スマレジのログインIDとパスワードを入力し、アクセスを許可します。

メイン画面へ自動遷移 ログイン完了後、アプリのメイン画面に移動します。ヘッダーにログイン中のスタッフ名が表示されます。

ログアウトはヘッダー右上の「ログアウト」リンクから行えます。

① 販売登録

「販売登録」タブでは、スプレッドシート形式で販売データを入力し、スマレジに一括登録できます。複数の伝票をまとめて処理することが可能です。

販売設定

項目	説明
スタッフ	ログイン中のスタッフ名が固定表示されます（変更不可）
端末	販売に使用するスマレジの端末を選択します
商品追加時の店舗選択	「端末の店舗を使用」または「在庫のある店舗を選択」から選びます

商品の追加方法

商品コードを入力 「商品コード」欄にスマレジの商品コードを入力し Enter キーを押すか「行に追加」ボタンをクリックします。商品名・価格は自動で取得されます。

販売点数・価格の確認・変更 スプレッドシートで数量や販売価格（税込）を直接編集できます。

店舗・顧客ID・取引タグの入力 各行に店舗、顧客ID（任意）、取引タグ（任意）を入力します。同じ店舗・顧客ID・取引タグの行は1件の伝票にまとめられます。

スプレッドシートの列

列	説明	必須
商品コード	スマレジに登録された商品コード	✓
商品名	自動取得（参照用、編集不可）	-
数量	販売する点数	✓
販売価格（税込）	自動取得。変更する場合は直接入力	✓
店舗	販売する店舗（在庫確認後に自動セット）	✓
顧客ID	スマレジの顧客ID（任意）	-
取引タグ	伝票に付与するタグ（任意）	-

販売実行

「販売伝票プレビュー」で確認 登録前に伝票の件数・合計金額を確認します。

「販売登録実行」をクリック 確認ダイアログが表示されます。内容を確認して実行します。

結果を確認 プログレスバーで進捗を確認できます。完了後は実行ログに結果が表示されます。

同じ「店舗・顧客ID・取引タグ」の行は自動的に1件の販売伝票にまとめられます。異なる場合は別伝票になります。

② CSV 結合・ダウンロード

「CSV結合」タブでは、スマレジからエクスポートした2種類のCSVを結合して分析・ダウンロードできます。

使い方

スマレジからCSVをエクスポート スマレジの管理画面から「取引履歴CSV」と「商品一覧CSV」をそれぞれエクスポートします。

2ファイルをドラッグ＆ドロップ CSVファイル2つをまとめてドロップゾーンにドラッグ＆ドロップします。取引履歴CSVと商品一覧CSVは自動で判別されます。

結合結果の確認 商品コードで結合された一覧がスプレッドシートに表示されます。

出力カラムの選択とダウンロード 「出力カラムを選択」で必要な列だけを選び、CSV または Excel 形式でダウンロードします。

取引履歴と商品情報（商品名・原価など）を1つのファイルにまとめることで、売上分析や帳票作成に活用できます。

③ インセンティブ集計

「インセンティブ集計」タブでは、全店舗分の取引データから店舗別の売上・粗利・インセンティブを集計します。

使い方

CSVファイルをドロップ 全店舗分の「取引履歴CSV」と「商品一覧CSV」の2ファイルをドロップします。

インセンティブ計算式を設定（任意） 「インセンティブ計算設定」を開き、JavaScript式で計算方法を指定します。
例：粗利益の5%を支払う場合 → Math.round(grossProfit * 0.05)

集計結果を確認 店舗別に集計された結果が一覧表示されます。行をクリックすると取引明細も確認できます。

計算式で使える変数

変数	説明
`qty`	販売数量
`lineTotal`	売上金額（税込）
`lineCost`	原価（「原価を税込みにする」設定に従う）
`grossProfit`	粗利益（売上金額 - 原価）
`expectedLineTotal`	販売予想金額
`tag`	取引タグ
`productCode`	商品コード
`productName`	商品名
`storeName`	店舗名

集計オプション

オプション	説明
原価を税込みにする	原価計算時に消費税を含めます
買取品のみ集計する	買取品の取引のみを対象にします
取引タグフィルター	特定の取引タグのみ集計対象にします

設定

取引タグ設定

画面左のサイドメニューを開き「取引タグ設定」から、販売登録で使用するタグの候補を登録できます。 1行に1つずつ入力し「保存」ボタンをクリックします。

入力例

本部売上
委託販売
イベント販売

取引タグはサーバーに保存され、同じ契約IDのスタッフ全員で共有されます。

使用スコープ（申請用）

このアプリがスマレジAPIに要求するOAuthスコープは以下の通りです。

openid — OpenID Connect 認証（ログインユーザーの識別）
email — メールアドレス取得
profile — プロフィール情報取得
offline_access — リフレッシュトークンによるセッション維持
pos.stores:read — 店舗情報の参照
pos.staffs:read — スタッフ情報の参照
pos.transactions:read — 取引情報の参照
pos.transactions:write — 取引の登録（販売登録機能で使用）
pos.products:read — 商品情報の参照
pos.stock:read — 在庫情報の参照

使用 API（申請用）

エンドポイント	用途
`GET /userinfo`	ログインユーザーの契約ID・ユーザーID取得
`GET /{contractId}/pos/staffs`	スタッフ一覧取得
`GET /{contractId}/pos/stores`	店舗一覧取得
`GET /{contractId}/pos/terminals`	端末一覧取得
`GET /{contractId}/pos/products`	商品情報取得（商品コード検索）
`GET /{contractId}/pos/stock`	在庫情報取得（店舗選択用）
`POST /{contractId}/pos/transactions`	販売取引の登録

認証方式

パブリックアプリ（本番）

OAuth 2.0 Authorization Code Flow を使用。ユーザーがスマレジアカウントでログインし、アクセストークンを取得します。リフレッシュトークンによる自動更新に対応しています。

リダイレクトURI

https://（ドメイン）/api/auth/callback.php

本アプリはサーバー側でトークンを管理します（PHPセッション）。アクセストークンはブラウザのlocalStorageには保存されません。