Bijlages toevoegen

Tijdens het versturen van de factuur kan je ook bijkomend bestanden toevoegen.

Het opladen van deze bijkomende bestanden gebeurt in een afzonderlijke call.

Gebruik de POST-methode met als URL https://eenvoudigfactureren.be/api/v1/uploads.

Verstuur het bestand als form-data met als key ‘file’. Het bestand mag niet groter zijn dan 5MB. Je kan meerdere bestanden in één keer toevoegen door ‘file[]’ te gebruiken. Optioneel kan je ook een bestandsnaam meegeven langs key ‘filename’.

Als antwoord krijg je een lijst terug met per opgeladen bestand:

upload_id: Deze gebruik je bij het verzenden van de e-mail (argument attachments)

filename: Doorgegeven bestandsnaam (deze wordt echter niet bijgehouden en dien je opnieuw door te geven tijdens doorsturen van de attachment per e-mail).

available_until: Geldigheidsperiode waarin het bestand beschikbaar blijft (tot 1 uur na opladen van het bestand).

$p = curl_init('https://eenvoudigfactureren.be/api/v1/uploads');
curl_setopt($p, CURLOPT_HTTPHEADER, [
    "X-API-Key: your_api_key_here",
    "Accept: application/json",
]);
curl_setopt($p, CURLOPT_POSTFIELDS, [
    'file' => new CURLFile('/path/to/attachment.pdf'),
    'filename' => 'attachment.pdf'
]);
curl_setopt($p, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($p);
if (curl_errno($p)) {
    echo 'Error: ' . curl_error($p);
} else {
    echo $response;
}
curl_close($p);

Uploaden

Om een nieuwe bijlage toe te voegen gebruik je /upload.
Bijvoorbeeld: POST https://eenvoudigfactureren.be/api/v1/invoices/3003/files/upload

Gebruik een multipart/form-data body om het bestand toe te voegen.
Bijvoorbeeld: Content-Disposition: form-data; name="file"; filename="attachment.pdf" Content-Type: application/pdf

Downloaden

Om de inhoud van de bijlage op te halen gebruik je /download.
Bijvoorbeeld: GET https://eenvoudigfactureren.be/api/v1/invoices/3003/files/8764/download