Offerteaanvragen — details

GET Haal de volledige details van één offerteaanvraag op.

Met het id uit de lijst-endpoint vraagt u de volledige details van een offerteaanvraag op, inclusief deelnemers, pakketten, vragenlijst, verbruik en (indien beschikbaar) acceptaties.

Toegang

Alleen beschikbaar voor licentiehouders van PharmaPortal.

Endpoint

TestProductie

GET https://demo.pharma-portal.nl/api/offerte-aanvraag/{id}

GET https://www.pharma-portal.nl/api/offerte-aanvraag/{id}

Parameter	In	Type	Verplicht	Omschrijving
id	pad	string	ja	ID van de aanvraag, bijv. ronde-3077.

Authenticatie

Header	Toelichting
x-portal-key	De aan uw organisatie uitgereikte API-key.

Request

curl https://demo.pharma-portal.nl/api/offerte-aanvraag/ronde-x-1 \
  -H "x-portal-key: <uw-api-key>"

Response

Code	Betekenis
200	Correct request.
401	Foutieve authenticatie of HMAC.

Voorbeeld van een succesvolle response (ingekort):

{
  "result": "success",
  "data": {
    "id": "ronde-x-1",
    "status": "nieuw",
    "omschrijving": "Ronde X",
    "ingangsdatumContracten": "2019-02-01T00:00:00+01:00",
    "sluitingsdatumOfferte": "2018-10-13T00:00:00+02:00",
    "piCodeCoordinator": 630001,
    "looptijdenMaanden": [12, 24, 36],
    "vragenLijst": [
      {
        "id": "07ad0b4b-2e89-40c7-a9c6-43ebefefaa5f",
        "vraag": "Testvraag 1",
        "perZindexNummer": false,
        "soortVraag": "tekst"
      }
    ],
    "deelnemers": [],
    "pakketten": [],
    "documenten": [],
    "verbruik": [],
    "offertes": [],
    "acceptaties": []
  }
}

Belangrijkste velden

Veld	Type	Omschrijving
status	string	nieuw, offerte ingediend, besluitvorming afgerond, afgerond.
piCodeCoordinator	integer	PI-Code van de coördinerende partij.
looptijdenMaanden	int[]	Toegestane contractlooptijden in maanden.
vragenLijst	object[]	Vragen bij de offerte. soortVraag: tekst, numeriek, datum, meerkeuze.
deelnemers	object[]	Deelnemende organisaties met contactpersoon.
pakketten	object[]	Pakketten per ATC-code.
documenten	object[]	Downloadbare documenten (zie hieronder).
offertes	object[]	Uw eigen ingediende offerteregels (zie hieronder).
acceptaties	object[]	Alleen bij status besluitvorming afgerond.

Over acceptaties

De key acceptaties bestaat alleen als er vanuit ZAGIS besluitvorming is verstuurd naar PharmaPortal. Een lege array [] betekent dat de ZAGIS-gebruikers (nog) geen keuze hebben gemaakt.

offertes — uw ingediende offerteregels

De key offertes bevat een kopie van de offerteregels die uw organisatie zelf via het Offerteloket heeft ingediend. De key is altijd aanwezig; een lege array [] betekent dat er geen regels via het loket zijn ingediend — offertes die op papier of per e-mail zijn aangeleverd, verschijnen hier dus niet. Bij een herindiening vervangen de nieuwe regels de eerdere volledig; er is geen historie.

{
  "offertes": [
    {
      "zindexNummer": 15274793,
      "vastOfPercentage": "vast",
      "prijzen": [
        { "route": "direct", "looptijdMaanden": 12, "prijs": "1.23450" },
        { "route": "groothandel", "looptijdMaanden": 24, "prijs": "1.19000" }
      ],
      "toeslag": "0.00",
      "isStaffel": false,
      "staffelInformatie": null,
      "opmerking": null,
      "referentie": "PO-2026-001",
      "heeftBarcode": true,
      "afwijkendJaarVolumeStuks": 0,
      "terugkoppeling_vanuit_inkoper": null
    }
  ]
}

Veld	Type	Omschrijving
zindexNummer	integer	Z-Index-nummer van het geoffreerde artikel.
vastOfPercentage	string	vast (bedrag) of percentage. Bepaalt de betekenis van prijzen[].prijs.
prijzen	object[]	Prijsmatrix per route (direct/groothandel) en looptijdMaanden.
terugkoppeling_vanuit_inkoper	string	Terugkoppeling van de inkoper. null zolang de status vóór besluitvorming afgerond ligt.
isStaffel / staffelInformatie	boolean / object[]	Alleen bij historische staffelregels; het loket accepteert geen nieuwe staffels meer. Bij een staffelregel kan prijzen onvolledig zijn.

Niet-gegunde regels bepalen

Vergelijk offertes[].prijzen met acceptaties[] op de combinatie (zindexNummer, route, looptijdMaanden). Een prijsregel zonder bijbehorende acceptatie is wel geoffreerd maar niet gegund.

Documenten downloaden

Documenten haalt u op via GET /api/offerte-aanvraag/{id}/documenten/{uuid}.