우리 트래킹 API는 TGBU6232252에 invalid_number로 답합니다. 마지막 자리를 1로 바꾼 TGBU6232251은 Nhava Sheva에서 Long Beach 쪽으로 항해 중인 운송 구간을 돌려줍니다. 접두어는 같습니다. 오류 메시지가 하나뿐인 트래커라면 두 번호 모두에 “컨테이너를 찾을 수 없음”을 띄울 것이고, 그 밖의 많은 경우에도 똑같이 띄울 겁니다.
우리 트래킹 API 덕분에 나머지 경우도 세어 볼 수 있었습니다. 2026년 11월 8일에 한 계정에서 추적 중인 참조 번호 4,000건을 뽑았습니다. 그중 1,026건이 상태 unknown이었고, 1,011건은 시스템이 사유를 기록해 두었습니다. 일곱 가지 사유가 그중 951건을 차지합니다. 다른 58건은 다른 표시인 no_data가 붙어 있고, 2건은 첫 번째 그룹의 미확인 변형입니다. 이 건들은 뺐습니다. 여기 나오는 비율은 이 데이터 묶음에 대한 것입니다. 테스트 항목, 예를 들면 ZZ0 같은 식별자도 섞여 있습니다. 업계 전체를 말해 주는 수치는 아닙니다.
우리가 처음 시도했을 때도 제목과 똑같은 메시지가 나왔습니다. 조회 엔드포인트를 호출하면서 번호를 쿼리 문자열에 넣었더니, 정상적으로 추적되는 번호까지 포함해 모든 번호에 Container not found가 돌아왔습니다. 이 엔드포인트는 식별자를 경로에 넣어야 합니다. 같은 호출에서 번호를 경로에 넣자 작동했습니다. 그러니 “not found”는 박스가 존재하지 않는다는 뜻일 수도, 엉뚱한 곳에 물어봤다는 뜻일 수도, 박스는 있는데 아무도 보고하지 않는다는 뜻일 수도 있습니다. 아래 그룹은 큰 것부터 작은 것 순서입니다.
선사에 이 박스의 기록이 없다(1,011건 중 369건)
TFLU4505062는 “no results found at carrier side”를 돌려줬습니다. 선사는 Transfar Shipping이었습니다. UETU3269340도 같은 답을 받았습니다. 소유자는 UES Investment이고, Asian Express Shipping (Hong Kong)이 리스하고 있습니다. Triton 소유로 오프리스 처리된 TCKU3442774는 이벤트 목록이 빈 채로 왔고 추적 상태는 not_found였습니다.
이 그룹은 전체의 36.5%입니다. API는 사유 코드 carrier_no_record만 줄 뿐 원인은 주지 않습니다. 코드가 이유를 말해 주지 않으니 아래는 제 추측입니다. 부킹은 됐지만 아직 게이트인하지 않은 박스는 이벤트가 없거나, 엉뚱한 선사로 추적했거나 둘 중 하나입니다. TCKU와 UETU의 소유자 페이지에는 리스 회사인 Triton과 UES가 나와 있습니다. UETU3269340의 리스 이용자는 트래커 기록에서 나온 것입니다. 박스의 이동을 보고하는 쪽은 리스 회사가 아니라 선사이므로, UETU3269340의 부킹과 게이트인에 대한 질문은 선사나 포워더에게 해야 합니다. TCKU3442774는 오프리스로 표시되어 있으니 아예 선사가 관여하지 않을 수도 있습니다.
박스는 리스품이고 트래커는 어느 선사가 쓰는지 모른다(222건, 22%)
TGHU3855882는 체크 디지트를 통과합니다. 이 접두어는 리스 회사 Textainer 것이고, 기록상 DOLPHIN SHPG라는 선사에 리스된 박스로 나옵니다. 조회 답은 REFERENCE_NOT_RESOLVABLE, 사유는 leased_needs_reference였습니다. 연결된 선사는 없습니다.
TGBU6232251과 비교해 보세요. 이것도 Textainer이고, 이것도 리스품입니다. 여기서는 리스 회사 조회가 박스를 KMTC에 연결했고(기록에는 선사 출처가 lessor로 표시됨), API가 여정을 돌려줬습니다. 9월 19일 Nhava Sheva에서 게이트아웃, 9월 24일(UTC) XIN CHANG SHU에 선적, 10월 28일 부산(KRPUS)에서 양하, 상태는 환적 중, Long Beach 도착 예정은 12월 6일입니다. Textainer 리스 박스 두 개에 답은 두 가지였습니다.
소유자와 선사가 왜 다른 회사인지는 컨테이너 접두어 조회에서 다룹니다. 리스 박스에 가장 믿을 만한 키는 선사의 B/L 번호나 부킹 번호입니다. 이동을 보고하는 쪽이 Textainer가 아니라 선사이기 때문입니다. TGHU와 TGBU 페이지도 그렇게 안내하고, 그 번호는 포워더가 갖고 있습니다.
트래커가 선사를 식별하지 못한다(213건, 21%)
GATU1284385는 체크 디지트(5)가 맞습니다. 기록에는 소유자도, 리스 회사도, 선사도 없습니다. 접두어가 정체불명인 것은 아닙니다. Hanjin에 리스되어 있던 박스들의 소유자를 정리한 2016년 BIC 업계 경보는 GATU를 Textainer의 접두어로 올려 두었습니다. 위의 TGHU, TGBU와 같은 리스 회사입니다. 그 목록은 Hanjin의 리스 회사만 다루고, 접두어는 2016년 이후 주인이 바뀔 수 있습니다. 우리 컨테이너 접두어 레퍼런스에는 GATU 페이지가 없고, 트래커 기록에도 그 소유자는 없습니다.
우리 API의 다른 오류가 준 조언이 여기에도 아마 맞을 겁니다. “Please repeat the request specifying the shipping line SCAC code.” 하이픈이 들어간 번호를 매칭하지 못했을 때 나온 메시지이고, GATU1284385로는 시험해 보지 않았습니다. 디렉터리에 SCAC 코드가 없는 선사도 있지만, 내 선사에 코드가 있다면 SCAC 코드 목록에서 볼 수 있습니다. 트래커의 Carrier 칸에 선사를 적어 주세요. 그러면 트래커가 추측하는 단계를 건너뛸 수도 있습니다.
선사는 알지만 아무 말이 없다(100건, 9.9%)
CAIU7958630은 11월 5일에 사용자가 선사를 CMA CGM으로 지정해서 추가됐습니다. 리스 회사 CAI는 이 박스가 CMA CGM에 리스되어 있다고 올려 두었으니, 짝은 맞아 보입니다. 11월 8일 03:02 UTC의 마지막 폴링에서도 여전히 아무것도 나오지 않았습니다. 사유: line_no_info.
질문은 맞는 곳으로 갔는데 빈손으로 돌아왔습니다. 선사 자체 웹사이트를 열어서 거기서 같은 번호를 넣어 보세요. 그다음 B/L 번호로 해 보세요. CMA CGM 페이지에는 SCAC 코드(CMDU)와 이 선사 박스가 쓰는 접두어(CMAU, CMDU, CMNU)가 나와 있어서, 제대로 된 선사에 묻고 있는지 확인할 수 있습니다. 선사 사이트에서도 비어 있다면 포워더에게 전화하세요.
지난 운송 구간만 보인다(21건)
SEGU1112302는 COSCO에 고정되어 있고 11월 3일부터 사유가 previous_trip_only입니다. TEXU2209771도 11월 1일에 설정된 같은 사유이고, 기록에는 아직 KUO LUNG이라는 선명과 2026년 7월 27일의 도착 예정일이 남아 있습니다. 마지막 폴링은 11월 7일이었습니다.
컨테이너 하나는 같은 번호로 여러 번 운송 구간을 오갑니다. 번호만으로 조회하면 이전 구간에 걸릴 수 있습니다. 새 구간이 안 보이는 이유는 데이터에 나와 있지 않습니다. 새 화물을 기다리는 중이라면 새 부킹이나 B/L로 추적하세요. COSCO 페이지에 SCAC 코드(COSU)가 있습니다.
번호가 틀렸다(20건)
TGBU6232252는 invalid_number로 돌아왔습니다. 왜일까요? 체크 디지트는 열한 번째 문자입니다. 앞의 열 문자로 계산합니다. 각 문자에 값을 매기는데 A는 10부터 시작하고 11의 배수는 건너뜁니다. 각 자리에는 2⁰부터 시작하는 2의 거듭제곱으로 가중치를 주고, 합을 11로 나눈 나머지가 10이면 0으로 칩니다. ISO 6346 표준에 그렇게 정리되어 있습니다. TGBU623225의 합은 4,049이고, 4,049를 11로 나눈 나머지는 1입니다. 그래서 TGBU6232251은 유효하고 TGBU6232252는 유효하지 않습니다. BIC 체크 디지트 계산기는 소유자 코드와 일련번호를 넣으면 체크 디지트를 계산해 줍니다.
이 잘못된 번호는 첫 호출에서 답을 받기까지 46초가 걸렸습니다. 반복 호출은 0.6초였습니다. 틀린 숫자라고 해서 늘 빨리 거절당하는 것은 아닙니다.
형식이 나머지 절반입니다. tgbu6232251과 TGBU 6232251은 둘 다 박스를 찾았지만, 하이픈이 들어간 TGBU-6232251은 “could not find tracking data”로 돌아왔습니다. 번호는 컨테이너 문이나 B/L에서 그대로 옮겨 적으세요. O와 0, I와 1을 헷갈리지 않게 보세요. 이 확인부터 하세요. 1분이면 됩니다. 그다음 접두어 페이지를 읽고 리스 박스인지 보세요.
선박 이름이 아직 없다(6건)
TRDU9288422는 9월 18일에 추가됐습니다. 사유 awaiting_vessel_tbn은 9월 21일부터 그대로입니다. TBN은 “to be nominated”, 즉 아직 배가 지정되지 않았다는 뜻입니다. 코드가 알려 주는 것은 그게 전부입니다. 제가 조회했을 때는 호출이 45초 동안 멈춰 있다가 STILL_RESOLVING이 돌아왔고, 60초 뒤에 다시 시도하라는 지시가 담긴 202였습니다.
11월 8일이 되자 이 사유는 48일째였습니다. 얼마나 지나면 너무 긴 것인지는 데이터에 나와 있지 않으니, 포워더에게 지정 날짜를 물어보세요. 그동안 운항 스케줄에서 그 항로에 어떤 선박이 다니는지 볼 수 있습니다. 202를 받았나요? 60초를 기다리세요. 깔끔하게 조회하려면 번호를 Navo 트래커에 붙여 넣고, 선사를 안다면 함께 넣으세요. 같은 데스크에 해상 운임과 적재 계산기도 있습니다. 많은 박스를 손으로 추적하는 팀은 감시를 Nav 에이전트나 AI 어시스턴트 중 하나에 맡길 수 있고, Navo Mesh는 물류를 위한 작업 거래소입니다. 문의는 문의 페이지로 보내 주세요.
자주 묻는 질문
유효해 보이는 번호인데 트래커가 컨테이너를 찾을 수 없다고 하는 이유는 무엇인가요?
번호가 체크 디지트를 통과해도 아무 결과가 안 나올 수 있습니다. 2026년 11월 8일에 뽑은 우리 데이터에서 가장 흔한 원인은 선사에 이 박스의 기록이 없는 경우(1,011건 중 369건)였고, 그다음은 선사를 알 수 없는 리스 박스(222건)였습니다. 부킹은 포워더에게 확인하세요.
컨테이너 번호가 틀렸다고 판단하기까지 얼마나 기다려야 하나요?
오래 기다릴 필요 없습니다. 그 번호가 존재할 수 있는지는 체크 디지트로 1분이면 알 수 있습니다. 통과했다면 기다리는 시간은 화물에 따라 다릅니다. 게이트인이나 선박 지정 전에는 이벤트가 전혀 없을 수도 있습니다. 우리 데이터에는 선박 지정 사유가 48일 동안 붙어 있던 박스가 하나 있었습니다.
컨테이너 번호 대신 B/L 번호나 부킹 번호로 추적할 수 있나요?
네, 리스 박스에는 대개 그쪽이 더 나은 키입니다. 우리 조회는 컨테이너 번호, B/L 번호, 부킹 번호를 모두 받습니다. 선사는 자기 번호로 이동을 보고하므로, 부킹 번호를 쓰면 트래커가 올바른 시스템을 보게 됩니다.