Create Case API

Creëer nieuwe incassozaken door facturen aan te bieden met deze API.

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

Met de Create Case API kan je op een simpele wijze een factuur ter incasso overdragen. Elke dag om 16:00 uur worden de aangeboden gegevens omgezet naar incassozaken.

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 (Customer Code).

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.

Request

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

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

Attachment object De factuur kan als bijlage worden meegezonden met het Attachment object. Uitgebreide informatie staat op de Attachment Object pagina. Beschikbare gegevens: Name MediaType Content

Response

Resource Geeft aan dat het antwoord een case (incassozaak) object bevat. De waarde zal bij deze api-call dan ook altijd case zijn

Id De unieke id gekoppeld aan deze factuur. Deze unieke id wordt altijd automatisch gegenereerd. Let op: Dit is dus de id van de factuur en niet van de incassozaak. Deze is pas beschikbaar, nadat een incassozaak is aangemaakt (ieder dag om 16:00 uur).

Status Statuscode van de factuur. Deze zal in eerste instantie de status planned krijgen. Nadat de incassozaak is aangemaakt zal de factuur de status created krijgen.

Response Het antwoord van de api-server als omschrijving.

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 --location 'https://api.incasso.io/v2/cases' \
--header 'Authorization: dHar4XY7LxsDOtmnkVtjNVWXLSlXsM' \
--header 'Content-Type: text/plain' \
--data-raw '{
    "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": ""
    }
}'

PHP

<?php
$incasso = new IncassoApi();
$incasso->setApiKey("dHar4XY7LxsDOtmnkVtjNVWXLSlXsM");
$incasso = $incasso->createCase([
      "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.createCase("{
    "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

De response

{
    "resource": "case",
    "id": "c3097f04-6b98-4887-8d1f-6180356974b2"
    "status": "planned",
    "response"": "Incasso wordt vandaag om 16:00 gestart",
}