All technical specifications for the use of GS1 Data Source.
GLN
The GLN (Global Location Number) of the GS1 data pool is 8712345013042 for both test and production environments.
XML schema
View the schema for the GDSN XML messages at the following website: https://www.gs1.org/standards/gdsn.
Data models
Three data models are used in the Netherlands:
GS1 interface
The GS1 interface has a test and a production environment. The output formats of the GS1 interface are: Excel, PDF, GS1 GDSN XML and media (tiff, jpg, pdf, etc.).
| You will need this: | |
| URL's | Test environment: https://uat-datasource.gs1.nl |
| Production environment: https://datasource.gs1.nl/ | |
| User name | Your email address |
| Pass word | Create at registration |
AS2
| URL's | Test environment (UAT): http://uat-as2-datasource.gs1.nl:9080/Receiver |
| Production environment (PROD): https://uat-as2-datasource.gs1.nl:9081/Receiver | |
| AS2 name: | 8712345013042 |
| AS2-configuration | |
| UAT Certificate (test environment) | CA Root (UAT) : CARoot TC.cer |
| Client: Trade_Connectors_AS2_UAT.cer | |
| PROD Certificate (production environment) | Client: TC_GdsnClientSign.cer |
| PROD Inbound IP (url shall not be replaced with ID) | 52.174.38.79 |
| PROD Outbound IPs | 52.233.171.11 40.68.207.108 |
| UAT IP | 13.81.15.173 |
| Version | 1.2 |
| SSL | No |
| User / Password | No |
| Encryption | 3DES |
| Message Digest | SHA-256 |
| Signed | Yes |
| Compressed | Yes |
| MDN | Synchronous |
| MDN Signed | Yes |
| Chunked encoding | Yes |
FTPS
The FTPS interface has a test and a production environment. Using FTPS software, for example Filezilla, you can extract data from the GS1 data pool. The FTPS output formats for data recipients are: GS1 GDSN XML and media (tiff, jpg, pdf, etc.).
| Protocol | FTP – File Transfer Protocol |
| Host / URL | Testomgeving: ftp://uat-datasource.gs1.nl |
| Productieomgeving: ftp://ftp-datasource.gs1.nl | |
| Poort | 21 |
| Data communication port range | 4000 – 5000 |
| Encryption | TLS/SSL Explicit encryptie |
| User name | GLN\emailaddress |
| Pass word | The same as for the web interface. You have defined this password yourself. |
API
API has a test and a production environment. The API output formats for data clients are: JSON and media (tiff, jpg, pdf, etc.).
We distinguish two types of API:
Media APIs
The media APIs can be used to retrieve media files (photos, safety sheets, pdfs, etc.).
| Test environment (UAT) | |
| Account API | https://uat-datasource.gs1.nl:5443/Account/Login |
| Media help page | https://uat-datasource.gs1.nl/swagger/ui/index |
| Media basis url | https://uat-datasource.gs1.nl |
| Production environment (PROD) | |
| Account API | https://datasource.gs1.nl:5443/Account |
| Media help page | https://datasource.gs1.nl/swagger/ui/index |
| Media basis url | https://datasource.gs1.nl/api |
GDSN APIs
The GDSN APIs can be used to retrieve product data from consumer and trade units. Data receivers can retrieve all articles published to them as well as the public articles. Queries can be made per article hierarchy, item or data module.
| Test environment (UAT) | |
| Account API | https://uat-datasource.gs1.nl:5443/Account/Login |
| GDSN API help page | https://uat-datasource.gs1.nl:5443/helpPages/gdsnApi/index |
| GDSN API | https://uat-datasource.gs1.nl:5443/helpPages/gdsnApi/index |
| Public item API help page | https://uat-datasource.gs1.nl:5443/helpPages/publicItemApi/in |
| Public item API | https://uat-datasource.gs1.nl:5443/PublicItemApi |
| Production environment (PROD) | |
| Account API | https://datasource.gs1.nl:5443/Account |
| GDSN API help page | https://datasource.gs1.nl:5443/helpPages/gdsnApi/index |
| Public item API help page | https://datasource.gs1.nl:5443/helpPages/publicItemApi/index |
| Public item API | https://datasource.gs1.nl:5443/PublicItemApi |
Availability Public Item API
| Monday - Friday from 07.00 - 18.00 | |
| Limit per second | 5 |
| Limit per minute | 60 |
| Limit per hour | 500 |
| Limit per day | 5000 |
| Monday - Friday from 18.00 - 07.00 | |
| Limit per second | 10 |
| Limit per minute | 120 |
| Limit per hour | 1000 |
| Limit per day | 10.000 |
|
Saturday and Sunday (Saturday night maintenance) |
|
| Limit per second | 10 |
| Limit per minute | 120 |
| Limit per hour | 1000 |
| Limit per day | 10.000 |