Shopify 다중 운송장 이관: trackingNumber가 배열을 가리는 경우
복수 운송장 기능을 켜도 옛 단수 필드가 요청에 남아 있으면 일부 번호를 잃을 수 있다.
새 필드를 붙이기 전에 옛 필드를 확인한다
단수와 복수 운송장 필드를 함께 보내면 단수 필드가 우선한다. 다중 포장 주문의 이전 매핑을 먼저 제거해야 번호 목록을 보존할 수 있다. 원천 시스템에 두 포장이 있는데 이관된 주문에 번호가 하나만 보여도 주문 생성 자체는 성공했을 수 있다. 성공 건수만으로는 고객에게 전달할 추적 정보의 완전성을 설명하지 못한다. [1, 2, 3]
공식 우선순위가 설명하는 누락
Shopify의 2026년 8월 3일 공지는 2026-10부터 OrderCreateFulfillmentInput에 trackingNumbers 배열을 지원한다고 안내한다. trackingNumber와 trackingNumbers를 함께 제공하면 단수 값이 쓰이고 배열은 무시된다. trackingCompany는 배열의 모든 번호에 적용된다. 따라서 서로 다른 운송 회사의 번호를 한 배열로 합치는 문제와 단수·복수 필드 충돌은 따로 확인해야 한다. [1]
포장 단위의 원천과 결과를 대조한다
주문 이관 담당자는 원천 포장별 운송장 집합과 생성 결과를 대조하고, 누락되면 단수 필드가 남은 요청 매핑을 고친 뒤 해당 주문을 다시 확인한다. 비교 범위는 같은 주문의 같은 fulfillment로 고정한다. 원천 목록과 실제 전송 payload를 함께 보관해야 잘못된 추출인지 요청 생성 단계의 충돌인지 나눌 수 있다. [1, 3]
두 번호를 한 번호로 줄인 반례
설명용 원천 포장 번호를 PKG-A와 PKG-B로 정하면 기대 집합은 PKG-A|PKG-B다. 생성 결과도 두 번호를 포함하면 번호 보존 조건은 통과한다. PKG-A만 남으면 주문 건수가 같아도 PKG-B의 추적 정보를 잃은 것이다. 번호 개수만 비교하면 다른 번호로 바뀐 경우를 놓치므로 실제 값 전체도 대사한다. 세로줄 표기는 예시의 정렬 표현일 뿐이며 운영에서는 구분자 충돌이 없는 정규화를 사용한다. [1, 3]
검사 결과를 배송 완료로 확대하지 않는다
Truthound Core 3.3.2의 ColumnPairValidator로 외부에서 정규화한 기준 집합과 관측 집합을 비교할 수 있다. 결측 쌍은 건너뛰므로 입력 존재 여부도 따로 검사한다. 결과는 번호 보존의 근거이며 번호의 진위나 배송 완료를 증명하지 않는다. 요청 생성기에서 단수 필드 사용을 종료하거나 공식 fulfillment 갱신 경로를 검토하되, 이 예 자체가 실제 주문을 생성·수정한 증거는 아니다. [1, 2, 3]
적용 조건
2026-10 이상에서 수입할 주문의 원천 포장 목록이 확정되어 있어야 하며, 동일 fulfillment와 운송 회사 범위에서 두 집합을 결측 없이 대조한다.
대안
요청 생성기에서 단수 필드 사용을 명시적으로 종료하고, 필요한 경우 공식 fulfillment 갱신 경로로 누락 번호를 처리한다.
한계
운송장 집합 일치는 배송 완료를 뜻하지 않는다. trackingCompany는 배열 전체에 적용되므로 서로 다른 운송 회사의 포장을 임의로 한 배열에 넣지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
