--- articleId: 491612df-2850-454a-826f-25dc47498073 slug: data-source-smaregi title: 転送元 - スマレジ parentCategoryId: b257af88-17fc-4a4d-bf94-dc694a258787 languageCode: ja --- 本ページでは、スマレジからデータを取得するための設定(転送設定)について説明します。 接続に関する設定については、[接続情報 - スマレジ](/docs/connection-configuration-smaregi)を参照ください。 ## 利用上の注意・制約 ### 認証について スマレジAPIは、OAuth 2.0標準に準拠した認証方式を採用しています。 TROCCOでは、UserAccessToken(Authorization Code Flow)を使用してデータを取得します。 ### API制限について スマレジAPIには以下の制限があります。 #### ページネーション 1回のリクエストで取得できるデータ件数には上限があります。 - **最小件数**: 1件 - **最大件数**: 1,000件 - **デフォルト件数**: 100件 大量のデータを取得する場合は、自動的にページネーションが実行され、すべてのデータが取得されます。 #### レート制限 APIのレート制限については、スマレジの公式ドキュメントまたはサポートにてご確認ください。 大量のデータを頻繁に取得する場合は、制限に注意が必要です。 #### 契約IDについて すべてのAPIエンドポイントで**契約ID**が必須です。 契約IDは、スマレジの契約単位で発行される識別子です。 取得方法については、スマレジの管理画面またはサポートにてご確認ください。 ## 取得対象 ### 部門一覧 スマレジに登録されている部門(カテゴリ)の一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。
契約IDは、スマレジの管理画面またはサポートにて確認できます。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`categoryId`|`string`|部門ID| |`categoryCode`|`string`|部門コード| |`categoryName`|`string`|部門名| |`categoryAbbr`|`string`|部門略称| |`displaySequence`|`string`|表示順序| |`displayFlag`|`string`|表示フラグ| |`taxDivision`|`string`|税区分| |`pointNotApplicable`|`string`|ポイント不適用フラグ| |`taxFreeDivision`|`string`|免税区分| |`reduceTaxId`|`string`|軽減税ID| |`color`|`string`|色| |`categoryGroupId`|`string`|部門グループID| |`parentCategoryId`|`string`|親部門ID| |`level`|`string`|レベル| |`tag`|`string`|タグ| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| ### 精算一覧 指定した店舗と期間の精算情報一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**店舗ID**|✓|-|精算情報を取得する店舗のIDを入力します。| |**精算日時(開始)**|✓|-|精算情報を取得する期間の開始日時を入力します。
フォーマット: `YYYY-MM-DDTHH:mm:ss±HH:MM`
※ 開始〜終了の期間は最大31日間です(1ヶ月ではありません)| |**精算日時(終了)**|✓|-|精算情報を取得する期間の終了日時を入力します。
フォーマット: `YYYY-MM-DDTHH:mm:ss±HH:MM`
※ 開始〜終了の期間は最大31日間です(1ヶ月ではありません)| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`storeId`|`string`|店舗ID| |`terminalId`|`string`|端末ID| |`adjustmentDateTime`|`timestamp`|精算日時| |`childTerminals`|`json`|子端末情報| |`transactionCount`|`string`|取引件数| |`preparationCash`|`string`|預金準備金| |`cashSales`|`string`|現金売上| |`creditSales`|`string`|クレジット売上| |`otherSalesList`|`json`|その他売上リスト| |`partPayment`|`string`|分割払い| |`partPaymentCash`|`string`|分割払い(現金)| |`partPaymentCredit`|`string`|分割払い(クレジット)| |`receivedDeposit`|`string`|受取預金| |`receivedDepositCash`|`string`|受取預金(現金)| |`receivedDepositCredit`|`string`|受取預金(クレジット)| |`partPaymentCancel`|`string`|分割払いキャンセル| |`partPaymentCashCancel`|`string`|分割払いキャンセル(現金)| |`partPaymentCreditCancel`|`string`|分割払いキャンセル(クレジット)| |`tip`|`string`|チップ| |`tipCash`|`string`|チップ(現金)| |`tipCredit`|`string`|チップ(クレジット)| |`deposit`|`string`|預金| |`returnDeposit`|`string`|預金返金| |`receipt`|`string`|レシート| |`payment`|`string`|支払い| |`nonSalesCashTotal`|`string`|非売上合計(現金)| |`nonSalesCreditTotal`|`string`|非売上合計(クレジット)| |`nonSalesOtherTotal`|`string`|非売上合計(その他)| |`calculateBalance`|`string`|計算残高| |`cashAdjustment`|`json`|現金調整| ### 日別予算 指定した店舗・年月の日別予算情報を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**店舗ID**|✓|-|予算情報を取得する店舗のIDを入力します。| |**年度**|✓|-|予算情報を取得する年度を入力します。
フォーマット: `YYYY`| |**月**|✓|-|予算情報を取得する月を入力します。
フォーマット: `MM`(01-12)| |**日**|-|-|特定の日の予算情報のみを取得する場合に入力します。
フォーマット: `DD`(01-31)| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`storeId`|`string`|店舗ID| |`ym`|`string`|年月| |`day`|`string`|日| |`salesTargetDaily`|`string`|日次売上目標| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| ### 客層一覧 スマレジに登録されている客層情報の一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`customerGroupId`|`string`|客層ID| |`customerGroupSectionId`|`string`|客層セクションID| |`label`|`string`|ラベル| |`displayFlag`|`string`|表示フラグ| |`displaySequence`|`string`|表示順序| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| ### 日次締め情報一覧 指定した条件の日次締め情報一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**締め日付**|-|-|特定の締め日付の情報のみを取得する場合に入力します。
フォーマット: `YYYY-MM-DD`| |**店舗ID**|-|-|特定の店舗の情報のみを取得する場合に入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`sumDate`|`string`|締め日付| |`storeId`|`string`|店舗ID| |`cashDrawerId`|`string`|現金引出ID| |`status`|`string`|ステータス| |`salesTotal`|`string`|売上合計| |`discount`|`string`|割引| |`pointDiscount`|`string`|ポイント割引| |`taxExcludeReceive`|`string`|税抜受取| |`nonSalesTargetTotal`|`string`|非売上対象合計| |`total`|`string`|合計| |`totalExcludeTax`|`string`|合計(税抜)| |`totalExcludTax`|`string`|合計(税抜)(非推奨)| |`inTaxSalesTotal`|`string`|内税売上合計| |`taxInclude`|`string`|税込| |`outTaxSalesTotal`|`string`|外税売上合計| |`taxExclude`|`string`|税抜| |`taxTotal`|`string`|税合計| |`taxDetailList`|`json`|税詳細リスト| |`nonTaxSalesTotal`|`string`|非課税売上合計| |`taxFreeTotal`|`string`|免税合計| |`nonSalesTargetTaxFreeTotal`|`string`|非売上対象免税合計| |`costTotal`|`string`|原価合計| |`grossMargin`|`string`|粗利| |`amount`|`string`|金額| |`transactionCount`|`string`|取引件数| |`returnAmount`|`string`|返金金額| |`carriage`|`string`|送料| |`commission`|`string`|手数料| |`preparationCash`|`string`|預金準備金| |`cashSales`|`string`|現金売上| |`creditSales`|`string`|クレジット売上| |`otherSalesList`|`json`|その他売上リスト| |`otherSalseList`|`json`|その他売上リスト(非推奨)| |`partPayment`|`string`|分割払い| |`partPaymentCash`|`string`|分割払い(現金)| |`partPaymentCredit`|`string`|分割払い(クレジット)| |`receivedDepositCash`|`string`|受取預金(現金)| |`receivedDepositCashTotal`|`string`|受取預金(現金)合計| |`receivedDepositCreditTotal`|`string`|受取預金(クレジット)合計| |`partPaymentCancel`|`string`|分割払いキャンセル| |`partPaymentCashCancel`|`string`|分割払いキャンセル(現金)| |`partPaymentCreditCancel`|`string`|分割払いキャンセル(クレジット)| |`deposit`|`string`|預金| |`returnDeposit`|`string`|預金返金| |`receipt`|`string`|レシート| |`payment`|`string`|支払い| |`nonSalesCashTotal`|`string`|非売上合計(現金)| |`nonSalesCreditTotal`|`string`|非売上合計(クレジット)| |`nonSalesOtherTotal`|`string`|非売上合計(その他)| |`nonSalesTaxFreeTotal`|`string`|非売上免税合計| |`changeDifference`|`string`|お釣り差異| |`calculateBalance`|`string`|計算残高| |`realBalance`|`string`|実残高| |`difference`|`string`|差異| |`saving`|`string`|積立金| |`carryOver`|`string`|繰越| |`tenThousandYen`|`string`|1万円| |`fiveThousandYen`|`string`|5千円| |`twoThousandYen`|`string`|2千円| |`oneThousandYen`|`string`|千円| |`fiveHundredYen`|`string`|5百円| |`oneHundredYen`|`string`|百円| |`fiftyYen`|`string`|50円| |`tenYen`|`string`|10円| |`fiveYen`|`string`|5円| |`oneYen`|`string`|1円| |`comment`|`string`|コメント| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| |`salesTotalNonSalesTargetDivision`|`string`|売上合計(非売上対象区分)| |`totalTaxFreeDivision`|`string`|合計(免税区分)| ### 商品一覧 スマレジに登録されている商品の一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`productId`|`string`|商品ID| |`categoryId`|`string`|部門ID| |`productCode`|`string`|商品コード| |`productName`|`string`|商品名| |`productKana`|`string`|商品名(カナ)| |`taxDivision`|`string`|税区分| |`productPriceDivision`|`string`|商品価格区分| |`price`|`string`|価格| |`customerPrice`|`string`|顧客価格| |`cost`|`string`|原価| |`attribute`|`string`|属性| |`description`|`string`|説明| |`catchCopy`|`string`|キャッチコピー| |`size`|`string`|サイズ| |`color`|`string`|色| |`tag`|`string`|タグ| |`groupCode`|`string`|グループコード| |`url`|`string`|URL| |`printReceiptProductName`|`string`|レシート印字商品名| |`displaySequence`|`string`|表示順序| |`salesDivision`|`string`|販売区分| |`stockControlDivision`|`string`|在庫管理区分| |`displayFlag`|`string`|表示フラグ| |`division`|`string`|区分| |`productOptionGroupId`|`string`|商品オプショングループID| |`pointNotApplicable`|`string`|ポイント不適用フラグ| |`taxFreeDivision`|`string`|免税区分| |`supplierProductNo`|`string`|仕入先商品番号| |`calcDiscount`|`string`|計算割引| |`staffDiscountRate`|`string`|スタッフ割引率| |`useCategoryReduceTax`|`string`|カテゴリ軽減税を使用| |`reduceTaxId`|`string`|軽減税ID| |`reduceTaxPrice`|`string`|軽減税価格| |`reduceTaxCustomerPrice`|`string`|軽減税顧客価格| |`orderPoint`|`string`|注文ポイント| |`purchaseCost`|`string`|購入原価| |`appStartDateTime`|`timestamp`|アプリ開始日時| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| ### 商品取扱店舗一覧 指定した商品がどの店舗で取り扱われているかを取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**商品ID**|✓|-|取扱店舗を取得する商品のIDを入力します。| |**店舗ID**|-|-|特定の店舗の情報のみを取得する場合に入力します。| |**取扱区分**|-|-|店舗での取扱状況で絞り込む場合に入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`productId`|`string`|商品ID| |`storeId`|`string`|店舗ID| |`assignDivision`|`string`|取扱区分| ### スタッフ一覧 スマレジに登録されているスタッフの一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`staffId`|`string`|スタッフID| |`staffCode`|`string`|スタッフコード| |`staffName`|`string`|スタッフ名| |`staffNameKana`|`string`|スタッフ名(カナ)| |`rank`|`string`|ランク| |`displayFlag`|`string`|表示フラグ| |`displaySequence`|`string`|表示順序| |`loginStaffFlag`|`string`|ログインスタッフフラグ| |`email`|`string`|メールアドレス| |`loginIpAddress`|`string`|ログインIPアドレス| |`roleId`|`string`|ロールID| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| ### 在庫一覧 指定した条件の在庫情報一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**店舗ID**|-|-|特定の店舗の在庫情報のみを取得する場合に入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`storeId`|`string`|店舗ID| |`productId`|`string`|商品ID| |`stockAmount`|`string`|在庫数量| |`layawayStockAmount`|`string`|積置在庫数量| |`updDateTime`|`timestamp`|更新日時| ### 店舗一覧 スマレジに登録されている店舗の一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**ポイント条件の含否**|-|none|レスポンスにポイント条件を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**レシート印字情報の含否**|-|none|レスポンスにレシート印字情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`storeId`|`string`|店舗ID| |`storeCode`|`string`|店舗コード| |`storeName`|`string`|店舗名| |`storeAbbr`|`string`|店舗略称| |`printReceiptStoreName`|`string`|レシート印字店舗名| |`printStockReceiptStoreName`|`string`|在庫レシート印字店舗名| |`division`|`string`|区分| |`postCode`|`string`|郵便番号| |`address`|`string`|住所| |`phoneNumber`|`string`|電話番号| |`faxNumber`|`string`|FAX番号| |`mailAddress`|`string`|メールアドレス| |`homepage`|`string`|ホームページ| |`tempTranMailAddress`|`string`|一時転送メールアドレス| |`priceChangeFlag`|`string`|価格変更フラグ| |`sellDivision`|`string`|販売区分| |`sumProcDivision`|`string`|締め処理区分| |`sumDateChangeTime`|`string`|締め日付変更時刻| |`sumRefColumn`|`string`|締め参照列| |`pointNotApplicable`|`string`|ポイント不適用フラグ| |`taxFreeDivision`|`string`|免税区分| |`maxBundleProductCount`|`string`|最大バンドル商品数| |`maxDiscountRate`|`string`|最大割引率| |`carriageDisplayFlag`|`string`|送料表示フラグ| |`terminalAdjustmentCashFlag`|`string`|端末調整現金フラグ| |`terminalCheckCashFlag`|`string`|端末確認現金フラグ| |`waiterAdjustmentDivision`|`string`|ウェイター調整区分| |`savingAutoDivision`|`string`|積立自動区分| |`savingAutoPrice`|`string`|積立自動金額| |`cancelSettingDivision`|`string`|キャンセル設定区分| |`roundingDivision`|`string`|四捨五入区分| |`discountRoundingDivision`|`string`|割引四捨五入区分| |`cardCompanySelectDivision`|`string`|カード会社選択区分| |`giftReceiptValidDays`|`string`|ギフトレシート有効日数| |`taxLabelNormal`|`string`|税ラベル(通常)| |`taxLabelReduce`|`string`|税ラベル(軽減)| |`pauseFlag`|`string`|一時停止フラグ| |`displaySequence`|`string`|表示順序| |`facePaymentUseDivision`|`string`|フェイス決済使用区分| |`invoiceRegistrationNo`|`string`|インボイス登録番号| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| |`pointCondition`|`json`|ポイント条件| |`receiptPrintInfo`|`json`|レシート印字情報| ### レジ端末一覧 スマレジに登録されているレジ端末の一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`storeId`|`string`|店舗ID| |`terminalId`|`string`|端末ID| |`terminalName`|`string`|端末名| |`cashDrawerId`|`string`|現金引出ID| |`uuid`|`string`|UUID| |`selfCheckoutAvailableFlag`|`string`|セルフレジ利用可フラグ| |`useStopDivision`|`string`|使用停止区分| |`transactionEditableFlag`|`string`|取引編集可能フラグ| |`smartIdEngineAvailableFlag`|`string`|SmartIDエンジン利用可フラグ| |`creditTerminalId`|`string`|クレジット端末ID| |`parentTerminalId`|`string`|親端末ID| |`appVersion`|`string`|アプリバージョン| |`insDateTime`|`timestamp`|作成日時| |`updDateTime`|`timestamp`|更新日時| ### 取引一覧 指定した条件の取引情報一覧を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**取引日時(開始)**|-|-|取得する取引の期間(開始日時)を入力します。
フォーマット: `YYYY-MM-DDTHH:mm:ss±HH:MM`
※ 開始〜終了の期間は最大31日間です。
※ 取引日時・締め日付・更新日時のうち1つを指定してください。| |**取引日時(終了)**|-|-|取得する取引の期間(終了日時)を入力します。
フォーマット: `YYYY-MM-DDTHH:mm:ss±HH:MM`
※ 開始〜終了の期間は最大31日間です。
※ 取引日時・締め日付・更新日時のうち1つを指定してください。| |**締め日付(開始)**|-|-|取得する取引の締め日付(開始)を入力します。
フォーマット: `YYYY-MM-DD`
※ 開始〜終了の期間は最大31日間です。
※ 取引日時・締め日付・更新日時のうち1つを指定してください。| |**締め日付(終了)**|-|-|取得する取引の締め日付(終了)を入力します。
フォーマット: `YYYY-MM-DD`
※ 開始〜終了の期間は最大31日間です。
※ 取引日時・締め日付・更新日時のうち1つを指定してください。| |**更新日時(開始)**|-|-|取得する取引の更新日時(開始日時)を入力します。
フォーマット: `YYYY-MM-DDTHH:mm:ss±HH:MM`
※ 開始〜終了の期間は最大31日間です。
※ 取引日時・締め日付・更新日時のうち1つを指定してください。| |**更新日時(終了)**|-|-|取得する取引の更新日時(終了日時)を入力します。
フォーマット: `YYYY-MM-DDTHH:mm:ss±HH:MM`
※ 開始〜終了の期間は最大31日間です。
※ 取引日時・締め日付・更新日時のうち1つを指定してください。| |**取引明細の含否**|-|none|レスポンスに取引明細を含めるかを選択します。
選択肢: `all`(すべて含める)、`summary`(サマリーのみ)、`none`(含めない)| |**預金その他の含否**|-|none|レスポンスに預金その他の情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**積置の含否**|-|none|レスポンスに積置情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**積置引取の含否**|-|none|レスポンスに積置引取情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**金銭管理の含否**|-|none|レスポンスに金銭管理情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**商品属性詳細の含否**|-|none|レスポンスに商品属性詳細を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`transactionHeadId`|`string`|取引ヘッドID| |`transactionDateTime`|`timestamp`|取引日時| |`transactionHeadDivision`|`string`|取引ヘッド区分| |`cancelDivision`|`string`|キャンセル区分| |`unitNonDiscountsubtotal`|`string`|ユニット非割引小計| |`unitDiscountsubtotal`|`string`|ユニット割引小計| |`unitStaffDiscountsubtotal`|`string`|ユニットスタッフ割引小計| |`unitBargainDiscountsubtotal`|`string`|ユニット値引割引小計| |`subtotal`|`string`|小計| |`subtotalForDiscount`|`string`|割引用小計| |`subtotalDiscountPrice`|`string`|小計割引金額| |`subtotalDiscountRate`|`string`|小計割引率| |`subtotalDiscountDivision`|`string`|小計割引区分| |`pointDiscount`|`string`|ポイント割引| |`couponDiscount`|`string`|クーポン割引| |`total`|`string`|合計| |`taxInclude`|`string`|税込| |`taxExclude`|`string`|税抜| |`roundingDivision`|`string`|四捨五入区分| |`roundingPrice`|`string`|四捨五入金額| |`cashTotal`|`string`|現金合計| |`creditTotal`|`string`|クレジット合計| |`deposit`|`string`|預金| |`depositCash`|`string`|預金(現金)| |`depositCredit`|`string`|預金(クレジット)| |`change`|`string`|おつり| |`tipCash`|`string`|チップ(現金)| |`tipCredit`|`string`|チップ(クレジット)| |`amount`|`string`|金額| |`returnAmount`|`string`|返金金額| |`costTotal`|`string`|原価合計| |`salesHeadDivision`|`string`|売上ヘッド区分| |`inTaxSalesTotal`|`string`|内税売上合計| |`outTaxSalesTotal`|`string`|外税売上合計| |`nonTaxSalesTotal`|`string`|非課税売上合計| |`nonSalesTargetTotal`|`string`|非売上対象合計| |`nonSalesTargetOutTaxTotal`|`string`|非売上対象外税合計| |`nonSalesTargetInTaxTotal`|`string`|非売上対象内税合計| |`nonSalesTargetTaxFreeTotal`|`string`|非売上対象免税合計| |`nonSalesTargetCostTotal`|`string`|非売上対象原価合計| |`nonSalesTargetAmount`|`string`|非売上対象金額| |`nonSalesTargetReturnAmount`|`string`|非売上対象返金金額| |`newPoint`|`string`|新規ポイント| |`spendPoint`|`string`|使用ポイント| |`point`|`string`|ポイント| |`totalPoint`|`string`|合計ポイント| |`currentMile`|`string`|現在マイル| |`earnMile`|`string`|獲得マイル| |`totalMile`|`string`|合計マイル| |`adjustmentMile`|`string`|調整マイル| |`adjustmentMileDivision`|`string`|調整マイル区分| |`adjustmentMileValue`|`string`|調整マイル値| |`storeId`|`string`|店舗ID| |`storeCode`|`string`|店舗コード| |`terminalId`|`string`|端末ID| |`customerId`|`string`|顧客ID| |`customerCode`|`string`|顧客コード| |`terminalTranId`|`string`|端末取引ID| |`terminalTranDateTime`|`timestamp`|端末取引日時| |`sumDivision`|`string`|締め区分| |`adjustmentDateTime`|`timestamp`|調整日時| |`sumDate`|`string`|締め日付| |`customerRank`|`string`|顧客ランク| |`customerGroupId`|`string`|顧客グループID| |`customerGroupId2`|`string`|顧客グループID2| |`customerGroupId3`|`string`|顧客グループID3| |`customerGroupId4`|`string`|顧客グループID4| |`customerGroupId5`|`string`|顧客グループID5| |`staffId`|`string`|スタッフID| |`staffCode`|`string`|スタッフコード| |`staffName`|`string`|スタッフ名| |`creditDivision`|`string`|クレジット区分| |`paymentCount`|`string`|支払い回数| |`slipNumber`|`string`|伝票番号| |`cancelSlipNumber`|`string`|キャンセル伝票番号| |`authNumber`|`string`|認可番号| |`authDate`|`string`|認可日| |`cardCompany`|`string`|カード会社| |`denomination`|`string`|金種| |`memo`|`string`|メモ| |`receiptMemo`|`string`|レシートメモ| |`carriage`|`string`|送料| |`commission`|`string`|手数料| |`guestNumbers`|`string`|ゲスト数| |`guestNumbersMale`|`string`|ゲスト数(男性)| |`guestNumbersFemale`|`string`|ゲスト数(女性)| |`guestNumbersUnknown`|`string`|ゲスト数(不明)| |`enterDateTime`|`timestamp`|入店日時| |`taxFreeSalesDivision`|`string`|免税売上区分| |`netTaxFreeGeneralTaxInclude`|`string`|純免税一般品(税込)| |`netTaxFreeGeneralTaxExclude`|`string`|純免税一般品(税抜)| |`netTaxFreeConsumableTaxInclude`|`string`|純免税消耗品(税込)| |`netTaxFreeConsumableTaxExclude`|`string`|純免税消耗品(税抜)| |`tags`|`string`|タグ| |`pointGivingDivision`|`string`|ポイント付与区分| |`pointGivingUnitPrice`|`string`|ポイント付与単価| |`pointGivingUnit`|`string`|ポイント付与単位| |`pointSpendDivision`|`string`|ポイント使用区分| |`mileageDivision`|`string`|マイレージ区分| |`mileageLabel`|`string`|マイレージラベル| |`customerPinCode`|`string`|顧客PINコード| |`returnSales`|`string`|返品売上| |`disposeDivision`|`string`|処分区分| |`disposeServerTransactionHeadId`|`string`|処分サーバー取引ヘッドID| |`cancelDateTime`|`timestamp`|キャンセル日時| |`sellDivision`|`string`|販売区分| |`taxRate`|`string`|税率| |`taxRounding`|`string`|税四捨五入| |`discountRoundingDivision`|`string`|割引四捨五入区分| |`transactionUuid`|`string`|取引UUID| |`exchangeTicketNo`|`string`|交換チケットNo| |`giftReceiptValidDays`|`string`|ギフトレシート有効日数| |`barcode`|`string`|バーコード| |`updDateTime`|`timestamp`|更新日時| |`details`|`json`|取引明細| |`depositOthers`|`json`|預金その他| |`layaway`|`json`|積置| |`layaways`|`json`|積置一覧| |`layawayPickUp`|`json`|積置引取| |`layawayPickUps`|`json`|積置引取一覧| |`moneyControl`|`json`|金銭管理| ### 取引 指定した取引IDの詳細情報を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**取引ID**|✓|-|取得する取引のIDを入力します。| |**取引明細の含否**|-|none|レスポンスに取引明細を含めるかを選択します。
選択肢: `all`(すべて含める)、`summary`(サマリーのみ)、`none`(含めない)| |**預金その他の含否**|-|none|レスポンスに預金その他の情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**クーポンの含否**|-|none|レスポンスにクーポン情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**クーポン対象商品の含否**|-|none|レスポンスにクーポン対象商品を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**割引の含否**|-|none|レスポンスに割引情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**店舗情報の含否**|-|none|レスポンスに店舗情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**顧客情報の含否**|-|none|レスポンスに顧客情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**顧客グループの含否**|-|none|レスポンスに顧客グループ情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**スタッフ情報の含否**|-|none|レスポンスにスタッフ情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**記録スタッフの含否**|-|none|レスポンスに記録スタッフ情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**積置の含否**|-|none|レスポンスに積置情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**積置引取の含否**|-|none|レスポンスに積置引取情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**金銭管理の含否**|-|none|レスポンスに金銭管理情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**商品属性詳細の含否**|-|none|レスポンスに商品属性詳細を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`transactionHeadId`|`string`|取引ヘッドID| |`transactionDateTime`|`timestamp`|取引日時| |`transactionHeadDivision`|`string`|取引ヘッド区分| |`cancelDivision`|`string`|キャンセル区分| |`unitNonDiscountsubtotal`|`string`|ユニット非割引小計| |`unitDiscountsubtotal`|`string`|ユニット割引小計| |`unitStaffDiscountsubtotal`|`string`|ユニットスタッフ割引小計| |`unitBargainDiscountsubtotal`|`string`|ユニット値引割引小計| |`subtotal`|`string`|小計| |`subtotalForDiscount`|`string`|割引用小計| |`subtotalDiscountPrice`|`string`|小計割引金額| |`subtotalDiscountRate`|`string`|小計割引率| |`subtotalDiscountDivision`|`string`|小計割引区分| |`pointDiscount`|`string`|ポイント割引| |`couponDiscount`|`string`|クーポン割引| |`total`|`string`|合計| |`taxInclude`|`string`|税込| |`taxExclude`|`string`|税抜| |`roundingDivision`|`string`|四捨五入区分| |`roundingPrice`|`string`|四捨五入金額| |`cashTotal`|`string`|現金合計| |`creditTotal`|`string`|クレジット合計| |`deposit`|`string`|預金| |`depositCash`|`string`|預金(現金)| |`depositCredit`|`string`|預金(クレジット)| |`change`|`string`|おつり| |`tipCash`|`string`|チップ(現金)| |`tipCredit`|`string`|チップ(クレジット)| |`amount`|`string`|金額| |`returnAmount`|`string`|返金金額| |`costTotal`|`string`|原価合計| |`salesHeadDivision`|`string`|売上ヘッド区分| |`inTaxSalesTotal`|`string`|内税売上合計| |`outTaxSalesTotal`|`string`|外税売上合計| |`nonTaxSalesTotal`|`string`|非課税売上合計| |`nonSalesTargetTotal`|`string`|非売上対象合計| |`nonSalesTargetOutTaxTotal`|`string`|非売上対象外税合計| |`nonSalesTargetInTaxTotal`|`string`|非売上対象内税合計| |`nonSalesTargetTaxFreeTotal`|`string`|非売上対象免税合計| |`nonSalesTargetCostTotal`|`string`|非売上対象原価合計| |`nonSalesTargetAmount`|`string`|非売上対象金額| |`nonSalesTargetReturnAmount`|`string`|非売上対象返金金額| |`newPoint`|`string`|新規ポイント| |`spendPoint`|`string`|使用ポイント| |`point`|`string`|ポイント| |`totalPoint`|`string`|合計ポイント| |`currentMile`|`string`|現在マイル| |`earnMile`|`string`|獲得マイル| |`totalMile`|`string`|合計マイル| |`adjustmentMile`|`string`|調整マイル| |`adjustmentMileDivision`|`string`|調整マイル区分| |`adjustmentMileValue`|`string`|調整マイル値| |`storeId`|`string`|店舗ID| |`terminalId`|`string`|端末ID| |`customerId`|`string`|顧客ID| |`terminalTranId`|`string`|端末取引ID| |`terminalTranDateTime`|`timestamp`|端末取引日時| |`sumDivision`|`string`|締め区分| |`adjustmentDateTime`|`timestamp`|調整日時| |`sumDate`|`string`|締め日付| |`customerRank`|`string`|顧客ランク| |`customerGroupId`|`string`|顧客グループID| |`customerGroupId2`|`string`|顧客グループID2| |`customerGroupId3`|`string`|顧客グループID3| |`customerGroupId4`|`string`|顧客グループID4| |`customerGroupId5`|`string`|顧客グループID5| |`staffId`|`string`|スタッフID| |`staffName`|`string`|スタッフ名| |`creditDivision`|`string`|クレジット区分| |`paymentCount`|`string`|支払い回数| |`slipNumber`|`string`|伝票番号| |`cancelSlipNumber`|`string`|キャンセル伝票番号| |`authNumber`|`string`|認可番号| |`authDate`|`string`|認可日| |`cardCompany`|`string`|カード会社| |`denomination`|`string`|金種| |`memo`|`string`|メモ| |`receiptMemo`|`string`|レシートメモ| |`carriage`|`string`|送料| |`commission`|`string`|手数料| |`guestNumbers`|`string`|ゲスト数| |`guestNumbersMale`|`string`|ゲスト数(男性)| |`guestNumbersFemale`|`string`|ゲスト数(女性)| |`guestNumbersUnknown`|`string`|ゲスト数(不明)| |`enterDateTime`|`timestamp`|入店日時| |`taxFreeSalesDivision`|`string`|免税売上区分| |`netTaxFreeGeneralTaxInclude`|`string`|純免税一般品(税込)| |`netTaxFreeGeneralTaxExclude`|`string`|純免税一般品(税抜)| |`netTaxFreeConsumableTaxInclude`|`string`|純免税消耗品(税込)| |`netTaxFreeConsumableTaxExclude`|`string`|純免税消耗品(税抜)| |`tags`|`string`|タグ| |`pointGivingDivision`|`string`|ポイント付与区分| |`pointGivingUnitPrice`|`string`|ポイント付与単価| |`pointGivingUnit`|`string`|ポイント付与単位| |`pointSpendDivision`|`string`|ポイント使用区分| |`mileageDivision`|`string`|マイレージ区分| |`mileageLabel`|`string`|マイレージラベル| |`customerPinCode`|`string`|顧客PINコード| |`returnSales`|`string`|返品売上| |`disposeDivision`|`string`|処分区分| |`disposeServerTransactionHeadId`|`string`|処分サーバー取引ヘッドID| |`cancelDateTime`|`timestamp`|キャンセル日時| |`sellDivision`|`string`|販売区分| |`taxRate`|`string`|税率| |`taxRounding`|`string`|税四捨五入| |`discountRoundingDivision`|`string`|割引四捨五入区分| |`transactionUuid`|`string`|取引UUID| |`exchangeTicketNo`|`string`|交換チケットNo| |`giftReceiptValidDays`|`string`|ギフトレシート有効日数| |`discountCalculateDivision`|`string`|割引計算区分| |`barcode`|`string`|バーコード| |`updDateTime`|`timestamp`|更新日時| |`details`|`json`|取引明細| |`depositOthers`|`json`|預金その他| |`coupons`|`json`|クーポン| |`couponItems`|`json`|クーポン対象商品| |`discounts`|`json`|割引| |`store`|`json`|店舗情報| |`customer`|`json`|顧客情報| |`customerGroups`|`json`|顧客グループ| |`staff`|`json`|スタッフ情報| |`recordedStaff`|`json`|記録スタッフ| |`layaway`|`json`|積置| |`layaways`|`json`|積置一覧| |`layawayPickUp`|`json`|積置引取| |`layawayPickUps`|`json`|積置引取一覧| |`moneyControl`|`json`|金銭管理| ### 取引明細 指定した取引IDの取引明細情報を取得します。 詳しくは、[スマレジ公式ドキュメント − POS仕様書](https://developers.smaregi.dev/platform-api-reference/apis/pos/)を参照ください。 #### 設定項目 |項目名|必須|デフォルト値|説明| |---|---|---|---| |**契約ID**|✓|-|スマレジの契約IDを入力します。| |**取引ID**|✓|-|取引明細を取得する取引のIDを入力します。| |**割引の含否**|-|none|レスポンスに割引情報を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| |**商品属性詳細の含否**|-|none|レスポンスに商品属性詳細を含めるかを選択します。
選択肢: `all`(含める)、`none`(含めない)| #### 取得データ |カラム名|デフォルトのデータ型|補足事項| |---|---|---| |`transactionHeadId`|`string`|取引ヘッドID| |`transactionDetailId`|`string`|取引明細ID| |`parentTransactionDetailId`|`string`|親取引明細ID| |`transactionDetailDivision`|`string`|取引明細区分| |`productId`|`string`|商品ID| |`productCode`|`string`|商品コード| |`productName`|`string`|商品名| |`printReceiptProductName`|`string`|レシート印字商品名| |`color`|`string`|色| |`size`|`string`|サイズ| |`groupCode`|`string`|グループコード| |`taxDivision`|`string`|税区分| |`price`|`string`|価格| |`salesPrice`|`string`|販売価格| |`unitDiscountPrice`|`string`|ユニット割引金額| |`unitDiscountRate`|`string`|ユニット割引率| |`unitDiscountDivision`|`string`|ユニット割引区分| |`cost`|`string`|原価| |`quantity`|`string`|数量| |`unitNonDiscountSum`|`string`|ユニット非割引合計| |`unitDiscountSum`|`string`|ユニット割引合計| |`unitDiscountedSum`|`string`|ユニット割引済み合計| |`costSum`|`string`|原価合計| |`categoryId`|`string`|部門ID| |`categoryName`|`string`|部門名| |`discriminationNo`|`string`|識別番号| |`salesDivision`|`string`|販売区分| |`productDivision`|`string`|商品区分| |`inventoryReservationDivision`|`string`|在庫予約区分| |`pointNotApplicable`|`string`|ポイント不適用フラグ| |`calcDiscount`|`string`|計算割引| |`taxFreeDivision`|`string`|免税区分| |`taxFreeCommodityPrice`|`string`|免税商品価格| |`taxFree`|`string`|免税| |`productBundleGroupId`|`string`|商品バンドルグループID| |`discountPriceProportional`|`string`|割引金額按分| |`discountPointProportional`|`string`|割引ポイント按分| |`discountCouponProportional`|`string`|割引クーポン按分| |`taxIncludeProportional`|`string`|税込按分| |`taxExcludeProportional`|`string`|税抜按分| |`productBundleProportional`|`string`|商品バンドル按分| |`staffDiscountProportional`|`string`|スタッフ割引按分| |`bargainDiscountProportional`|`string`|値引割引按分| |`roundingPriceProportional`|`string`|四捨五入金額按分| |`productStaffDiscountRate`|`string`|商品スタッフ割引率| |`staffRank`|`string`|スタッフランク| |`staffRankName`|`string`|スタッフランク名| |`staffDiscountRate`|`string`|スタッフ割引率| |`staffDiscountDivision`|`string`|スタッフ割引区分| |`applyStaffDiscountRate`|`string`|適用スタッフ割引率| |`applyStaffDiscountPrice`|`string`|適用スタッフ割引金額| |`bargainId`|`string`|値引ID| |`bargainName`|`string`|値引名| |`bargainDivision`|`string`|値引区分| |`bargainValue`|`string`|値引値| |`applyBargainValue`|`string`|適用値引値| |`applyBargainDiscountPrice`|`string`|適用値引割引金額| |`taxRate`|`string`|税率| |`standardTaxRate`|`string`|標準税率| |`modifiedTaxRate`|`string`|修正税率| |`reduceTaxId`|`string`|軽減税ID| |`reduceTaxName`|`string`|軽減税名| |`reduceTaxRate`|`string`|軽減税率| |`reduceTaxPrice`|`string`|軽減税価格| |`reduceTaxMemberPrice`|`string`|軽減税会員価格| |`memo`|`string`|メモ| |`discounts`|`json`|割引| |`productAttributes`|`json`|商品属性| |`rfidTags`|`json`|RFIDタグ|