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.
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 | Validointisäännöt |
|---|---|---|---|---|---|---|
| 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 17.9.26 | Lataa | ||
| 3.1.37 | Marraskuu | Tuotannon käyttökatko 13.11. klo 18:00 - 16.11.2026 klo 9:00 | 8.10 - ympäristön päivitys 30.10. asiakastestaus alkaa | Lataa Päivitetty 8.10.26 BMS IDt lisätty | Lataa | Lataa |
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 ja sivustot
| Dokumentin otsikko | Viimeisin muutos | Kuvaus | |
|---|---|---|---|
| Suomen terveydenhuollon tietoprofiili 12 2021 | Lataa | 13.12.21 | Terveydenhuolto, attribuutit, koodilistat, validointisäännöt. |
| GDSN-dokumentaatio | Lue lisää | 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. | |
| GDSN hakutoiminto | Lue lisää | Linkki GDSN: virallisille sivuille, joilla voi hakea globaaliin tietomalliin kuuluvia tietoja, kuten attribuutteja, koodilistoja ja validointisääntöjä. | |
| GPC Browser | Lue lisää | GPC (Global Product Classification) on GS1:n tuoteluokituksen standardi. GPC Browserissa voit tarkastella nykyistä ja tulevaa versiota. |