Er zijn 2 verschillende manieren om bijlagen toe te voegen via de API, afhankelijk van wat je precies wil bereiken.

• Bijlage toevoegen aan de factuur zelf
• Bijlage toevoegen tijdens het verzenden van de e-mail

Beide opties gebruiken een andere API-aanroep.

E-mail bijlage toevoegen tijdens verzending

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);

Factuurbijlage

Uploaden

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

$p = curl_init('https://eenvoudigfactureren.be/api/v1/invoices/3003/files/upload');
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',
    'role' => 'attachment'
]);
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);

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