Documentation

Quotation

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.

Response fields

{
  "data": [
    {
      "Id": "string",
      "QuotationNrPostNL": "string",
      "SupplierID": "string",
      "QuotationSubject": "string",
      "QuotationDescription": "string",
      "PropertyId": "string",
      "Area": "string",
      "Asset": "string",
      "Street": "string",
      "Number": "string",
      "NumberAddition": "string",
      "PostalCode6": "string",
      "PostalCode4": "string",
      "City": "string",
      "CountryCode": "NL",
      "PostNLContact": "string",
      "QuotationRequestDate": "2021-01-29",
      "Attachment1": "string",
      "Attachment2": "string",
      "Attachment3": "string",
      "Attachment4": "string",
      "Attachment5": "string",
      "QuotationExpiryDate": "2021-01-29",
      "response": "string",
      "warningMessage": "string",
      "errorMessage": "string",
      "id": "string",
      "objectNameId": "string"
    }
  ]
}

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.

{
  "SupplierID": "string",
  "QuotationNrPostNL": "string",
  "QuotationNrSupplier": "string"
}

Response fields

{
  "data": [
    {
      "response": "string",
      "warningMessage": "string",
      "errorMessage": "string",
      "id": "string",
      "objectNameId": "string"
    }
  ]
}

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:

DutchEnglish
Uren (aantal)Hours (amount)
Loonkosten (kosten per uur)Labour (cost per hour)
VoorrijkostenCall-out charges
MateriaalkostenMaterials
Onderaanemer toeslagSubcontractor fee

(* the total amount of the quotation will be automatically be calculated, therefore adding the total amount is unnecessary)

Call guidelines

{
  "Line": [
    {
      "SupplierID": "string",
      "QuotationNrPostNL": "string",
      "DocumentId": "string",
      "QuotationCostDescription": "string",
      "QuotationCostQuantity": 0,
      "QuotationCostPrice": 0,
      "QuotationCostCurrency": "string",
      "QuotationCostUnit": "string"
    }
  ]
}

  • 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
All the fields are required.

Response fields

{
  "data": [
    {
      "response": "string",
      "warningMessage": "string",
      "errorMessage": "string",
      "id": "string",
      "objectNameId": "string"
    }
  ]
}

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.

Response fields

{
  "data": [
    {
      "Id": "string",
      "QuotationNrPostNL": "string",
      "SupplierID": "string",
      "PostNLQuotationStatus": "string",
      "RejectReason": "string",
      "response": "string",
      "warningMessage": "string",
      "errorMessage": "string",
      "id": "string",
      "objectNameId": "string"
    }
  ]
}

Possible error messages

  • SupplierID cannot be empty
  • Unknown SupplierID specified
  • SupplierID is does not have a valid supplier-Category