SCM API 식별자 검수, 숫자가 같으면 같은 품목일까
SCM 연동에서 상품·재고 ID의 숫자만 남기면 다른 객체가 합쳐질 수 있습니다. Shopify GID의 타입·부모 매개변수·조회 관계를 표본으로 대조해 ERP 품목 연결 보류 기준을 정리합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
SCM 연동은 전체 GID와 객체 관계를 보존해 검수합니다. 2026-11-22 확인 기준, 타입 없는 숫자 ID의 연결은 보류합니다.
쇼핑몰 상품 ID와 재고 ID가 모두 숫자로 끝납니다. 통합 화면에서 숫자만 남겨 같은 품목으로 묶었다면, 원래 서로 다른 객체가 하나로 합쳐질 수 있습니다. 화면의 품목 수가 맞아도 연결이 맞았다고 판단하기 어렵습니다.
이 글은 Shopify 공개 문서의 GID 형식을 예로 들어 통합 키 변환에서 객체 구분이 보존되는지 확인합니다. 등장하는 ID·SKU·연결 관계는 가상 설계 예시이며 실제 고객 데이터나 납품 사례가 아닙니다. 통합 조회를 인수하는 담당자는 아래 표에 자신의 원천 응답과 ERP 품목 연결 규칙을 대입할 수 있습니다.
API 식별자는 어디까지 보존해야 하나요?#
조회 응답의 전체 GID를 보존하고, 원천 연결과 객체 타입을 함께 기록합니다. 재고 객체를 찾을 때는 응답에 있는 관계를 따라갑니다. 상품 ID의 타입 문자열만 바꿔 재고 ID를 추정하지 않습니다.
Shopify Global IDs 공식 문서는 gid://shopify/{object_name}/{id} 형식을 설명합니다. 따라서 가상의 Product/101과 ProductVariant/101은 숫자 부분이 같아도 서로 다른 타입의 식별자입니다. 원문에서 숫자만 잘라 저장하면 구분에 필요한 타입이 사라집니다.
부모 매개변수가 있는 객체도 있습니다. 공식 예시의 gid://shopify/InventoryLevel/123?inventory_item_id=456에는 재고 객체를 가리키는 매개변수가 포함됩니다. ? 뒤를 불필요한 URL 추적값처럼 지우면 안 됩니다. 업무 키로 쓰는 변환 전에 원문 식별자를 남겨야 손실 여부를 대조할 수 있습니다.
상품과 재고를 연결하는 담당자는 ProductVariant.inventoryItem로 조회되는 재고 객체 ID를 확인합니다. ERP 품목과 연결하는 담당자는 그 뒤에 별도의 업무 매핑을 둡니다. GID가 다르다는 판정과 ERP에서 같은 품목군으로 묶겠다는 정책은 각각 기록합니다.
코드의 전각·반각 처리 문제는 SCM 품목 코드 유니코드 정규화 검수, 긴 숫자가 바뀌는 문제는 SCM 주문번호 정밀도 검수에서 다룹니다. 이번 글은 값의 문자 모양보다 객체 타입과 부모 조건이 사라지는 변환을 봅니다.
어떤 표본을 같은 조건으로 대조하나요?#
전체 식별자를 보존한 결과와 일부를 잘라 만든 결과를 같은 입력에서 비교합니다. 연결 표본에는 실제 응답에서 확인할 관계와 추정한 관계를 나란히 적습니다. 단순히 키 개수가 같다는 이유만으로 관계까지 통과시키지 않습니다.
아래는 2026-11-22에 Python으로 실행한 가상 8조건입니다. Product와 ProductVariant에는 설명용 숫자 101, 조회된 InventoryItem에는 901, 같은 SKU의 다른 재고 객체에는 902를 배정했습니다. InventoryLevel은 123이라는 경로와 서로 다른 부모 456·789를 조합했습니다. 이 ID들이 실제 Shopify 객체로 존재한다는 뜻은 아닙니다.
| 가상 입력·변환 조건 | 로컬 관측 결과 | 제안 인수 판정 |
|---|---|---|
| 타입이 다른 전체 GID | 서로 다른 객체 2개 | 전체 GID 보존 |
| 타입을 버리고 숫자만 저장 | 키 1개로 충돌 | 변환 거부 |
| InventoryLevel 매개변수 유지 | 서로 다른 키 2개 | 매개변수 포함 보존 |
| InventoryLevel 매개변수 제거 | 키 1개로 충돌 | 변환 거부 |
| 조회 응답의 재고 객체 연결 | InventoryItem/901 확인 | 응답 관계로 연결 |
| 상품 변형 ID의 타입만 치환 | 조회된 재고 ID와 불일치 | 추정 연결 보류 |
| 같은 SKU의 서로 다른 재고 객체 | 후보 2개 | ERP 품목 연결 보류 |
| 같은 재고 객체의 REST ID 대조 | 전체 GID와 일치 | 타입과 출처 함께 기록 |
매개변수 손실은 다음 최소 코드로 재현합니다. 첫 출력은 전체 문자열의 서로 다른 키 수이고, 다음 출력은 매개변수를 제거한 키 수입니다. 문자열이 합쳐지는 것을 보여주는 코드이며 API 식별자의 정당성을 검사하는 검증기는 아닙니다.
ids = [
"gid://shopify/InventoryLevel/123?inventory_item_id=456",
"gid://shopify/InventoryLevel/123?inventory_item_id=789",
]
print(len(set(ids))) # 2
print(len({value.split("?", 1)[0] for value in ids})) # 1
관계 표본에서 상품 변형의 id는 gid://shopify/ProductVariant/101, 같은 응답의 inventoryItem.id는 gid://shopify/InventoryItem/901로 두었습니다. 타입 이름만 치환한 InventoryItem/101은 조회된 InventoryItem/901과 다릅니다. 실제 인수에서도 전체 ID를 보존한 뒤 응답 관계와 연결 결과를 대조합니다.
숫자나 SKU를 쓰면 항상 잘못인가요?#
이미 객체 타입과 그 객체의 REST ID를 알고 있다면 공식 형식에 따라 GID를 구성할 수 있습니다. 같은 재고 객체에서 확인한 legacyResourceId를 대응시키는 경우가 여기에 해당합니다. 타입을 모르는 숫자나 다른 객체의 숫자로 관계를 발명하는 경우는 연결을 보류합니다.
SKU를 업무 품목 코드로 운영하는 경우에도 원천의 유일성 조건을 먼저 확인합니다. InventoryItem 공식 문서는 같은 SKU를 공유하는 재고 객체 수를 설명하는 duplicateSkuCount를 제공합니다. SKU가 같다는 사실만으로 API 객체까지 하나라고 가정하지 않습니다.
반대로 전체 GID가 있다고 모든 검수가 끝나는 것도 아닙니다. ID만으로 접근 권한·현재 존재·응답 완전성이나 ERP 품목 매핑의 적정성이 확인되지는 않습니다. 관계 조회에 실패했다면 빈 연결을 추정값으로 채우지 않고 보류 사유를 남깁니다.
품목군 단위 집계가 필요하면 원천 객체를 보존한 상태에서 합의한 다대일 매핑을 적용합니다. 파일의 주문행을 부모와 연결하는 문제는 SCM JSONL 부모 연결 검수에서 따로 다룹니다. 이 글의 제안 판정은 집계 정책을 없애는 대신, 집계 이전의 연결 근거를 되짚을 수 있게 합니다.
어떤 근거와 범위로 확인했나요?#
Shopify 공식 원문과 가상 문자열 실험을 구분했습니다. 2026-11-22 확인 당시 객체 문서의 안정 버전 표시는 2026-10이었고, 공식 버전 일정의 공개일은 2026-10-01입니다. GID 문서의 개별 발행·수정일은 미표기여서 확인일과 구분합니다. 이 글은 GID를 새 기능으로 소개하지 않습니다.
공식 근거는 GID의 객체명·부모 매개변수 구조, ProductVariant의 재고 객체 관계, InventoryItem의 동일 SKU 설명입니다. 가상 표본에서 보인 키 충돌과 제안 인수 판정은 자사 설계 예시입니다. 실제 상점의 조회 권한·전체 데이터·관계 누락·동기화 결과는 별도로 확인해야 합니다.
알파카랩스는 SCM 운영대시보드 개발 서비스에서 원천 정의·접근 조건, 통합 조회, 원천과 화면의 표본 대사·운영 인수 협의 범위를 설명합니다. 이는 자기표기이며 특정 GID 검수 기능의 납품 실적이나 성과 보장은 아닙니다. 운영 주체는 알파카랩스이며 아래 상담으로 연결될 수 있습니다.
자주 묻는 질문#
GID의 마지막 숫자가 같으면 같은 객체인가요?
객체 타입과 부모 매개변수까지 대조해야 합니다. 가상 Product/101과 ProductVariant/101은 숫자가 같아도 다른 타입입니다. 숫자만 남긴 통합 키는 이 구분을 잃습니다.
InventoryLevel의 물음표 뒤는 지워도 되나요?
공식 예시에는 부모 InventoryItem을 가리키는 inventory_item_id가 포함됩니다. 조회된 전체 GID를 보존하고 임의로 매개변수를 제거하지 않습니다. 실제 객체의 ID 계약은 사용 중인 API 버전에서 확인합니다.
상품 변형 ID를 InventoryItem ID로 바꿀 수 있나요?
상품 변형 ID의 타입 이름만 바꾸어 재고 관계를 추정하지 않습니다. ProductVariant.inventoryItem으로 조회한 ID와 대조합니다. 이미 같은 객체의 타입과 REST 대응 ID가 확정된 경우는 공식 형식에 따라 구성할 수 있습니다.
SKU가 같은 재고를 ERP 한 품목으로 묶으면 안 되나요?
그런 업무 정책을 합의할 수 있습니다. 먼저 원천 객체를 구분해 보존하고 다대일 매핑의 기준과 예외를 기록합니다. SKU가 같다는 사실만으로 API 객체의 유일성이나 연결 정확성이 보장되지는 않습니다.
가상 표본이 통과하면 운영 검수도 끝나나요?
가상 표본은 문자열 손실과 명시적 관계 대조만 확인했습니다. 운영에서는 비식별 원천 응답·권한·API 버전·관계 누락과 ERP 매핑 결과를 별도로 대조해야 합니다. 실제 고객 데이터나 상점 API를 시험한 결과가 아닙니다.
SCM 식별자 인수표 초안은 어떻게 준비하나요?#
인수표에는 원천 연결, 객체 타입, 전체 GID, 조회된 관계, ERP 품목 매핑과 보류 사유를 적습니다. 실제 고객명·연락처·인증값은 제외하고, 변환 전후에 같은 객체를 가리키는지 확인할 수 있는 표본을 준비합니다.
SCM 식별자 인수표 초안을 정리합니다
첫 범위 협의에서 비식별 원천 응답과 현재 매핑 규칙을 대조해 SCM 식별자 인수표 초안을 정리합니다. 소요 시간은 API 접근 조건·자료 범위를 확인한 뒤 안내합니다.
SCM 식별자 인수표 초안 협의