커스텀몰 API / 상태 매핑
주문 상태 매핑
품목마다 order_status에 카페24 상태 코드를 넣어 주세요. 주문 전체 상태는 릴로가 품목 상태로 계산해요.
카페24 코드 → 릴로 상태
| 카페24 `order_status` | 의미 | 릴로 `status` |
|---|---|---|
N00 | 입금 전 | pending_payment |
N10 | 상품 준비중(결제 완료) | paid |
N20 N21 N22 | 배송 준비중·대기·보류 | preparing |
N30 | 배송중 | shipping |
N40 | 배송 완료 | delivered |
C00 C10 | 취소 신청·접수 | cancel_requested |
C34 C40 | 취소 완료 | canceled |
R00 R10 | 반품 신청·접수 | return_requested |
R40 | 반품 완료 | returned |
E00 E10 | 교환 신청·접수 | exchange_requested |
E40 | 교환 완료 | exchanged |
| — | 환불 완료 | refunded (표준 값으로만) |
자체 상태가 카페24 코드에 딱 맞지 않을 때만 표준 값 status(확장)를 넣어 주세요. 넣으면 그 값이 우선해요. 화면 이름은 status_label(선택)이고, 없으면 카페24 이름(예: 배송중)을 써요.
배송 상태
| `status` | 의미 |
|---|---|
standby | 배송 대기 |
shipping | 배송중 |
shipped | 배송 완료 |
쓰기 가능 상태 (v1.1)
쓰기 요청은 품목 order_status로 판단해요. 맞지 않으면 409 not_allowed_in_state를 현재 order_status와 함께 돌려주세요.
| 쓰기 | 허용 | 막힘 |
|---|---|---|
취소 cancellation | 대상 품목이 모두 출고 전 (N00·N10·N20·N21·N22) | N30 이후, C*·R*·E* |
반품 return | N40 (배송 완료) | 출고 전 (→ 취소), N30 |
교환 exchange | N30·N40 (몰 정책상 N40만이면 N30은 409) | 출고 전, C*·R* |
배송지 receivers | 출고 전 N00~N22 | N30 이후 |
메모 memos | 모든 상태 | — |
| 쿠폰 발급 | 주문 상태와 무관 (회원·쿠폰 기간만 확인) | — |
- 같은 품목에 이미
C00·C10·R00·R10·E00·E10이 있으면 409already_requested를 돌려주세요. - 릴로도 호출 전에 같은 규칙으로 한 번 거르지만, 최종 판단은 쇼핑몰이 해요.