Yêu cầu đơn bán hàng

Cần đăng ký cửa hàng riêng làm kênh bán hàng trước khi gửi đơn. Hướng dẫn đăng ký kênh cửa hàng riêng →

Xác thực

Sao chép OPEN API key ngay sau khi cấp trong Quản lý tích hợp, lưu vào secret phía server và gửi bằng Bearer header. Đặt ID kênh đã sao chép từ chi tiết kênh vào 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
    }
  ]
}

Trường	Bắt buộc	Mô tả
`source_type`	Bắt buộc	Nguồn đơn hàng. Cửa hàng riêng dùng own_mall.
`source_channel_id`	Bắt buộc	ID kênh cửa hàng riêng đã sao chép từ chi tiết kênh.
`external_order_id`	Bắt buộc	Mã đơn hàng của cửa hàng.
`order_name`	Tùy chọn	Tên đơn bán hàng hiển thị trong ORCA.
`ordered_at`	Bắt buộc	Thời điểm đặt hàng theo ISO, ví dụ 2026-08-18T00:00:00Z.
`expected_delivery_at`	Bắt buộc	Ngày giao hàng theo ISO.
`vendor_code`	Bắt buộc	Mã đối tác đã đăng ký trong ORCA. Thiếu sẽ thất bại.
`currency`	Bắt buộc	Mã tiền tệ, ví dụ KRW.
`shipping_address`	Tùy chọn	Địa chỉ giao hàng.
`items`	Bắt buộc	Danh sách sản phẩm. Cần ít nhất một sản phẩm.
`items[].item_code`	Bắt buộc	Mã sản phẩm đã đăng ký trong ORCA. Thiếu sẽ thất bại.
`items[].quantity`	Bắt buộc	Số lượng. Số nguyên từ 1 trở lên.
`items[].unit_price`	Bắt buộc	Đơn giá. Từ 0 trở lên.

Gọi API đơn bán hàng

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",
    },
  }
);