배송 수정

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

Endpoint


PUT /vendor-api/shipment

요청 파라미터

필드	타입	필수	설명
`updates`	array	O	수정 항목 배열 (최대 100건)
`updates[].ord_prd_no`	string	O	주문품목번호
`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: bm_xOpGAqgHbJQBXxBBbUIZ_bAGZk4wK2FdLgF50277PU8" \
  -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": 150000,
      "new_supply_price": 140000,
      "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[].message`	string	처리 결과 메시지

참고사항

배송 등록이 완료된 품목에 대해서만 수정이 가능합니다.
공급가 변경 이력은 시스템에서 자동으로 추적됩니다 (최대 10건).
carrier_code, tracking_number, supply_price 중 변경하고자 하는 필드만 포함하면 됩니다. 포함하지 않은 필드는 기존 값이 유지됩니다.