Uw software + Furnipilot

Uw eigen software leest en schrijft aankopen met een API-sleutel, en krijgt een bericht bij een nieuwe aankoop, een andere status of een gelezen document.

Hoe het werkt

  1. Maak een sleutel

    Kies in Furnipilot Instellingen, Koppelingen, Rapporten en API en open API en webhooks. Kies Sleutel, geef ze een naam en de rechten Lezen, Schrijven, Leveranciers of Bedragen. U ziet de sleutel één keer.

  2. Roep de API aan

    Stuur bij elke vraag de kop Authorization: Bearer met uw sleutel, naar https://app.furnipilot.com/api/fpa/v1/extern/aankopen.

  3. Voeg een webhook toe

    Kies Webhook, geef een https-adres en de gebeurtenissen. Furnipilot ondertekent elk bericht met het geheim dat u één keer ziet.

GET /api/fpa/v1/extern/aankopen?status=bevestigd
Authorization: Bearer fpk_...

{
  "aankopen": [{
    "nummer": "FP-00412",
    "titel": "Lisa hoeksalon",
    "status": "bevestigd",
    "leverancier": { "naam": "Zitwerk" },
    "leverweek": "2027-W09"
  }],
  "volgende": null
}
Een vraag en een deel van het antwoord, met demogegevens.

Wat uw software krijgt

  • Wel:

    GET /extern/aankopen en /extern/aankopen/{id}: aankopen lezen, met filters op datum en status.

  • Wel:

    POST /extern/aankopen: een nieuwe aankoop. POST /extern/aankopen/{id}/status: een andere status.

  • Wel:

    GET /extern/leveranciers: de leveranciers van uw zaak.

  • Wel:

    Webhooks bij aankoop.gemaakt, aankoop.status en document.gelezen.

  • Niet:

    Namen van klanten staan nooit in een antwoord of een webhook.

  • Niet:

    Bedragen enkel met het recht Bedragen, en nooit in een webhook.

POST https://uw-software.example/furnipilot
webhook-id: msg_...
webhook-timestamp: 1798704000
webhook-signature: v1,...

{
  "type": "aankoop.status",
  "data": {
    "nummer": "FP-00412",
    "van": "gekocht",
    "naar": "bevestigd"
  }
}
Een webhook bij een andere status, met demogegevens.

In de praktijk

  • Eigen software

    Uw aankopen in uw eigen systeem

    Uw software haalt elke nacht de aankopen op die sinds de vorige keer veranderden.

  • Webwinkel

    Een aankoop vanuit een ander systeem

    Een bestelling uit uw eigen software wordt met één POST een aankoop in Furnipilot.

  • Meldingen

    Meteen weten dat een document gelezen is

    De webhook document.gelezen zegt uw software dat een document klaarstaat. De details haalt ze op met de API.

Over de API

De API van Furnipilot werkt met REST en JSON, op app.furnipilot.com. De webhooks volgen de afspraken van Standard Webhooks.

standardwebhooks.com

Leg uw eerste aankoop vast

Maak een account aan met het e-mailadres van uw zaak.