Verzend een document (factuur, offerte, …) via BPost naar de klant. Hiervoor moet eerst de koppeling met Mail-IT-Wize worden opgezet.


Gebruik de POST-methode met als URL bijvoorbeeld /api/v1/invoices/1001?send_postalmail.


Je moet hierbij wel enkele bijkomende gegevens meegeven (in XML, JSON of form-encoding):

  • address_type (text): Adrestype waaruit de adresgegevens worden opgehaald. Mogelijke waarden: “billing” (=standaard facturatiegegevens), “delivery” (=verzendadres), “site” (=werfadres).
  • send_registered (int): “0” voor gewone zending; “1” voor aangetekende zending.
  • document_type: Type van het document. Enkel van toepassing bij verzending van factuur. Kan volgende waardes bevatten: ‘pdf’, ‘duplicate’ (=duplicaat factuur), ‘reminder’ (=herinneringsdocument), ‘reminder_summary’ (=samenvattingsdocument herinnering). Indien niet opgegeven wordt ‘pdf’ gebruikt.


Een voorbeeld in XML om jouw gegevens door te geven:

<data>
  <address_type>billing</address_type>
  <send_registered>0</send_registered>
</data>

Een voorbeeld in PHP hoe een factuur via BPost kan worden verzonden:

$params = ['address_type' => 'billing', 'send_registered' => 0];
 
$p = curl_init('https://eenvoudigfactureren.be/api/v1/invoices/1001?send_postalmail');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: your_api_key_here",
]);
curl_setopt($p, CURLOPT_POSTFIELDS, $params);
curl_setopt($p, CURLOPT_RETURNTRANSFER, true);
$result_in_xml_string = curl_exec($p);
  Meer info over API? Lees onderstaande nuttige artikels