시작: "연결됐다"와 "통합됐다"는 다르다
한 제조사는 6개월 계획으로 WMS를 도입했지만, 7개월째에도 통합 테스트 중이었다. 사후 분석 결과: WMS 본체 조정은 3개월 만에 끝났고, 나머지 4개월은 ERP 인터페이스에 쓰였다. 내 경험칙은 이렇다. WMS 가동이 지연될 때 문제의 70%는 인터페이스에 있다. 인터페이스 설계는 "연결만 하면 된다"가 아니다. 모든 디테일에 악마가 산다. 아래 여덟 가지 함정 중 세 개만 밟아도 프로젝트는 지연된다.
여덟 가지 함정
함정 1: 마스터 데이터 소유자를 정하지 않았다
품목·고객·공급업체 마스터는 ERP의 것, WMS는 읽는다. 로케이션, 로트 규칙, 전략 파라미터는 WMS의 것. 악몽은 양방향 쓰기다. 양쪽이 품목 마스터를 편집하면 언젠가는 어긋난다. 원칙: 마스터 레코드의 소유자는 정확히 한 명.
함정 2: 전표 상태 전이를 맞추지 않았다
ERP의 "승인"은 WMS의 "실행 가능"에 대응하지만, 그 사이에 "할당됨", "릴리스됨" 같은 상태가 여러 개 끼어 있을 수 있다. 상태 간극은 전표를 얼린다. ERP는 보냈다고 생각하고, WMS는 온 적이 없다고 한다. 코딩 전에 양쪽 상태 대응표를 그리고 모든 상태를 확인하라.
함정 3: 인터페이스에 멱등성이 없었다
네트워크 지터로 재시도가 발생하면 같은 입고 전표가 두 번 실행되어 유령 재고가 생긴다. 모든 쓰기 인터페이스는 업무 키(입고 번호 + 행 번호)로 중복 제거하고, 반복 호출에는 첫 결과를 반환해야 한다. 철칙, 예외 없음.
함정 4: 로트·시리얼 번호 항목을 완전히 매핑하지 않았다
ERP는 로트 번호가 있기만 하면 만족하지만, WMS는 로트 속성을 관리해야 한다. 유통기한, 검사 상태, 보류 사유. 항목 매핑표는 한 행씩 확인해야 하며, 특히 ERP에는 있는데 WMS에 없는 항목, WMS가 필요하지만 ERP가 제공하지 않는 항목을 주의하라. 기본값이나 수동 보충 흐름을 먼저 정의하라.
함정 5: 재고 동기화 시점을 잘못 잡았다
실시간 동기화는 아름답게 들리지만, 하루 100,000건 이상의 재고 이동은 ERP를 무너뜨린다. 검증된 조합은 "증분 푸시 + 정기 정산"이다. WMS는 증분을 실시간으로 푸시하고, ERP는 4시간마다 정산하며, 임계치 초과는 알림을 띄운다.
함정 6: 표준 예외 콜백이 없었다
WMS 쪽의 부족 입고, 파손, 반품에는 표준 반환 코드가 필요하고, ERP 쪽에는 대응 프로세스(재주문, 클레임, 폐기)가 필요하다. 없으면 차이 전표가 WMS에 쌓이는 동안 재무는 월 마감을 못 하고, 두 부서는 서로를 탓한다.
함정 7: 인터페이스 모니터링이 없었다
모든 인터페이스에는 재시도 로직, 데드레터 큐, 알림 임계치가 필요하다. 첫 주에는 매일 정산하고, 이후 주간으로 낮춘다. 모니터링되지 않는 인터페이스는 IT보다 현장이 먼저 장애를 발견하게 된다. 가장 비싼 발견 방법이다.
함정 8: 전환 시 병행 운영을 하지 않았다
레거시 시스템과 새 WMS를 1~2주 병행 운영하고 일일 마감으로 정산하라. 재고 차이가 0.5% 이하로 유지될 때만 전환하라. 직접 전환은 용기가 필요하지만, 대가는 라인 정지가 될 수 있다.
대응표
| 함정 | 대표 증상 | 대응책 |
|---|---|---|
| 마스터 데이터 소유권 | 양쪽 주장이 다름 | 마스터 레코드당 소유자 1명 |
| 상태 전이 간극 | 전표 동결 | 먼저 상태 지도를 그려라 |
| 멱등성 없음 | 입고/출고 중복 | 업무 키로 중복 제거 |
| 로트 항목 누락 | 유통기한 미관리 | 항목을 한 행씩 매핑 |
| 동기화 시점 | ERP 마비 | 증분 푸시 + 정기 정산 |
| 예외 콜백 없음 | 차이 누적 | 표준 반환 코드 + 처리 흐름 |
| 모니터링 없음 | 현장이 먼저 장애 발견 | 재시도 + 데드레터 큐 + 알림 |
| 병행 운영 없음 | 전환 시 라인 정지 | 1~2주 병행, 일일 정산 |
현장 사례: 안정되기까지 세 번의 재작업
한 제조사는 WMS–SAP 통합을 세 번 다시 만들었다. 첫 번째는 상태 전이가 맞지 않아 전표가 얼었고, 두 번째는 로트 항목 누락으로 유통기한 관리가 무너졌으며, 세 번째에서야 멱등성과 모니터링을 추가했다. 근본 원인: 통합 테스트 환경이 두 달 늦게 도착해서 인터페이스 설계는 문서와 상상 위에 지어졌다. 교훈: 테스트 환경과 마스터 데이터 매핑표가 프로젝트의 첫 우선순위이며, 부수 작업이 아니다.
피해야 할 함정
- 코드보다 명세 먼저. 항목 매핑표, 상태 대응표, 예외 코드표는 개발 시작 전에 양쪽이 서명한다.
- 프로젝트 시간의 최소 30%는 인터페이스에 할애하라. 건강한 배분: WMS 본체 40%, 인터페이스와 통합 테스트 30%, 전환과 안정화 30%.
- ERP 벤더 협력을 계약에 넣으라. 많은 지연은 ERP 쪽 일정에서 비롯된다. 구두 약속은 약속이 아니다.
1주차: 인터페이스 인벤토리 만들기
WMS 프로젝트 1주차에는 코드를 쓰지 말고 인터페이스 인벤토리를 만들라.
| ID | 인터페이스 | 방향 | 빈도 | 일일 건수 | 업무 담당자 | IT 담당자 |
|---|---|---|---|---|---|---|
| IF-01 | PO 다운로드 | ERP→WMS | 실시간 | 500 건 | 기획 | IT |
| IF-02 | 입고 확정 | WMS→ERP | 실시간 | 500 건 | 창고 | IT |
| IF-03 | 재고 동기화 | WMS→ERP | 4시간마다 | 100K 건 | 재무 | IT |
건수 × 복잡도로 순위를 매기고 어려운 것부터 공략하라. 원칙: 핵심 전표 인터페이스(입고, 출고, 재고)가 보고/조회 인터페이스보다 먼저. 모든 인터페이스에 업무+IT 이중 담당자를 두어 항상 연락할 사람이 있게 하라.
이 표는 프로젝트의 조기 경보 레이더다. 업무 담당자가 없는 인터페이스는 미래의 지연이다.
통합 테스트 환경: 구축이 늦으면 지연은 확정
통합 테스트가 죽는 가장 흔한 원인: 환경이 준비되지 않았다. 협상 불가 4요소:
- ERP 테스트 환경: 데이터는 프로덕션의 마스킹 복사본이어야 하며, 절대 빈 데이터베이스를 쓰지 마라. 빈 DB 테스트는 테스트가 아니다.
- WMS 테스트 환경: 프로덕션과 같은 버전, 완전한 기본 마스터 데이터.
- 테스트 데이터: 정상 흐름 + 예외 흐름(부족 입고, 파손, 반품, 로트 보류), 각각 최소 20건.
- 벤더 시간 확보: ERP 벤더 컨설턴트를 4주 전에 예약하라. 구두 예약은 예약이 아니다.
준비 완료 관문: 운영 인력을 초대하기 전에 양쪽 IT 팀이 테스트 환경에서 완전한 업무 트랜잭션을 독립적으로 한 번씩 실행한다. 현장 사람들의 시간은 가장 비싸다. 환경 대기 중에 태우지 마라.
마무리
WMS–ERP 통합의 여덟 가지 함정은 사실 모두 "가정"이다. 마스터는 일치할 것이고, 상태는 맞을 것이고, 네트워크는 흔들리지 않을 것이라는 가정. 서명된 세 개의 표(항목 매핑, 상태 대응, 예외 코드)에 멱등성, 모니터링, 병행 운영을 더하면 지연 리스크의 70%를 시작 전에 제거할 수 있다.
영어판 번역본입니다. 내용이 다를 경우 영어판을 우선합니다.
