Calculeren via de API

Eenvoudig voorbeeld

Om een offerte uit te rekenen via de API, dien je ze aan te maken als volgt. Merk op dat je in de quantityFormula velden echte formules kan gaan gebruiken.

POST https://app.robaws.com/api/v2/offers
Content-Type: application/json

{
  "calculated": true, //geeft aan dat het over een gecalculeerde offerte gaat (versus eenvoudige offerte)
  "addressDistance": { //geef optioneel het aantal kilometers door naar de werf
    "value": "10",
    "unit": "KM"
  },
  "lineItems": [
    {
      "quantityFormula": "DISTANCE_KM", //voorbeeld: gebruik de voorgedefinieerde DISTANCE_KM variabele om het aantal kilometers te nemen als aantal
      "calculationLineItems": [
        {
          "description": "Kilometers",
          "quantityFormula": "1",
          "price": 0.5
        }
      ]
    }
  ]
}

Als alles goed is, krijgt u een 201 CREATED response terug met in de body onder andere:

 "calculationStatus": "PENDING"

De status "PENDING" geeft aan de calculatie aangevraagd is en in de wachtrij staat. U kan ofwel pollen (regelmatig de offerte ophalen) tot de status op "DONE" staat, of U kan een webhook gebruiken om te weten dat de berekening klaar is (aangeraden).

Webhook voor calculationStatus

Registreer een webhook als volgt om op de hoogte te worden gebracht wanneer de berekening van een offerte klaar is.

POST https://app.robaws.com/api/v2/webhook-endpoints
Content-Type: application/json

{
  "url": "https://webhooks.your-app.com/robaws/offer/recalculated",
  "events": ["offer.recalculated"]
}

Het bericht dat we via de webhook naar uw applicatie zullen sturen ziet er als volgt uit:

(Klik hier voor meer informatie over webhooks)

{
  "id": "08241443-0335-4f3d-94a2-d6da6c201545",
  "event": "offer.recalculated",
  "resource": "/offers/3409",
  "user": null,
  "timestamp": "2025-09-15T06:35:10.329Z",
  "data": {
    "id": "3409"
  }
}

Als u daarna een GET doet naar de betreffende offerte, kan u de totalen & subtotalen ophalen.

Voorbeeld met postnummers

Indien u wilt werken met voorgedefinieerde postnummers kan dit ook. Dan ziet de POST request er als volgt uit:

POST https://app.robaws.com/api/v2/offers
Content-Type: application/json

{
  "calculated": true, //geeft aan dat het over een gecalculeerde offerte gaat (versus eenvoudige offerte)
  "addressDistance": { //geef optioneel het aantal kilometers door naar de werf
    "value": "10",
    "unit": "KM"
  },
  "lineItems": [
    {
      "quantityFormula": "1",
      "chapter": "1.1" // hier geef je het postnummer mee
    },
    {
      "quantityFormula": "1",
      "chapter": "1.2" // hier geef je het postnummer mee
    }
  ],
  "actions": [
    {
      "action": "ASSIGN_POSTS" //posten uit bibliotheek toewijzen adhv chapter
    },
    {
      "action": "UPDATE_PRICES", // zorgen dat de prijzen correct staan adhv de laatste prijzen uit uw artikelbibliotheek
      "strategy": "UPDATE_COST_PRICE_AND_SALES_PRICE" //of UPDATE_COST_PRICE_KEEP_MARGIN	
    }
  ]
}

Bijgewerkt op: 15/09/2025