Styxis
Company
Knowledge

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는 배열 전체에 적용되므로 서로 다른 운송 회사의 포장을 임의로 한 배열에 넣지 않는다.

근거

사건 확인일
대상 확인일
수정일