수주 등록 요청

자사몰 주문을 등록하려면 먼저 판매채널에 자사몰을 등록해야 합니다. 자사몰 판매채널 등록 가이드 →

인증

연동관리에서 발급한 OPEN API key를 생성 직후 복사해 서버 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`	필수	주문 출처입니다. 자사몰은 own_mall을 사용합니다.
`source_channel_id`	필수	판매채널 상세에서 복사한 자사몰 채널 ID입니다.
`external_order_id`	필수	자사몰 주문번호입니다.
`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",
    },
  }
);