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 Data yhdistää syksyn 2026 aikana GS1 Synkan ja GS1 Rekisterin toiminnot yhteen moderniin palveluun. Tulemme julkaisemaan GS1 Datan rajapintojen dokumentaation lähiviikkoina.
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.33 | Marraskuu | 15.11.2025 Tuotannon käyttökatko | 2.10.- ympäristön päivitys 20.10.25 asiakastestaus alkaa | päivitetty 4.12.2025 | päivitetty 4.12.2025 |
| 3.1.34 | Helmikuu | 21.2.2026 | Valmisteverokoodilistan päivitys
| päivitetty 12.2.26 | päivitetty 12.2.26 |
| 3.1.35 | Toukokuu | Tuotannon käyttökatko 15.5. klo 18:00 - 18.5. klo 9:00 | 1.4.- ympäristön päivitys 22.4. asiakastestaus alkaa | Päivitetty 28.5.26 | Lataa |
| 3.1.36 | Elokuu | Tuotannon käyttökatko 21.8. klo 18:00 - 24.8. klo 9:00 | Lataa Päivitetty 18.6.26 | Lataa | |
| 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. |