MD-03 · MD-14 · 이지어드민(늘품) 재고 연동 · 기획 문서
이지어드민 재고 연동
늘품(이지어드민) 재고를 공급사(히어로)별로 받아 어드민 재고에 반영한다. API 실시간 연동 대신 엑셀 업로드 방식을 쓰고, 차이 나는 항목은 대사 리포트로 표시한다.
선행 확인 — 개발 착수 전
- 이지어드민 엑셀이 공급사(히어로)별로 오는가 — 실물 1장 확인. 깐마늘 하나로 뭉쳐 오면 모델이 바뀐다. (Buggy "있다")
- DC 코드 중복 규칙 — 1 히어로 = 1 DC, 복제 코드로 연결된 복제만 공유.
- 담당분(타입2)은 다음 차수 — 담당자·카테고리 매핑이 선행. 이번엔 전체 업로드만.
①
매칭 — 공급사 상품 관리에 「DC 작업 코드」
기존 메뉴에 컬럼 추가(새 메뉴 아님) · 그룹을 펼치면 히어로 상세에 신규 컬럼
1
1 히어로 = 1 DC 코드. 다른 히어로에 같은 코드를 넣으면 충돌로 저장되지 않는다.
2
예외는 「복제 코드」로 연결된 복제뿐이다. 복제는 노출용이고 재고는 대표에만 반영한다.
3
입력은 필수 아님(DC 상품만) · 엑셀 일괄 매핑 지원 · 결과는 성공 건수와 실패 항목의 사유를 함께 준다.
4
컬럼 명칭은 「DC 작업 코드」로 둔다. "이지어드민 코드"로 부르지 않는다(늘품 ERP 교체·타 DC 확장 대비).
②
재고 엑셀 업로드
재고관리 밑 새 화면 · 담당 MD가 산출 전 엑셀로 올린다
1
스냅샷 방식. 엑셀은 그 시점의 실재고이며, 기존 값을 덮어쓴다(누적하지 않음).
2
기준시각 역행 차단. 최근 반영보다 오래된 파일은 반영하지 않는다.
3
중복 무시. 같은 파일을 두 번 올려도 한 번만 반영한다.
4
이력 저장. 누가·언제·어떤 파일·몇 행을 반영했는지 남긴다.
5
이번 범위는 전체 업로드만. 담당분(타입2)은 다음 차수.
③
대사 리포트 — 차이 항목 표시
늘품(엑셀)과 우리 재고를 공급사별로 비교한다
늘품의 분실·조정도 차이로 표시되므로, 재고가 0인데 발주가 들어가는 사고를 막는다. 미매핑·음수·형식 오류 항목은 반영을 보류하고, 매핑을 하거나 매입(MD-01)으로 채울 때까지 리포트에 남는다.
④
정책 · 예외 정리 (컨펌용)
재고 단위
공급사(히어로)별. 엑셀이 공급사별로 주므로 동원·수마트를 따로 반영한다. 그룹은 합계.
매핑 기준
DC 작업 코드 ↔ 히어로코드. 1 히어로 1 DC · 복제 코드로 연결된 복제만 공유 · 필수 아님(DC 상품만).
연동 방식
엑셀 업로드(전체 스냅샷). API 실시간 연동은 쓰지 않는다. 담당 MD가 산출 전 수동 업로드.
매핑 결과 표시
성공은 건수만, 실패 항목만 사유와 함께 준다(+CSV). 전체 상세 화면은 만들지 않아 개발 부담을 줄인다.
업로드 예외 처리
미매핑 DC코드
매핑 없는 행은 보류 + 리포트 → MD-03에서 매핑 후 재대사
음수 재고
−값은 반영하지 않음 + 경고(분실·오타 확인)
형식 오류
숫자 아님·열 누락은 행 스킵 + 리포트
복제코드 재고
복제 히어로의 수량은 대표로 이동(이중 반영 방지)
엑셀에 없는 품목
전체 업로드인데 우리엔 있고 엑셀엔 없으면 0 처리 위험 → 보류+확인
티켓이 문서 = MD-03(매칭) + MD-14(업로드·대사) · 순서 03 → 14 · 재고·회전은 MD-01·04
요약DC 작업 코드로 매칭 → 늘품 엑셀 업로드(스냅샷) → 공급사별 대사로 차이·미매핑 표시 → 해당 공급사 재고에 반영.