배송 수정

등록된 배송 정보를 수정합니다. 택배사, 송장번호, 공급가를 변경할 수 있습니다.

Endpoint


PUT /vendor-api/shipment

요청 파라미터

필드	타입	필수	설명
`updates`	array	O	수정 항목 배열 (최대 100건)
`updates[].ord_prd_no`	string	O	주문품목번호 (세트 구성품은 `{주문품목번호}^s{n}`)
`updates[].carrier_code`	string	-	변경할 택배사 코드
`updates[].tracking_number`	string	-	변경할 송장번호
`updates[].memo`	string	-	메모
`updates[].supply_price`	object	-	공급가 정보 (공통 스키마 참조)

택배사 코드 목록은 배송 등록을 참조하세요.

요청 예시


curl -X PUT "https://brightmall-backend.certi.life/vendor-api/shipment" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: <발급받은 API 키>" \
  -H "X-Vendor-Id: 01KC51ST1WSTAET481SHPH3PSY" \
  -d '{
    "updates": [
      {
        "ord_prd_no": "202601220157_000020196_[1]",
        "tracking_number": "9876543210",
        "supply_price": {
          "unit_price": 70000,
          "quantity": 2,
          "total_amount": 140000
        }
      }
    ]
  }'

응답 예시


{
  "request_id": "req_mkp3upd_abc123",
  "timestamp": "2026-01-27T08:00:00.000Z",
  "success_count": 1,
  "failure_count": 0,
  "results": [
    {
      "ord_prd_no": "202601220157_000020196_[1]",
      "success": true,
      "previous_tracking_number": "1234567890",
      "new_tracking_number": "9876543210",
      "previous_supply_price": 75000,
      "new_supply_price": 70000,
      "message": "Shipment updated"
    }
  ]
}

응답 필드 설명

필드	타입	설명
`success_count`	number	처리 성공 건수
`failure_count`	number	처리 실패 건수
`results[].ord_prd_no`	string	주문품목번호
`results[].success`	boolean	처리 성공 여부
`results[].previous_tracking_number`	string	변경 전 송장번호
`results[].new_tracking_number`	string	변경 후 송장번호
`results[].previous_supply_price`	number	변경 전 공급 단가
`results[].new_supply_price`	number	변경 후 공급 단가 (세트 구성품 번호로 보낸 공급가는 반영하지 않으므로 없음)
`results[].base_ord_prd_no`	string	(v1.9.0) 세트 구성품 번호로 보낸 경우 몰 주문품목번호
`results[].quantity_mismatch`	object	(v1.9.0) `supply_price.quantity` 가 몰 주문 수량과 다를 때 `{ expected, received }` — 거절 아님
`results[].message`	string	처리 결과 메시지

참고사항

배송 등록이 완료된 품목에 대해서만 수정이 가능합니다.
공급가 변경 이력은 시스템에서 자동으로 추적됩니다 (최대 10건).
carrier_code, tracking_number, supply_price 중 변경하고자 하는 필드만 포함하면 됩니다. 포함하지 않은 필드는 기존 값이 유지됩니다.
(v1.9.0) 세트 구성품 번호로 보내면 같은 품목의 구성품이 보낸 carrier_code·tracking_number 가 같아야 합니다(다르면 SUB_ITEM_CONFLICT). 구성품 supply_price 는 검토용 기록만 하고 품목 공급가·정산은 바꾸지 않습니다.