데이터 자동 동기화 (API 연동)
데이터 자동 동기화 (API 연동)
매장별 발급 API 키로 본사 DB 재고 관리 섹션에 직접 적재 · 수동→자동 전환 효과
외부 시스템 연동 패턴
본사 환경에 따라 다음 시스템과 연동 가능합니다 (예시 — 실제 항목은 본사 협의)
| 시스템 | 방향 | 방식 | 빈도 | 본 IOM 역할 | 도입 |
|---|---|---|---|---|---|
본사 ERP 단가·발주 결재·전사 자원 관리 ✓ RFP 지원 자격: ERP 연동 경험 명시 | 양방향 | REST API + 표준 스키마 | 마스터 데이터: 시간당 1회 / 발주 결재: 즉시 | 본 시스템의 단가·결재 백엔드. 매장 입출고와 결합해 본사 결재 완결성 확보. | 필수 |
외부 물류사 CJ·한진 등 발송·배송 트래킹 | 양방향 | REST API + Webhook | 발송 등록: 즉시 / 배송 상태: Webhook 수신 | 매장↔창고 이동(트래킹 화면)의 외부 구간을 데이터로 연결. 운송장 번호로 추적성 확보. | 권장 |
PLM (제품 라이프사이클) BOM · 사양 마스터 · 도면 ✓ RFP 우대: 레거시 코드 분석·마이그레이션 경험 | 수신 | 표준 스키마 또는 CSV 마이그레이션 | 초기 1회 마이그레이션 + 변경 시 동기화 | 본사가 PLM 보유 시 즉시 연동. 미보유 시 IOM 자체 SKU 마스터로 대체 가능. | 선택 |
매장 POS 매장 측 자체 POS·판매 시스템 | 수신 | REST API (본사 발급 API 키 인증) | 발생 시 즉시 | 매장이 POS를 보유한 경우 직접 연동. 미보유 매장은 IOM 웹 화면으로 직접 등록 가능. | 선택 |
본사 통합 DB (내부 영역) 인사 · 회계 · 구매 · CRM 등 기존 영역 | 내부 참조 | 동일 DB 인스턴스 직접 참조 (네트워크 호출 없음) | 조회 시 실시간 | 본 IOM이 본사 DB의 신축 영역(재고 관리 섹션)에 위치하므로 기존 영역과 동일 인스턴스에서 조회 가능. 별도 API 호출 불필요. | 필수 |
설계 의도 — 본 IOM은 매장과 본사·외부 시스템 사이의 통합 허브로 작동합니다. 레거시 시스템과의 양방향 연동을 전제로 설계되어, 데이터 단절 없이 신규 영역(재고 관리 섹션)을 신축하면서도 기존 자산을 보존합니다.
수동 → 자동 전환 효과
처리 건수
↑ 높을수록 좋음
증가 (개선)
건당 처리 시간
↓ 낮을수록 좋음
감소 (개선)
오류율
↓ 낮을수록 좋음
감소 (개선)
월간 인력 시간
↓ 낮을수록 좋음
감소 (개선)
자동 동기화 도입 효과: 처리량 2.3배 증가하면서도 인력 시간은 95% 절감, 오류율은 85% 감소했습니다. 수동 처리 시 발생하던 CSV 다운 → 정리 → 업로드 18분 / 건 워크플로우가 API 호출 24초 / 건으로 압축되었습니다.
동기화 실패 알림
7건 — 시스템이 검증 룰로 자동 차단한 영구 오류입니다. 각 행 [원인 분석] 버튼으로 상세 확인 가능합니다.
가격 정책 검증 실패 (음수 단가)
2026-05-05 13:10 · 자동 재시도 0회
본사 API 응답 시간 초과
2026-05-05 02:10 · 자동 재시도 2회
본사 API 응답 시간 초과
2026-05-04 04:10 · 자동 재시도 2회
권한 토큰 만료
2026-05-03 08:10 · 자동 재시도 0회
SKU 코드 형식 불일치
2026-05-03 07:10 · 자동 재시도 0회
CSV 헤더 불일치 — 'sku_id' 필수 컬럼 누락
2026-05-05 11:40 · 자동 재시도 1회
권한 외 매장 데이터 요청 — 키 범위 초과
2026-05-05 10:10 · 자동 재시도 1회
실패 처리 정책
일시 오류는 자동 복구 · 그 외는 분류별 즉시 알림
- ·키 만료일 도래 (예: ak_live_xxxx**** 만료 D-7)
- ·키 회수됨 — 폐점 매장 자동 차단
- ·토큰 갱신 누락 — 본사 정책 변경 미반영
- ·파일 누락 — 업로드 본문이 비어 있음
- ·허용 외 확장자 — 사전 정의된 확장자 외 차단
- ·헤더 불일치 — 'sku_id' 등 필수 컬럼 누락
- ·인코딩 오류 — UTF-8 권장 (그 외 자동 변환 시도)
- ·파일 크기 초과 — 사전 정의된 한도 초과 시 분할 업로드 필요
- ·SKU 코드 형식 불일치 (정규식 위반)
- ·음수 단가 · 음수 재고 수량 차단
- ·필수 필드 누락 (skuId · quantity 등)
- ·참조 무결성 위반 (존재하지 않는 매장 ID)
- ·권한 외 매장 데이터 요청 — 키 범위 초과
- ·R(읽기) 키로 W(쓰기) 호출 시도
- ·타사 데이터 조회 시도 — 격리 정책 위반
동기화 이력
시간순 · 최근 7일본 시스템의 주력은 매장 재고 관리이며, 본사 ERP와의 연동을 통해 SKU 마스터 · 가격 정책 · 안전 재고 기준 · 매장 운영 시간 등 관련 데이터도 함께 동기화될 수 있습니다 (예시 — 실제 항목은 본사 협의).
| 일시 | 동기화 유형 | 방향 | 처리 건수 | 소요 시간 | 결과 | 사유 |
|---|---|---|---|---|---|---|
| 2026-05-05 23:10 | 가격 정책 | 수신 | 75 | 177ms | 성공 | — |
| 2026-05-05 22:10 | 가격 정책 | 수신 | 243 | 315ms | 성공 | — |
| 2026-05-05 21:10 | SKU 마스터 | 송신 | 194 | 110ms | 성공 | — |
| 2026-05-05 20:10 | SKU 마스터 | 수신 | 84 | 304ms | 성공 | — |
| 2026-05-05 19:10 | 재고 일괄 | 수신 | 256 | 467ms | 부분 | 가격 정책 검증 실패 (음수 단가) |
| 2026-05-05 18:10 | 재고 일괄 | 수신 | 171 | 348ms | 성공 | — |
| 2026-05-05 17:10 | 재고 일괄 | 송신 | 148 | 173ms | 성공 | — |
| 2026-05-05 16:10 | SKU 마스터 | 수신 | 220 | 220ms | 성공 | — |
| 2026-05-05 15:10 | 재고 일괄 | 송신 | 102 | 433ms | 성공 | — |
| 2026-05-05 14:10 | SKU 마스터 | 수신 | 138 | 383ms | 성공 | — |
| 2026-05-05 13:10 | 재고 일괄 | 수신 | 149 | 116ms | 실패 | 가격 정책 검증 실패 (음수 단가) |
| 2026-05-05 12:10 | 안전 재고 기준 | 송신 | 121 | 255ms | 성공 | — |
| 2026-05-05 11:10 | 가격 정책 | 송신 | 149 | 255ms | 성공 | — |
| 2026-05-05 10:10 | SKU 마스터 | 송신 | 79 | 188ms | 성공 | — |
| 2026-05-05 09:10 | 매장 운영 시간 | 송신 | 253 | 424ms | 성공 | — |