GEPIR Update: Version 4.0 and Conformance Process Session: Standards Development University Time: 09:00 – 09:20 Who May Attend: MO Only Speaker: Mark Van.

GEPIR Update: Version 4.0 and Conformance Process

Session: Standards Development University

Time: 09:00 – 09:20

Who May Attend: MO Only

Speaker: Mark Van Eeghem

GEPIR

(GS1 Electronic Party Information Registry)

© 2014 GS1

GEPIR History

• Launched in 1999 by Member Organizations as a way to eliminate the need to manually answer questions around issuance of Global Company Prefix data

• GS1 France, GS1 Sweden and GS1 Switzerland established a protocol enabling the interlinking of the different membership databases of these MO’s

• Since its origination, 108 MO’s joined the GEPIR network• Previous Versions 1.0 (‘99), 2.0 (‘02), 3.0 (‘04), 3.1 (’05)• Latest Version (Version 3.2) of GEPIR (’11)• Version 4.0 development in progress

© 2014 GS1

GEPIR Basic Information

• GEPIR is a Federated (Distributed) Registry• Operated by the Member Organizations (MO’s)• Any user can request information (Read Only)• Implemented by connecting nodes set up and maintained by each MO

• Accessed by anybody (Search functionality)• Web interface• Machine to Machine

• Information from data maintained by GS1 MO’s• Information regarding subscribers of other MO’s will be served by

the respective MO’s

© 2014 GS1

GEPIR Summary

• Total MO’s in GEPIR 111• There are 70 Member Organisations whose GEPIR services are hosted by

the GS1 Global Office• All updated to v3.2 August 2011

• The GS1 Global Office supports the MO’s• Hosting service for MO’s that require or request it• The Use of the GSMP (GS1 GEPIR TDT)• GS1 GO provides the development and implementation support for the

GEPIR specifications• Based upon a hybrid approach of a GO-hosted and non-GO-hosted

environment

© 2014 GS1

GEPIR Statistics as of February 2013

• 111 MO’s have data available through GEPIR• 70 MO’s hosted at Global Office• +41 MO’s locally hosted•

• =111 Member Organizations

• 6 MO’s on Version 2.0• 7 MO’s on Version 3.0 • 98 MO’s on Version 3.1 / 3.2 [70 hosted, 28 local)

• 11 MO’s-V3.1 July ‘09 94 MO’s - V3.1/3.2 Oct ‘11

© 2014 GS1

GEPIR Network

GEPIRGEPIR

http/XML

http/XML

HTTP/XML

HTTP/XML

HTTP/XML

© 2014 GS1

GEPIR Versioning

• Version 1 (Sunsetted July 2010) – First formal version• Search by GTIN, GLN, SSCC, Company name

• Version 2 adds the possibility of refined company search• Postal code and/or a city in order to receive precise results • Also added cascading – The ability to request further info from other sources• Backward Compatible with V1.0

• Version 3.0 / 3.1 / 3.2 - XSD Schema-Based, Web Services Approach• Now includes the ability to communicate a very small set of Item and Party information• Introduces the concept of “Premium Users”

– 30+ queries from one user or GLN/IP combination

© 2014 GS1

Functions of GEPIR

• Search for company ownership data, based on:• GTIN• GLN• SSCC• Company Name

• Responses also can contain additional information• List of Response Codes

© 2014 GS1

GEPIR by GTIN

© 2014 GS1

GEPIR by GTIN

© 2014 GS1

GEPIR by GLN

© 2014 GS1

GEPIR by GLN

© 2014 GS1

GEPIR by SSCC

© 2014 GS1

GEPIR by SSCC

© 2014 GS1

GEPIR by Name

© 2014 GS1

GEPIR by Name

© 2014 GS1

GEPIR Strategy Execution • Version 4.0 is here, ready to implement!

• Update functionality– GEPIR to handle resolution of all GS1 Keys– Additional Methods (Get Root Directory, Get Router Detail)– Additional Response Codes

• Resolution of GEPIR Work Requests– GLN = Optional : GS1 Company Prefix (GCP) = Mandatory– Additional attributes (GPS / Latitude Longitude, )

• Additional User-Defined fields to enable Value-Added Services• Alignment with the GS1 Global Data Dictionary & GS1 Architecture• Solution for Alliance Numbers• GS1 Company Prefixes from one MO managed by another MO• Documentation Consolidation

– Current: 4 Specification documents + 4 Guideline documents– New: 1 Specification + 1 Guideline document

• Better development tools– Use Cases, Activity & Sequence Diagrams, UML Models

© 2014 GS1

GEPIR V3.2 Party Definition

VersionLanguageGLNResponse

Return CodeInformation Provider Gln Last Change Date TimeGCP

Additional Party IdentificationParty NameStreet AddressPO Box NumberSub DivisionPostal CodeCityCountry ISO CodeContact NameCommunication Channel

Communication Channel CodeParty Role

Party ChildParty Child Role

GLN

© 2014 GS1

GEPIR V4.0 Party Definition

© 2014 GS1

GEPIR V3.2 Item Definition

Version LanguageGTINInformation Provider GLNManufacturer GLN Item NameBrand NameTrade Item Unit DescriptorDescriptive SizeNet Content Unit of MeasureLink URI URI Format Classification Code Classification System Code Last Change Date TimeChild Item Child Item GTIN Number Contained

© 2014 GS1

GEPIR V4.0 Item Definition

© 2014 GS1

GEPIR – v 3.2 Reason Codes (1/2)

Value Text Description

0 No error The request has been successfully completed and the response is in the body of the SOAP message.

1 Missing or invalid parameters

One or more parameters is missing or incorrect. This might be wrong length, invalid GS1 check digit, non-numeric characters in a number, etc. No data is returned.

2 No record found No record exists in the MO database for this company prefix, this GTIN or these search parameters. No data is returned.

3 No exact match on GLN No record was found with exactly this GLN. The data held in the MO database for this company prefix is returned.

4 Too many hits Over twenty records match the search criteria. Only twenty are returned.

5 Unknown country code The GS1 country prefix (numeric keys) does not exist or the ISO country code (name search) is not for a GS1 member country. No data is returned.

6 Response may be incomplete

One or more servers failed to respond. Such data as is available is returned.

7 Request timed out There was a timeout somewhere in the server chain. No data is returned.

8 No catalogue exists A request has been made for GTIN information, but there is no server for this company. No data is returned.

© 2014 GS1

GEPIR – v 3.2 Reason Codes (2/2)

Value Text Description

9 Company information withheld

The company prefix in the request exists, but the company has not released its information for publication. The name and address of the responsible MO is returned.

10 Company not a member of GS1

The company prefix in the request exists, but the company is no longer a member of GS1 under this prefix. The name and address of the responsible MO is returned.

11 Country not on the GEPIR network

There is no GEPIR MO server for this company prefix or ISO country code. The name and address of the responsible MO is returned.

12 Item information withheld The GTIN in the request exists, but the company has not released its information for publication.

13 Illegal number The company prefix in the request is known to be illegal. The name and address of the responsible MO is returned.

14 Daily request limit exceeded

The user has exceeded the number of ‘free’ requests permitted (30) and the request is rejected. No data is returned. The ‘responderGln’ element is set by the node refusing the request.

99 Server error An irrecoverable error occurred contacting a server. The ‘responderGln’ element is set by the node detecting the error.

© 2014 GS1

GEPIR – Additional v 4.0 Reason Codes15 GCP does not exist   GCP does not exist; GCP returned is a single-assigned key

16 GS1 Key is valid; GLN not assigned

  GS1 Key is valid; GLN not assigned

17 Prefix 02 or 04 for internal use only

  Prefix 02 or 04 are for company internal use. No information can be returned. The name and address of the MO inquired is returned.

18 Prefix 20-29 for internal use only

  Prefix 20-29 is for company internal use. No information can be returned. The name and address of the MO inquired is returned.

19 Prefix 977 (ISSN)   Prefix 977 is used for serial publications (ISSN). No information can be returned. The name and address of the MO inquired is returned.

20 Prefix 978-979 (ISBN)   Prefix 978-979 is used for books. (ISBN). No information can be returned. The name and address of the MO inquired is returned.

21 Prefix 990-999   Prefix 990-999 is used for coupons. No information can be returned. The name and address of the MO inquired is returned.

© 2014 GS1

GEPIR – Specification Enhancements

Activity Diagrams Sequence Diagrams UML Models

Use Case Diagrams

© 2014 GS1

GEPIR Where to get the documentation?

http://community.gs1.org/apps/org/workgroup/gs1_gepir/documents.php?folder_id=12133

© 2014 GS1

GEPIR - Monitoring

• A monitoring engine checks all nodes of GEPIR real-time availability of the connected routers and clients

© 2014 GS1

GS1 GEPIR MO Support Site (1/2)

© 2014 GS1

GS1 GEPIR MO Support Site (2/2)

© 2014 GS1

GEPIR Strategy Execution

Objectives• Execution of Approved GEPIR Strategy• All MOs participating in GEPIR network as part of MO Core Services (June 2012)

Progress• 111 MOs in GEPIR• Deployment of V3.2 at GO Hosting Services – Complete - August 2011• GEPIR MO Support Website and content for all things GEPIR – Complete• GEPIR V4.0 Requirements Process / Specification Design – In Progress• More timely updates of GEPIR data for Hosted MOs - Launched• GEPIR TDT Work Effort on Quality of GEPIR (Service Levels / Conformance)• Completion of technology refresh for hosting of GS1 GO GEPIR Hosting Services

Issues• None at this time

Next Steps• Complete GEPIR Conformance / Quality Program Definition

• Specification & Attribute Conformance and Service Levels

• GEPIR V4.0 Specification

Next Meeting / Calls

© 2014 GS1

Links to Additional Information

• GS1 GEPIR Website• http://gepir.gs1.org

• GEPIR Factsheet• http://www.gs1.org/docs/gepir/GEPIR_Factsheet.pdf

• GEPIR Introductory Video• http://www.youtube.com/watch?v=NC3QLKZIAA0

Contact DetailsMark Van Eeghem / Sean Lockhead

GS1

E: [email protected]

E: [email protected]

W: www.gs1.org