인디고가 품절을 알리는 기준과 맞았는지 보는 방법

2026-11-05 · 로커스코리아 인디고 팀

인디고 에이전트는 창고·쇼핑몰 시스템의 재고와 주문을 읽어서 품절과 송장 누락을 메신저로 알립니다. 이 글에는 무엇을 읽는지, 어떤 알림을 언제 보내는지, 보낸 알림이 맞았는지 어떻게 따지는지를 적습니다. 기준이 바뀌면 이 페이지를 고칩니다.

1. 무엇을 읽나요

상품별 가용 재고, 일별 출고(판매) 수량, 입고 예정과 입고 완료, 송장 등록 여부를 읽습니다.
조회 전용 키로만 읽습니다. 주문이나 재고를 바꾸는 기능은 없습니다.
사방넷 풀필먼트는 약 15분, 쇼핑몰·OMS·ERP는 약 1시간마다 읽습니다. 파일은 올릴 때, 구글 시트는 시트가 바뀔 때 읽습니다. 한 번 놓치면 다음 회차에 다시 읽습니다.

목록에 올린 시스템 430개 중 연결 코드를 만든 것은 211개입니다.

상태	개수	내용
운영 중	1	사방넷 풀필먼트. 로커스코리아 풀필먼트 센터 데이터로 매일 돌고 있습니다.
실데이터로 확인	2	구글 시트·CSV 파일, JSON 주소
코드만 있음	208	공개 API 문서를 보고 만들었고, 실제 고객 계정으로는 아직 확인하지 않았습니다. 첫 연결 때 같이 확인합니다.

연결이 없는 시스템은 엑셀·CSV 파일로 시작할 수 있습니다.

인디고는 두 가지를 나눠서 다룹니다.

이미 품절: 창고가 가용 재고 0을 실제로 돌려준 상품입니다. 조회한 사실이라 바로 알립니다.
품절 임박: 지금 재고를 최근 하루 평균 출고로 나눠 남은 일수를 계산한 값입니다. 앞으로의 판매와 입고에 따라 달라지는 추정이라, 근거 숫자를 같이 적고 "추정"이라고 표시합니다.

주말 출고가 평일보다 훨씬 적은 센터에서는 달력일 평균을 쓰면 월요일엔 급증, 주말엔 급감처럼 보이는 일이 생깁니다. 영업일 기준 계산을 시험하고 있고, 아직 운영 규칙에는 넣지 않았습니다.

사방넷 풀필먼트로 연결된 화주사 대화방 기준입니다(2026-11-05). 다른 시스템은 아직 운영 기록이 없습니다.

수시(08:40~21:00): '이미 품절'과 '24시간 넘은 송장 미등록'만 보냅니다. 이미 품절은 창고 가용 재고 0이 실제로 조회됐고, 최근 7일 안에 팔린 상품이고, 재고 조회가 30분 안일 때만 보냅니다. 같은 건은 하루 한 번만 보냅니다.
매일 08:30: 어제 마감 숫자와 확인할 품목을 보냅니다. 남은 일수는 "가용 42개 · 하루 평균 18개 · 약 2.3일 (추정)"처럼 근거 숫자와 함께 추정이라고 적습니다.
'2일 안 품절' 같은 예측은 실시간으로 보내지 않습니다. 추정이라 담당자가 아침에 한꺼번에 보고 판단하는 편이 낫다고 봤습니다.
로커스 내부 운영방은 담당자가 매일 보는 방이라 품절 임박까지 실시간으로 받습니다.

D일 아침 판단에는 D−1일까지의 데이터만 씁니다. 맞았는지는 그 뒤의 실제 판매와 재고로 봅니다.
2026-11-06부터 매일 아침, 전날 판단을 일별 재고 스냅샷과 맞춰 봅니다. 판정한 건수, 맞은 건수, 그 사이 입고로 다시 채워진 건을 따로 셉니다.
알림을 받은 담당자가 입고를 당겨 품절을 막았다면 알림이 틀린 것과 구분이 안 됩니다. 그래서 입고로 채워진 건은 맞음·틀림 판정에서 따로 둡니다.
과거 데이터로도 같은 방식으로 돌려 보며 기준을 고르고 있습니다. 결과는 내부 기준을 정하는 데 쓰고 있습니다.

지금까지의 기록은 한 회사(로커스코리아) 풀필먼트 센터 화주 32곳의 데이터입니다. 다른 업종이나 다른 창고에서 같은 결과가 나온다는 근거는 없습니다.
재고 이력은 2026-11-04 스냅샷부터만 있습니다. 그 전 재고는 판매와 입고를 거꾸로 빼서 복원한 값이라 오차가 있습니다.
출고 지연 알림은 과거 주문 접수·출고 시각 기록이 없어 검증하지 못했습니다.

문의: cs@locuskorea.kr