화요일 오전 6시 40분, 바젤 인근 창고의 3번 하역장. 한 대의 트럭이 조립 공장에서 48개의 전기 자전거 배터리가 실린 팔레트를 운반해 오자, 스캐너에서 삑 소리가 나고 창고 관리 시스템이 입고 처리를 완료한다. 이 배터리들은 지금까지 세 가지 시스템을 거쳤다. 공장의 생산 관리 시스템, 운송사의 배송 시스템, 그리고 이제 창고 시스템이다. 각 시스템은 이 배터리들의 이동 경로 중 자신과 관련된 부분만을 파악하고 있다.
이제부터 이러한 정보 조각들이 Transpareo로 통합됩니다. 각 워크스페이스에는 GS1의 공급망 이벤트 표준인 EPCIS 2.0을 위한 인터페이스가 마련되어 있습니다. 공장, 운송업체, 창고는 배터리 제품 여권이 저장된 곳으로 해당 이벤트를 보고하며, 세 파트너 중 어느 한 곳을 위해 별도의 연결 시스템을 구축할 필요가 없습니다.
공장, 운송업체, 창고를 아우르는 하나의 솔루션
EPCIS는 Electronic Product Code Information Services의 약자입니다. EPCIS 이벤트는 ‘어떤 제품인지’, ‘언제’, ‘어디서’, ‘왜’라는 네 가지 질문에 답합니다. 여기서 ‘왜’는 제조, 출하 또는 입고와 같은 비즈니스 단계와, 그 후 제품의 상태를 의미합니다. 오늘날 시스템들이 공급망 이벤트를 교환하는 분야, 특히 수년 전부터 이를 시행해 온 제약 물류 분야에서는 많은 시스템이 이미 EPCIS를 사용하고 있습니다. 또한 제품 여권 자체도 EPCIS의 세 가지 사전 중 하나에 제품에 어떤 일이 발생했는지를 기록하고 있습니다.
공통된 형식이 없다면 각 파트너는 각자의 방식을 사용해야 합니다. 공장에서 이메일로 보내는 표, 운송업체의 내보내기 파일, 창고에서 제공하는 보고서 등, 각각 고유한 열 구성을 가지고 있습니다. Transpareo에서는 각 파트너가 귀사의 워크스페이스 인터페이스에 대한 전용 접속 권한을 부여받아 EPCIS에 이벤트를 보고합니다. Transpareo Connect 는 API, 웹훅, 그리고 이제 EPCIS 2.0을 통해 다른 시스템을 Transpareo와 연결합니다. 귀사의 ERP에 있는 배터리 마스터 데이터는 기존 방식대로 계속 전송됩니다.
공급업체가 배터리에 대해 알고 있는 정보(예: 무게나 셀의 원산지 등)는 별도의 경로를 통해 귀하에게 전달됩니다. Transpareo Upstream 를 통해 공급업체에 해당 정보를 직접 요청하면, 해당 업체 담당자가 정보를 입력하고, 귀사는 답변 내용을 확인한 후 패스에 기록합니다. EPCIS를 통해 파트너사의 시스템은 배터리의 처리 현황(조립, 발송, 도착 등)을 보고합니다.
새로운 파트너는 하나의 접속 권한만 있으면 됩니다.
공장은 한 교대 근무 분량의 조립 내역을 한 번에 전송하며, 한 번에 최대 10,000건의 이벤트를 처리합니다. Transpareo는 각 이벤트를 GS1 스키마에 따라 검증합니다. 파트너의 요청에 따라 배송을 전체적으로 승인하거나 거부할 수 있으며, 또는 Transpareo가 유효한 이벤트는 모두 수용하고 오류가 있는 항목은 구체적으로 명시할 수도 있습니다.
GTIN, 일련번호 및 로트 번호를 통한 제품 여권
이벤트는 제품의 식별번호를 통해 제품을 식별합니다. 배터리를 GTIN, 일련번호 또는 로트 번호와 함께 지정하면 Transpareo가 이를 바탕으로 해당 제품 여권을 찾아내며, 2027년 2월 18일부터 전기 자전거용 배터리는 별도의 여권이 필요합니다. 팔레트만 명시하는 이벤트의 경우, 해당 여권은 생성되지 않습니다. 운송업체가 배터리를 EPC 식별자로 기재하든 , 여권의 QR 코드에 표시된 GS1 Digital Link로 기재하든 , 두 경우 모두 동일한 여권으로 연결됩니다.
공장에서 아직 여권이 생성되지 않은 배터리를 보고하더라도 데이터가 손실되지 않습니다. 해당 기록은 저장되어 있으며, 여권이 생성되는 즉시 해당 여권에 대한 조회 시 해당 기록도 함께 검색됩니다.
이 쿼리는 여권 자체와 관련된 공개 이벤트(예: 발급, 수리, 재활용 등)도 함께 반환합니다. 각 이벤트는 여권의 이벤트 파일이 서명한 그대로, 수신자가 확인할 수 있는 서명과 함께 제공됩니다.
조회 결과를 통해 배터리의 전체 이력을 확인할 수 있습니다: 파트너들이 보고한 내용과 배터리의 패스가 서명한 내용까지 모두 포함됩니다.
파트너가 보고한 내용은 제품 여권 옆에 기재됩니다. 따라서 입고 내역은 고객, 정비소, 관공서 등이 확인하는 공개 패스에 자동으로 표시되지 않습니다. 그렇게 하는 편이 개발 기간을 단축할 수 있었지만, 우리는 이를 채택하지 않기로 결정했습니다. 서명된 제품 여권은 귀하가 책임을 지는 문서이며, 파트너가 보고한 내용은 해당 파트너의 진술로만 남기 때문입니다.
한 파트너가 오류를 범한 경우, EPCIS에서 규정하는 바와 같이 오류 설명서를 통해 해당 이벤트를 수정합니다. 원래의 이벤트는 그대로 유지되고, 수정 내용은 그 옆에 표시되며, 조회하는 사람은 두 가지 모두를 확인할 수 있습니다.
조회, 저장, 구독
이러한 이벤트들은 귀사의 시스템은 물론, 접근 권한 범위 내에서 파트너사의 시스템에서도 조회됩니다. 조회 시 제품, 일련번호 또는 로트 번호, 기간, 거래 단계, 위치 또는 상태를 기준으로 필터링할 수 있습니다. 이를 통해 고객 서비스 담당자는 운송업체에 전화할 필요 없이, 고객의 배터리가 언제 창고를 출고했는지 확인할 수 있습니다.
자주 사용하는 쿼리는 이름을 지정하여 저장하고 구독하세요. 그러면 Transpareo는 새로운 이벤트가 발생하자마자, 또는 매일 아침 같은 시간 등 미리 정해진 일정에 따라 이를 전달해 드립니다. 수신자가 비밀번호를 설정해 두면, 각 전달 내용에는 서명이 포함되어 있어 수신자가 해당 내용이 귀하의 워크스페이스에서 발송된 것임을 확인할 수 있습니다.
바젤에서 발생한 입고 정보를, 누군가가 파일을 전달하지 않아도 귀사의 ERP 시스템이 자동으로 파악합니다.
누가 무엇을 보는지
각 액세스 권한에는 고유한 권한이 있으며, 이벤트 조회와 이벤트 보고는 서로 별개의 권한입니다. 또한 특정 여권에 한해 액세스 권한을 제한할 수도 있습니다. 이 경우 운송업체는 귀하가 승인한 여권에 해당하는 배터리 관련 이벤트와 운송업체가 직접 보고한 이벤트만 조회할 수 있습니다.
파트너는 귀하가 공유한 제품만 볼 수 있습니다.
이 사건들은 EU 내, 즉 귀하의 워크스페이스에 있는 자체 데이터베이스에 저장되어 있으며, 이는 Transpareo에 저장된 귀하의 모든 데이터와 마찬가지입니다.
왜 표준이 중요한가
GS1의 설명에 따라 구축된 파트너의 시스템은 별도의 설정 변경 없이 귀사의 워크스페이스와 연동되어야 합니다. 그렇지 않으면 해당 시스템과 귀사의 시스템 사이에 변환 과정이 필요하게 되며, 이 과정에서 값의 의미가 왜곡될 수 있습니다. 그렇기 때문에 GS1이 EPCIS 2.0을 위해 공개한 연결 인터페이스는 오류 메시지까지 세심하게 고려되어 있습니다.
표준어는 상대방이 글자 그대로 발음할 때 비로소 유용해집니다.
자동 테스트는 새로운 버전이 출시되기 전마다 인터페이스의 응답이 GS1의 설명 및 스키마를 준수하는지 확인합니다. 일부 항목에서는 설명이 불완전하거나 표준 문구와 상충되는 경우가 있습니다. 이러한 경우 당사는 표준을 따르며, GS1에서 해당 부분을 수정하는 즉시 테스트에서 오류가 발생합니다.
우리가 의도적으로 다른 방식을 채택하거나 허용된 옵션을 생략하는 경우, 파트너는 시스템을 연동하기 전에 무엇보다 다음 세 가지 사항을 반드시 파악해야 합니다:
- 이 인터페이스는 해당 연동을 위한 표준에서 요구하는 두 가지 형식인 JSON과 JSON-LD를 지원합니다. 표준에서 선택 사항으로 허용하는 XML은 지원하지 않습니다.
- 식별자는 표준에 따라 별도의 지정이 없는 경우 GS1 Digital Link 형식으로 반환되거나, 요청 시 파트너가 신고한 형식으로 반환됩니다. 이 인터페이스는 각 식별자를 EPC 표기법으로 변환하는 기능을 제공하지 않습니다.
- 구독 서비스는 귀하가 지정한 주소로만 배송되며, 암호화된 연결(https)을 통해서만 제공됩니다. WebSocket을 통한 배송 서비스는 제공하지 않습니다.
파트너 시스템이 자신의 액세스 정보로 로그인하는 방법과, 이 인터페이스가 표준과 다른 점은 무엇인지에 대해서는 개발자들이 Transpareo의 API 문서 가이드에서 확인할 수 있습니다.
램프로 돌아가기
오전 6시 41분에 창고에서 입고 사실을 보고했고, 그 직후 ERP 시스템이 구독 기능을 통해 이를 파악합니다. 48개의 배터리 중 하나의 일련번호를 조회하면, 그 배터리의 이동 경로를 확인할 수 있습니다: 공장에서 조립되어 팔레트에 실린 후, 운송업체에 인계되어 바젤에 도착한 과정과, 그 옆에는 해당 배터리의 ‘여권’에 기록된 이벤트 내역이 표시됩니다.
해당 운송업체는 이를 위해 접속 권한을 부여받았으며, 자사 시스템이 이미 지원하는 형식으로 데이터를 전송합니다.
이 게시물에 대한 질문
EPCIS 2.0이란 무엇인가요?
EPCIS 2.0은 2022년에 채택된 GS1의 공급망 이벤트 표준입니다. 이벤트는 어떤 제품이 언제, 어디서, 어떤 비즈니스 단계에서 기록되었는지, 그리고 그 이후의 상태가 어떻게 되는지를 기록합니다. 버전 2.0에서는 JSON 및 JSON-LD 형식이 추가되었으며, 시스템이 이벤트를 보고하고 조회할 수 있는 REST 인터페이스도 도입되었습니다.
EPCIS는 디지털 제품 여권과 어떤 관련이 있나요?
디지털 제품 여권은 제품이 무엇인지 설명하고, EPCIS는 해당 제품에 어떤 일이 발생했는지 기록합니다. Transpareo에서는 각 여권이 서명된 EPCIS 파일 형태로 자체 이벤트를 게시하며, 파트너사의 이벤트는 GTIN을 통해 일련번호나 로트 번호와 연계되어 해당 여권에 연결됩니다.
별도의 EPCIS 저장소가 필요한가요?
아닙니다. Transpareo의 각 워크스페이스는 각각 고유한 주소를 가지고 있습니다. 이 워크스페이스는 이벤트를 수신하고 저장하며, 쿼리에 응답합니다. 파트너 시스템은 이곳에 이벤트를 전송하고, 귀사의 시스템은 이곳에서 정보를 조회합니다.
신고된 사건이 내 제품 여권에 영향을 미치나요?
아닙니다. 보고된 이벤트는 여권 옆에 표시되며, 해당 식별자를 통해 여권과 연결됩니다. 여권의 서명된 내역과 고객들이 확인하는 여권은 귀하가 게시한 그대로 유지됩니다.
파트너는 시스템을 어떻게 연동하나요?
사용자를 위해 프로그램용 액세스 권한을 생성하고, 이벤트 보고 권한을 부여하며, 요청 시 이벤트 조회 권한도 부여합니다. 키와 비밀번호를 사용하여 해당 시스템은 액세스 토큰을 획득한 후, 이벤트를 EPCIS 문서로 변환하여 귀하의 워크스페이스 주소로 전송합니다. 그의 시스템이 이미 EPCIS 2.0을 지원하는 경우, 주소와 접속 권한만 전달됩니다.
Transpareo는 인터페이스가 표준을 준수하는지 어떻게 확인하나요?
자동 테스트는 새로운 버전이 출시되기 전마다 각 연산의 응답이 GS1이 EPCIS 2.0용으로 공개한 OpenAPI 설명 및 JSON 스키마와 일치하는지 확인합니다. 설명이 불완전하거나 표준 문구와 상충되는 경우, 당사는 표준을 따르며, GS1이 해당 부분을 수정하는 즉시 테스트에서 오류가 발생합니다. 인터페이스가 표준과 다른 경우, API 문서에서 해당 부분을 모두 명시합니다.




