Items uit het domein “purchases” stellen aankoopfacturen voor. Aankoopfacturen kunnen niet handmatig worden aangemaakt, omdat ze automatisch via Peppol worden ontvangen. Aanpassingen kunnen alleen worden doorgevoerd in het veld 'state'.
URL opbouw
- Alle aankoopfacturen:
GET /api/v1/purchases - Specifieke aankoopfactuur:
GET /api/v1/purchases/{purchase_id}
Velden
| Veldnaam | Type | Omschrijving | Voorbeeld | ||
| int | Uniek ID van de aankoopfactuur | 13 | ||
| uri | text | URL naar de aankoopfactuur | /api/v1/purchases/13 | ||
| supplier_id | int | Unieke ID van de leverancier | 11 | ||
| supplier_uri | text | URL naar de leverancier | /api/v1/suppliers/11 | ||
| supplier_name | text | Naam van de leverancier. | Mobile Vikings NV | ||
| state | text | Status van de aankoopfactuur. Mogelijke waarden: pending, accepted, overdue, rejected, paid | pending | ||
| date | date | Factuurdatum van de aankoopfactuur. Formaat YYYY-MM-DD. | 2024-09-04 | ||
| due_date | date | Datum waarop betaling verschuldigd is. Formaat YYYY-MM-DD. | 2024-10-04 | ||
| currency | text | De valuta van de aankoopfactuur . Dit moet een 3-lettercode zijn. Standaard 'EUR' als niet gespecificeerd. | EUR | ||
| total_without_tax | float | Totaalbedrag van de aankoopfactuur exclusief btw. | 500 | ||
| total_with_tax | float | Totaalbedrag van de aankoopfactuur inclusief btw. | 605 | ||
| file_available | text | Geeft aan of een bestand beschikbaar is voor de aankoopfactuur . Kan 'yes' of 'no' zijn. | yes | ||
| has_attachments | text | Geeft aan of er extra bijlagen zijn voor de aankoopfactuur . Kan 'yes' of 'no' zijn. | yes | ||
| created | date | Datum waarop de aankoopfactuur is aangemaakt. Formaat YYYY-MM-DD. | 2024-08-30 | ||
| references | list | Referenties van de aankoopfactuur. 3 types referenties beschikbaar: peppol, transmission, purchase_order |
| ||
| tags | list | Lijst van tags die aan de aankoopfactuur zijn gekoppeld. |
|
Voorbeeld in JSON:
{
"purchase_id": 104,
"uri": "https://.../api/v1/purchases/104",
"supplier_id": 72,
"supplier_uri": "https://.../api/v1/suppliers/72",
"supplier_name": "Telenet BV",
"state": "pending",
"number": "00390002",
"date": "2024-11-07",
"due_date": "2024-12-07",
"currency": "EUR",
"total_without_tax": 2500,
"total_with_tax": 3025,
"file_available": "yes",
"has_attachments": "yes",
"created": "2024-11-12",
"references": [
{
"type": "peppol",
"value": "cb7ec06a-4180-4f19-94fc-c4c711346fe4"
},
{
"type": "transmission",
"value": "c038dbdc1-26ed-41bf-9ebf-37g3c4ceaa58"
},
{
"type": "purchase_order",
"value": "PO-987654"
}
],
"tags": [
{
"name": "accountant"
}
]
}