본문으로 건너뛰기
Nextflow

위탁배송 자동화 연동 실패 이유 — 처음 설정할 때 놓치는 3가지

주문 자동화를 도입했는데 첫날부터 오류가 났다면, 대부분 3가지 설정을 빠뜨린 경우다. 판매 채널 API 권한, 공급처 발주 채널 불일치, 송장 회신 경로 미설정이 가장 흔한 원인이다.

Nextflow 팀 · 2026.03.28

연동 후 테스트 주문은 들어오는데 발주가 나가지 않거나 송장이 반영되지 않는다면 API 권한, 발주 전달 경로, 송장 회신 설정을 확인한다. 초기 설정에서 빠뜨리기 쉬운 3가지 항목이다.

1. 판매 채널 API 권한 — 주문 읽기와 발주 실행은 다른 권한이다

스마트스토어, 쿠팡, 11번가 모두 API 권한을 단계별로 분리한다. 주문 내역을 읽는 권한만 있으면 주문 목록은 불러올 수 있지만, 발주 상태 업데이트나 송장 입력은 별도 실행 권한이 필요하다.

초기 설정 시 가장 자주 빠뜨리는 항목은 아래와 같다.

채널 자주 빠지는 권한 증상
스마트스토어 주문 처리(발주확인·배송처리) 권한 주문 목록은 보이지만 상태 변경 불가
쿠팡 Wing Wing API 발주 승인 권한 발주 요청이 들어가지 않음
11번가 배송 처리 API 권한 송장 입력 오류 반복

연동 후 바로 테스트 주문을 넣어 보는 게 확인 방법이다. 주문은 들어오지만 발주 확인이 안 된다면 권한 재설정이 필요하다.

2. 공급처 발주 채널 불일치 — 자동화와 수동 발주 채널이 섞이면 중복이 난다

자동화를 도입한 뒤에도 기존 수동 발주 루틴을 완전히 끄지 않으면, 같은 주문에 발주가 두 번 나가는 상황이 생긴다. 특히 공급처마다 발주 채널이 다를 때(이메일 공급처 A, 발주 시스템 공급처 B) 자동화 설정에서 채널을 혼용하면 발주 누락 또는 중복이 함께 발생한다.

확인 방법: 자동화 도입 첫 주는 공급처별로 발주 채널 1개만 활성화하고, 나머지는 비활성화한다. 발주 이력 기록(엑셀 또는 시트)에 자동/수동 구분 컬럼을 추가해 중복 여부를 일별로 체크한다.

발주 채널 정리가 되어 있지 않은 상태에서 자동화를 켜면 병목 진단 시트에서도 ‘발주 처리 지연’ 항목이 반복적으로 나온다.

3. 송장 회신 경로 미설정 — 자동화가 송장을 받을 위치를 모른다

발주 자동화가 잘 돌아가더라도 공급처가 송장을 돌려주는 방식이 설정되어 있지 않으면 마지막 단계(스토어 송장 입력)에서 막힌다. 공급처 송장 회신 방식은 크게 3가지다.

회신 방식 자동화 설정 필요 항목 놓치기 쉬운 포인트
이메일 회신 수신 메일 주소 + 파싱 규칙 공급처마다 송장 파일 형식이 다름
포털 시스템 입력 포털 로그인 API 또는 스크래핑 경로 포털 UI 변경 시 파싱 오류
엑셀 파일 공유 파일 경로 + 열 매핑 열 이름이 공급처마다 다를 수 있음

이메일로 송장을 받는다면 수신 메일 계정과 자동화 도구를 연결해야 한다. 연결하지 않으면 메일이 와도 스토어에 반영되지 않는다. 설정 전 공급처의 회신 방식부터 확인한다.

자동화 설정 전에 확인할 것

연동 실패를 줄이려면 툴을 연결하기 전에 아래 3가지를 먼저 확인한다.

  1. 판매 채널 API 권한 목록 — 발주·송장 입력 권한이 포함되어 있는지
  2. 공급처별 발주 채널 목록 — 어떤 공급처가 어떤 방식으로 발주를 받는지
  3. 공급처별 송장 회신 방식 — 이메일/포털/파일 중 어느 방식인지, 형식은 무엇인지

이 3가지가 정리된 상태에서 연동을 시작하면 초기 오류 빈도가 크게 줄어든다. 현재 운영 중인 주문 처리 흐름에서 어느 단계가 수작업으로 남아 있는지 먼저 파악하고 싶다면 자동화가 필요한 시점 판단 가이드를 먼저 확인하는 것도 도움이 된다.

관련 진단 도구: 주문·송장 수작업 병목 진단 시트 — 현재 처리 흐름에서 수작업이 몰리는 구간을 먼저 파악할 수 있다.

자동화 설정 전 하루 주문 처리 루틴을 정리해 두는 것도 설정 시 놓치는 항목을 줄이는 방법이다.

발주 자동화 설정 단계도 함께 확인하세요
연동 실패 원인을 파악했다면 위탁배송 발주 자동화 설정 3단계에서 공급처별 전달 방식 설정 순서를 확인해 보세요.