受注グループ登録
const url = 'https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-b2b/order_groups';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"orders":[{"orderNumber":"20260327-093233","customerId":"12345678-1234-1234-1234-1234567890op","lastName":"すまれじ","firstName":"太郎","zipCode":"5555555","prefectureCode":13,"address01":"大阪市中央区","orderDetails":[{"orderDetailNumber":"1-001","productId":"12345678-1234-1234-1234-1234567890uv"}]}],"orderShipments":[{"shipmentStatusId":"12345678-1234-1234-1234-1234567890c3","deliveryRuleId":"12345678-1234-1234-1234-1234567890d4","deliveryMethodId":"12345678-1234-1234-1234-1234567890f6","recipientId":"12345678-1234-1234-1234-1234567890g7","recipientCompanyName":"株式会社スマレジ","recipientZipCode":"5555555","recipientPrefectureCode":13,"recipientAddress01":"大阪市中央区","orderShipmentDetails":[{"orderDetailNumber":"1-001","unitPriceNoTax":"100.00","quantity":1,"subtotalNoTax":"100.00"}],"orderShipmentTracks":[]}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-b2b/order_groups \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "orders": [ { "orderNumber": "20260327-093233", "customerId": "12345678-1234-1234-1234-1234567890op", "lastName": "すまれじ", "firstName": "太郎", "zipCode": "5555555", "prefectureCode": 13, "address01": "大阪市中央区", "orderDetails": [ { "orderDetailNumber": "1-001", "productId": "12345678-1234-1234-1234-1234567890uv" } ] } ], "orderShipments": [ { "shipmentStatusId": "12345678-1234-1234-1234-1234567890c3", "deliveryRuleId": "12345678-1234-1234-1234-1234567890d4", "deliveryMethodId": "12345678-1234-1234-1234-1234567890f6", "recipientId": "12345678-1234-1234-1234-1234567890g7", "recipientCompanyName": "株式会社スマレジ", "recipientZipCode": "5555555", "recipientPrefectureCode": 13, "recipientAddress01": "大阪市中央区", "orderShipmentDetails": [ { "orderDetailNumber": "1-001", "unitPriceNoTax": "100.00", "quantity": 1, "subtotalNoTax": "100.00" } ], "orderShipmentTracks": [] } ] }'受注グループを登録します。
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
受注グループステータスID
未指定で登録した場合、受注グループステータス (GET /order_group_statuses) の progress: 200(初期ステータス「未対応」)のIDが自動設定されます。
売上日[YYYY-MM-DD]
税ルールID
決済ステータス
0: 対象外1: 未処理2: 処理予定3: 処理済4: 処理取消5: 処理不可
受注
object
注文番号
省略した場合は登録日時から自動採番されます(形式: YYYYMMDD-hhmmss)。
自動採番された値はレスポンスで返却されます(レスポンスの orderNumber は常に値が入り、null にはなりません)。
取引先ID
ユーザーID
受注ステータスID
注文日時[YYYY-MM-DDThh:mm:ssTZD]
備考
会社名
姓
名
郵便番号
住所1
住所2
住所3
電話番号
メールアドレス
デバイスコード
1: モバイル2: スマートフォン3: パソコン99: 管理画面
受注明細
object
受注明細番号
商品ID
数量
販売価格(税抜)
単価(税抜)
税率(%)
受注支払
object
支払方法ID
支払ステータスID
手数料(税抜)
請求金額
出荷
object
配送ステータスID
配送ルールID
配送方法ID
出荷日[YYYY-MM-DD]
配達予定日[YYYY-MM-DD]
配送先ID
届け先会社名
届け先姓
届け先名
届け先郵便番号
届け先住所1
届け先住所2
届け先住所3
届け先電話番号
届け先メールアドレス
配送明細
object
受注明細番号
単価(税抜)
数量
小計(税抜)
配送追跡
object
追跡番号
Examples
{ "orders": [ { "orderNumber": "20260327-093233", "customerId": "12345678-1234-1234-1234-1234567890op", "lastName": "すまれじ", "firstName": "太郎", "zipCode": "5555555", "prefectureCode": 13, "address01": "大阪市中央区", "orderDetails": [ { "orderDetailNumber": "1-001", "productId": "12345678-1234-1234-1234-1234567890uv" } ] } ], "orderShipments": [ { "shipmentStatusId": "12345678-1234-1234-1234-1234567890c3", "deliveryRuleId": "12345678-1234-1234-1234-1234567890d4", "deliveryMethodId": "12345678-1234-1234-1234-1234567890f6", "recipientId": "12345678-1234-1234-1234-1234567890g7", "recipientCompanyName": "株式会社スマレジ", "recipientZipCode": "5555555", "recipientPrefectureCode": 13, "recipientAddress01": "大阪市中央区", "orderShipmentDetails": [ { "orderDetailNumber": "1-001", "unitPriceNoTax": "100.00", "quantity": 1, "subtotalNoTax": "100.00" } ], "orderShipmentTracks": [] } ]}Responses
Section titled “Responses”登録成功
object
受注グループID
受注グループステータスID
受注グループ支払ステータスID
受注グループ配送ステータスID
受注日時[YYYY-MM-DDThh:mm:ssTZD]
売上日[YYYY-MM-DD]
購入タイプ
1: 通常2: 定期
重量
サイズ
0 以上 9999999999.99 以下の小数2桁。商品の size が null の場合や集計対象が無い場合は 0.00 になります(null にはなりません)。
配送費用
単価(税抜)
定期初回費用(税抜)
定期継続費用(税抜)
配送料(税抜)
手数料(税抜)
小計(税抜)
消費税
合計金額
請求金額
税ルールID
決済ステータス
0: 対象外1: 未処理2: 処理予定3: 処理済4: 処理取消5: 処理不可
更新日時[YYYY-MM-DDThh:mm:ssTZD]
受注
object
受注ID
受注グループID
注文番号
受注ステータスID
注文番号枝番
定期契約ID
注文日時[YYYY-MM-DDThh:mm:ssTZD]
備考
定期初回費用(税抜)
定期初回費用税率(%)
定期継続費用(税抜)
定期継続費用税率(%)
付与ポイント
使用ポイント
小計(税抜)
消費税
合計金額
請求金額
取引先ID
ユーザーID
会社名
部署名
姓
名
姓(フリガナ)
名(フリガナ)
郵便番号
住所1
住所2
住所3
電話番号
FAX番号
メールアドレス
デバイスコード
1: モバイル2: スマートフォン3: パソコン99: 管理画面
ユーザーエージェント
IPアドレス
リファラURL
リファラパラメータ
受注明細
object
受注明細ID
受注ID
受注明細番号
商品ID
商品グループ名
商品名
販売価格(税抜)
仕入掛率
単価(税抜)
税率(%)
数量
小計(税抜)
在庫切れ注文コード
1: 受け付けない2: 在庫切れでも注文を受け付ける
重量
サイズ
0 以上 9999999999.99 以下の小数2桁。商品の size が null の場合や集計対象が無い場合は 0.00 になります(null にはなりません)。
受注支払
object
受注支払ID
受注グループID
支払方法ID
支払ステータスID
手数料(税抜)
手数料税率(%)
請求期限日[YYYY-MM-DD]
請求金額
入金情報
object
入金情報ID
受注支払ID
入金日[YYYY-MM-DD]
入金金額
出荷
object
出荷ID
受注グループID
配送ステータスID
配送ルールID
配送会社ID
配送方法ID
配送温度帯ID
普通郵便フラグ
配達希望日[YYYY-MM-DD]
出荷予定日[YYYY-MM-DD]
出荷日[YYYY-MM-DD]
配達予定日[YYYY-MM-DD]
配達日時[YYYY-MM-DDThh:mm:ssTZD]
品名
注意事項
備考
重量
サイズ
0 以上 9999999999.99 以下の小数2桁。商品の size が null の場合や集計対象が無い場合は 0.00 になります(null にはなりません)。
配送費用
配送料(税抜)
配送料税率(%)
口数
配送先ID
取引先ID
届け先会社名
届け先部署名
届け先姓
届け先名
届け先姓(フリガナ)
届け先名(フリガナ)
届け先郵便番号
届け先住所1
届け先住所2
届け先住所3
届け先電話番号
届け先FAX番号
届け先メールアドレス
届け先表示名
配送明細
object
出荷明細ID
出荷ID
受注明細ID
受注明細番号
単価(税抜)
数量
小計(税抜)
引当済フラグ
引当数量
配送追跡
object
配送追跡ID
出荷ID
追跡番号
受注グループ金額
object
受注グループ金額ID
受注グループID
税率(%)
小計(税抜)
小計(消費税)
単価(税抜)
単価(消費税)
定期初回費用(税抜)
定期初回費用(消費税)
定期継続費用(税抜)
定期継続費用(消費税)
配送料(税抜)
配送料(消費税)
手数料(税抜)
手数料(消費税)
売上(税抜)
売上(消費税)
値引(税抜)
値引(消費税)
ポイント値引(税抜)
ポイント値引(消費税)
クーポン値引(税抜)
クーポン値引(消費税)
その他値引(税抜)
その他値引(消費税)
受注グループタグ
object
受注グループタグID
タグ名
Examples
{ "id": "12345678-1234-1234-1234-1234567890ab", "orderGroupStatusId": "12345678-1234-1234-1234-1234567890cd", "orderGroupPaymentStatusId": "12345678-1234-1234-1234-1234567890ef", "orderGroupShipmentStatusId": "12345678-1234-1234-1234-1234567890gh", "orderGroupAt": "2026-03-27T09:32:33+09:00", "salesOn": null, "purchaseTypeCode": 1, "weight": 452, "size": "835.00", "deliveryCost": "0", "unitPriceNoTax": "100.00", "subscriptionInitialFeeNoTax": "0.00", "subscriptionRecurringPriceNoTax": "0.00", "deliveryFeeNoTax": "0", "chargeNoTax": "628", "subtotalNoTax": "728.00", "tax": "72", "total": "800.00", "billingAmount": "800.00", "taxRuleId": "12345678-1234-1234-1234-1234567890ij", "settlementStatus": 0, "updatedAt": "2026-03-27T09:36:28+09:00", "orders": [ { "id": "12345678-1234-1234-1234-1234567890kl", "orderGroupId": "12345678-1234-1234-1234-1234567890ab", "orderNumber": "20260327-093233", "orderStatusId": "12345678-1234-1234-1234-1234567890mn", "orderNumberBranch": 0, "subscriptionContractId": null, "orderAt": "2026-03-27T09:32:33+09:00", "note": null, "subscriptionInitialFeeNoTax": "0.00", "subscriptionInitialFeeTaxRate": 10, "subscriptionRecurringPriceNoTax": "0.00", "subscriptionRecurringPriceTaxRate": 10, "addPoint": 0, "usePoint": 0, "subtotalNoTax": "100.00", "tax": "10.00", "total": "110.00", "billingAmount": "110", "customerId": "12345678-1234-1234-1234-1234567890op", "linkedUserId": "12345678-1234-1234-1234-1234567890qr", "companyName": "株式会社スマレジ", "department": "hic", "lastName": "すまれじ", "firstName": "太郎", "lastNameFurigana": "スマレジ", "firstNameFurigana": "タロウ", "countryCode": 392, "zipCode": "5555555", "prefectureCode": 13, "address01": "大阪市中央区", "address02": "大繁盛物産ビル 65F", "address03": null, "telephoneNumber": "00011112222", "faxNumber": "00033334444", "email": "sample@example.com", "deviceCode": 99, "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36", "remoteIpAddress": "251.5.21.104", "referrerUrl": null, "referrerParameters": null, "orderDetails": [ { "id": "12345678-1234-1234-1234-1234567890st", "orderId": "12345678-1234-1234-1234-1234567890kl", "orderDetailNumber": "1-001", "productId": "12345678-1234-1234-1234-1234567890uv", "productGroupName": "test", "name": "test", "sellingPriceNoTax": "100.00", "tradeRate": null, "unitPriceNoTax": "100.00", "taxRate": 10, "quantity": 1, "subtotalNoTax": "100.00", "backOrderCode": 1, "weight": 452, "size": "835.00" } ] } ], "orderPayments": [ { "id": "12345678-1234-1234-1234-1234567890wx", "orderGroupId": "12345678-1234-1234-1234-1234567890ab", "paymentId": "12345678-1234-1234-1234-1234567890yz", "paymentStatusId": "12345678-1234-1234-1234-1234567890a1", "chargeNoTax": "628", "chargeTaxRate": 10, "billingDueOn": null, "billingAmount": "800.00", "orderPaymentDeposits": [] } ], "orderShipments": [ { "id": "12345678-1234-1234-1234-1234567890b2", "orderGroupId": "12345678-1234-1234-1234-1234567890ab", "shipmentStatusId": "12345678-1234-1234-1234-1234567890c3", "deliveryRuleId": "12345678-1234-1234-1234-1234567890d4", "deliveryCompanyId": "12345678-1234-1234-1234-1234567890e5", "deliveryMethodId": "12345678-1234-1234-1234-1234567890f6", "deliveryTemperatureId": null, "isGeneralDelivery": false, "desiredDeliveryOn": null, "estimatedShippingOn": null, "shippingOn": "2026-03-27", "estimatedDeliveryOn": "2026-03-31", "deliveryAt": null, "invoiceArticle": null, "attention": null, "note": null, "weight": 452, "size": "835.00", "deliveryCost": "0", "deliveryFeeNoTax": "0", "deliveryFeeTaxRate": 10, "deliveryPiecesNumber": null, "recipientId": "12345678-1234-1234-1234-1234567890g7", "recipientCustomerId": null, "recipientCompanyName": "株式会社スマレジ", "recipientDepartment": "quibusdam", "recipientLastName": "すまれじ", "recipientFirstName": "太郎", "recipientLastNameFurigana": "スマレジ", "recipientFirstNameFurigana": "タロウ", "recipientCountryCode": 392, "recipientZipCode": "5555555", "recipientPrefectureCode": 13, "recipientAddress01": "大阪市中央区", "recipientAddress02": "大繁盛物産ビル 65F", "recipientAddress03": null, "recipientTelephoneNumber": "00011112222", "recipientFaxNumber": "00033334444", "recipientEmail": "sample@example.com", "recipientDisplayName": "omnis", "orderShipmentDetails": [ { "id": "12345678-1234-1234-1234-1234567890h8", "orderShipmentId": "12345678-1234-1234-1234-1234567890b2", "orderDetailId": "12345678-1234-1234-1234-1234567890st", "orderDetailNumber": "1-001", "unitPriceNoTax": "100.00", "quantity": 1, "subtotalNoTax": "100.00", "isAllocated": true, "allocatedQuantity": 0 } ], "orderShipmentTracks": [ { "id": "12345678-1234-1234-1234-1234567890i9", "orderShipmentId": "12345678-1234-1234-1234-1234567890b2", "trackingNumber": "track123456789" } ] } ], "orderGroupAmounts": [ { "id": "12345678-1234-1234-1234-1234567890j0", "orderGroupId": "12345678-1234-1234-1234-1234567890ab", "taxRate": 10, "subtotalNoTax": "728.00", "subtotalTax": "72", "unitPriceNoTax": "100.00", "unitPriceTax": "10", "subscriptionInitialFeeNoTax": "0.00", "subscriptionInitialFeeTax": "0", "subscriptionRecurringPriceNoTax": "0.00", "subscriptionRecurringPriceTax": "0", "deliveryFeeNoTax": "0.00", "deliveryFeeTax": "0", "chargeNoTax": "628.00", "chargeTax": "62", "salesNoTax": "728.00", "salesTax": "72", "discountNoTax": "0.00", "discountTax": "0", "pointDiscountNoTax": "0.00", "pointDiscountTax": "0", "couponDiscountNoTax": "0.00", "couponDiscountTax": "0", "otherDiscountNoTax": "0.00", "otherDiscountTax": "0" }, { "id": "12345678-1234-1234-1234-1234567890k1", "orderGroupId": "12345678-1234-1234-1234-1234567890ab", "taxRate": 0, "subtotalNoTax": "0.00", "subtotalTax": "0", "unitPriceNoTax": "0.00", "unitPriceTax": "0", "subscriptionInitialFeeNoTax": "0.00", "subscriptionInitialFeeTax": "0", "subscriptionRecurringPriceNoTax": "0.00", "subscriptionRecurringPriceTax": "0", "deliveryFeeNoTax": "0.00", "deliveryFeeTax": "0", "chargeNoTax": "0.00", "chargeTax": "0", "salesNoTax": "0.00", "salesTax": "0", "discountNoTax": "0.00", "discountTax": "0", "pointDiscountNoTax": "0.00", "pointDiscountTax": "0", "couponDiscountNoTax": "0.00", "couponDiscountTax": "0", "otherDiscountNoTax": "0.00", "otherDiscountTax": "0" } ], "orderGroupTags": [ { "id": "12345678-1234-1234-1234-1234567890l2", "name": "重要" }, { "id": "12345678-1234-1234-1234-1234567890m3", "name": "要確認" } ]}- 入力チェックエラーの場合
object
Example
{ "type": "about:blank", "title": "Bad Request", "detail": "request_json:[orders][0][customerId]は必須です。", "status": 400}