발송처리

주문에 딸린 발주(배송) 단위​​로 상태와 운송장을 갱신해요. 관리자 주문 상세의 [발송처리]와 같은 처리를 서버에서 하는 API예요.

발송 완료로 넘기면서 운송장을 같이 넣으면 배송 추적이 자동으로 붙어요. 그 뒤로는 택배사가 알려주는 단계가 자동으로 쌓여요 — 배송추적 조회로 읽으면 되고, 배송 완료를 받으면 발주 상태도 배송 완료로 스스로 넘어가요.

Basic 인증과 user:order_purchase_update scope가 필요해요. 입력과 오류 전체는 주문 API 원문를 확인해요.

API 엔드포인트

요청 파라미터

여러 발주는 순서대로 처리돼요. 중간 항목에서 오류가 나면 앞 항목의 변경은 남을 수 있어요. 오류 뒤에는 배송추적 조회로 현재 상태를 다시 확인해요.

코드 예제

curl -X PUT "https://api.bootapi.com/v1/orders/25071182085082524116/purchases" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{
    "purchases": [
      {
        "order_purchase_number": "P25071182085082524116",
        "status": 4,
        "delivery_company_code": "CJGLS",
        "tracking_number": "620148310301"
      }
    ]
  }'bash

const { BootpayCommerce } = require('@bootpay/backend-js')

const commerce = new BootpayCommerce({
    client_key: 'your-commerce-client-key',
    secret_key: 'your-commerce-secret-key',
    mode: 'production'
})

const response = await commerce.put('orders/25071182085082524116/purchases', { purchases: [
    {
        order_purchase_number: 'P25071182085082524116',
        status: 4,
        delivery_company_code: 'CJGLS',
        tracking_number: '620148310301'
    }
] })
console.log(response)javascript

응답

성공 응답

갱신이 끝난 뒤의 발주 목록이 그대로 돌아와요. 필드 설명은 주문 상세와 같아요.

[
  {
    "order_purchase_id": "6870824fb0eacea5cd974f12",
    "order_purchase_number": "P25071182085082524116",
    "status": 4,
    "delivery_company_code": "CJGLS",
    "tracking_number": "620148310301",
    "d_ts": 1,
    "sent_at": "2025-07-12T09:10:00Z",
    "tracking_histories": []
  }
]json

에러 코드