Create Reminder API

https://api.incasso.io/v2/reminders

Met de Create Reminder API kan je op een simpele wijze een laatste betalingsherinnering (aanmaning) naar je debiteur verzenden. Elke dag om 14:00 uur worden de aangeboden gegevens verwerkt en per e-mail aangeboden.

Elke dag om 16:00 uur worden aangeboden facturen omgezet naar incassozaken. Meerdere facturen van dezelfde debiteur worden automatisch gecombineerd in 1 dossier. Debiteur herkenning vindt plaats op basis van het klantnummer.

De aan te leveren gegevens zijn verdeeld in de factuurgegevens een een object met alle debiteurgegevens. Deze gegevens kunnen worden meegeleverd in het Customer object.

Data in de API call

InvoiceNumber required Factuurnummer

InvoiceDate required Datum van de factuur in 01-01-2020 formaat

InvoiceDuedate required Vervaldatum van de factuur in 01-01-2020 formaat

InvoiceTotal required Totaalbedrag van de factuur incl eventuele btw in 100.00 formaat

InvoiceOpen Het nog openstaande bedrag van de factuur in 100.00 formaat. Indien dit bedrag niet wordt meegestuurd wordt In voiceTotal als openstaand bedrag aangehouden.

InvoiceStatus Statuscode van de factuur. Mogelijkheden: open paid cancelled. Standaard zal de statuscode open worden aangehouden.

Customer object Object met de debiteurgegevens. Uitgebreide informatie staat op de Customer Object pagina. Beschikbare gegevens: Code Name Contact Address Postalcode City Country

Phone Mobile Iban Email Language KvK

Request voorbeelden

Json

{
    "InvoiceNumber": "12345",
    "InvoiceDate": "28-10-2020",
    "InvoiceDuedate": "28-12-2020",
    "InvoiceTotal": "100.00",
    "InvoiceOpen": "80.00",
    "InvoiceStatus": "open",
    "Customer": {
        "Code": "1001",
        "Name": "Test B.V.",
        "Contact": "J. Voorbeeld",
        "Address": "Straat 1",
        "Postalcode": "1001 AA",
        "City": "Amsterdam",
        "Country": "NL",
        "Phone": "0882441111",
        "Mobile": "0612345678",
        "Iban": "NL00RABO1111111111",
        "Email": "[email protected]",
        "Language": "NL",
        "KvK": "123456"
    },
    "Attachment": {
        "Name": "Invoice-202003.pdf",
        "MediaType": "application/pdf",
        "Content": ""
    }
}

cURL

curl -X POST https://api.incasso.io/v2/reminders \
   -H "Authorization: dHar4XY7LxsDOtmnkVtjNVWXLSlXsM" \
   -H "Content-Type: text/plain" \
   -d "InvoiceNumber=12345" \
   -d "InvoiceDate=28-10-2020" \
   -d "InvoiceDuedate=28-11-2020" \
   -d "InvoiceTotal=100.00" \
   -d "Customer[Code]=1001" \
   -d "Customer[Name]=Test B.V." \
   -d "Customer[Address]=Straat 1" \
   -d "Customer[Postalcode]=1001 AA" \
   -d "Customer[City]=Amsterdam" \
   -d "Customer[Email][email protected]" \
   -d "Attachment[Name]=Invoice-202003.pdf" \
   -d "Attachment[MediaType]=application/pdf" \
   -d "Attachment[Content]=base64file

PHP

<?php
$incasso = new IncassoApi();
$incasso->setApiKey("dHar4XY7LxsDOtmnkVtjNVWXLSlXsM");
$incasso = $incasso->createreminder([
      "InvoiceNumber" => "12345",
      "InvoiceDate" => "28-10-2020",
      "InvoiceDuedate" => "28-11-2020",
      "InvoiceTotal" => "100.00",
      "Customer" => [
            "Code" => "1001",
            "Name" => "Test B.V.",
            "Address" => "Straat 1",
            "Postalcode" => "1001 AA",
            "City" => "Amsterdam",
            "Email" => "[email protected]",
      ],
      "Attachment" => [ 
            "Name" => "Invoice-202003.pdf",
            "MediaType" => "application/pdf",
            "Content" => ""
      ]
]);

ASP

<%
Set IncassoApi = New IncassoApiClient
IncassoApi.setApiKey("dHar4XY7LxsDOtmnkVtjNVWXLSlXsM")
Createdebtcollection = IncassoApi.CreateReminder("{
    "InvoiceNumber": "202003",
    "InvoiceDate": "2020-10-23",
    "InvoiceDuedate": "2020-11-23",
    "InvoiceTotal": "200.00",
    "InvoiceOpen": "180.00",
    "InvoiceStatus": "open",
    "Customer": {
        "Code": "1001",
        "Name": "Test B.V.",
        "Contact": "J. Voorbeeld",
        "Address": "Straat 1",
        "Postalcode": "1001 AA",
        "City": "Amsterdam",
        "Country": "NL",
        "Phone": "0882441111",
        "Mobile": "0612345678",
        "Iban": "NL00RABO1111111111",
        "Email": "[email protected]",
        "Language": "NL",
        "KvK": "123456"
    },
    "Attachment": {
        "Name": "Invoice-202003.pdf",
        "MediaType": "application/pdf",
        "Content": ""
    }
}")
%>

Response

{
    "resource": "reminder",
    "id": "c3097f04-6b98-4887-8d1f-6180356974b2"
    "status": "planned",
    "response": "Herinnering wordt vandaag om 14:00 verstuurd",
}