EPCIS 팔레트 해체 검수, 구성 목록이 비면 무엇이 풀릴까
EPCIS 팔레트 해체를 검수할 때 두 구성 목록이 빈 DELETE와 일부 해제를 구분합니다. 원본 JSON과 가상 검수표로 남은 구성, 부모 식별자, 수신 누락을 확인합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
2026년 11월, EPCIS AggregationEvent의 DELETE는 원본의 두 목록이 비면 해당 팔레트의 직속 구성 전체를, 값이 있으면 지정된 구성만 해제합니다.
재포장한 상자가 기존 팔레트 아래에도 남으면 작업자는 어느 단위로 출고해야 하는지 다시 확인해야 합니다. 반대로 상자 하나만 꺼냈는데 화면에서 팔레트 구성이 전부 지워질 수도 있습니다. 해체 이벤트의 원본과 해체 뒤 화면을 같은 팔레트로 대조해 두 오류를 잡습니다.
어떤 팔레트의 구성이 해제되나요?#
GS1 EPCIS 2.0.1 §7.4.3에서 AggregationEvent는 상자와 팔레트처럼 물리적으로 묶인 관계를 표현합니다. action이 DELETE이면 parentID로 지정한 부모의 구성 관계가 풀립니다. 개별 물품 식별자는 childEPCs에, 품목 분류별 수량은 childQuantityList에 담습니다.
- 일부 해제는 두 목록을 함께 봅니다. 한 목록이라도 값이 있으면 그 이벤트에 명시된 구성만 풀립니다.
- 전체 해제는 완전한 원본 이벤트에서 두 목록 모두에 값이 없는 경우입니다. 필드를 생략하거나 빈 배열로 보낼 수 있습니다.
ADD와OBSERVE에는 적어도 한 목록에 값이 있어야 합니다.ADD에는 부모 ID도 필요합니다.OBSERVE에서는 부모 ID를 생략할 수 있습니다. A만 관찰했다고 B를 구성에서 빼지 않습니다.
같은 팔레트에서 무엇을 시험하나요?#
가상 팔레트 P에 A·B 상자와 클래스 C 물품 6개가 직속으로 연결돼 있다고 가정합니다. 아래 각 표본은 이 상태에서 따로 시작합니다. 다른 팔레트 Q에는 D 상자가 있고 모든 표본에서 그대로 남습니다.
| 입력 조건 | 배포된 GS1 JSON Schema | P의 업무 판정 |
|---|---|---|
| A 상자만 해제 | 통과 | B 상자, C 6개 |
| DELETE에서 두 목록 생략 | 통과 | 직속 구성 없음 |
| DELETE에서 두 목록 모두 빈 배열 | 통과 | 직속 구성 없음 |
| 수량 목록에서 C 2개만 해제 | 통과 | A·B 상자, C 4개 |
| A 상자만 관찰 | 통과 | 변경 없음 |
| 추가인데 두 목록 생략 | 실패 | 보류: 구성 목록 필요 |
| 해제인데 부모 식별자 생략 | 통과 | 보류: 부모 식별자 필요 |
| 해제인데 목록에 null 입력 | 실패 | 보류: 배열 형식 오류 |
다음 JSON은 같은 팔레트에서 먼저 A만 꺼내고, 이후 남은 구성도 해제하는 가상 문서입니다. 첫 이벤트 뒤에는 B 상자와 C 6개가 남습니다. 다음 이벤트 뒤에는 P의 직속 구성이 비고 Q는 그대로입니다. 식별자는 가상 URI이며, GS1 CBV 2.0의 식별자 예시 형식을 따랐습니다.
{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
],
"type": "EPCISDocument",
"schemaVersion": "2.0",
"creationDate": "2026-11-16T16:10:00+09:00",
"epcisBody": {
"eventList": [
{
"type": "AggregationEvent",
"eventTime": "2026-11-16T16:00:00+09:00",
"eventTimeZoneOffset": "+09:00",
"parentID": "https://example.org/obj/pallet-P",
"action": "DELETE",
"childEPCs": [
"https://example.org/obj/box-A"
]
},
{
"type": "AggregationEvent",
"eventTime": "2026-11-16T16:05:00+09:00",
"eventTimeZoneOffset": "+09:00",
"parentID": "https://example.org/obj/pallet-P",
"action": "DELETE"
}
]
}
}
형식 검사를 통과하면 화면에 반영해도 될까요?#
이 예에서 GS1의 배포 JSON Schema는 parentID가 빠진 DELETE도 통과시켰습니다. 표준 §7.4.3에서 해제에는 부모 ID가 필요하므로 수신 단계에서 따로 확인합니다. 문제가 발견되면 팔레트 구성을 유지하고 원본을 확인할 담당자에게 넘깁니다.
수신 중 목록이 잘렸거나 일부 필드만 내려주는 조회 결과라면 완전한 원본을 다시 조회하고 확인 전 반영을 보류합니다. 일부 해제에서 대상을 담은 필드가 사라지면 두 목록이 빈 정상 전체 해제처럼 보일 수 있습니다. 현재 구성과 이미 적용한 해체를 재현할 수 있도록 부모 ID, 원본 이벤트, 발생 시각, 적용 전후 구성을 연결해 둡니다.
팔레트의 상자 관계가 풀린 뒤에도 그 상자와 내부 물품은 별도의 추적 대상입니다. 재고 차감, 다른 팔레트에 다시 묶기, 오류가 있는 과거 이벤트를 고치는 작업은 각각 근거가 필요합니다. 기존 창고 시스템에서 이 조건을 시험할 수 있다면 운영 화면을 새로 만들기 전에 같은 표본으로 먼저 확인합니다.
어떤 문서를 기준으로 삼았나요?#
GS1의 EPCIS 2.0.1은 2025년 7월 1일 공개됐습니다. §7.4.3에서 해제의 의미를, 2.0.1 공식 검증 파일에서 JSON 형식 판정을 확인했습니다. 두 근거의 확인일은 2026년 11월 16일입니다.
알파카랩스의 SCM 운영대시보드 개발 범위는 원천과 화면의 표본 대사 및 운영 인수 기준을 협의 항목으로 안내합니다. 이 글의 판정표는 그 협의에 가져갈 가상 설계 예입니다. 위치는 입고 스캔 지점과 보관 위치 검수, 잘못 기록된 이벤트는 EPCIS 오류 선언 검수에서 확인할 수 있습니다.
자주 묻는 질문#
EPCIS DELETE는 상품을 삭제하나요?
AggregationEvent의 DELETE는 지정한 팔레트와 내용물 사이의 구성 관계를 해제합니다. 재고 차감이나 상품 폐기는 별도의 업무 근거가 필요합니다.
childEPCs만 비어 있으면 전체 해제인가요?
AggregationEvent의 DELETE에서 원본의 두 목록 모두에 값이 없으면 지정한 팔레트의 직속 구성을 모두 해제합니다. childQuantityList에 값이 있으면 그 목록에서 지정한 분류와 수량만 해제합니다.
부모 식별자가 빠진 해체 이벤트도 반영하나요?
부모 식별자를 확인할 때까지 구성을 변경하지 않습니다. EPCIS 표준은 AggregationEvent의 DELETE에 parentID를 요구합니다.
관찰에서 A 상자만 스캔했으면 B 상자는 빠진 건가요?
OBSERVE는 상자를 추가하거나 제거하는 이벤트가 아닙니다. 일부만 관찰할 수 있으므로 관찰 목록을 팔레트 전체 구성으로 덮어쓰지 않습니다.
팔레트 전체를 풀면 각 상자 내부도 풀리나요?
지정한 부모의 직속 구성 관계가 해제됩니다. 그 아래 상자와 상자 내용물의 관계가 바뀌었다면 해당 상자를 대상으로 한 근거를 확인합니다.
검수표 초안에 무엇을 담나요?#
팔레트 해체의 인수 기준을 정리합니다
첫 범위 협의에서 비식별 이벤트와 운영 화면을 대조해 부분 해제·전체 해제·보류의 검수표 초안을 정리합니다. 소요 시간은 원본 조회 범위와 표본을 확인한 뒤 협의합니다.
팔레트 해체 검수표 초안 협의