본문으로 건너뛰기
버전: v0.311

19.9. bmrmember-order/bulk-order-number POST

여러 주문의 송장번호[orderNumber]를 주문번호[bulkNumber] 기준으로 한 번에 수정
  • 한 번에 최대 1,000건까지 요청할 수 있습니다.
  • 건별로 처리합니다. 일부 건이 실패해도 나머지 건은 수정되며, 실패 건은 results.failed 에 사유와 함께 회신됩니다. 응답의 status 가 SUCCESS 여도 failed_count 를 확인해 주세요.
  • 수정 가능한 주문 상태와 송장번호 형식은 19.7. 송장번호 수정과 같습니다.

POST[DOMAIN]/api/bmrmember-order/bulk-order-number/

  • Headers: Api-Key: {APIKEY}, Content-Type: application/json

요청 parameter (Body, JSON)​

파라미터 명필수여부데이터 타입값제한 사항
items필수Array수정할 주문 목록1건 이상 1,000건 이하
items[].bulkNumber필수String주문번호요청 내 중복 불가
items[].orderNumber필수String새로운 송장번호min length=1, max length=50. 앞뒤 공백은 제거 후 저장

호출 결과 코드​

요청 전체에 대한 결과입니다.

statuserr_code설명
SUCCESS요청 처리 완료. 건별 결과는 results 참조
FAILNO_ITEMSitems 가 전달되지 않았거나 빈 목록
FAILTOO_MANY_ITEMSitems 가 1,000건 초과

results​

필드 명데이터 타입설명
total_countInteger요청 건수
updated_countInteger수정 성공 건수
failed_countInteger수정 실패 건수
updated[].bulkNumberString주문번호
updated[].orderNumberString수정된 송장번호
failed[].bulkNumberString요청한 주문번호
failed[].orderNumberString요청한 송장번호 (앞뒤 공백 제거)
failed[].err_codeString실패 사유 코드
failed[].messageString실패 사유 설명

실패 사유 (failed[].err_code)​

err_code설명
NO_BULK_NUMBER주문번호[bulkNumber]가 전달되지 않았거나 빈 값
DUPLICATED_BULK_NUMBER같은 주문번호가 요청에 2번 이상 포함됨. 해당 주문번호의 모든 항목이 실패 처리됨
NOT_FOUND해당 주문번호가 존재하지 않음
NO_ORDER_NUMBER송장번호[orderNumber]가 전달되지 않았거나 빈 값
INVALID_ORDER_NUMBER송장번호[orderNumber]가 50자 초과
UNABLE_STATUSES주문[Order]의 상태[statuses]가 송장번호 변경 불가 (검품센터 도착[returned] 이후, 미회수[failed], 주문 취소[cancelled])
UPDATE_FAILED저장 중 오류 발생. 다시 요청해 주세요

호출 예시​

{
"items": [
{"bulkNumber": "20230720000048", "orderNumber": "123456789012"},
{"bulkNumber": "20230720000049", "orderNumber": "123456789013"}
]
}

호출 결과 예시​

{
"status": "SUCCESS",
"results": {
"total_count": 2,
"updated_count": 1,
"failed_count": 1,
"updated": [
{"bulkNumber": "20230720000048", "orderNumber": "123456789012"}
],
"failed": [
{
"bulkNumber": "20230720000049",
"orderNumber": "123456789013",
"err_code": "UNABLE_STATUSES",
"message": "송장번호를 수정할 수 없는 주문 상태입니다. (검품센터 도착)"
}
]
},
"message": "송장번호 일괄 수정이 완료되었습니다."
}
{
"status": "FAIL",
"err_code": "TOO_MANY_ITEMS",
"errors": {
"message": "한 번에 최대 1000건까지 수정할 수 있습니다."
}
}