スマレジ 販売オプション

操作説明書  /  アプリ機能概要

アプリ概要

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

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

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

主な機能

🧾

① 販売一括登録

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

🗂️

② 取置登録

取置タブに切り替えることで、取置伝票を一括登録できます。商品コード・取置点数・販売価格を入力するだけで簡単に登録できます。

📊

③ CSV 結合・ダウンロード

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

💰

④ インセンティブ集計

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

🏷️

⑤ 取引タグ管理

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

💲

⑥ 販売価格設定

商品の販売価格・会員価格をスプレッドシートで一括修正。店舗別価格の設定・削除にも対応しています。

📝

⑦ 商品情報変更

サイズ・カラー・タグ・グループコード・品番・仕入原価などの基本情報と、自由項目をスプレッドシートで一括変更。スマレジ商品CSVのドラッグ&ドロップにも対応しています。

ログイン方法

ログイン画面を開く システム管理者から案内されたURLにアクセスします。ログイン画面が表示されます。
「スマレジでログイン」ボタンをクリック スマレジの認証画面に移動します。
スマレジアカウントで認証 スマレジのログインIDとパスワードを入力し、アクセスを許可します。
メイン画面へ自動遷移 ログイン完了後、アプリのメイン画面に移動します。ヘッダーにログイン中のスタッフ名が表示されます。
ログアウトはヘッダー右上の「ログアウト」リンクから行えます。
このアプリにログインできるのは、スマレジの契約オーナー(管理者)アカウント、またはログインを許可されたアカウントのみです。他のスタッフにもログインさせたい場合の設定方法は「スタッフのログイン許可」をご覧ください。

① 販売

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

販売設定

項目説明
スタッフプルダウンから選択します。「スタッフ設定」にログインアカウントのメールアドレスとスタッフIDを紐付けて登録している場合は、ログイン時に対応するスタッフが自動で選択されます(変更も可能です)。
端末販売に使用するスマレジの端末を選択します
商品追加時の店舗選択 「商品コード」から行を追加する際、どの店舗を自動でセットするかを選びます。
  • 端末の店舗を使用 — 上で選択した端末に紐づく店舗を使用します。
  • 在庫のある店舗を選択 — 商品の在庫があるスマレジの店舗を自動的に選びます。
  • 商品コードから店舗を選択 — 商品コードの一部を店舗IDとして抽出して使用します。選択すると「店舗IDの抽出位置」欄が表示されるので、商品コードの何文字目から何文字を店舗IDとして使うかを指定してください(初期値: 8文字目から3文字)。抽出した文字列が「001」のように0埋めされた数字でも、自動的に数値(1)に変換して店舗IDと照合します。
「商品コードから店舗を選択」は、商品コードの特定の桁位置に店舗IDを埋め込んだ運用をしている場合に使用します。取置タブでは店舗列がないため、この設定は販売タブでのみ有効です。

商品の追加方法

商品コードを入力 「商品コード」欄にスマレジの商品コードを入力し Enter キーを押すか「行に追加」ボタンをクリックします。 商品名・価格は自動で取得されます。
販売点数・価格の確認・変更 スプレッドシートで数量や販売価格(税込)を直接編集できます。
店舗・顧客ID・取引タグの入力 各行に店舗、顧客ID(任意)、取引タグ(任意)を入力します。 同じ店舗・顧客ID・取引タグの行は1件の伝票にまとめられます。

スプレッドシートの列

説明必須
商品コードスマレジに登録された商品コード
商品名自動取得(参照用、編集不可)-
数量販売する点数
販売価格(税込)自動取得。変更する場合は直接入力
店舗販売する店舗(「商品追加時の店舗選択」の設定に従って自動セット)
顧客IDスマレジの顧客ID(任意)-
取引タグ伝票に付与するタグ(任意)-
「顧客ID」は、スマレジの「会員コード」「会員番号」とは異なります。スマレジ管理画面の会員情報変更画面を開いた際に、ブラウザのアドレス欄に表示される URL 内の customerId パラメーターの値を入力してください。

店舗更新ボタン

「クリア」ボタンの右にある「店舗更新」ボタンをクリックすると、一覧表に入力済みの全行(商品コードが入力されている行)の「店舗」列を、その時点の「商品追加時の店舗選択」の設定に従って一括で再設定できます。

店舗選択のモードを変更した後や、CSVの貼り付けなどで店舗列を入力していない行がある場合に便利です。取置タブには店舗列がないため、このボタンは使用できません。

販売実行

「販売実行」欄には「商品を更新する」チェックボックスがあります(初期状態でオンになっています)。 チェックを入れて「販売登録実行」を行うと、販売する商品ごとに、内容を何も変更しなくてもスマレジ側の商品情報の更新(PATCHリクエスト)が実行され、商品の「更新日時」が現在日時に更新されます。

これにより、スマレジの商品一覧画面で「更新日時」を条件に検索した際に、販売した商品がヒットするようになります。更新日時を使った絞り込みで対象商品を抽出したい場合にご活用ください。
更新が不要な場合はチェックを外してから「販売登録実行」を行ってください。同一の商品が複数行にある場合でも、更新は商品ごとに1回だけ実行されます。
「販売伝票プレビュー」で確認 登録前に伝票の件数・合計金額を確認します。
「販売登録実行」をクリック 確認ダイアログが表示されます。内容を確認して実行します。
結果を確認 プログレスバーで進捗を確認できます。完了後は実行ログに結果が表示されます。
同じ「店舗・顧客ID・取引タグ」の行は自動的に1件の販売伝票にまとめられます。異なる場合は別伝票になります。

② 取置

「取置」タブでは、スプレッドシート形式で取置データを入力し、スマレジに一括登録できます。 画面の構成は「販売」タブと共通で、モードが切り替わります。

取置設定

項目説明
スタッフプルダウンから選択します。「スタッフ設定」にログインアカウントのメールアドレスとスタッフIDを紐付けて登録している場合は、ログイン時に対応するスタッフが自動で選択されます(変更も可能です)。
端末使用するスマレジの端末を選択します。取置の店舗はここで選択した端末の店舗が使用されます
取置タブでは店舗選択欄は表示されません。端末に紐づく店舗が自動的に使用されます。

スプレッドシートの列

説明必須
商品コードスマレジに登録された商品コード
商品名自動取得(参照用、編集不可)-
取置点数取置する点数
販売価格(税込)自動取得。変更する場合は直接入力

取置実行

「取置伝票プレビュー」で確認 登録前に伝票の件数・合計金額を確認します。
「取置登録実行」をクリック 確認ダイアログが表示されます。内容を確認して実行します。
結果を確認 プログレスバーで進捗を確認できます。完了後は実行ログに結果が表示されます。

③ 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店舗名

計算式の書き方:IF文を使う

条件によってインセンティブを変えたい場合は、即時関数の中に if 文を書く方法が読みやすくおすすめです。

(() => {
  if (grossProfit >= 1000000) return Math.round(grossProfit * 0.05);
  if (grossProfit >= 500000)  return Math.round(grossProfit * 0.03);
  return Math.round(grossProfit * 0.01);
})()

上記の例では、粗利益が100万円以上なら5%、50万円以上なら3%、それ以下なら1%を支払います。
条件が2〜3個程度なら、三項演算子(? :)で1行に書くこともできます。

Math.round(
  grossProfit >= 1000000 ? grossProfit * 0.05 :
  grossProfit >= 500000  ? grossProfit * 0.03 :
                           grossProfit * 0.01
)

集計オプション

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

「売上原価(税込み)」の計算元について

集計結果の「売上原価(税込み)」「売上原価」は、取引履歴CSVの「原価計」列を元に計算されます。 商品一覧CSVの「原価」列は、軽減税率の判定(税設定)や販売予想金額の集計に使われるのみで、売上原価の金額そのものには使用されません。

商品一覧CSVで「原価」を入力・修正しても、売上原価が0円のまま変わらない場合は、取引履歴CSV側の「原価計」列を確認してください。 考えられる原因は、取引発生時点で商品マスタに原価が未登録だった、取引履歴CSVのエクスポート設定で「原価計」が出力対象に含まれていない、対象行が返品・取消区分で集計から除外されている、のいずれかです。

⑥ 販売価格設定

「販売価格設定」タブでは、商品の販売価格・会員価格をスプレッドシート形式で一括変更できます。 商品全体の価格変更のほか、店舗ごとの個別価格の設定・削除にも対応しています。

商品の追加

商品コードを入力して「行に追加」 商品コードを入力し Enter キーまたは「行に追加」ボタンをクリックすると、 商品名と現在の販売価格が自動で取得されスプレッドシートに追加されます。
スプレッドシートで価格を編集 追加された行の「商品単価」列に新しい価格を入力します。 複数商品をまとめて入力して一括更新することも可能です。
「価格を更新する」をクリック 確認ダイアログが表示されます。内容を確認して実行します。 更新件数・削除件数が表示されます。

スプレッドシートの列

説明必須
商品コードスマレジに登録された商品コード
商品名自動取得(参照用。更新には使用されません)-
店舗店舗別価格を設定する場合に選択。空欄の場合は商品全体の価格を変更します-
商品単価設定する価格(税抜き)。空欄にすると店舗価格の削除になります
価格区分1:商品単価 / 2:会員価格
適用開始日価格の適用開始日(デフォルト: 2026-01-01)
適用終了日価格の適用終了日(デフォルト: 10年後)-

動作パターン

店舗商品単価動作
空欄入力あり商品全体の販売価格(または会員価格)を変更します
選択あり入力あり指定店舗の店舗別価格を設定・更新します
選択あり空欄指定店舗の店舗別価格を削除します(商品全体の価格に戻ります)
商品単価が空欄の削除行は、店舗の選択と適用開始日の両方が入力されている場合のみ削除対象になります。

ツールバーボタン

ボタン動作
空行追加スプレッドシートの末尾に空行を1行追加します。価格区分・適用日はデフォルト値が自動入力されます
最終行削除スプレッドシートの最終行を削除します
クリア全行のデータをクリアして初期状態に戻します(確認ダイアログあり)

ペースト機能

Excelや他のアプリからコピーしたデータを貼り付けることができます。

操作動作
1セルコピー → 複数セル選択してペースト選択した全セルに同じ値が入力されます
1行コピー → 複数行を縦に選択してペースト選択した全行にコピーした行のデータが繰り返し入力されます
価格修正はスマレジのAPIで即時反映されます。実行後のキャンセルはできませんのでご注意ください。

⑦ 商品情報変更

「商品情報変更」タブでは、商品の基本情報(サイズ・カラー・タグ・グループコード・品番・仕入原価)と自由項目を、 スプレッドシート形式で複数商品まとめて一括変更できます。

① 変更する項目の選択

「基本情報」は常に表示される6項目から、「自由項目」は「自由項目をスマレジから取得」ボタンでスマレジ管理画面に設定されたラベル一覧を取得してから選択します。

基本情報説明
サイズ商品のサイズ
カラー商品のカラー
タグ商品のタグ
グループコード商品をグルーピングするための一意のキー
品番メーカー品番
仕入原価商品の仕入原価
チェックボックスにチェックを入れると、ボタン操作なしですぐにスプレッドシートへ列が追加されます。チェックを外すと該当列だけが削除されます(他の列のデータは保持されます)。

「チェックを外す」ボタンをクリックすると、選択中の基本情報・自由項目のチェックを一括で解除できます(確認ダイアログはありません)。商品コード・商品名は削除されず、そのまま残ります。

② 商品情報変更データ入力

商品コードを入力して「行に追加」 商品コードを入力し Enter キーまたは「行に追加」ボタンをクリックすると、商品名と選択中の項目の現在値が自動取得されスプレッドシートに追加されます。
スプレッドシートで値を編集 各列に新しい値を直接入力します。Excelからのコピー&ペーストにも対応しています。
「商品情報変更実行」をクリック 商品コードが1件以上入力されるとボタンが有効になります。確認ダイアログで内容を確認して実行します。

スプレッドシートの列

説明必須
商品コードスマレジに登録された商品コード
商品名自動取得(参照用、編集不可。更新には使用されません)-
①で選択した項目基本情報・自由項目が選択した順に列として並びます。空欄のまま実行すると、その項目は空欄で上書きされます-

ツールバーボタン

ボタン動作
空行追加スプレッドシートの末尾に空行を1行追加します
最終行削除スプレッドシートの最終行を削除します
クリア全行のデータをクリアして初期状態に戻します(確認ダイアログあり)
スマレジから取得商品コードが入力済みの行について、スマレジから選択中の項目の現在値を取得して各列に反映します

スマレジ商品CSVのドラッグ&ドロップ

「商品情報変更」タブを選択している時のみ、スマレジからダウンロードした商品CSVを画面上にドラッグ&ドロップして読み込めます(他のタブでは機能しません)。

商品情報変更タブを選択 タブが選択されている間だけ、ドロップ操作を受け付ける案内が画面に表示されます。
商品CSVをドロップ スマレジ管理画面からダウンロードした商品CSV(Shift_JIS / UTF-8 いずれも可)をドロップします。
自動でチェック・データ読み込み CSVの列名と一致する基本情報・自由項目に自動でチェックが入り(未取得の自由項目ラベルはこの時に自動取得されます)、 商品コード・商品名と該当する列の値がスプレッドシートに読み込まれます。
CSVに商品コード・商品名の列が見つからない場合や、基本情報・自由項目に一致する列が1つもない場合は読み込みが行われず、メッセージが表示されます。
商品情報の変更はスマレジのAPIで即時反映されます。実行後のキャンセルはできませんのでご注意ください。

設定

スタッフのログイン許可

このアプリは、スマレジの契約オーナー(管理者)アカウントであれば常にログインできます。 それ以外のスタッフにもログインさせたい場合は、画面左のサイドメニューを開き「スタッフ設定」から、そのスタッフのスマレジアカウントのメールアドレスを登録して許可する必要があります。

設定手順

契約オーナーでログイン スタッフのログイン許可設定は、契約オーナーアカウントでログインしている場合のみ変更できます。
サイドメニューの「スタッフ設定」を開く 「追加」ボタンで行を増やします。
スタッフID・表示名・メールアドレスを入力 ログインさせたいスタッフのスマレジアカウントのメールアドレスを入力してください。スタッフID・表示名は「販売」「取置」タブの「スタッフ」プルダウンに表示される内容です(省略可)。
「ログイン可」にチェックを入れて保存 チェックを入れて「保存」をクリックすると、次回からそのメールアドレスのスマレジアカウントでログインできるようになります。
スタッフID・表示名を入力していない場合は、既存の「スタッフ」プルダウンには表示されず、ログイン許可のみが登録されます。

スタッフの自動選択

スタッフID・メールアドレスの両方を登録しておくと、そのメールアドレスでログインした際に「販売」「取置」タブの「スタッフ」プルダウンが自動的に選択されます(変更も可能です)。

登録したメールアドレスは個人情報のため、サーバーに送信された時点でハッシュ化され、平文のままデータベースに保存されることはありません。保存後は入力欄が空欄で表示されますが、これは正常な動作です(変更したい場合のみ再入力してください。入力欄を空欄のまま保存すれば、既存の登録内容がそのまま維持されます)。

取引タグ設定

画面左のサイドメニューを開き「取引タグ設定」から、販売登録で使用するタグの候補を登録できます。 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.products:write — 商品価格・基本情報・自由項目の更新・削除(販売価格設定・商品情報変更機能で使用)
  • 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販売取引の登録
GET /{contractId}/pos/products/{id}/prices商品の店舗別価格取得(価格修正・取置価格表示で使用)
PATCH /{contractId}/pos/products/{id}商品価格・基本情報・自由項目の更新(販売価格設定・商品情報変更機能で使用)
DELETE /{contractId}/pos/products/{id}/prices/{div}/{store}/{date}店舗別価格の削除(販売価格設定機能で使用)
GET /{contractId}/pos/products/reserve_item_labels自由項目ラベル一覧取得(商品情報変更機能で使用)
GET /{contractId}/pos/products/{id}/reserve_items商品の自由項目の現在値取得(商品情報変更機能で使用)

認証方式

パブリックアプリ(本番)

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

リダイレクトURI

https://(ドメイン)/api/auth/callback.php

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