결론부터 말하겠습니다. 배송 라벨 API 분실 주문 문제 해결 사례에서 운송사가 주문을 잃어버린 경우는 거의 없습니다. 실제로 일어난 일은 체인의 어느 한 고리가 주문을 다음 단계로 넘기지 못한 것입니다. 주문이 들어왔고, 출고 주문이 생성됐는데, 라벨이 나오지 않았습니다. 소포는 포장대에 놓인 채로 있고, 고객 서비스 전화가 울리기 시작합니다. 저는 이 고장을 정확히 3번 봤고, 근본 원인은 매번 달랐지만, 찾는 방법은 언제나 같은 체인입니다. OMS에서 WMS로, WMS에서 운송사 API로, 그리고 프린터로, 한 구간씩 따라가는 것입니다. 먼저 위치를 찾고, 그다음 고치십시오.
분실된 라벨에서 가장 힘든 부분은 손실 자체가 아닙니다. 어디를 봐야 할지 모른다는 것입니다. 포장 담당자는 시스템이 라벨을 인쇄하지 않았다고 하고, 고객 서비스는 주문이 확정됐다고 하고, IT는 API가 오류를 반환하지 않았다고 합니다. 세 사람 모두 맞습니다. 주문이 그 사이의 틈에 끼어 있기 때문입니다. 아래 체인은 그 틈을 찾는 방법입니다.
먼저 위치 찾기: 배송 라벨 API의 어느 구간이 주문을 잃어버렸나
서비스를 다시 시작하거나 주문을 다시 제출하는 것부터 시작하지 마십시오. 5분을 들여 고장 위치를 찾으십시오. 주문은 네 구간 중 한 곳에 걸려 있고, 그다음 모든 단계는 어느 구간인지에 따라 달라집니다.
OMS에서 주문 상태를 확인하십시오. 확정되어 출고를 기다리는 중인지, 아니면 이미 WMS로 넘어갔는지. OMS가 한 번도 보내지 않았다면 문제는 라벨 API가 아니라 OMS 전송 규칙에 있습니다. 그런 다음 WMS에 해당 출고 작업이 있는지, 그 작업이 피킹 대기 중인지, 피킹 완료인지, 포장 완료인지 확인하십시오. 작업이 없으면 주문은 OMS와 WMS 사이에서 사라진 것입니다. 작업은 있고, 라벨 요청은 보냈고, 운송사 답변이 없으면 문제는 API 구간에 있습니다. 답변은 받았고, 라벨 파일도 도착했고, 프린터가 조용하면 문제는 인쇄 구간에 있습니다.
위치를 찾는다는 것은 아무것도 건드리기 전에 네 가지 질문을 하고 답을 적어두는 것입니다. OMS가 보냈나? WMS가 받았나? 운송사가 답변했나? 프린터가 인쇄했나? 답이 아니오로 바뀌는 구간이 바로 문제가 있는 곳입니다.
배송 라벨 API 분실 주문 문제 해결: 주문에서 도크까지 네 구간 따라가기
구간 1, OMS에서 WMS로. 여기서 가장 흔한 고장은 어떤 주문 유형을 다루지 않는 전송 규칙입니다. 성수기 중에 팀이 새로운 선물 주문 유형을 추가하는데 전송 규칙이 이를 한 번도 다루지 않아, 주문은 OMS에 머물고 WMS는 그 존재를 전혀 모릅니다. 확인 방법: 분실된 주문 번호로 OMS 전송 로그를 검색하십시오. 전송 기록이 있는지, 결과는 무엇이었는지. 기록이 없으면 규칙 문제입니다. 실패 기록이 있으면 네트워크나 필드 문제입니다. 안전망: OMS 전송에 재시도와 알림을 추가하십시오. 전송이 3번 실패하면 당직자를 호출하십시오. 주문을 조용히 방치하지 마십시오.
구간 2, WMS 내부. 작업은 있고, 피킹은 끝났고, 라벨 인쇄 단계에서 멈춥니다. 저는 이 함정을 3번 봤고, 근본 원인은 매번 같았습니다. WMS가 라벨 요청을 보내기 전에 주소와 무게와 운송사 서비스 상품을 검증합니다. 세 가지 중 하나라도 검증에 실패하면 요청은 절대 나가지 않고, 오류도 없고, 작업 메모에 작은 한 줄만 남습니다. 확인 방법: 작업 상세를 열고 검증 패널을 보십시오. 안전망: 검증 실패는 눈에 보이는 알림을 띄우고 로그 항목을 남겨야 합니다. 조용한 실패야말로 분실 라벨의 가장 큰 공범입니다.
구간 3, 운송사 API. 요청은 나갔는데 답변이 돌아오지 않았습니다. 여기에는 두 가지 경우가 있습니다. 하나는 운송사 API 타임아웃입니다. 다른 하나는 답변이 돌아왔지만 WMS가 이를 인식하지 못한 경우입니다. 타임아웃의 경우 먼저 타임아웃이 몇 초로 설정되어 있는지 확인하고, 그다음 피크 시간 대기열인지 확인하십시오. 인식되지 않은 답변의 경우 운송사의 상태 코드가 시스템에 매핑된 상태 코드와 일치하지 않는 경우가 대부분입니다. 확인 방법: 요청 추적 ID를 API 로그로 가져가 운송사가 정확히 무엇을 반환했는지 보십시오. 안전망: 타임아웃 시 자동으로 한 번 재시도하되, 재시도하기 전에 라벨 번호가 이미 생성되었는지 확인하십시오. 하나의 주문에 라벨 번호를 두 개 만들지 마십시오.
구간 4, 프린터와 라벨 파일. 라벨 파일은 도착했는데 프린터가 아무것도 하지 않거나, 인쇄했는데 시스템이 주문을 여전히 미출고로 표시합니다. 먼저 프린터 대기열을 확인하고, 그다음 라벨 파일 형식이 올바른지 확인하고, 그다음 기록 반영을 확인하십시오. 인쇄 성공이 WMS에 기록 반영됐습니까? 기록 반영 실패는 네 가지 중 가장 지독합니다. 소포는 이미 떠났는데 시스템은 여전히 출고 대기 중이고, 재고와 주문 상태가 둘 다 틀렸습니다. 확인 방법: 프린터 로그와 시스템 출고 기록을 비교하십시오. 수량이 맞지 않으면 기록 반영이 사라진 것입니다. 안전망: 인쇄 성공이 기록 반영으로 확인될 때까지 소포를 내보내지 마십시오. 포장대에서 보내는 여분의 10초가 현실과 어긋난 시스템보다 낫습니다.
| 구간 | 대표적인 증상 | 먼저 확인할 것 | 안전망 |
|---|---|---|---|
| OMS에서 WMS로 | WMS에 작업 없음 | 전송 로그, 주문 유형 규칙 | 3번 재시도한 뒤 알림 |
| WMS 내부 | 라벨 인쇄 단계에서 작업 멈춤 | 주소와 무게 검증 패널 | 검증 실패 시 알림을 띄우고 기록 |
| 운송사 API | 요청은 보냈으나 답변 없음 | API 로그, 상태 코드 매핑 | 재시도 전에 라벨 번호 존재 여부 확인 |
| 프린터 | 인쇄했으나 여전히 미출고 | 인쇄 대기열, 기록 반영 기록 | 내보내기 전에 기록 반영 확인 |
여기가 직관에 반하는 부분입니다. 라벨을 분실했을 때 가장 두려워해야 할 것은 손실이 아닙니다. 중복입니다. 라벨이 없다는 것을 본 순간 사람들은 재시도를 누르고, 주문을 다시 제출하고, 라벨은 마침내 나옵니다. 두 번이나요. 라벨 번호 두 개, 주문 하나. 소포 하나가 출고되고, 다른 라벨 번호는 시스템 안에 떠다닙니다. 잘해야 재고가 틀립니다. 최악의 경우 고객은 상품을 손에 쥐고 있는데 시스템은 여전히 미출고라고 하고, 고객 서비스는 두 번째로 무너집니다. 재시도하기 전에 라벨 번호가 이미 존재하는지 확인하십시오. 이것이 철칙입니다. 위치를 찾는 느린 10분이 다시 제출하는 빠른 3초보다 낫습니다.
제 고객 중 한 곳이 성수기 전날 밤 새로운 운송사 API로 전환했다가 첫날 200개가 넘는 라벨을 잃어버렸습니다. 근본 원인은 민망할 정도로 단순했습니다. 새 API의 마감 시간이 기존 API보다 1시간 빨랐던 것입니다. 마감 시간 이후에 들어온 주문은 그 자리에서 거부됐고, 시스템은 한 번도 알림을 울리지 않았습니다. 결국 팀은 오전 3시까지 한 장씩 손으로 라벨을 인쇄했습니다. 그날 밤 이후로 저는 규칙을 하나 만들었습니다. 성수기 전날 밤에는 절대 인터페이스를 전환하지 말 것.
고라이브 당일 밤 체크리스트: 잠들기 전에 이것을 실행하십시오
고라이브 당일 밤은 비전을 이야기할 시간이 아닙니다. 이 목록을 따라 내려가며 모든 항목에 체크하십시오.
하나, 전송 규칙: 모든 주문 유형이 다뤄지고 있습니까? 테스트 주문이 아니라 실제 주문을 처음부터 끝까지 실행하십시오. 둘, 검증 규칙: 주소, 무게, 서비스 상품. 검증이 실패하면 누군가 알림을 볼 수 있습니까? 셋, 타임아웃과 재시도: 타임아웃은 몇 초입니까? 재시도는 몇 번입니까? 재시도가 먼저 기존 라벨 번호를 확인합니까? 넷, 상태 코드 매핑: 운송사가 반환하는 모든 상태 코드를 시스템이 인식합니까? 다섯, 인쇄 기록 반영: 프린터 오프라인, 용지 없음, 용지 걸림, 각 경우에 시스템은 어떻게 합니까? 여섯, 알림: 분실 라벨이 몇 개, 또는 몇 분 멈춰 있어야 누군가에게 전화가 갑니까? 일곱, 대체 방안: API가 완전히 다운되면 누가 손으로 라벨을 인쇄하고, 라벨 번호는 어디서 옵니까?
잠들기 전에 일곱 개 모두에 체크하십시오. 하나라도 체크하지 않으면 자정 전화는 당신의 몫입니다.
배송 라벨 API 분실 주문 문제 해결은 처음 할 때는 어렵지 않습니다. 어려운 것은 매번 같은 방식으로 하는 것입니다. 감으로 추측하지 말고 체인을 따라가는 것입니다. 이 안내를 포장대 옆에 붙여 두십시오. 다음에 라벨이 나오지 않으면 네 구간을 따라 내려가면 10분 안에 위치를 찾을 수 있습니다. 위치만 맞으면 고치는 것은 빠릅니다.
Lin Xiao, WMS 구현 컨설턴트 지음 영어판 번역본입니다. 내용이 다를 경우 영어판을 우선합니다.







