Quotation requests — details¶

GET Retrieve the full details of a single quotation request.

Using the id from the list endpoint you can retrieve the full details of a quotation request, including participants, packages, questionnaire, consumption and (where available) acceptances.

Access

Available to PharmaPortal licence holders only.

Endpoint¶

TestProduction

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

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

Parameter	In	Type	Required	Description
`id`	path	string	yes	Request ID, e.g. `ronde-3077`.

Authentication¶

Header	Description
`x-portal-key`	The API key issued to your organisation.

Request¶

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

Response¶

Code	Meaning
`200`	Correct request.
`401`	Invalid authentication or HMAC.

Example of a successful response (abbreviated):

{
  "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": []
  }
}

Key fields¶

Field	Type	Description
`status`	string	`nieuw`, `offerte ingediend`, `besluitvorming afgerond`, `afgerond`.
`piCodeCoordinator`	integer	PI-Code of the coordinating party.
`looptijdenMaanden`	int[]	Allowed contract durations in months.
`vragenLijst`	object[]	Questions for the quotation. `soortVraag`: `tekst`, `numeriek`, `datum`, `meerkeuze`.
`deelnemers`	object[]	Participating organisations with contact person.
`pakketten`	object[]	Packages per ATC code.
`documenten`	object[]	Downloadable documents (see below).
`offertes`	object[]	Your own submitted quote lines (see below).
`acceptaties`	object[]	Only present when status is `besluitvorming afgerond`.

About acceptaties

The acceptaties key only exists once ZAGIS has sent decision-making to PharmaPortal. An empty array [] means the ZAGIS users have not (yet) made a choice.

`offertes` — your submitted quote lines¶

The offertes key contains a copy of the quote lines your own organisation submitted through the Offerteloket. The key is always present; an empty array [] means no lines were submitted through the loket — quotes delivered on paper or by e-mail do not appear here. A resubmission fully replaces the earlier lines; there is no history.

{
  "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
    }
  ]
}

Field	Type	Description
`zindexNummer`	integer	Z-Index number of the quoted article.
`vastOfPercentage`	string	`vast` (fixed amount) or `percentage`. Determines the meaning of `prijzen[].prijs`.
`prijzen`	object[]	Price matrix per `route` (`direct`/`groothandel`) and `looptijdMaanden`.
`terugkoppeling_vanuit_inkoper`	string	Feedback from the buyer. `null` while the status is before `besluitvorming afgerond`.
`isStaffel` / `staffelInformatie`	boolean / object[]	Historical tiered-price lines only; the loket no longer accepts new tiers. For a tiered line, `prijzen` may be incomplete.

Determining lines that were not awarded

Compare offertes[].prijzen with acceptaties[] on the combination (zindexNummer, route, looptijdMaanden). A price line without a matching acceptance was quoted but not awarded.

Downloading documents

Retrieve documents via GET /api/offerte-aanvraag/{id}/documenten/{uuid}.