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.27 | Toukokuu | 18.05.2024 Tuotannon käyttökatko 17.5. klo 18:00 - 20.5. klo 9:00 | 4.4. - 18.4. ympäristön päivitys 19.4.24 asiakastestaus alkaa | päivitetty 29.5.2024 | Lataa |
| 3.1.28 | Elokuu | 17.08.2024 Tuotannon käyttökatko | 11.7. - 21.7. ympäristön päivitys 22.7.24 asiakastestaus alkaa | päivitetty 15.8.2024 | Lataa |
| 3.1.29 | Marraskuu | 16.11.2024 Tuotannon käyttökatko | 3.10. -13.10. ympäristön päivitys 21.10.24 asiakastestaus alkaa | päivitetty 10.10.2024 | Lataa |
| 3.1.30 | Helmikuu | 22.02.2025 | Helmikuu 2025 päivitys on PERUUTETTU | ||
| 3.1.31 | Toukokuu | 24.05.2025 | |||
| 3.1.32 | Elokuu | 23.08.2025 | |||
| 3.1.33 | Marraskuu | 15.11.2025 |
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
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. |