Je maakt eerst een tijdelijke documentbucket aan, uploadt het bestand daarin en koppelt het document-ID daarna aan het juiste item.
Twee soorten uploads
Er zijn twee soorten uploads. Gebruik een tijdelijke bucket voor afbeeldingen of pdf's van een regel, artikel, factuur of certificaat. Gebruik de documenten van een entiteit voor alles met een tabblad Documenten in de interface, zoals projecten en facturen.
Grote bestanden
Bestanden tot 6 MB upload je in één keer. Grotere bestanden verdeel je in delen van maximaal 6 MB, die je met een partNumber vanaf 0 uploadt naar de upload-sessie.
Als je een bestand niet koppelt, wordt het verwijderd wanneer de tijdelijke bucket verloopt.
Zo doe je het
- Maak een tijdelijke documentbucket aan via POST naar
/api/v2/temp-document-buckets - Upload het bestand naar
/api/v2/temp-document-buckets/{bucket-id}/documents, of voor bestanden groter dan 6 MB maak je een upload-sessie aan en upload je de delen naar/api/v2/document-upload-sessions/{sessionId} - Koppel het ontvangen document-ID aan het item, bijvoorbeeld via een PATCH op de aankoopfactuur