Coupang Developer Center

API 적용 가능한 구매자 사용자 지역: 한국

잘못 등록한 운송장 내용을 변경합니다.
변경된 운송장의 배송상태는 배송지시(DEPARTURE)로 변경되며 이후 트래킹 정보 연동에 따라 변경될 수 있습니다.

<주의!> 배송상태가 배송지시(DEPARTURE), 배송중(DELIVERING), 배송완료(FINAL_DELIVERY), 업체직송(NONE_TRACKING) 상태일 때만 운송장정보 변경이 가능합니다. (나머지 상태에서는 에러 발생).

Path

POST

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/updateInvoices

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/orders/updateInvoices

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	묶음배송번호
	orderId	O	Number	주문번호
	deliveryCompanyCode	O	String	변경할 택배사 코드 택배사 코드 바로가기
	invoiceNumber	O	String	변경할 송장번호
	vendorItemId	O	Number	옵션 ID 송장을 업데이트할 상품의 옵션 ID를 입력.
	splitShipping	O	Boolean	분리배송 여부 ● false(전체배송) 1개의 주문번호에 포함된 전체 상품을 1개의 송장번호로 배송하는 경우 ● true(분리배송) 1개의 주문번호에 포함 된 상품을 분리하여 여러 송장번호로 배송하는 경우
	preSplitShipped	O	Boolean	분리 배송중인지 여부 ● false 분리배송을 하지 않는 경우 (=splitshipping이 false인 경우) 해당 주문번호에 대해 처음으로 분리배송처리 할 경우 ● true 해당 주문번호에 이미 분리배송을 진행한 상품이 있을 경우
	estimatedShippingDate	O	String	(분리배송)출고예정일 YYYY-MM-DD 포멧으로 분리배송 시에만 선택적으로 입력. 입력 하지 않는 경우 "" 공백을 입력한다. 분리배송 시, 송장번호 또는 출고예정일 둘 중 한가지만 입력.

Request Example

{
  "vendorId": "A00012345",
  "orderSheetInvoiceApplyDtos": [
    {
      "shipmentBoxId": 123456789012345678,
      "orderId": 2000019631453,
      "vendorItemId": 3819657333,
      "deliveryCompanyCode": "KDEXP",
      "invoiceNumber": 201808231414,
      "splitShipping": "False",
      "preSplitShipped": "False",
      "estimatedShippingDate": ""
    }
  ]
}

Response Message

Name

Type

Description

code

Number

서버 응답 코드

message

String

서버 응답 메세지

data

Array

responseCode

Number

request 전체결과값에 대한 상태메세지

code	message	remark
-1	NONE	결과없음
0	SUCCESS	성공
1	PARTIAL_ERROR	부분실패
99	FAILED	실패

responseMessage

String

request 전체결과값에 대한 상태메세지

responseList

Array

개별 건에 대한 결과셋

shipmentBoxId

Number

묶음배송번호

succeed

Boolean

성공여부

resultCode

String

결과코드

code	retry required	remark
OK	false	성공
NOT_FOUND_SHIPMENT_BOX	false	존재하지 않는 송장번호입니다.
INVALID_STATUS	false	배송진행상태가 유효하지 않습니다.
PERMISSION_DENIED	true	권한이 없습니다.
DUPLICATE_INVOICE_NUMBER	true	이미 저장된 송장번호가 있습니다.
INVALID_INVOICE_NUMBER	true	송장번호가 유효하지 않습니다.
ORDER_DELIVERY_CANCELED	false	취소된 주문건입니다. or 출고 준비중 상태인경우-> 출고중지 요청건입니다.
ORDER_DELIVERY_PARTIAL_STOP_REQUESTED	true	출고중지 요청건입니다.
ORDER_DELIVERY_CANCELED_HOLDING_FOR_CANCEL	true	취소대기상태의 주문건입니다.
UNDEFINED_ERROR_OCCUR	true	알수없는 오류
NOT_ALLOW_INVOICE_NUMBER_RE_UPLOAD	false	이미 저장된 송장번호가 있어, 송장번호 등록이 불가능합니다. (동일송장번호 업로드 조건 : 주문자/수취인정보 동일)
NOT_FOUND_INVOICE_NUMBER	false	이미 출고 예정일이 등록된 상품이어서 운송장 번호를 입력하셔야 합니다.
NOT_FOUND_VENDOR_ITEM	false	합포장건 중 누락된 상품이 있습니다.
NOT_ALLOW_VENDOR_DIRECT	false	업체직송은 분리배송 할 수 없습니다.
PSD_NOT_ALLOW_TO_CHANGE	false	출고예정일은 최초 등록 이후 변경 할 수 없습니다.
NOT_ALLOW_SEPARATE_AFTER_NORMAL_DELIVERY	false	일반배송 접수 후 분리배송을 다시 할 수 없습니다.
IS_SEPARATE_MUST_BE_TRUE_WHEN_SEPARATE_DELIVERY	false	분리배송 접수 후 일반배송으로 처리 할 수 없습니다. 분리배송 여부를 Y로 수정하시기 바랍니다.
NOT_ALLOW_SEPARATE_WHEN_ONE_VENDOR_ITEM	false	상품이 한가지인 경우 분리배송 할 수 없습니다.

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-62-10*]	올바른 송장번호를 입력했는지 확인합니다. 송장번호에 숫자 이외의 문자가 포함되었는지 확인합니다.
400 (요청변수확인)	업체직송의 운송장번호는 숫자로만 구성되어야 합니다. InvoiceNumber must be number. [***]	업체직송(DIRECT)의 송장번호를 숫자로 입력합니다. 예) 202002031830
400 (요청변수확인)	invalid delivery company code:	올바른 택배사 코드(deliveryCompanyCode)를 입력했는지 확인합니다.
400 (요청변수확인)	OO택배의 송장번호 형식에 맞지않는 운송장 번호 입니다. [956****734]	올바른 송장번호를 입력했는지 확인합니다.

URL API Name

UPDATE_ORDER_INVOICE

송장업데이트 처리

요약

상세

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name