GS1 Synkka – Dokumentaatio ja päivitykset
Tältä sivulta löydät dokumentteja ja ohjeita GS1 Synkan tietosisällöistä. Kerromme sivulla myös palveluun tulevista päivityksistä.
GS1 Synkka -tuotetietopalvelun päivitykset
Päivitämme GS1 Synkka -tuotetietopalvelua alla olevien ajankohtien mukaan. Päivityksen yhteydessä tuotantoympäristössä on aina viikonlopun mittainen käyttökatko, josta tiedotamme erikseen.
Päivitykset vaikuttavat GS1 Synkan sanomarakenteeseen sekä tietosisältöön, eli käytettäviin attribuutteihin (tietokenttä), koodiarvoihin ja tarkastussääntöihin.
| Versio | Ajankohta | Käyttöönotto | Testi-ympäristö | Tietoprofiili | Muutokset |
|---|---|---|---|---|---|
| 3.1.31 | Toukokuu | 24.05.2025 Tuotannon käyttökatko | 4.4. - 21.4. ympäristön päivitys 29.4.25 asiakastestaus alkaa | päivitetty 11.6.2025 | Lataa |
| 3.1.32 | Elokuu | 23.08.2025 Tuotannon käyttökatko | 17.7. - 24.7 ympäristön päivitys 28.7.25 asiakastestaus alkaa | päivitetty 29.10.2025 | päivitetty 15.8 |
| 3.1.33 | Marraskuu | 15.11.2025 Tuotannon käyttökatko | 2.10.- ympäristön päivitys 20.10.25 asiakastestaus alkaa | Lataa päivitetty 4.12.2025 | Lataa päivitetty 4.12.2025 |
| 3.1.34 | Helmikuu | 21.2.2026 | Helmikuu 2026 päivitys on PERUUTETTU | ||
| 3.1.35 | Toukokuu | 16.5.2026 | |||
| 3.1.36 | Elokuu | 22.8.2026 | |||
| 3.1.37 | Marraskuu | 14.11.2026 |
XML-rajapinta
GS1 Synkan integraation voi toteuttaa käyttäen standardinmukaisia xml-sanomia. Tuetut tiedonsiirtoprotokollat ovat AS2 ja FTPS.
| Sanomamallit | Lataa | 7.11.18 | Sanomamallit (CIC, CIHW, CIS, GS1 Response ja RFCIN) |
| AS2 Connectivity Guide | Lataa | 1.09.17 | Kuvaus yhteysasetuksista |
| FTPS Connectivity Guide | Lataa | 1.09.17 | Kuvaus yhteysasetuksista |
| Yhteyslomake/Connectivity guide | Lataa | Lomake AS2 tai FTPS yhteyden avaamista varten |
API-dokumentaatio
Tuotantoympäristössä FTP- ja APIn token-autentikoinnissa käytetään kirjatutumiseen samaa käyttäjätunnusta kuin OmaGS1-palvelussa, mutta salasana tulee asettaa erikseen alla olevasta linkistä:
https://sso.tradeconnectors.org/ResetPassword/ResetPassword
Salasana voi olla sama tai eri kuin OmaGS1-tunnuksella. UAT-ympäristöissä kirjautumiseen käytetään samaa salasanaa kuin käyttöliittymässä, eikä sitä tarvitse asettaa erikseen.
GS1 Synkassa on kolme API-rajapintaa, joiden mahdollistamat tietosisällöt poikkeavat toisistaan:
- My Products API
- Public Products API
- Media API.
Kaksi ensimmäistä mahdollistavat tuotetietojen hakemisen ja viimeinen median lataamisen sekä hakemisen järjestelmästä. API-dokumentaatio on jaettu omiksi kokonaisuuksikseen. Alla on linkit dokumentaatioon.
| My Products API v. 2.0 | Lue lisää | GS1 Synkkaan ja muihin GDSN-pankkeihin perustettujen sekä private label -tuotteiden tietojen hakemisen mahdollistava API-rajapinta. Rajapinnan käyttö edellyttää tuotetietokyselyiden luomista ja ylläpitämistä GS1 Synkan käyttöliittymän kautta. Tavarantoimittajat voivat hakea omien tuotteidensa tietoja tämän rajapinnan kautta. |
| Public Products API v. 2.0 | Lue lisää | GS1 Synkkaan perustettujen julkisten tuotteiden tuotetietojen hakemisen mahdollistava API-rajapinta. Tämän rajapinnan kautta ei saa haettua muihin tuotetietopankkeihin perustettujen tai private label -tuotteiden tietoja. |
| Media API | Lue lisää | Media API:n kautta tavarantoimittaja voi ladata GS1 Synkkaan mediatiedostojaan. Vastaanottajat voivat hakea API-rajapinnan kautta mediatiedostoja sekä luoda niille kyselyitä. |
Muut tiedostot
| Dokumentin otsikko | Viimeisin muutos | Kuvaus | |
|---|---|---|---|
| Suomen terveydenhuollon tietoprofiili 12 2021 | Lataa | 13.12.21 | Terveydenhuolto, attribuutit, koodilistat, validointisäännöt. |
| GDSN-dokumentaatio | Lue lisää | 26.6.2023 | Linkki GDSN:n virallisille sivuille, mistä löytyy englanninkieliset dokumentit ja skeemat. Jokaisen version dokumentit on esitelty omalla sivulla, voit tarkastella nykyistä ja tulevaa versiota. |