GEPIR Update: Version 4.0 and Conformance Process

advertisement

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

HTTP

/XML http/

XML

GEPIR 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

Version

Language

GLN

Response

Return Code

Information Provider Gln

Last Change Date Time

GCP

Additional Party Identification

Party Name

Street Address

PO Box Number

Sub Division

Postal Code

City

Country ISO Code

Contact Name

Communication Channel

Communication Channel Code

Party Role

Party Child

Party Child Role

GLN

© 2014 GS1

GEPIR V4.0 Party Definition

© 2014 GS1

GEPIR V3.2 Item Definition

Version

Language

GTIN

Information Provider GLN

Manufacturer GLN

Item Name

Brand Name

Trade Item Unit Descriptor

Descriptive Size

Net Content

Unit of Measure

Link URI

URI Format

Classification Code

Classification System Code

Last Change Date Time

Child 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

0

1

2

No error

Missing or invalid parameters

No record found

Description

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

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.

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 The company prefix in the request exists, but the company is no longer a

GS1 member of GS1 under this prefix. The name and address of the responsible MO is returned.

11 Country not on the GEPIR There is no GEPIR MO server for this company prefix or ISO country network 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

14 Daily request limit exceeded

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

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

19

20

21

18

15

16

17

GEPIR – Additional v 4.0 Reason Codes

GCP does not exist GCP does not exist; GCP returned is a single-assigned key

GS1 Key is valid; GLN not assigned

Prefix 02 or 04 for internal use only

GS1 Key is valid; GLN not assigned

Prefix 02 or 04 are for company internal use. No information can be returned.

The name and address of the MO inquired is returned.

Prefix 20-29 for internal use only

Prefix 977 (ISSN)

Prefix 978-979 (ISBN)

Prefix 990-999

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

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

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

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

GEPIR – Specification Enhancements

Use Case Diagrams

© 2014 GS1

Activity Diagrams Sequence Diagrams UML Models

GEPIR Where to get the documentation?

© 2014 GS1 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 Details

Mark Van Eeghem / Sean Lockhead

GS1

E: mark.vaneeghem@gs1.org

E: sean.lockhead@gs1.org

W: www.gs1.org

Download