접수 경로 (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)
| serviceCode | serviceName | 접수 구분 | 설명 |
|---|---|---|---|
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"
}
]