Quotation request
GET//supplier/v1/quotation/request Retrieve a quotation request
Through this API, all quotation requests are presented that are associated with the stated supplier ID.
Call guidelines
By stating your apikey and supplierID you receive all quotation requests available for you. Each quotation request can be received once.
The fields apikey and SupplierID should be provided. RequestDate is optional and will be used to show quotations from a specific date.
Possible error messages
- SupplierID cannot be empty
- Unknown SupplierID specified
- SupplierID does not have a valid supplier-Category
- Dateformat is not valid
Confirmation retrieval of quotation request
POST/supplier/v1/quotation/request Provide a quotation request
Through this API, confirmation of successful registering the quotation request can be send by posting the unique reference of the supplier.
Call guidelines
By stating your apikey and the body you will hand your unique ticketing ID to PostNL. All fields are mandatory.
Possible error messages
- SupplierID cannot be empty
- Unknown SupplierID specified
- QuotationNrPostNL cannot be empty
- QuotationNrPostNL does not occur in SupplierID
- QuotationNrSupplier is allready filled in Axxerion
- Quotation is not in status 1.1
- SupplierID does not have a valid supplier-Category
Quotation items
POST/supplier/v1/quotation Provide a quotation
Through this API the quotation will be posted via quotation lines. The following quotation items can be, but are not limited to, registered:
| Dutch | English |
| Uren (aantal) | Hours (amount) |
| Loonkosten (kosten per uur) | Labour (cost per hour) |
| Voorrijkosten | Call-out charges |
| Materiaalkosten | Materials |
| Onderaanemer toeslag | Subcontractor fee |
(* the total amount of the quotation will be automatically be calculated, therefore adding the total amount is unnecessary)
- SuppierID: CON- reference of supplier
- QuotationNrPostNL: QUI- reference of quotation
- QuotationCostDescription: Description of the quotation item
- QuotationCostQuantity: Amount of the quotation item
- QuotationCostPrice: Price per unit of quotation item
- QuotationCostCurrency: Currency value (i.e. EUR) (when empty, EUR is selected).
- QuotationCostUnit: Unit of quotation item. If necessary the values will be shared by PostNL
Possible error messages
- SupplierID cannot be empty
- Unknown SupplierID specified
- QuotationNrPostNL cannot be empty
- QuotationNrPostNL does not occur in SupplierID
- Quotation is not in status 1.2 or 2.1
- SupplierID is does not have a valid supplier-Category
- Unknown Currency used
- Unknown Unit used
- Maximum of QuotationItems is reached (max is currently set at 10)
Quotation reply
GET/supplier/v1/quotation/status Retrieve a quotation status
Through this API the answer to a quotation can be received. The result consist of all the quotations available to a supplier ID, and can either give the status “geaccepteerd”(accepted) or “afgewezen” (rejected).
Call guidelines
By stating your apikey and supplierID you receive all statuses of quotations pending at PostNL requests available for you. Each status can be received once.
The fields apikey and SupplierID should be provided.
Possible error messages
- SupplierID cannot be empty
- Unknown SupplierID specified
- SupplierID is does not have a valid supplier-Category