ZAGIS Prijs API

Voor gebruikers van ZAGIS is het mogelijk om via een API vanuit een eigen systeem de geldende prijs voor een specifiek product op te vragen

Deze prijs API is een REST api met 1 endpoint en 1 mogelijke actie

Test API endpoint:
https://demo.zagis.nl/api/zagis/prijsCheck

Productie API endpoint:
https://www.zagis.nl/api/zagis/prijsCheck

Authenticatie

Deze API maakt gebruik van:

  • IP-whitelisting voor beveiliging
  • Een API key voor authenticatie & rate-limiting
  • HMAC voor integriteitscontrole
Headers

x-zagis-key De aan uw organisatie uitgereikte API key

x-zagis-hmac Hexadecimaal geëncodeerde SHA-512 HMAC van het request body

Request

Requests zijn POST requests met een JSON payload. Voorbeeld: 

{
	"zindexNummer": 12345678, // Het Z-Index nummer van het te controleren artikel
	"route": "direct", // 'direct' of 'groothandel'
	"datum": "01-01-2018" // Datum in nederlandse notatie waarvoor de geldende prijs wordt bepaald
}
Response

Deze API retourneert de volgende HTTP status codes:

  • 200 Bij een correct request

Voorbeeld van een response bij een succesvol & correct request: 

{
	"result" : "success",	// 'success' of 'error'
	"errorMessage" : "",	// Error message bij fout
	"errorCode" : 0,		// Error code bij fout
	"zindexNummer" : "12345678", // Het gecontroleerde Z-Index nummer
	"route" : "direct",	// De gecontroleerde leveringswijze
	"datum" : "01-01-2018", // De gecontroleerde datum
	"soortPrijs" : "aip", // aip, gip of contract
	"basisPrijsVerpakking" : 0, // Kale prijs ex BTW per verpakking
	"toeslagenVerpakking" : 0, // Toeslagen totaal per verpakking
	"btwBedrag" : 0, // BTW per verpakking
	"btwPercentage" : 0, // Geldend BTW percentage bij inkoop
	"totaalPrijsVerpakkingExBtw" : 0, // Totale prijs ex BTW per verpakking
	"totaalPrijsVerpakkingIncBtw" : 0, // Totale prijs inc BTW per verpakking
	"verpakkingsHoeveelheid" : 0, // Aantal counting units (tabletten/ampullen/flacons etc) per verpakking
	"aantalBasiseenheden" : 0, // Aantal basiseenheden (tabletten/mililiters/eenheden) per verpakking
	"contractPartij" : "", // Leveranciernaam van het artikel (Contractpartij bij contract, "Groothandel" bij GIP, Registratiehouder bij AIP)
  "contractPartijNaam" : "", // Leveranciernaam van het artikel (Contractpartij bij contract, "Groothandel" bij GIP, Registratiehouder bij AIP)
  "contractPartijNummer" : "", // G-Standaard NAW-Nummer van het artikel (Contractpartij bij contract, leeg bij GIP, Registratiehouder bij AIP)
	"artikelIsActief" : false, // Is artikel actief in de G-Standaard
	"artikelUnKode" : "", // UN kode uit de G-Standaard bij een vervallen artikel
	"artikelUnDatum" : "", // Datum waarop UN kode ingaat bij een vervallen artikel
	"ziekenhuis" : "" // Naam van het ziekenhuis
}

Voorbeeld van een response bij een inhoudelijk foutief request: 

{
	"result":	"error",
	"errorMessage":	"Onbekend Z-Index nummer",
	"errorCode":	2
}
Aandachtspunten

ZAGIS kent aparte prijsafspraken voor levering via groothandel en directe levering. Het controlerende systeem moet per request zelf bepalen welke prijs wordt opgevraagd

Indien u uw integratie wilt testen neemt u tijdig contact met ons op via info@zagis.nl. Wij zetten dan testdata voor u klaar en voorzien u van een API-Key.