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

접수 경로 (integrationService)

주문이 어떤 경로로 접수되었는지를 나타내는 연동 서비스 정보입니다. 주문 응답의 integrationService에 배열로 회신되며, 각 항목이 접수 경로 기록 1건입니다. 직접(수기) 접수와 자동 연동 접수의 구분에 사용합니다. (v0.306, BMR-905)

항목 구조​

파라미터 명필수데이터 타입값비고
id필수Integer접수 경로 기록 ID리터니즈 내부 식별값
service필수Object연동 서비스아래 연동 서비스 (service) 참조
integrationOrderNumber필수String연동 쇼핑몰 주문번호쇼핑몰 연동으로 자동 수집된 주문의 원 주문번호. CAFE24: 카페24 주문번호 order_id (예: 20261004-0000643) / MAKESHOP: 메이크샵 주문번호(ordernum). 그 밖의 접수 경로는 ''
integrationReturnOrderNumber필수String연동 쇼핑몰 반품/교환 번호쇼핑몰 연동으로 자동 수집된 주문의 반품·교환 클레임 식별값. CAFE24: 카페24 클레임 번호 claim_code (예: C20261010-0032089) / MAKESHOP: 메이크샵 품목 번호. 반품/교환 구분은 주문의 externalServiceExchangeReturn 참조. 그 밖의 접수 경로는 ''
orderFromName필수String연동 쇼핑몰 코드CAFE24/MAKESHOP: 연동 쇼핑몰 ID(몰 ID, 예: bysec2022) / 그 밖의 접수 경로: 리터니즈 브랜드 ID(ecommerceId)

연동 서비스 (service)​

파라미터 명필수데이터 타입값비고
id필수Integer연동 서비스 ID
serviceCode필수String연동 서비스 코드아래 접수 경로 코드 참조
serviceName필수String연동 서비스명

접수 경로 코드 (serviceCode)​

serviceCodeserviceName접수 구분설명
RNSSIN리터니즈 단건 접수직접(수기) 접수리터니즈 웹에서 주문을 1건씩 직접 등록
RNSMUL리터니즈 다량 접수직접(수기) 접수리터니즈 웹에서 엑셀 양식으로 여러 주문을 일괄 등록
CAFE24카페24자동 연동 접수카페24 쇼핑몰 연동으로 반품·교환 신청을 자동 수집
MAKESHOP메이크샵자동 연동 접수메이크샵 쇼핑몰 연동으로 반품·교환 신청을 자동 수집
GOODSFLOW굿스플로자동 연동 접수굿스플로 연동 접수
BMRMEMAPI일반API자동 연동 접수고객사 시스템이 19.3. bmrmember-order POST로 접수
SMARTSTORE스마트스토어자동 연동 접수스마트스토어 연동 접수

판별 방법: service.serviceCode가 RNSSIN 또는 RNSMUL이면 직접(수기) 접수, 그 밖의 값이면 자동 연동 접수입니다.

참고 사항​

  • 한 주문에 자동 연동 경로와 직접(수기) 경로가 함께 기록되지 않습니다(자동 연동 경로가 기록된 주문에는 직접 접수 경로를 추가하지 않음).
  • 같은 연동 서비스라도 쇼핑몰 반품·교환 건이 여러 개 연결된 주문은 항목이 2개 이상일 수 있습니다.
  • 재접수 주문은 재접수한 경로 기준으로 기록됩니다 (리터니즈 웹 재접수 = RNSSIN, API 재접수 = BMRMEMAPI).
  • 빈 배열([])로 회신되는 경우
    • 직접(수기) 접수 경로(RNSSIN/RNSMUL) 기록이 시작된 2026-04-29 이전 접수 건 중 연동 이력이 없는 주문 (자동 연동 건은 그 이전에도 기록 있음: 카페24 2025-06~, 굿스플로 2025-07~)
    • 브랜드의 연동 설정이 삭제되어 접수 경로를 확인할 수 없는 주문

예시​

"integrationService": [
{
"id": 156140,
"service": {"id": 1, "serviceCode": "CAFE24", "serviceName": "카페24"},
"integrationOrderNumber": "20261004-0000643",
"integrationReturnOrderNumber": "C20261010-0032089",
"orderFromName": "bysec2022"
}
]
"integrationService": [
{
"id": 123456,
"service": {"id": 5, "serviceCode": "RNSSIN", "serviceName": "리터니즈 단건 접수"},
"integrationOrderNumber": "",
"integrationReturnOrderNumber": "",
"orderFromName": "TST"
}
]