SCM 대량 조회 검수, JSONL 품목을 어느 주문에 연결할까
SCM 대량 조회 JSONL은 부모 식별자로 주문과 품목을 복원합니다. Shopify 규칙과 가상 8조건 표로 연결 오류·부분 파일·중복 ID를 구분하고, 원천과 화면의 인수 기준을 정리합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
SCM 대량 조회는 부모 식별자로 주문·품목을 연결해 검수합니다. 2026-11-19 확인 기준, 부모가 없거나 부분 파일이면 연결 확정을 보류합니다.
파일은 끝까지 읽혔는데 주문 상세에 다른 주문의 품목이 붙는다면, 수신 건수만으로 원인을 찾기 어렵습니다. 주문과 품목을 줄마다 분리해 내보내는 형식에서는 읽힌 객체와 복원한 관계를 함께 비교해야 합니다.
최근 SCM 통합 조회 요구에서 일반화한 인수 문제입니다. 아래 Shopify·JSONL은 공식 기술을 설명하기 위한 가상 예시이며, 문의자의 사용 제품이나 실제 장애·구축 성과를 뜻하지 않습니다.
JSONL 한 줄이 주문 한 건인가요?#
이 예시에서는 주문과 주문행이 각각 다른 줄의 노드입니다. Shopify Bulk query 가이드는 중첩 연결의 자식 노드를 평탄화하고, 부모를 가리키는 __parentId를 자동으로 포함한다고 설명합니다. 이 필드는 API 스키마에 없어 쿼리에 직접 추가하는 필드가 아닙니다. 공식 JSONL 형식
따라서 주문 루트의 id와 자식의 __parentId를 대조합니다. SKU가 같거나 두 줄이 붙어 있다는 이유만으로 관계를 확정하지 않습니다. SKU는 이 예시에서 비교할 품목 정보이고, 주문행 식별자는 별도로 보존합니다.
조회 정의도 함께 보관합니다. 여기서는 주문의 id·__typename, lineItems 연결의 id·__typename·sku를 요청한 경우를 가정합니다. 다른 종류의 연결이 섞인 쿼리라면 그 노드 유형과 관계도 별도로 정의해야 합니다. Order의 lineItems 원문
어떤 입력을 정상과 보류로 나누나요?#
부모가 확인된 품목만 해당 주문 상세에 연결하는 인수표를 둡니다. 다음 표는 서버의 오류 코드 목록이 아니라, 수신 파일을 화면에 반영하기 전에 적용하는 가상 정책입니다. 같은 수집 작업의 동일 조회 정의를 비교한다는 조건을 고정했습니다.
| 가상 입력 조건 | 기대 판정 | 확인할 대상 |
|---|---|---|
| 2주문·3품목의 부모 ID 일치 | 연결 확인 | 주문 2개·품목 3개 보존 |
| 내부 처리 순서를 재배치 | 같은 관계 유지 | 줄 위치 대신 부모 ID 대조 |
| 품목의 부모 ID 필드 누락 | 반영 보류 | 조회 정의·변환 누락 확인 |
| 파일에 없는 주문을 부모로 지정 | 반영 보류 | 미해결 부모 목록 |
| 같은 SKU, 서로 다른 주문행 ID | 두 주문행 보존 | SKU로 주문행 합치지 않음 |
| 같은 주문행 ID의 부모가 충돌 | 반영 보류 | 충돌 원본과 수집 작업 |
| 실패 작업의 부분 결과 파일 | 완전 반영 보류 | 작업 상태·partialDataUrl |
| 다른 수집 작업의 파일 혼입 | 반영 보류 | 파일과 작업 ID의 출처 |
다음은 내부 처리 순서를 재배치한 가상 JSONL 표본입니다. 원천 서버가 항상 이 순서로 내보낸다는 뜻은 아닙니다. 식별자는 설명용이며 실제 주문을 가리키지 않습니다.
{"__typename":"Order","id":"gid://shopify/Order/101"}
{"__typename":"Order","id":"gid://shopify/Order/102"}
{"__typename":"LineItem","id":"gid://shopify/LineItem/1001","sku":"DEMO-X","__parentId":"gid://shopify/Order/101"}
{"__typename":"LineItem","id":"gid://shopify/LineItem/1002","sku":"DEMO-X","__parentId":"gid://shopify/Order/102"}
{"__typename":"LineItem","id":"gid://shopify/LineItem/1003","sku":"DEMO-Y","__parentId":"gid://shopify/Order/101"}
이 표본은 5노드, 2주문, 3품목입니다. 주문 101에는 주문행 1001·1003, 주문 102에는 주문행 1002가 연결됩니다. 두 주문행의 SKU가 같아도 서로 다른 주문행을 하나로 줄이지 않습니다. 파일을 다 읽은 뒤 부모 목록과 미해결 관계를 대조하고, 미해결 부모를 임의의 주문으로 채우지 않는 것이 이 글의 정책입니다.
부모 아래로 묶어서 받으면 연결 검수가 끝날까요?#
묶음 출력은 처리를 도울 수 있지만 관계 검수를 대신하지 않습니다. 2026-10의 bulkOperationRunQuery는 groupObjects로 부모 바로 아래의 그룹화를 설정하며 기본값은 false입니다. 공식 가이드의 부모 이후 자식 설명도 함께 확인해야 합니다. 이 글은 모든 결과가 무작위 순서라고 가정하지 않고, 내부 변환 이후에도 식별자 관계가 유지되는지 검수합니다. groupObjects 공식 정의
파일을 내려받았다는 사실도 완전성을 보장하지 않습니다. 실패 작업의 partialDataUrl는 불완전 결과이며, 이 글의 인수 정책에서는 이를 전체 조회 완료로 반영하지 않습니다. 부분 결과를 진단에 쓸지와 기존 정상 화면을 언제 교체할지는 별도로 합의합니다. BulkOperation의 상태·부분 결과
원천 접근 권한·필터·조회 필드가 다르면 비교 모집단도 달라집니다. 합의한 조회 범위 밖의 주문을 파일에서 찾지 못했다고 수집 누락으로 단정하지 않습니다. 줄 경계 자체가 깨졌다면 SCM CSV 레코드 경계 검수를, 수집 시점이 달랐다면 SCM 집계·상세 조회 일관성을 별도로 확인하세요.
어떤 판본과 회사 설명을 확인했나요?#
Shopify GraphQL Admin API 2026-10 표시 판본과 Bulk query 가이드를 2026-11-19에 확인했습니다. 공식 버전 정책에 따른 판본 기준일은 2026-10-01이며, 각 문서의 최초 게시·갱신일은 미표기입니다. 이 날짜를 JSONL 기능의 신설일로 해석하지 않습니다. API 판본·쿼리·그룹화·권한·수집 작업 경계가 바뀌면 인수표를 다시 대조합니다.
BulkOperation.objectCount는 루트와 자식 객체를 함께 세고, rootObjectCount는 루트 객체를 셉니다. 이 예시처럼 주문이 루트라면 주문 수와 전체 객체 수를 구분할 수 있습니다. 두 숫자가 맞더라도 부모가 잘못 연결됐을 수 있으므로, 관계 표본을 함께 검수합니다. 객체 수와 루트 수 정의
알파카랩스의 SCM 운영대시보드 개발은 원천별 지표 정의·조회 권한·원천과 화면의 표본 대사·운영 인수 협의를 설명합니다. 2026-11-19에 확인한 공개 자기표기이며 최초 게시일은 미표기입니다. 특정 제공자와의 호환이나 이 글의 부모 연결 정책이 이미 구현됐다는 보장은 아닙니다.
자주 묻는 질문#
JSONL 파일의 줄 수를 주문 수로 세도 되나요?
주문과 자식 주문행이 각각 별도 노드로 나오는 조회라면 구분해야 합니다. 가상 표본은 5노드에 주문 2개와 품목 3개가 들어 있습니다. 실제로 어떤 객체가 루트인지는 쿼리에서 확인합니다.
부모 식별자가 없으면 바로 앞 주문에 붙여도 되나요?
이 글의 정책은 반영을 보류합니다. 부모 식별자가 필요한 조회 정의인지, 변환 과정에서 필드가 사라졌는지, 파일이 완전한지 먼저 대조합니다.
SKU가 같은 주문행은 합쳐야 하나요?
주문행 식별자가 다르면 별도로 보존합니다. SKU별 집계가 필요하면 관계 복원 후 합의한 집계 규칙을 적용하며, 원래 주문행과 부모 연결을 남깁니다.
부분 결과 파일도 조회 화면에 올릴 수 있나요?
진단용 부분 표시와 전체 완료 반영을 구분해야 합니다. 이 글의 인수 정책은 실패 작업의 부분 파일로 전체 정상 화면을 교체하는 것을 보류합니다.
표를 통과하면 실제 연동 검수도 끝나나요?
표는 합성 관계 복원 모델입니다. 실제 쿼리·권한·파일 완전성·조회 범위와 원천 대사는 운영 환경의 비식별 표본으로 별도 시험해야 합니다.
부모 연결 인수표는 어떻게 준비하나요?#
비밀값과 고객정보를 제거한 원천 표본, 실행한 조회 정의, 파일에 대응하는 작업 식별자, 기대 주문 상세를 준비합니다. 올바른 관계와 보류할 관계를 같은 표에 놓으면 파일 수신 성공과 화면 반영의 검수 범위를 구체적으로 나눌 수 있습니다.
주문과 품목의 연결 기준을 정리합니다
첫 범위 협의에서 비식별 JSONL·조회 정의·기대 화면을 대조해 부모 연결 인수표 초안을 정리합니다. 소요 시간은 원천·쿼리·표본 범위를 확인한 뒤 안내합니다.
부모 연결 인수표 초안 협의