송장을 업로드하여 주문을 배송지시 상태로 변경합니다.
상품준비중 상태의 주문에 대해서만 송장업로드가 가능합니다.
분리배송이 필요한 경우, 송장 업로드 예시는 FAQ를 참고해주세요.
상품준비중 상태의 주문에 대해서만 송장업로드가 가능합니다.
분리배송이 필요한 경우, 송장 업로드 예시는 FAQ를 참고해주세요.
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 | Number |
배송번호(=묶음배송번호)
분리배송 시, 이미 발송한 상품의 shipmentBoxId는 변경됩니다. (orderId로 발주서 단건 조회API를 통해 확인 가능)
|
|||||
| orderId | Number |
주문번호
|
|||||
| deliveryCompanyCode | String |
택배사 코드
|
|||||
| invoiceNumber | String |
송장번호
분리배송 시 선택. 입력 하지 않는 경우 "" 공백으로 입력한다.
분리배송 시에는 송장번호 또는 출고예정일 둘중에 한가지만 입력한다.
업체직송(DIRECT)일 경우 임의의 숫자만 입력가능하며 배송트래킹은 지원하지 않습니다. |
|||||
| vendorItemId | Number |
옵션Id
송장을 업로드 할 상품의 옵션 ID를 입력.
분리배송 시 해당 shipmentBoxId의 vendorItemId단위로 접수해야한다. |
|||||
| splitShipping | String |
분리배송 여부
● false(전체배송)
1개의 주문번호에 포함된 전체 상품을 1개의 송장번호로 배송하는 경우 ● true(분리배송) 1개의 주문번호에 포함 된 상품을 분리하여 여러 송장번호로 배송하는 경우 |
|||||
| preSplitShipped | String |
분리 배송중인지 여부
● false
분리배송을 하지 않는 경우 (=splitshipping이 false인 경우) 해당 주문번호에 대해 처음으로 분리배송처리 할 경우 ● true 해당 주문번호에 이미 분리배송을 진행한 상품이 있을 경우 |
|||||
| estimatedShippingDate | String |
(분리배송)출고예정일
YYYY-MM-DD 포멧으로 분리배송 시에만 선택적으로 입력.
입력 하지 않는 경우 "" 공백을 입력한다. 분리배송 시, 송장번호 또는 출고예정일 둘 중 한가지만 입력.
|
|||||
Request Example
{
"vendorId": "A00034612",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 606920263,
"orderId": 4000019469460,
"vendorItemId": 3823839899,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "20180731040123",
"splitShipping": false,
"preSplitShipped": false,
"estimatedShippingDate": ""
},
{
"shipmentBoxId": 606920263,
"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": 606920263,
"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