Mapping-API

Om te voorzien in mappingen tussen meerdere datacatalogi biedt SIVI de mapping-API aan. Deze service verzorgt het transformeren van een bericht volgens een datacatalogus naar een bericht volgens een ander gewenste datacatalogus. Momenteel is er een API beschikbaar voor het mappen van AFD 1.0-berichten naar SIVI AFS, op korte termijn komt ook een vice versa-mapping beschikbaar. Verder staan mappingen op de planning vanuit andere domeinen (bijv. Ockto, Pensioenregister en vooringevulde aangifte Belastingdienst).

Actief

Momenteel biedt SIVI de volgende mappingTypes aan via de mapping-API:

AFD1_AFD2: mapping van AFD 1.0-berichten naar SIVI AFS

Om de mapping-API te kunnen gebruiken moet er een aantal stappen worden doorlopen, deze stappen worden in de volgende paragrafen behandeld.

Beschikbaarheid

De API is in principe 24 maal 7 beschikbaar, maar kan door een calamiteit of onderhoud tijdelijk niet beschikbaar zijn. De architectuur van de software is zo ontworpen dat de service bij releasing van updates beschikbaar blijft om de downtime tot een minimum te beperken.

Fair Use Policy

De Fair Use Policy staat u toe de beschikbaar gestelde API in eigen producten en diensten te gebruiken zolang u het digitaal stelsel niet zo zwaar belast dat andere gebruikers daar substantiële hinder van ondervinden.

Request throttling

Om de belasting van de server te beperken is request throttling ingesteld, d.w.z. dat er een x aantal berichten binnen een tijdsbestek per gebruiker verwerkt kunnen worden.

Deze staat momenteel op 40 berichten per minuut per gebruiker.

Grootte bericht

De grootte van het bericht is van invloed op de performance en belast de server in aanzienlijke mate. Om deze reden is een maximale grootte van het bericht ingesteld.

De maximale grootte van een bericht is momenteel 2Mb.

Logging

Bij het gebruik van de mapping-API worden de volgende gegevens bewaard:

• E-mailadres van het gebruikte systeemaccount van de gebruiker.
• Soort mapping.
• Datum en tijd van aanroep.
• Tijdsduur transactie in milliseconden.
• Grootte bericht.
• Bestandstype inkomend bericht.
• Resultaat van mapping succesvol of foutmelding.
• Versienummer van de mapping.
• Versienummer van de processoftware.
  

Deze gegevens worden gebruikt voor monitoring en voor ondersteuning. Deze logging bevat niet het ingezonden bericht en antwoord, dus bij ondersteuning kan gevraagd worden om deze berichten of een deel daarvan, indien nodig.

Ondersteuning

Voor specifieke situaties is er persoonlijke ondersteuning nodig. SIVI zal trachten om deze ondersteuning binnen kantoortijden vlot te verlenen. Dit kan ondersteuning zijn bij het aansluiten van de service, problemen met specifieke berichten of functionele vragen over het gebruik van de API.

Heb je verder nog vragen of ondersteuning nodig bij foutmeldingen, neem dan contact op via support@sivi.org.