slug: wcs-wms-count-discrepancy-troubleshooting-guide lang: ko title: WCS 카운트가 WMS와 맞지 않을 때: 차이 원인 해결 플레이북 excerpt: WCS 카운트가 WMS와 맞지 않을 때, 90%의 원인은 다섯 가지 근본 원인으로 귀결됩니다. Lin Xiao의 10단계 트러블슈팅 체크리스트를 사용하면 4단계 이전에 대부분의 차이를 찾을 수 있습니다. section: software subcategory: wcs region: common tags: ['wcs','wms','정합성','차이','컨베이어-카운트'] author: 林晓

WCS 카운트가 WMS와 맞지 않을 때: 차이 원인 해결 플레이북

먼저 결론부터 말씀드리겠습니다: WCS 카운트와 WMS 재고가 맞지 않을 때, 열 번 중 아홉 번은 원인이 정확히 다섯 가지 범주 중 하나에 들어갑니다——광전 센서와 스캐너 오독, 네트워크 패킷 손실과 시계 드리프트, 고리를 닫지 않는 역류, 스캔되지 않는 수작업 개입, 그리고 처음부터 정렬되지 않은 카운트 정의입니다. 저는 이 장애를 세 번 겪었고, 매번 고객의 첫 반응은 "오늘 밤 건물 전체를 다시 세자"였습니다. 매번 그것은 틀렸습니다. 그 이유와 10단계 트러블슈팅 체크리스트를 이어서 설명하겠습니다. 순서대로 실행하면 90%의 차이가 4단계 이전에 드러납니다.

실제 재난: 가동 전야 3,000개 차이

2024년 10월, 새로 도입된 WCS 기반 분류 라인으로 하루 20,000개를 처리하는 50,000제곱피트 규모의 이커머스 창고는 가동 3주차에 WMS 재고와 WCS 기계 카운트가 벌어지기 시작했습니다——누적으로 3,000개 이상이었습니다. 운영 이사는 그날 밤 전수 재고조사를 요구했습니다. 저는 말렸습니다: 재고조사는 "얼마나 어긋났는지"는 알려주지만 "어디서 차이 났는지"는 알려주지 않습니다. 3시간을 파고들어 두 가지 근본 원인을 찾았습니다. 첫째, 분류기의 투과형 광전 센서가 판지 먼지에 가려 약 1,200개를 적게 셌습니다. 둘째, 반품 프로세스가 오프라인으로 돌아가 1,800개가 넘는 반품이 스캔 지점을 한 번도 거치지 않았습니다. 합치면 약 3,000개입니다. 교훈은 한 문장입니다: 숫자를 맞추려 하기 전에 차이가 어디서 생겼는지부터 찾으십시오.

WCS–WMS 카운트 차이의 다섯 가지 진짜 원인

원인 1: 광전 센서와 스캐너 오독. 가장 흔합니다. 더러워진 센서, 틀어진 빔, 너무 촘촘히 붙은 박스로 인한 이중 트리거. 고정식 스캐너에는 노리드(no-read)율이 있습니다——그것은 고장이 아니라 확률입니다. 계산해 보십시오: 하루 20,000개에 노리드율 0.5%라면, 하루에 100개, 한 달에 3,000개가 어긋납니다. 위의 창고가 3,000개 차이를 쌓은 방식이 바로 이것입니다.

원인 2: 네트워크 손실과 시계 드리프트. WCS 컨트롤러와 WMS 서버의 시계가 다르면 이벤트 순서가 깨집니다. WCS가 "분류 완료"를 보고하고, WMS는 타임스탬프로 중복을 제거하면서 "그 이벤트는 이미 봤다"고 판단해 버립니다. 저는 이걸 세 번 겪었고, 세 번 다 IT는 "네트워크는 정상입니다"라고 주장했습니다——컨트롤러 시계가 40초 이상 늦게 가고 있다는 걸 찾기 전까지는요.

원인 3: 고리를 닫지 않는 역류. 반품, 예외 다이버트, 재포장——주 경로를 벗어나는 모든 것. WCS는 이 수량을 세지 않지만 WMS 재고는 움직입니다. 열 곳 중 아홉 곳의 창고가 역류를 오프라인 수작업으로 처리합니다. 차이가 번식하는 곳이 바로 여기입니다.

원인 4: 재스캔 없는 수작업 개입. 걸림 발생, 작업자가 박스를 예외 슈트까지 직접 들고 가고, 스캔 없음. 품질 샘플링으로 몇 개를 빼내고, 잊어버림. 한두 번은 아무것도 아니지만, 성수기에 하루 수십 번 반복되면 숫자는 절대 맞지 않습니다.

원인 5: 처음부터 정렬되지 않은 카운트 정의. 가장 억울한 경우: 양쪽 다 맞지만, 같은 것을 세고 있지 않은 겁니다. WCS는 "기계를 통과한 수량"을 세고, WMS는 "재고 수량"을 셉니다——운송 중, 예외 슈트, 품질 보류 구역: 어느 쪽이 소유합니까? 정의가 어긋난 채로는 카운트가 절대 맞을 수 없습니다.

직관에 반하는 판단 원칙: WCS의 누적 카운트 자체를 절대 신뢰하지 말고, 타임스탬프가 찍힌 이벤트 스트림을 신뢰하십시오. 이벤트 하나를 놓치는 누적 카운터는 영원히 틀립니다. 빈 구간이 있는 이벤트 스트림은 로그에서 복원할 수 있습니다. 항상 이벤트에서 트러블슈팅하고, 총합을 쳐다보며 해결하려 하지 마십시오.

10단계 체크리스트: 이 순서대로 트러블슈팅

차이 보고서를 뽑고 쪼개십시오. SKU별, 슈트/도착지별, 시간대별로 쪼갭니다. 몇 개 슈트에 집중된 차이는 장비를, 균일하게 퍼진 차이는 인터페이스와 정의를 가리킵니다.
WCS 이벤트 로그를 읽으십시오. 노리드 기록과 광전 이상에 집중하고, 차이가 시작된 시점과 맞춰 보십시오.
광전 센서를 테스트하십시오. 하나씩 차광 테스트합니다: 더러운 것은 청소하고, 틀어진 것은 재조정합니다. 박스 최소 간격이 300밀리미터 아래로 떨어지면 이중 트리거는 거의 확실합니다——간격을 고치거나, 오차를 받아들이고 보정 로직을 만드십시오.
네트워크와 시계를 확인하십시오. 컨트롤러와 WMS 서버의 동기화를 확인하고, 5초를 넘는 드리프트는 다른 무엇보다 먼저 고칩니다. 인터페이스 큐에 백로그, 재시도, 드롭이 없는지 확인합니다.
역류를 감사하십시오. 지난 한 주간의 반품, 예외 다이버트, 재포장 티켓을 추적하고, 각각이 WMS에 도착했는지 검증합니다.
수작업 개입 기록을 검토하십시오. 예외 슈트 수작업 로그, 걸림 해소 기록, 품질 샘플링——하나씩 대조합니다.
카운트 정의를 정렬하십시오. 양쪽의 정의를 적고 한 줄씩 비교합니다: 운송 중, 예외 슈트, 품질 보류, 스테이징——누가 소유합니까. 모든 "차이"의 절반은 이 단계에서 증발합니다.
마스터 데이터를 확인하십시오. 중복된 SKU 바코드, 한 제품에 여러 코드——스캐너는 바코드를 제대로 읽었지만, 그 바코드가 잘못된 SKU에 연결되어 있었습니다.
한 시간을 처음부터 끝까지 복원하십시오. 가장 나쁜 한 시간을 골라 카메라 영상과 로그를 뽑고, 하나씩 대조합니다. 노가다지만, 사건을 종결하는 유일한 방법입니다.
고치고, 재테스트하고, 그 다음에 셉니다. 근본 원인을 고친 뒤 4시간 가동하고 차이가 수렴하는지 지켜봅니다. 수렴하면 기준을 맞추기 위해 한 번 실사합니다. 수렴하지 않으면 근본 원인이 틀렸다는 뜻——돌아가서 다시 확인합니다.

카운트 차이 트러블슈팅을 위해 창고 전기 제어 캐비닛을 점검하는 엔지니어

네 가지 고전적인 실수

재고조사부터 시작하기. 재고조사는 "이벤트 누락"을 "재고 차이"로 바꿀 뿐, 근본 원인은 계속 새어 나옵니다. 다음 날이면 차이가 돌아옵니다.
장비는 확인하고 인터페이스는 확인하지 않기. 제 경험상, 불일치의 절반 이상은 센서 문제가 아니라 소프트웨어와 인터페이스 문제입니다.
정의를 정렬하기 전에 회의하기. 양쪽이 한 오후 내내 엇갈린 이야기를 합니다. 먼저 정의를 적고, 논쟁은 나중에.
재테스트 없이 승리를 선언하기. 센서를 닦고, 문제 "해결", 3일 뒤 차이가 돌아옵니다. 4시간 가동하고, 데이터로 수렴을 증명하십시오.