상품 API 카테고리 API 브랜드 API 배송 / 주문 API 반품 API 교환 API 프로모션 / 쿠폰 물류 정보 고객 문의 정산 CGF / CGF lite Rocket Growth

배송 / 주문 API

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

송장업데이트 처리

KRTW

# 01

요약

송장업데이트 처리

# 02

상세

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

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

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

경로

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

예시 엔드포인트

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

URL API Name

UPDATE_ORDER_INVOICE

# 03

Path 파라미터

Name	Type	Description
vendorId*	string	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345

# 04

요청 본문

요청 파라미터

본문 파라미터

Name	Type	Description
vendorId*	string	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345
orderSheetInvoiceApplyDtos*	object[]	배송지시 상태로 변경할 대상 정보 목록
shipmentBoxId* orderSheetInvoiceApplyDtos[].shipmentBoxId	integer	묶음배송번호
orderId* orderSheetInvoiceApplyDtos[].orderId	integer	주문번호
deliveryCompanyCode* orderSheetInvoiceApplyDtos[].deliveryCompanyCode	string	변경할 택배사 코드 택배사 코드 바로가기
invoiceNumber* orderSheetInvoiceApplyDtos[].invoiceNumber	integer	변경할 송장번호
vendorItemId* orderSheetInvoiceApplyDtos[].vendorItemId	integer	옵션 ID 송장을 업데이트할 상품의 옵션 ID를 입력.
splitShipping* orderSheetInvoiceApplyDtos[].splitShipping	string	분리배송 여부 ● false(전체배송) 1개의 주문번호에 포함된 전체 상품을 1개의 송장번호로 배송하는 경우 ● true(분리배송) 1개의 주문번호에 포함 된 상품을 분리하여 여러 송장번호로 배송하는 경우
preSplitShipped* orderSheetInvoiceApplyDtos[].preSplitShipped	string	분리 배송중인지 여부 ● false 분리배송을 하지 않는 경우 (=splitshipping이 false인 경우) 해당 주문번호에 대해 처음으로 분리배송처리 할 경우 ● true 해당 주문번호에 이미 분리배송을 진행한 상품이 있을 경우
estimatedShippingDate* orderSheetInvoiceApplyDtos[].estimatedShippingDate	string	(분리배송)출고예정일 YYYY-MM-DD 포멧으로 분리배송 시에만 선택적으로 입력. 입력 하지 않는 경우 "" 공백을 입력한다. 분리배송 시, 송장번호 또는 출고예정일 둘 중 한가지만 입력.

요청 예시application/json

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

# 05

응답 본문

응답 메시지

Name

Type

Description

code

integer

서버 응답 코드

message

string

서버 응답 메세지

data

object

responseCode

data.responseCode

integer

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

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

responseMessage

data.responseMessage

string

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

responseList

data.responseList

object[]

개별 건에 대한 결과셋

shipmentBoxId

data.responseList[].shipmentBoxId

integer

묶음배송번호

succeed

data.responseList[].succeed

boolean

성공여부

resultCode

data.responseList[].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	상품이 한가지인 경우 분리배송 할 수 없습니다.

retryRequired

data.responseList[].retryRequired

boolean

retry 가능 여부

resultMessage

data.responseList[].resultMessage

string

결과메세지

Response Example

{
  "code": 200,
  "message": "OK",
  "data": {
    "responseCode": 0,
    "responseMessage": "SUCCESS",
    "responseList": [
      {
        "shipmentBoxId": 123456789012345680,
        "succeed": true,
        "resultCode": "OK",
        "retryRequired": false,
        "resultMessage": null
      }
    ]
  }
}

# 06

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

HTTP	유형	오류 메시지	해결 방법
400	400 (요청변수확인)	CJ 대한통운의 송장번호 형식에 맞지않는 운송장 번호 입니다. [6255*****632]	올바른 송장번호를 입력했는지 확인합니다.
400	400 (요청변수확인)	CJ 대한통운의 운송장번호는 숫자로만 구성되어야 합니다. InvoiceNumber must be number. [6257-62-10*]	올바른 송장번호를 입력했는지 확인합니다. 송장번호에 숫자 이외의 문자가 포함되었는지 확인합니다.
400	400 (요청변수확인)	업체직송의 운송장번호는 숫자로만 구성되어야 합니다. InvoiceNumber must be number. [***]	업체직송(DIRECT)의 송장번호를 숫자로 입력합니다. 예) 202002031830
400	400 (요청변수확인)	invalid delivery company code:	올바른 택배사 코드(deliveryCompanyCode)를 입력했는지 확인합니다.
400	400 (요청변수확인)	OO택배의 송장번호 형식에 맞지않는 운송장 번호 입니다. [956****734]	올바른 송장번호를 입력했는지 확인합니다.