Dokumentaatio ja päivitykset
Tämä sivu sisältää dokumentteja ja ohjeita liittyen tietosisältöön. Sivulla on myös listattuna tulevat päivitykset.
Synkka-tuotetietopalvelu päivittyy alla olevien ajankohtien mukaan. Päivityksen yhteydessä tuotantoympäristössä on aina viikonlopun mittainen käyttökatko, josta tiedotamme erikseen.
Päivitys vaikuttaa Synkan tietosisältöön ja sanomarakenteeseen. Tietosisällöllä tarkoitetaan käytettäviä attribuutteja (tietokenttiä), koodiarvoja ja tarkastussääntöjä.
| Versio | Ajankohta | Käyttöönotto | Testi-ympäristö | Tietoprofiili | Muutokset |
|---|---|---|---|---|---|
| 3.1.23 | Toukokuu | 20.05.2023 | 3.4.2023 | Lataa päivitetty 5.5.23 | |
| 3.1.24 | Elokuu | 19.08.2023 | päivitetty 24.8.23 | Lataa | |
| 3.1.25 | Marraskuu | 18.11.2023 | 5.-15.10. ympäristön päivitys 16.10. Asiakastestaus alkaa | Lataa | Lataa |
| 3.1.26 | Helmikuu | 24.02.2024 | |||
| 3.1.27 | Toukokuu | 18.05.2024 | |||
| 3.1.28 | Elokuu | 17.08.2024 | |||
| 3.1.29 | Marraskuu | 16.11.2024 | |||
| 3.1.30 | Helmikuu | 22.05.2025 | |||
| 3.1.31 | Toukokuu | 24.05.2025 | |||
| 3.1.32 | Elokuu | 23.08.2025 | |||
| 3.1.33 | Marraskuu | 15.11.2025 |
XML-rajapinta
Synkka-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
Synkassa on kolme API-rajapintaa, joiden mahdollistamat tietosisällöt poikkeavat toisistaan. Nämä ovat My Products API, Public Products API sekä 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ää | 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ä 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ää | 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 Synkkaan mediatiedostojaan. Vastaanottajat voivat hakea API-rajapinnan kautta mediatiedostoja sekä luoda niille kyselyitä. |
Muut tiedostot
| Dokumentin otsikko | Viimeisin muutos | Kuvaus | |
|---|---|---|---|
| Suomen tietoprofiili | Lataa | 5.5.2023 | Suomen tietoprofiili sisältää käytettävät attribuutit, koodiarvot ja tarkastussäännöt. |
| 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. |