← API documentatie

Offertes API

Inhoud
GET /quotes

Offertes ophalen

Geeft een gepagineerde lijst van offertes. Beschikbare filters: quote_number, status (draft, sent, accepted, rejected), date_from + date_to, total_amount_min + total_amount_max, page en page_size.

Verzoek
curl "https://financial.gyvex.com/api/quotes?status=sent" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
GET /quotes/{quote}

Offerte ophalen

Geeft één offerte met regels. Voeg ?customer toe om ook de klantgegevens op te nemen.

POST /quote/store

Offerte aanmaken

Werkt zoals het aanmaken van een factuur, met deze verschillen:

  • status is draft, sent, accepted of rejected.
  • customer_id en due_date zijn optioneel. De vervaldatum mag niet voor de offertedatum liggen.
  • Het offertenummer wordt automatisch doorgenummerd. Het veld quote_number moet u wel meesturen, maar de waarde wordt vervangen door het volgende nummer.
  • Geef bij elke regel vat_percentage mee.
Verzoek
curl -X POST "https://financial.gyvex.com/api/quote/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_number": "1",
    "date": "2026-11-18",
    "customer_id": 7,
    "status": "draft",
    "items": [
      {
        "description": "Ontwerp huisstijl",
        "quantity": 1,
        "unit_price": 750,
        "vat_percentage": 21
      }
    ]
  }'
PUT /quote/{quote}/update

Offerte bijwerken

Werkt een offerte bij. Net als bij facturen vervangen de meegestuurde items alle bestaande regels.

GET /quote/{quote}/pdf

Offerte-PDF ophalen

Genereert de PDF van een offerte. Het antwoord heeft dezelfde opbouw als bij een factuur-PDF.

POST /quote/{quote}/convert

Offerte omzetten naar factuur

Maakt een conceptfactuur van een offerte, met dezelfde klant en regels, en zet de offerte op accepted. Alleen mogelijk voor een verzonden offerte (sent) met een klant en minstens een regel. Bij succes volgt status 201 met de nieuwe factuur.

Verzoek
curl -X POST "https://financial.gyvex.com/api/quote/1/convert" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
DELETE /quote/{quote}

Offerte verwijderen

Verwijdert een offerte. Bij succes volgt status 204 zonder inhoud.

Verzoek
curl -X DELETE "https://financial.gyvex.com/api/quote/1" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"

Hulp nodig bij uw koppeling?

Maak een ticket aan via "Mijn Gyvex" in uw dashboard. Met Premium krijgt u priority support, met reactie binnen 24 uur.