Styxis
Company
Knowledge

Shopify 복수 바코드 수정: 추가 요청처럼 보이는 전체 집합 교체

새 barcodes 입력에 추가할 값만 보내면 기존 식별자가 사라질 수 있다. 전체 목록과 첫 항목의 호환성을 따로 확인한다.

한 식별자를 더하는 작업의 숨은 범위

barcodes 쓰기는 추가가 아니라 전체 집합 교체다. 유지할 식별자까지 포함한 승인 목록을 요청 전에 만들어야 한다. 상품 담당자는 새 판매 채널의 번호만 추가하려 했는데 ERP가 사용하던 번호를 잃을 수 있다. 변경 화면에서 새 값이 보인다는 사실은 유지해야 할 값이 남았다는 증거가 아니다. [1, 2, 3]

전체 집합과 첫 번째 값의 역할

Shopify의 2026-10 공지는 복수 바코드 조회·입력을 소개하며 barcodes를 보내면 전체 집합이 교체된다고 설명한다. 기존 barcode 필드는 첫 항목을 반환하고, 단수 필드로 쓰면 첫 항목을 갱신하면서 나머지는 유지한다. 한 입력에 두 필드를 동시에 설정할 수 없다. 두 번째 바코드가 생겨도 단수 필드만 읽는 통합에는 다른 번호의 존재가 보이지 않을 수 있다는 점도 공지한다. [1]

쓰기 전의 승인 목록과 쓰기 후의 실재 목록

상품 연동 담당자는 원천의 유지·추가·삭제 의도를 명시한 전체 바코드 목록을 승인받고, 저장 후 목록과 첫 번째 식별자가 예상대로 남았는지 확인한다. 같은 variant의 연결을 끝까지 읽어 대조하고, 첫 항목을 소비하는 시스템은 별도 목록으로 관리한다. 읽기와 쓰기 사이에 다른 작성자가 수정할 수 있다면 경쟁 방지 절차도 필요하다. 데이터 비교가 동시 갱신 자체를 막지는 않는다. [1, 3]

가상 식별자 두 개로 보는 교체 반례

설명용으로 기존 CODE-A를 유지하면서 CODE-B를 추가한다고 승인한다. 표준 타입을 지정하지 않은 가상 문자열이며 기대 집합은 CODE-A|CODE-B다. 저장 후 두 값이 모두 있으면 집합 보존 조건은 통과한다. CODE-B만 남으면 추가할 값만 보낸 전체 교체가 CODE-A를 지운 것이므로 ERP 동기화를 보류한다. 두 값이 있어도 첫 항목이 바뀌면 단수 소비자에게 다른 번호가 보일 수 있어 순서 호환성은 따로 확인한다. [1, 3]

집합 검사와 바코드 진위를 분리한다

Truthound Core 3.3.2의 ColumnPairValidator로 완전하게 정규화한 승인·관측 집합을 비교할 수 있다. 결측 쌍을 건너뛰므로 필수값 확인이 선행되어야 한다. 이 검사만으로 바코드 표준의 체크디지트나 실제 상품 연결의 진위를 보증하지 않는다. 정렬 집합은 첫 항목의 의미도 잃으므로 대표 식별자는 별도 비교한다. 전체 교체 방식에 맞는 목록 구성과 승인 절차를 마련한 뒤 데이터 검사를 연결하는 순서가 필요하다. [1, 2, 3]

적용 조건

2026-10 API의 단수·복수 입력을 동시에 보내지 않고, 전체 연결을 끝까지 읽어 같은 variant의 정규화된 집합을 대조한다. 표준별 형식 검증과 집합 보존은 분리한다.

대안

변경 전 전체 목록을 읽어 승인된 변경분을 반영한 뒤 전체 교체하고, 첫 항목을 소비하는 시스템은 별도 호환성 시험을 거친다.

한계

  • 집합 일치는 바코드가 실제 상품을 올바르게 가리킨다는 보증이 아니다. 정렬한 집합만으로 기존 barcode 필드가 반환하는 첫 항목의 유지도 증명할 수 없다.

근거

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