サンドボックス
https://api.smaregi.dev/{契約ID}/order-shipment
本番
https://api.smaregi.jp/{契約ID}/order-shipment
一覧を取得するAPIでは1回で取得できる件数に上限があり、より多くの件数が必要となる場合はページを指定する必要があります。
page
に1から始まるページ番号を指定してください。
スマレジ・プラットフォームAPI 受注管理で定義しているscope一覧です。
Security Scheme Type | OAuth2 |
---|---|
clientCredentials OAuth Flow | Token URL: https://id.smaregi.dev/app/{contractId}/token Scopes:
|
受注を登録します。
指定した配達希望日によって出荷予定日、出荷準備開始予定日が以下のルールで適用されます。
order-shipment.orders:write
) contract_id required | string 契約ID |
orderCode required | string <string> [ 1 .. 50 ] characters ^[ -~]+$ 受注番号 |
orderDateTime required | string <date-time> 受注日時[YYYY-MM-DDThh:mm:ssTZD] |
carriage | integer [ 0 .. 999999999 ] Default: 0 送料 |
commission | integer [ 0 .. 999999999 ] Default: 0 手数料 |
giftWrapPrice | integer [ 0 .. 999999999 ] Default: 0 ギフトラッピング料 |
totalPointDiscount | integer [ 0 .. 999999999 ] Default: 0 ポイント利用 |
totalCouponDiscount | integer [ 0 .. 999999999 ] Default: 0 クーポン値引き |
subtotalCouponDiscount | integer [ 0 .. 999999999 ] Default: 0 クーポン値引き(モール) |
totalPromotionDiscount | integer [ 0 .. 999999999 ] Default: 0 プロモーション値引き |
taxExclude | integer [ 0 .. 999999999 ] Default: 0 外税受領額 |
total required | integer [ 0 .. 999999999 ] 合計金額 下記計算式と一致する必要があります。 合計 = 小計(明細リストの販売単価 * 数量の総和) + 外税受領額 + (送料 + 手数料 + ギフトラッピング料) - (ポイント利用 + クーポン値引き + クーポン値引き(モール) + プロモーション値引き) |
tax | integer [ 0 .. 999999999 ] Default: 0 内消費税 |
taxRate required | integer [ 0 .. 100 ] 消費税率(ヘッダ) |
taxRounding required | string Enum: "0" "1" "2" 税の丸め方式:(0:四捨五入、1:切り捨て、2:切り上げ) |
paymentMethodId | string non-empty Deprecated スマレジの支払方法ID |
payType | string Default: "unset" Enum: "before" "after" "unset" 前払/後払
|
paymentDate | string <date> Nullable Default: null 入金日:支払いされた日付 |
payment | integer (入金額) [ 0 .. 999999999 ] Nullable Default: null 入金額 |
Array of objects (Payments) [ 1 .. 3 ] items 支払情報リスト | |
orderMemo | string <= 5000 characters 受注メモ |
deliveryMemo | string <= 5000 characters 発送メモ |
paymentMemo | string <= 5000 characters 入金メモ |
memo | string <= 5000 characters 管理メモ |
required | Array of objects (OrderItem) [ 1 .. 99 ] items 明細リスト |
storeId required | string non-empty 受注店舗ID |
required | object (Customer) 購入者 |
required | object (ShippingAddress) 発送先 |
object 配送情報 | |
object 出荷情報 | |
Array of objects (OrderTag) <= 5 items unique 受注分類タグリスト |
{- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "productId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "quantity": 1,
- "reduceTaxId": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string"
}
]
}
{- "orderHeadId": "string",
- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "cancelDateTime": "2019-08-24T14:15:22Z",
- "subtotal": 0,
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "orderDetailId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "total": 999999999,
- "quantity": 1,
- "taxRate": 100,
- "reduceTaxId": "string",
- "reduceTaxName": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string",
- "tagName": "string"
}
]
}
受注を登録します。
※登録に成功した場合の受注ステータスは「出荷済」になります。
order-shipment.orders:write
) contract_id required | string 契約ID |
orderCode required | string <string> [ 1 .. 50 ] characters ^[ -~]+$ 受注番号 |
orderDateTime required | string <date-time> 受注日時[YYYY-MM-DDThh:mm:ssTZD] |
carriage | integer [ 0 .. 999999999 ] Default: 0 送料 |
commission | integer [ 0 .. 999999999 ] Default: 0 手数料 |
giftWrapPrice | integer [ 0 .. 999999999 ] Default: 0 ギフトラッピング料 |
totalPointDiscount | integer [ 0 .. 999999999 ] Default: 0 ポイント利用 |
totalCouponDiscount | integer [ 0 .. 999999999 ] Default: 0 クーポン値引き |
subtotalCouponDiscount | integer [ 0 .. 999999999 ] Default: 0 クーポン値引き(モール) |
totalPromotionDiscount | integer [ 0 .. 999999999 ] Default: 0 プロモーション値引き |
taxExclude | integer [ 0 .. 999999999 ] Default: 0 外税受領額 |
total required | integer [ 0 .. 999999999 ] 合計金額 下記計算式と一致する必要があります。 合計 = 小計(明細リストの販売単価 * 数量の総和) + 外税受領額 + (送料 + 手数料 + ギフトラッピング料) - (ポイント利用 + クーポン値引き + クーポン値引き(モール) + プロモーション値引き) |
tax | integer [ 0 .. 999999999 ] Default: 0 内消費税 |
taxRate required | integer [ 0 .. 100 ] 消費税率(ヘッダ) |
taxRounding required | string Enum: "0" "1" "2" 税の丸め方式:(0:四捨五入、1:切り捨て、2:切り上げ) |
paymentMethodId | string non-empty Deprecated スマレジの支払方法ID |
payType | string Default: "unset" Enum: "before" "after" "unset" 前払/後払
|
paymentDate | string <date> Nullable Default: null 入金日:支払いされた日付 |
payment | integer (入金額) [ 0 .. 999999999 ] Nullable Default: null 入金額 |
Array of objects (Payments) [ 1 .. 3 ] items 支払情報リスト | |
shippingDate required | string <date> 出荷日[YYYY-MM-DD] |
deliveryNumber | string <= 20 characters 送り状番号 |
orderMemo | string <= 5000 characters 受注メモ |
deliveryMemo | string <= 5000 characters 発送メモ |
paymentMemo | string <= 5000 characters 入金メモ |
memo | string <= 5000 characters 管理メモ |
required | Array of objects (OrderItem) [ 1 .. 99 ] items 明細リスト |
storeId required | string non-empty 受注店舗ID |
required | object (Customer) 購入者 |
required | object (ShippingAddress) 発送先 |
object 配送情報 | |
object 出荷情報 | |
Array of objects (OrderTag) <= 5 items unique 受注分類タグリスト |
{- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "productId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "quantity": 1,
- "reduceTaxId": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string"
}
]
}
{- "orderHeadId": "string",
- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "cancelDateTime": "2019-08-24T14:15:22Z",
- "subtotal": 0,
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "orderDetailId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "total": 999999999,
- "quantity": 1,
- "taxRate": 100,
- "reduceTaxId": "string",
- "reduceTaxName": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string",
- "tagName": "string"
}
]
}
受注を取得します。
order-shipment.orders:read
) contract_id required | string 契約ID |
id required | string 受注ID |
{- "orderHeadId": "string",
- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "cancelDateTime": "2019-08-24T14:15:22Z",
- "subtotal": 0,
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "orderDetailId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "total": 999999999,
- "quantity": 1,
- "taxRate": 100,
- "reduceTaxId": "string",
- "reduceTaxName": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string",
- "tagName": "string"
}
]
}
受注をキャンセルします。
order-shipment.orders:write
) contract_id required | string 契約ID |
id required | string 受注ID |
{- "orderHeadId": "string",
- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "cancelDateTime": "2019-08-24T14:15:22Z",
- "subtotal": 0,
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "orderDetailId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "total": 999999999,
- "quantity": 1,
- "taxRate": 100,
- "reduceTaxId": "string",
- "reduceTaxName": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string",
- "tagName": "string"
}
]
}
指定した受注の入金情報を更新します。
指定した受注の入金ステータスを「入金済」に更新します。
order-shipment.orders:write
) contract_id required | string 契約ID |
id required | string 受注ID |
paymentMethodId | string non-empty Deprecated スマレジの支払方法ID |
payType | string Enum: "before" "after" "unset" 前払/後払
|
paymentDate required | string <date> 入金日:支払いされた日付 |
payment | integer [ 0 .. 999999999 ] Nullable 入金額 |
Array of objects (Payments) [ 1 .. 3 ] items 支払情報リスト |
{- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": "2019-08-24",
- "payment": 999999999,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
]
}
{- "orderHeadId": "string",
- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "cancelDateTime": "2019-08-24T14:15:22Z",
- "subtotal": 0,
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "orderDetailId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "total": 999999999,
- "quantity": 1,
- "taxRate": 100,
- "reduceTaxId": "string",
- "reduceTaxName": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string",
- "tagName": "string"
}
]
}
指定した受注の入金情報を取消します。
指定した受注の入金日と支払金額を未設定にして、入金ステータスを「未払い」に更新します。
order-shipment.orders:write
) contract_id required | string 契約ID |
id required | string 受注ID |
{- "orderHeadId": "string",
- "orderCode": "string",
- "orderDateTime": "2019-08-24T14:15:22Z",
- "cancelDateTime": "2019-08-24T14:15:22Z",
- "subtotal": 0,
- "carriage": 0,
- "commission": 0,
- "giftWrapPrice": 0,
- "totalPointDiscount": 0,
- "totalCouponDiscount": 0,
- "subtotalCouponDiscount": 0,
- "totalPromotionDiscount": 0,
- "taxExclude": 0,
- "total": 999999999,
- "tax": 0,
- "taxRate": 100,
- "taxRounding": "0",
- "paymentMethodId": "deprecated",
- "payType": "before",
- "paymentDate": null,
- "payment": null,
- "payments": [
- {
- "paymentMethodId": "string",
- "payment": null
}
], - "shippingDate": "2019-08-24",
- "deliveryNumber": "string",
- "orderMemo": "string",
- "deliveryMemo": "string",
- "paymentMemo": "string",
- "memo": "string",
- "items": [
- {
- "orderDetailId": "string",
- "productName": "string",
- "connectedProductCode": "string",
- "taxDivision": "0",
- "price": 0,
- "salesPrice": 999999999,
- "total": 999999999,
- "quantity": 1,
- "taxRate": 100,
- "reduceTaxId": "string",
- "reduceTaxName": "string",
- "options": [
- {
- "attribute": "string",
- "value": "string"
}
]
}
], - "storeId": "string",
- "customer": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "shippingAddress": {
- "fullName": "string",
- "email": "string",
- "fullNameKana": "string",
- "zip": "string",
- "prefectures": "string",
- "address1": "string",
- "address2": "string",
- "phone": "string"
}, - "deliveryInfo": {
- "deliveryCompany": "sagawa",
- "deliveryMethodName": "string",
- "desiredDeliveryDate": null,
- "desiredDeliveryTime": "string"
}, - "shippingInfo": {
- "giftDivision": false,
- "printedInvoiceDivision": false,
- "deliverySlipNotice": "string"
}, - "tags": [
- {
- "tagId": "string",
- "tagName": "string"
}
]
}
受注店舗を登録します。
order-shipment.stores:write
) contract_id required | string 契約ID |
storeCode required | string <= 20 characters ^[ -~]+$ 店舗コード |
storeName required | string [ 1 .. 85 ] characters 店舗名 |
storeAbbr | string <= 85 characters 店舗名略称 |
sellDivision | string Default: "included" Enum: "included" "excluded" 販売区分:受注店舗での販売時の消費税の扱いを指定できます。
|
sumDateChangeTime | string^(2[0-3]|[01][0-9]):([0-5][0-9])$ Default: "00:00" 指定した時刻を起点として締めを行なう日付が切り替わります。 |
displaySequence | integer [ 1 .. 999999999 ] Nullable Default: null 店舗の並び順。 |
pointPaymentMethodId | string non-empty ポイント支払方法 |
{- "storeCode": "string",
- "storeName": "string",
- "storeAbbr": "string",
- "sellDivision": "included",
- "sumDateChangeTime": "23:59",
- "displaySequence": null,
- "pointPaymentMethodId": "string"
}
{- "storeId": "string",
- "storeCode": "string",
- "storeName": "string",
- "storeAbbr": "string",
- "sellDivision": "included",
- "sumDateChangeTime": "23:59",
- "displaySequence": null,
- "pauseFlag": true,
- "pointPaymentMethodId": "string"
}
受注店舗を取得します。
order-shipment.stores:read
) contract_id required | string 契約ID |
store_id required | string 受注店舗ID |
{- "storeId": "string",
- "storeCode": "string",
- "storeName": "string",
- "storeAbbr": "string",
- "sellDivision": "included",
- "sumDateChangeTime": "23:59",
- "displaySequence": null,
- "pauseFlag": true,
- "pointPaymentMethodId": "string"
}
受注店舗を削除します。
order-shipment.stores:write
) contract_id required | string 契約ID |
store_id required | string 受注店舗ID |
{- "type": "about:blank",
- "title": "BadRequest",
- "detail": "指定された受注店舗は他店の在庫参照店舗に設定されているため、削除できません。",
- "status": 400
}
受注店舗の在庫参照店舗の在庫情報一覧を取得します。
order-shipment.stock:read
) contract_id required | string 契約ID |
store_id required | string 受注店舗ID |
limit | integer [ 1 .. 1000 ] Default: 100 取得件数 |
page | integer >= 1 Default: 1 ページ |
sort | string Default: "updatedAt:desc" Enum: "updatedAt" "updatedAt:desc" "reserveUpdatedAt" "reserveUpdatedAt:desc" ソート
|
product_ids | string non-empty スマレジの商品ID |
updated_at_from | string <date-time> 在庫数の最終更新日時(From)[YYYY-MM-DDThh:mm:ssTZD] |
updated_at_to | string <date-time> 在庫数の最終更新日時(To)[YYYY-MM-DDThh:mm:ssTZD] |
reserve_updated_at_from | string <date-time> 引当数の最終更新日時(From)[YYYY-MM-DDThh:mm:ssTZD] |
reserve_updated_at_to | string <date-time> 引当数の最終更新日時(To)[YYYY-MM-DDThh:mm:ssTZD] |
[- {
- "productId": "string",
- "stockAmount": 0,
- "updatedAt": "2019-08-24T14:15:22Z",
- "reserveAmount": 0,
- "nonReserveAmount": 0,
- "reserveUpdatedAt": "2019-08-24T14:15:22Z"
}
]
Smaregi-Event | string イベント名 |
contractId | string (契約ID) |
event | string (イベント) |
action | string (アクション)
※actionは今後追加される場合があります。 |
storeId | string (受注店舗ID) |
orderHeadIds | Array of strings (受注IDリスト) |
{- "contractId": "smaregi",
- "event": "order-shipment:orders",
- "action": "shipped",
- "storeId": "1",
- "orderHeadIds": [
- "111",
- "222"
]
}