검증 가능한 샘플 데모
Cafe24 Sync Kit
쇼핑몰 주문 동기화에서 무서운 건 한 건의 실패가 아니라 그 실패가 전체를 막는 것입니다. 10건 중 1건이 상태값 오류여도 9건은 그대로 반영되고, 실패한 1건만 로그로 남는 구조를 샘플로 확인합니다.
1. 상태값 매핑과 10건 동기화
카페24의 원시 상태값(20/21/22/50)을 의미 있는 상태로 매핑해 10건을 동기화했습니다. 9건 반영, 1건 실패 — 실패 건은 C24-1005(상태값 99, 미지정) 하나입니다.
- 입력 / 반영
- 10건 / 9건
- 반영 합계
- 247,900원
- 상태 매핑
- 20·21·22·50 → 4상태
| 주문 번호 | 원시 상태 | 매핑 상태 | 금액 |
|---|---|---|---|
C24-1001 | 20 → 결제완료 | 결제완료 | 32,000원 |
C24-1002 | 21 → 배송중 | 배송중 | 18,500원 |
C24-1003 | 22 → 완료 | 완료 | 45,000원 |
C24-1004 | 50 → 취소 | 취소 | 12,000원 |
C24-1006 | 20 → 결제완료 | 결제완료 | 27,000원 |
C24-1007 | 20 → 결제완료 | 결제완료 | 15,400원 |
C24-1008 | 20 → 결제완료 | 결제완료 | 63,000원 |
C24-1009 | 20 → 결제완료 | 결제완료 | 21,000원 |
C24-1010 | 20 → 결제완료 | 결제완료 | 14,000원 |
2. 1건 실패, 9건 보존
상태값 99는 매핑표에 없습니다. 이 건만 실패 로그에 남기고 나머지는 그대로 반영했습니다 — INVALID_STATUS: 알 수 없는 주문 상태값 99 — 매핑표를 확인해야 합니다.
3. 재동기화 시 멱등성
1001·1002가 이미 동기화된 상태에서 1001~1003이 재전송되면, C24-1001·C24-1002는 건너뛰고 C24-1003만 새 반영됩니다. 주문이 두 번 기록되는 일은 없습니다.
sample-output.csv다운로드