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
-
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.
-
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.
-
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
}
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"
}
}
Goed om te weten
-
De sleutel handelt voor de beheerder
Een sleutel werkt namens de beheerder die ze maakte. Wat u schrijft, volgt dezelfde regels als een aankoop in de app.
-
Opnieuw proberen
Komt een webhook niet aan, dan probeert Furnipilot het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2 uur, 5 uur en 10 uur.
-
Ondertekend
Elk bericht draagt de koppen webhook-id, webhook-timestamp en webhook-signature, volgens Standard Webhooks. Een webhook gaat enkel naar een https-adres.
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.comAndere koppelingen
Alle koppelingenLeg uw eerste aankoop vast
Maak een account aan met het e-mailadres van uw zaak.
