6개월 이내에 중복된 송장번호를 입력할 경우 송장중복에러가 발생할 수 있습니다.
올바르지 않은 운송장을 입력하여 정확한 배송흐름을 추적할 수 없거나 기한 내 운송장을 입력하지 않아 고객이 취소를 요청할 경우 이로 인해 발생하는 배송비는 판매자가 부담해야 합니다.
Path
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/invoices
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/orders/invoices
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드.
예) A00012345
|
||||
| orderSheetInvoiceApplyDtos | O | Object |
배송지시 상태로 변경할 대상 정보 목록
|
||||
| shipmentBoxId | O | Number |
배송번호(=묶음배송번호)
분리배송 시, 이미 발송한 상품의 shipmentBoxId는 변경됩니다. (orderId로 발주서 단건 조회API를 통해 확인 가능)
|
||||
| orderId | O | Number |
주문번호
|
||||
| deliveryCompanyCode | O | String |
택배사 코드
|
||||
| invoiceNumber | O | String |
송장번호
분리배송 시 선택. 입력 하지 않는 경우 "" 공백으로 입력한다.
분리배송 시에는 송장번호 또는 출고예정일 둘중에 한가지만 입력한다.
업체직송(DIRECT)일 경우 임의의 숫자만 입력가능하며 배송트래킹은 지원하지 않습니다. |
||||
| vendorItemId | O | Number |
옵션Id
송장을 업로드 할 상품의 옵션 ID를 입력.
분리배송 시 해당 shipmentBoxId의 vendorItemId단위로 접수해야한다. |
||||
| splitShipping | O | Boolean |
분리배송 여부
● false(전체배송)
1개의 주문번호에 포함된 전체 상품을 1개의 송장번호로 배송하는 경우 ● true(분리배송) 1개의 주문번호에 포함 된 상품을 분리하여 여러 송장번호로 배송하는 경우 |
||||
| preSplitShipped | O | Boolean |
분리 배송중인지 여부
● false
분리배송을 하지 않는 경우 (=splitshipping이 false인 경우) 해당 주문번호에 대해 처음으로 분리배송처리 할 경우 ● true 해당 주문번호에 이미 분리배송을 진행한 상품이 있을 경우 |
||||
| estimatedShippingDate | O | String |
(분리배송)출고예정일
YYYY-MM-DD 포멧으로 분리배송 시에만 선택적으로 입력.
입력 하지 않는 경우 "" 공백을 입력한다. 분리배송 시, 송장번호 또는 출고예정일 둘 중 한가지만 입력.
|
||||
Request Example
{
"vendorId": "A00034612",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 123456789012345678,
"orderId": 4000019469460,
"vendorItemId": 3823839899,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "20180731040123",
"splitShipping": false,
"preSplitShipped": false,
"estimatedShippingDate": ""
},
{
"shipmentBoxId": 123456789012345679,
"orderId": 4000019469460,
"vendorItemId": 3834780191,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "20180731040123",
"splitShipping": false,
"preSplitShipped": false,
"estimatedShippingDate": ""
}
]
}Response Message
| Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
서버 응답 코드
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| message | String |
서버 응답 메세지
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data | Array |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| responseCode | Number |
request 전체결과값에 대한 상태메세지
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| responseMessage | String |
request 전체결과값에 대한 상태메세지
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| responseList | Array |
개별 건에 대한 결과셋
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| shipmentBoxId | Number |
배송번호
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| succeed | Boolean |
성공여부
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| resultCode | String |
결과코드
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| resultMessage | String |
결과메세지
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| retryRequired | Boolean |
retry 가능 여부
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response Example
{
"code": "200",
"message": "OK",
"data": {
"responseCode": 0,
"responseMessage": "SUCCESS",
"responseList": [
{
"shipmentBoxId": 123456789012345678,
"succeed": true,
"resultCode": "OK",
"retryRequired": false,
"resultMessage": null
}
]
}
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | CJ 대한통운의 송장번호 형식에 맞지않는 운송장 번호 입니다. [6255*****632] | 올바른 송장번호를 입력했는지 확인합니다. |
| 400 (요청변수확인) | CJ 대한통운의 운송장번호는 숫자로만 구성되어야 합니다. InvoiceNumber must be number. [6257-6**2-10***] | 올바른 송장번호를 입력했는지 확인합니다. 송장번호에 숫자 이외의 문자가 포함되었는지 확인합니다. |
| 400 (요청변수확인) | 업체직송의 운송장번호는 숫자로만 구성되어야 합니다. InvoiceNumber must be number. [***] | 업체직송(DIRECT)의 송장번호를 숫자로 입력합니다. 예) 202002031830 |
| 400 (요청변수확인) | invalid delivery company code: | 올바른 택배사 코드(deliveryCompanyCode)를 입력했는지 확인합니다. |
| 400 (요청변수확인) | OO택배의 송장번호 형식에 맞지않는 운송장 번호 입니다. [956****734] | 올바른 송장번호를 입력했는지 확인합니다. |
URL API Name
UPDATE_ORDER_SHIPPING_INFO