결론부터 말하면, WMS–TMS 연동이 끊어지면 먼저 출하를 계속하고 데이터는 나중에 고쳐야 합니다. 출하 상태 피드가 멈췄다고 창고가 멈추는 것은 아닙니다. 화물은 나가야 합니다. 2024년 11월, 성수기 한가운데 한 고객의 TMS 콜백 피드가 6시간 동안 끊겼습니다. 400건이 넘는 주문이 이미 출하된 상태였고, 그 주문들은 모두 WMS에서 "출하 대기" 상태로 멈춰 있었습니다. 그날 밤 우리는 종이 기록으로 버텼습니다. 분실 주문 0건, 오출하 0건이었습니다.
저는 이 똑같은 장애를 세 번 봤습니다. 세 번의 '죽음'은 각각 달랐습니다. 빠져나가는 방법은 매번 같았습니다.
WMS–TMS 연동이 끊어졌을 때, 지켜야 할 세 가지
첫째, 화물은 멈출 수 없습니다. 출고는 창고의 본선이고, 상태 동기화는 지선입니다. 지선이 끊어져도 본선은 계속 돌아갑니다. 피드가 복구되기를 기다리며 출고를 멈춘 사람은 작은 문제를 큰 문제로 바꾼 것입니다.
둘째, 데이터는 잃을 수 없습니다. 나가는 주문마다 그 자리에서 네 가지를 적습니다. 운송장 번호, 운송사, 출하 시간, 수량입니다. 하나라도 빠지면 나중에 채우는 작업이 맞지 않습니다. 수기 기록은 정확히 이 네 가지를 기록합니다. 더 많으면 쓸모없고, 더 적으면 부족합니다.
셋째, 고객을 모르게 둘 수 없습니다. 피드가 멈추면 고객이 보는 것은 "출하 대기"뿐이고, 30분도 안 돼 전화가 오기 시작합니다. 먼저 알리고, 그다음 한 건씩 답하세요. 고객이 전화하기를 기다리지 마세요. 고객은 "상태 업데이트가 몇 시간 늦어지고 있습니다"는 받아들일 수 있습니다. "내 주문이 출하됐는지 아무도 모른다"는 받아들일 수 없습니다.
왜 끊어지는가: 제가 본 세 가지 죽음
가장 흔한 죽음: 운송사의 API 토큰이 만료된 경우입니다. 2025년 3월, 한 고객의 운송사 토큰이 금요일 밤에 만료됐고, 월요일 아침까지 아무도 눈치채지 못했습니다. 900건이 넘는 출하 상태가 동기화되지 않은 채 쌓였습니다. 만료일은 연동 문서에 적혀 있었습니다. 아무도 알림을 설정하지 않았고, 아무도 책임지지 않았습니다.
두 번째 죽음: 운송사가 아무에게도 알리지 않고 API를 업그레이드한 경우입니다. 필드 이름이 바뀌고, 응답 코드가 바뀌고, WMS는 옛날 형식을 계속 파싱했습니다. 파싱에 실패한 건 조용히 버려졌습니다. 오류도, 알림도 없습니다. 이것이 가장 교묘한 종류입니다. 아무것도 움직이지 않는데 시스템은 완벽하게 건강해 보입니다.
세 번째 죽음: 콜백이 사라진 경우입니다. TMS는 상태를 보냈고, WMS는 받지 못했고, TMS는 전달됐다고 믿었고, WMS는 아무것도 보내지지 않았다고 믿었습니다. 어느 쪽에도 재시도 장치가 없어서 상태는 중간에서 죽었습니다. 2024년의 6시간 장애가 바로 이 경우였습니다. 로그에는 TMS 쪽에 "전송됨"이라고 표시됐고, WMS 쪽에는 아무것도 없었습니다.
세 번 중 두 번은 창고 쪽의 잘못이 아니었습니다. 하지만 고객이 보는 것은 창고뿐입니다. 당신이 출하했으니 당신이 상태를 알려줘야 합니다. 누구의 API인지는 고객에게 중요하지 않습니다.
처음 90분: 버티기 위한 다섯 단계
1단계, 10분 이내: 끊어진 곳을 찾습니다. 세 곳을 확인합니다. WMS 연동 로그, TMS 전송 로그, 운송사 자체의 추적 페이지입니다. 대부분의 경우 10분이면 어느 구간이 죽었는지 특정할 수 있습니다. 찾기 전에는 누구도 서비스를 재시작하게 하지 마세요. 재시작하면 실시간 로그가 지워집니다.
2단계, 20분 이내: 수기 기록으로 전환합니다. 출고 대장을 인쇄하거나, 네 개 열이 있는 공유 시트를 엽니다. 운송장 번호, 운송사, 출하 시간, 수량입니다. 문을 나가는 주문마다 한 줄씩 기록하고, 슈퍼바이저가 한 시간에 한 번 대조합니다. 지저분한 글씨는 괜찮습니다. 중요한 것은 정확한 숫자입니다.
3단계, 30분 이내: 고객에게 알립니다. 공지에는 세 문장이 필요합니다. 상태 업데이트가 일시 중단됐고, 화물은 정상적으로 출하되고 있으며, 예상 복구 시간입니다. 빈 "시스템 업그레이드"라는 말은 빼세요. 고객이 알고 싶은 것은 "내 주문이 어디에 있나"입니다.
4단계, 60분 이내: 고객 서비스에 실제로 확인할 수 있는 목록을 줍니다. 전화가 오면 상담원은 수기 기록을 보고 답합니다. 창고까지 달려가 물어볼 필요가 더는 없습니다. 그날 밤 우리는 통화량을 절반 이상 줄였습니다. 서비스 리드는 나중에 그날이 "내 주문이 출하됐나요" 문의에 대한 성수기 가장 조용한 야간 근무였다고 말했습니다.
5단계, 90분 이내: 복구 계획에 합의합니다. 연동 책임자가 수정 기한을 제시하고, 창고는 채우기 작업에 합의합니다. 장애 기간의 상태를 시간 순서대로 다시 보내고, 한 건씩 확인합니다. 계획을 적어 관계자 모두에게 보냅니다. 말로만 하는 약속이 아닙니다.
저는 이 다섯 단계를 세 고객의 고라이브 당일 밤 체크리스트에 적어 넣었습니다. 매번 고객은 "아마 쓸 일이 없을 겁니다"라고 말했습니다. 쓸 일이 생겼을 때마다, 적어 두어서 다행이라고 했습니다.
WMS–TMS 연동이 복구된 뒤: 채우기, 대조, 예방
복구는 끝이 아닙니다. 후반 작업의 시작입니다. 채우기: 장애 기간의 상태를 시간 순서대로 다시 보내고, 수기 기록에 한 건씩 체크합니다. 티켓은 체크가 돼야 완료입니다. 대조: 채우기가 끝난 뒤 WMS 출고 기록과 TMS 배송 기록을 주문별로 대조하고, 모든 불일치를 추적합니다. 시간을 아끼려고 표본 검사로 넘어가지 않습니다. 예방: 세 가지입니다. 토큰 만료 7일 전 자동 알림, 연동의 재시도와 데드레터 큐, 그리고 이 다섯 단계를 그대로 실행하는 월간 장애 훈련입니다.
훈련은 보여주기 식이 아닙니다. 한 달에 한 번, 화요일 오후에 1시간 동안 장애를 시뮬레이션합니다. 콜백을 끄고, 종이 기록을 쓰고, 고객 서비스에 실제로 전화를 겁니다. 그 뒤 세 가지 숫자를 검토합니다. 끊어진 곳을 찾는 데 걸린 시간, 수기 기록에서 빠진 행 수, 고객 공지가 나가기까지 걸린 분입니다. 숫자가 매번 좋아지면 훈련이 제대로 되고 있는 것입니다.
여기에 직관에 반하는 부분이 있습니다. 대부분 종이 기록을 후퇴로 여깁니다. 시스템이 실패했다는 증거라고요. 저는 반대로 봅니다. 수동 대체 수단이 없는 연동은 애초에 완성된 적이 없습니다. 시스템이 자동화될수록, 고장 나는 날을 위한 대체 수단은 미리 적어 두어야 합니다. 자동화는 평범한 날을 처리합니다. 수동 계획은 일이 잘못되는 날을 처리합니다.
다음 고라이브 밤에는 수동 대체 수단 시트를 인쇄해서 출고 도크에 붙이세요. 절대 쓸 일이 없기를 바랍니다. 하지만 피드가 죽는 날, 그 시트가 당신의 시스템입니다.
Lin Xiao, WMS 구현 컨설턴트 지음
영어판 번역본입니다. 내용이 다를 경우 영어판을 우선합니다.








