Shopify 복수 송장 검수, 번호와 추적 링크가 바뀌었는지 확인하는 법
Shopify 출고 한 건에 송장이 여러 개라면 번호와 추적 링크를 소포별로 대조하세요. 배열 위치가 뒤바뀌는 경우부터 운송사 자동 링크와 고객 알림까지 인수 검수표로 정리합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
2026-11-17 확인한 Shopify API 2026-10 기준, 복수 송장의 번호와 링크를 같은 순서로 맞춥니다. 자동 링크도 소포별로 열어 확인합니다.
주문 하나를 두 상자로 보냈다고 가정해 봅시다. 주문 화면에 송장이 두 개 있고 링크도 두 개 열립니다. 그런데 첫 번째 송장을 누르면 두 번째 상자가 나옵니다. 창고 파일을 번호순으로 정렬한 뒤 링크 열을 이전 순서로 붙이면 이런 결과가 생길 수 있습니다. 인수할 때는 링크가 열리는지에 더해, 열린 화면이 누른 송장의 소포를 보여 주는지 확인합니다.
알파카랩스가 작성했으며 본문에 자사 서비스 안내를 포함합니다. Shopify GraphQL Admin API 2026-10 문서를 2026년 11월 17일에 확인했습니다. 아래 번호와 추적 주소는 검수 설계를 위한 가상 예시입니다.
Shopify는 번호와 링크를 어떻게 짝짓나요?#
복수 송장의 번호는 numbers, 링크는 urls에 넣습니다. Shopify는 두 배열의 같은 위치에 있는 값을 짝짓습니다. 링크를 명시하면 Shopify가 운송사 이름이나 번호 형식으로 링크를 생성하는 방식보다 우선합니다. 지원 운송사 이름으로 자동 생성할 경우 같은 운송사를 모든 번호에 적용합니다. Shopify FulfillmentTrackingInput 공식 문서
보낼 대상을 고를 때는 주문 번호와 출고 건을 함께 봅니다. fulfillmentTrackingInfoUpdate의 fulfillmentId는 추적 정보를 바꿀 출고 건의 ID입니다. 같은 주문 안에 출고 건이 여럿이면 어느 출고 건의 소포인지 구분한 뒤 요청하세요. 검수 기록에는 출고 ID, 소포별 원천 번호와 링크, 전송값, 응답의 trackingInfo와 userErrors를 남깁니다. Shopify 추적 정보 수정 공식 문서
소포별 링크는 어떻게 검수하나요?#
창고에서 받은 번호와 링크를 소포별 한 행에 묶습니다. 요청을 만들 때 한 행 목록에서 두 배열을 뽑고, 요청이나 저장 결과를 원천 행과 대조합니다. 정렬이 필요하면 행 전체를 움직입니다. 아래는 대상 출고 건을 골랐다고 가정한 trackingInfoInput 예시입니다.
{
"numbers": ["DEMO-A", "DEMO-B"],
"urls": [
"https://carrier.example/track/DEMO-A",
"https://carrier.example/track/DEMO-B"
]
}
아래 표는 2026-11-17에 확인한 API를 기준으로 만든 가상 검수표입니다.
| 검수 입력 | 합격 또는 보류 기준 | 확인 근거 |
|---|---|---|
| 번호와 명시 URL이 모두 일치 | 합격. 두 번호 모두 자기 소포의 링크를 엽니다. | 표본 원천 행과 주문 화면 |
| 링크 배열만 반대로 정렬 | 보류. 두 배열 길이가 같아도 송장과 링크가 뒤바뀝니다. | 번호별 예상 주소와 저장된 주소 |
| Shopify 지원 여부를 확인하지 않은 운송사의 URL 한 건 누락 | 보류. 모든 번호의 명시 링크를 채웁니다. | 배열 길이와 누락된 소포 행 |
| 모든 소포가 같은 지원 운송사이며 URL 생략 | 생성 링크가 각 소포를 열면 합격입니다. | 응답에 저장된 링크와 테스트 운송사 화면 |
| 같은 출고 건에 여러 운송사 사용 | 공통 운송사 이름을 생략한 설계에서 소포별 명시 링크를 대조합니다. | 소포별 운송사와 예상 링크 |
| 같은 주문의 다른 출고 ID 지정 | 보류. 원천 소포가 속한 출고 건을 다시 확인합니다. | 원천 출고 ID와 응답 출고 ID |
| 응답에 사용자 오류가 있음 | 보류. 오류 내용을 확인하고 출고 건을 다시 조회합니다. | userErrors와 재조회 결과 |
| 고객 알림을 보내는 변경 | 별도 검수. 테스트 수신자에게 전달된 번호와 링크를 대조합니다. | 테스트 메일과 주문 화면 |
주소에서 송장 번호가 보이지 않는 링크도 있습니다. 이때는 URL 문자열에 번호가 들어 있는지로 판정할 수 없습니다. 검수용 운송사 화면이나 테스트 환경에서 열어 원천에 기록된 소포와 대조합니다. 번호와 링크를 정확히 저장하는 일과 링크가 실제로 추적 결과를 열어 주는 일은 검수 기록에서 각각 확인합니다.
자동 생성 링크와 고객 알림은 언제 따로 확인하나요?#
운송사 자동 링크는 소포마다 열어 확인하고, 고객 알림은 실제 고객에게 발송되지 않는 환경에서 별도로 검수합니다.
모든 소포를 Shopify 지원 운송사 한 곳이 맡으면 공식 목록의 이름을 대소문자까지 맞춰 입력하고, 주문 화면에서 생성 링크를 열어 확인합니다. 번호 형식으로 운송사를 추정하면 비슷한 형식을 쓰는 다른 업체에 잘못 연결될 수 있다고 Shopify는 설명합니다. 지원 여부가 불확실하면 각 번호에 명시 링크를 준비합니다. 출고 건마다 송장이 하나면 number와 url로 대조합니다. 공식 문서는 같은 요청에서 번호나 링크의 단수형 필드와 복수형 필드를 함께 보내지 않도록 안내합니다. Shopify 운송사 이름과 링크 생성 규칙
notifyCustomer에 true를 넣으면 Shopify는 이번 수정에 추적 정보가 담긴 배송 업데이트 이메일을 보냅니다. 해당 출고 건의 이후 업데이트도 고객 알림 대상에 포함합니다. 이 필드를 생략하면 출고 건을 업데이트할 때 고객 알림을 보내지 않는다고 공식 문서는 안내합니다. 데이터 매핑을 확인한 다음, 발송이 필요한 경우 테스트 수신자로 메일을 검수합니다. Shopify 고객 알림 인자
이 글의 합격 기준은 송장과 링크의 연결입니다. 도착 여부를 집계할 때는 분할 배송의 완료 검수에 나온 배송 단위와 완료 증거를 사용합니다. 현황을 읽는 화면과 외부 시스템에 쓰는 연동의 범위는 SCM 운영대시보드 개발 안내에서 확인할 수 있습니다.
기준 문서와 확인 날짜#
- Shopify 2026-10 릴리스 노트. API 버전 공개 2026-10-01, 확인 2026-11-17.
- Shopify FulfillmentTrackingInput과 Shopify fulfillmentTrackingInfoUpdate. 출고 ID, 입력 필드, 링크 매칭과 고객 알림을 확인한 공식 문서입니다. 개별 문서 게시일 미표기, 확인 2026-11-17.
- 알파카랩스 API 연동 개발 안내. 데이터 매핑과 표본 검수의 공개 서비스 범위를 확인했습니다. 게시일 미표기, 확인 2026-11-17.
API 버전이나 출고·운송사 매핑이 바뀌면 같은 소포 표본으로 다시 검수합니다.
자주 묻는 질문#
Shopify 복수 송장에서 추적 링크의 순서는 중요한가요?
번호 배열과 링크 배열의 같은 위치가 한 쌍이 됩니다. 정렬할 때 소포 행 전체를 이동한 뒤 두 배열을 만들고, 화면에서 번호별로 예상했던 소포가 열리는지 확인합니다.
모든 송장에 URL을 꼭 넣어야 하나요?
Shopify가 지원하는 운송사 이름을 넣으면 그 운송사가 전체 번호에 적용되며 링크를 자동 생성할 수 있습니다. 지원 운송사를 지정하지 않는다면 모든 번호의 URL을 제공하는 것이 공식 문서의 안내입니다.
한 출고 건에 운송사가 여러 곳이면 어떻게 하나요?
명시한 링크를 소포마다 대응시키고 화면에서 번호별로 열어 확인하세요. 운송사를 지정하는 company 입력값은 출고 건 안에서 하나를 공유합니다.
API가 값을 돌려주면 검수에 합격한 건가요?
업데이트된 출고 ID와 번호·링크의 짝, 사용자 오류를 확인한 뒤 원천과 비교합니다. 링크 목적지와 테스트 알림은 고객이 보는 화면에서도 확인합니다.
송장 링크가 열리면 배송 완료인가요?
추적 링크는 배송 조회 경로입니다. 배송 완료를 집계할 때는 각 배송 단위에 배송 완료 증거가 있는지 별도로 확인합니다.
인수표에 넣을 소포 표본을 고르세요#
한 출고 건에 속한 비식별 소포 표본을 골라 출고 ID, 송장 번호, 기대 링크를 한 행씩 적어 보세요. 링크의 연결이 올바른 화면을 어디에서 확인할지 같이 적으면 인수 기준으로 쓸 수 있습니다.
번호와 추적 링크의 인수 기준을 정리합니다
첫 범위 협의에서 비식별 소포 표본과 주문 화면을 대조해 번호·추적 링크·알림 검수표 초안을 정리합니다. 소요 시간은 대상 출고와 화면 범위를 확인한 뒤 안내합니다.
복수 송장 검수표 초안 협의