受注登録request

自社ECの注文を登録するには、先に販売チャネルへ自社ECを登録してください。自社EC販売チャネル登録ガイド →

認証

連携管理で発行したOPEN API keyを発行直後にコピーしてserver secretに保存し、Bearer headerで送信します。チャネル詳細からコピーしたチャネルIDをsource_channel_idに入れます。

Authorization: Bearer <open-api-key>
Content-Type: application/json

Payload

{
  "source_type": "own_mall",
  "source_channel_id": "42",
  "external_order_id": "ORDER-2026-00042",
  "order_name": "Own mall ORDER-2026-00042",
  "ordered_at": "2026-08-18T00:00:00Z",
  "expected_delivery_at": "2026-08-22T00:00:00Z",
  "vendor_code": "ONLINE-CUSTOMER",
  "currency": "KRW",
  "shipping_address": "110 Sejong-daero, Seoul",
  "items": [
    {
      "item_code": "FINISHED-001",
      "quantity": 2,
      "unit_price": 12000
    }
  ]
}

フィールド	必須	説明
`source_type`	必須	注文の出典です。自社ECはown_mallを使用します。
`source_channel_id`	必須	チャネル詳細からコピーした自社ECチャネルIDです。
`external_order_id`	必須	自社ECの注文番号です。
`order_name`	任意	ORCAに表示する受注名です。
`ordered_at`	必須	注文日時です。ISO形式（例: 2026-08-18T00:00:00Z）を使用します。
`expected_delivery_at`	必須	納期日です。ISO形式を使用します。
`vendor_code`	必須	ORCAに登録済みの取引先コードです。未登録だと失敗します。
`currency`	必須	通貨コードです。例: KRW
`shipping_address`	任意	配送先です。
`items`	必須	受注品目の一覧です。1件以上必要です。
`items[].item_code`	必須	ORCAに登録済みの品目コードです。未登録だと失敗します。
`items[].quantity`	必須	注文数量です。1以上の整数です。
`items[].unit_price`	必須	品目単価です。0以上です。

受注API呼び出し

const axios = require("axios");

const response = await axios.post(
  "https://open-api.orca.partners/v1/sales-orders",
  payload,
  {
    headers: {
      Authorization: "Bearer <open-api-key>",
      "Content-Type": "application/json",
    },
  }
);