Introductie

Api

Op administratie.digitalefactuur.nl kan je je eigen API key aanmaken in het instellingen menu. Deze key is nodig om de DigitaleFactuur API te gebruiken.

De API key bestaat uit een toegangscode en een account ID. Er zijn twee manieren om the authenticeren met deze key:

  • Basic auth. Hier is de username de account ID en password is de toegangscode. Hiervoor moet je gebruik maken van de V3 endpoints.
  • Toevoegen aan de url zoals https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/klanten. Dit is deprecated en wordt in de toekomst uitgezet.

Klanten

Klanten Lijst GET

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/klanten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/klanten

URL parameters

Naam Type Beschrijving
page int Er zijn maximaal 25 resultaten per pagina. Door een pagina nummer aan te geven krijg je de resultaten van die pagina.
order_column string Waar er op gesorteerd moet worden; name, relatienummer.
order_type asc | dec Oplopend of aflopend sorteren.
json boolean 0|1 Laat de API met json antwoorden.
klanten_id int ID van de klant.
email string Email adres van de klant.
zoekwoord string Woord waar je op wilt zoeken.
relatienummer int nummer van de relatie.
timestamp int Haalt klanten op die aangemaakt/gewijzigd zijn na het aangegeven tijdstip.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klanten&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klanten"

Response body 

[{
	"id":"1681087",
	"type_klant":"debiteur",
	"name":"DigitaleFactuur",
	"department":"Support",
	"address":"Haagweg 4F12",
	"postal_code":"2311AA",
	"place":"Leiden",
	"email":"support@digitalefactuur.nl",
	"country":"Nederland",
	"relatienummer":"1002",
	"btw_nr":"NL851898841B01",
	"telefoon":"071-7110335",
	"faxnummer":"123-4567890",
	"contact_persoon":"Ravi Chotkan",
	"automatische_incasso":"nee",
	"klant_mobiel":"0612345678",
	"kvk_nummer":"55888720",
	"aanhef":"Mr.",
	"iban":"NL68INGB0004270579",
	"bic":"INGBNL2A",
	"naam_bekend_bij_bank":"Digitalefactuur",
	"mandate_id":"1001",
	"mandate_date":"31-12-2015",
	"btw_verlegd":"nee"
}]

Response body 

<klant>
	<id>1681087</id>
	<relatienummer>1002</relatienummer>
	<btw_nummer>NL851898841B01</btw_nummer>
	<type>debiteur</type>
	<naam>DigitaleFactuur</naam>
	<contactpersoon_naam>Ravi</contactpersoon_naam>
	<contactpersoon_afdeling>Support</contactpersoon_afdeling>
	<contactpersoon_email>support@digitalefactuur.nl</contactpersoon_email>
	<email>support@digitalefactuur.nl</email>
	<adres>Haagweg 4F12</adres>
	<postcode>2311AA</postcode>
	<plaats>Leiden</plaats>
	<telefoonnummer>071-7110335</telefoonnummer>
	<faxnummer>123456789</faxnummer>
	<land>Nederland</land>
	<rekeningnummer>0004270579</rekeningnummer>
	<tenaamstelling>Digitalefactuur</tenaamstelling>
	<automatische_incasso>nee</automatische_incasso>
	<mandaat_kenmerk>1001</mandaat_kenmerk>
	<mandaat_datum>31-12-2015</mandaat_datum>
	<soort>Zakelijk</soort>
	<iban>NL68INGB0004270579</iban>
	<bic>INGBNL2A</bic>
	<voorletters>R</voorletters>
	<tussenvoegsel></tussenvoegsel>
	<achternaam>Chotkan</achternaam>
 </klant>

Code example 

<?php
	$json = '';
	 
	// url naar waar de xml gepost moet worden
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klanten&json=true";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	 
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);
	 
	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Code example 

<?php

	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klanten";
	 
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL, $url);
	 
	$result = curl_exec($ch);
	curl_close($ch);
	 
	echo $result;
	exit();
 
?>

Klant Aanmaken POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/klant_aanmaken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_aanmaken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_aanmaken"

Response body 

[{
	"id":"1681087",
	"type_klant":"debiteur",
	"name":"DigitaleFactuur",
	"department":"Support",
	"address":"Haagweg 4F12",
	"postal_code":"2311AA",
	"place":"Leiden",
	"email":"support@digitalefactuur.nl",
	"country":"Nederland",
	"relatienummer":"1002",
	"btw_nr":"NL851898841B01",
	"telefoon":"071-7110335",
	"faxnummer":"123-4567890",
	"contact_persoon":"Ravi Chotkan",
	"automatische_incasso":"nee",
	"klant_mobiel":"0612345678",
	"kvk_nummer":"55888720",
	"aanhef":"Mr.",
	"iban":"NL68INGB0004270579",
	"bic":"INGBNL2A",
	"naam_bekend_bij_bank":"Digitalefactuur",
	"mandate_id":"1001",
	"mandate_date":"31-12-2015",
	"btw_verlegd":"nee"
}]

Response body 

<klant>
	<id>1681087</id>
	<relatienummer>1002</relatienummer>
	<btw_nummer>NL851898841B01</btw_nummer>
	<type>debiteur</type>
	<naam>DigitaleFactuur</naam>
	<contactpersoon_naam>Ravi</contactpersoon_naam>
	<contactpersoon_afdeling>Support</contactpersoon_afdeling>
	<contactpersoon_email>support@digitalefactuur.nl</contactpersoon_email>
	<adres>Haagweg 4F12</adres>
	<postcode>2311AA</postcode>
	<plaats>Leiden</plaats>
	<telefoonnummer>071-7110335</telefoonnummer>
	<faxnummer>123456789</faxnummer>
	<land>Nederland</land>
	<rekeningnummer>0004270579</rekeningnummer>
	<tenaamstelling>Digitalefactuur</tenaamstelling>
	<automatische_incasso>nee</automatische_incasso>
	<mandaat_kenmerk>1001</mandaat_kenmerk>
	<mandaat_datum>31-12-2015</mandaat_datum>
	<soort>Zakelijk</soort>
	<iban>NL68INGB0004270579</iban>
	<bic>INGBNL2A</bic>
	<voorletters>R</voorletters>
	<tussenvoegsel></tussenvoegsel>
	<achternaam>Chotkan</achternaam>
</klant>

Code example 

<?php
	$json = '{"id":"1681087",
	"type_klant":"debiteur",
	"name":"DigitaleFactuur",
	"department":"Support",
	"address":"Haagweg 4F12",
	"postal_code":"2311AA",
	"place":"Leiden",
	"email":"support@digitalefactuur.nl",
	"country":"Nederland",
	"relatienummer":"1002",
	"btw_nr":"NL851898841B01",
	"telefoon":"071-7110335",
	"faxnummer":"123-4567890",
	"contact_persoon":"Ravi Chotkan",
	"automatische_incasso":"nee",
	"klant_mobiel":"0612345678",
	"kvk_nummer":"55888720",
	"aanhef":"Mr.",
	"iban":"NL68INGB0004270579",
	"bic":"INGBNL2A",
	"naam_bekend_bij_bank":"Digitalefactuur",
	"mandate_id":"1001",
	"mandate_date":"31-12-2015",
	"btw_verlegd":"nee"}';

	// url naar waar de xml gepost moet worden
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_aanmaken&json=true";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);

	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);

	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Code example 

<?php
	$xml = "<klant>
	<id>1681087</id>
	<relatienummer>1002</relatienummer>
	<btw_nummer>NL851898841B01</btw_nummer>
	<type>debiteur</type>
	<naam>DigitaleFactuur</naam>
	<contactpersoon_naam>Ravi</contactpersoon_naam>
	<contactpersoon_afdeling>Support</contactpersoon_afdeling>
	<contactpersoon_email>support@digitalefactuur.nl</contactpersoon_email>
	<adres>Haagweg 4F12</adres>
	<postcode>2311AA</postcode>
	<plaats>Leiden</plaats>
	<telefoonnummer>071-7110335</telefoonnummer>
	<faxnummer>123456789</faxnummer>
	<land>Nederland</land>
	<rekeningnummer>0004270579</rekeningnummer>
	<tenaamstelling>Digitalefactuur</tenaamstelling>
	<automatische_incasso>nee</automatische_incasso>
	<mandaat_kenmerk>1001</mandaat_kenmerk>
	<mandaat_datum>31-12-2015</mandaat_datum>
	<soort>Zakelijk</soort>
	<iban>NL68INGB0004270579</iban>
	<bic>INGBNL2A</bic>
	<voorletters>R</voorletters>
	<tussenvoegsel></tussenvoegsel>
	<achternaam>Chotkan</achternaam>
	</klant>";

	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_aanmaken";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);

	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);

	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Klant Updaten POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_updaten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/klant_updaten

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_updaten&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_updaten"

Response body 

[{
	"id":"1681087",
	"type_klant":"debiteur",
	"name":"DigitaleFactuur",
	"department":"Support",
	"address":"Haagweg 4F12",
	"postal_code":"2311AA",
	"place":"Leiden",
	"email":"support@digitalefactuur.nl",
	"country":"Nederland",
	"relatienummer":"1002",
	"btw_nr":"NL851898841B01",
	"telefoon":"071-7110335",
	"faxnummer":"123-4567890",
	"contact_persoon":"Ravi Chotkan",
	"automatische_incasso":"nee",
	"klant_mobiel":"0612345678",
	"kvk_nummer":"55888720",
	"aanhef":"Mr.",
	"iban":"NL68INGB0004270579",
	"bic":"INGBNL2A",
	"naam_bekend_bij_bank":"Digitalefactuur",
	"mandate_id":"1001",
	"mandate_date":"31-12-2015",
	"btw_verlegd":"nee"
}]

Response body 

<klant>
	<id>1681087</id>
	<relatienummer>1002</relatienummer>
	<btw_nummer>NL851898841B01</btw_nummer>
	<type>debiteur</type>
	<naam>DigitaleFactuur</naam>
	<contactpersoon_naam>Ravi</contactpersoon_naam>
	<contactpersoon_afdeling>Support</contactpersoon_afdeling>
	<contactpersoon_email>support@digitalefactuur.nl</contactpersoon_email>
	<adres>Haagweg 4F12</adres>
	<postcode>2311AA</postcode>
	<plaats>Leiden</plaats>
	<telefoonnummer>071-7110335</telefoonnummer>
	<faxnummer>123456789</faxnummer>
	<land>Nederland</land>
	<rekeningnummer>0004270579</rekeningnummer>
	<tenaamstelling>Digitalefactuur</tenaamstelling>
	<automatische_incasso>nee</automatische_incasso>
	<mandaat_kenmerk>1001</mandaat_kenmerk>
	<mandaat_datum>31-12-2015</mandaat_datum>
	<soort>Zakelijk</soort>
	<iban>NL68INGB0004270579</iban>
	<bic>INGBNL2A</bic>
	<voorletters>R</voorletters>
	<tussenvoegsel></tussenvoegsel>
	<achternaam>Chotkan</achternaam>
</klant>

Code example 

<?php
	$json = '{"id":"1681087",
	"type_klant":"debiteur",
	"name":"DigitaleFactuur",
	"department":"Support",
	"address":"Haagweg 4F12",
	"postal_code":"2311AA",
	"place":"Leiden",
	"email":"support@digitalefactuur.nl",
	"country":"Nederland",
	"relatienummer":"1002",
	"btw_nr":"NL851898841B01",
	"telefoon":"071-7110335",
	"faxnummer":"123-4567890",
	"contact_persoon":"Ravi Chotkan",
	"automatische_incasso":"nee",
	"klant_mobiel":"0612345678",
	"kvk_nummer":"55888720",
	"aanhef":"Mr.",
	"iban":"NL68INGB0004270579",
	"bic":"INGBNL2A",
	"naam_bekend_bij_bank":"Digitalefactuur",
	"mandate_id":"1001",
	"mandate_date":"31-12-2015",
	"btw_verlegd":"nee"}';
	 
	// url naar waar de xml gepost moet worden
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_updaten&json=true";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	 
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);
	 
	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Code example 

<?php
	$xml = "<klant>
	  <id>1681087</id>
	  <relatienummer>1002</relatienummer>
	  <btw_nummer>NL851898841B01</btw_nummer>
	  <type>debiteur</type>
	  <naam>DigitaleFactuur</naam>
	  <contactpersoon_naam>Ravi</contactpersoon_naam>
	  <contactpersoon_afdeling>Support</contactpersoon_afdeling>
	  <contactpersoon_email>support@digitalefactuur.nl</contactpersoon_email>
	  <adres>Haagweg 4F12</adres>
	  <postcode>2311AA</postcode>
	  <plaats>Leiden</plaats>
	  <telefoonnummer>071-7110335</telefoonnummer>
	  <faxnummer>123456789</faxnummer>
	  <land>Nederland</land>
	  <rekeningnummer>0004270579</rekeningnummer>
	  <tenaamstelling>Digitalefactuur</tenaamstelling>
	  <automatische_incasso>nee</automatische_incasso>
	  <mandaat_kenmerk>1001</mandaat_kenmerk>
	  <mandaat_datum>31-12-2015</mandaat_datum>
	  <soort>Zakelijk</soort>
	  <iban>NL68INGB0004270579</iban>
	  <bic>INGBNL2A</bic>
	  <voorletters>R</voorletters>
	  <tussenvoegsel></tussenvoegsel>
	  <achternaam>Chotkan</achternaam>
	 </klant>";
	      
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_updaten";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	 
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);
	 
	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Klant Verwijderen POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_verwijderen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/klant_verwijderen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
klanten_id int Klanten ID nummer.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_verwijderen&json=true"

Curl example 

url -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_verwijderen"

Response body

Response body

Code example 

<?php
	$json = '';
	 
	// url naar waar de xml gepost moet worden
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_verwijderen&json=true&klanten_id=1682537";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	 
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);
	 
	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Code example 

<?php
 
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/klant_verwijderen&klanten_id=1682536";
	 
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL, $url);
	 
	// curlen en resultaat opvangen
	$result = curl_exec($ch);
	curl_close($ch);
	 
	echo $result;
	exit();
 
?>

Facturen

Facturen Lijst GET

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/facturen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/facturen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
page int Er zijn maximaal 25 resultaten per pagina. Door een pagina nummer aan te geven krijg je de resultaten van die pagina.
order_column string Waar er op gesorteerd moet worden; factuurnummer, factuurdatum, vervaldatum, referentie, nummerern_nummer.
order_type asc | desc Hoe het gesorteerd word, oplopend of aflopend.
facturen_id int ID van de factuur.
klanten_id int ID van de klant.
relatienummer int nummer van de relatie.
zoekwoord string Woord waar je op wilt zoeken.
factuurnummer int nummer van de factuur.
betaalstatus openstaand | betaald Status van de betaling.
timestamp int Haalt facturen op die aangemaakt/gewijzigd zijn na het aangegeven tijdstip.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/facturen&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/facturen"

Response body 

{
	"id":"1785134",
	"klanten_id":"1654497",
	"sjablonen_id":"124410",
	"btw_verlegd":"nee",
	"credit_factuur":"nee",
	"including_vat":"nee",
	"referentie":"489AAD",
	"opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
	"betaalstatus":"betaald",
	"factuurnummer":"20151001",
	"automatische_incasso":"nee",
	"factuurdatum":"2015-09-07",
	"vervaldatum":"2015-09-21",
	"cyclus_id":"37907",
	"volgende_actie_datum":"2015-09-21",
	"volgende_actie":"Herinnering",
	"cyclus_stap":"Standaard",
	"totaal_ex_btw":"195.00",
	"totaal_btw":"40.95",
	"status":"betaald",
	"klant_naam":"Digitalefactuur",
	"klant_adres":"Haagweg 4F12",
	"klant_postcode":"2311AA",
	"klant_plaats":"Leiden",
	"klant_land":"Nederland",
	"klant_email":"support@digitalefactuur.nl",
	"betaaldatum":"14-10-2015",
	"factuurregels":
	[{
	"id":"10029489",
	"quantity":"1.00",
	"item":"Hostingkosten",
	"price":"10.000",
	"vat":"0.210"
	}]
}

Response body 

<factuur>
  <id>1845872</id>
  <extern_id></extern_id>
  <klant_id>1681254</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <contactpersoon_id>1234</contactpersoon_id>
  <contactpersoon_naam>Ravi Chotkan</contactpersoon_naam>
  <sjabloon_id>124410</sjabloon_id>
  <btw_verlegd>nee</btw_verlegd>
  <credit_factuur>nee</credit_factuur>
  <totaalprijs_exclusief_btw>950.00</totaalprijs_exclusief_btw>
  <totaal_btw>0.00</totaal_btw>
  <inclusief_btw>nee</inclusief_btw>
  <referentie>489AAD</referentie>
  <offerte_id>1234</offerte_id>
  <betaalstatus>nog niet verstuurd</betaalstatus>
  <betaaldatum></betaaldatum>
  <factuurnummer_voorloop>1234</factuurnummer_voorloop>
  <factuurnummer>12345</factuurnummer>
  <opmerking>Bedankt voor het vertrouwen in Digitalefactuur</opmerking>
  <opmerking_op_factuur>nee</opmerking_op_factuur>
  <automatische_incasso>ja</automatische_incasso>
  <factuurdatum>2015-11-05</factuurdatum>
  <vervaldatum>2015-11-19</vervaldatum>
  <factuurregel>
   <id>10666052</id>
   <aantal>1.00</aantal>
   <omschrijving>Hostingkosten</omschrijving>
   <prijs>10.00</prijs>
   <btw>0.000</btw>
  </factuurregel>
  <kortingen>
   <id>172396</id>
   <soort>percentage</soort>
   <hoeveelheid>0.0500</hoeveelheid>
   <btw>0.000</btw>
   <omschrijving>Korting</omschrijving>
  </kortingen>
 </factuur>

Code example 

<?php
	$json = '';
	 
	// url naar waar de xml gepost moet worden
	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/facturen&json=true";
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	 
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL,$url);
	 
	$result= curl_exec ($ch);
	curl_close ($ch);
	echo $result;
	die();
?>

Code example 

<?php

	$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/facturen";
	 
	$ch = curl_init();
    curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_URL, $url);
	 
	$result = curl_exec($ch);
	curl_close($ch);
	 
	echo $result;
	exit();

?>

Factuur Aanmaken POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_aanmaken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken"

Response body 

{
	"id":"1785134",
	"klanten_id":"1654497",
	"sjablonen_id":"124410",
	"btw_verlegd":"nee",
	"credit_factuur":"nee",
	"including_vat":"nee",
	"referentie":"489AAD",
	"opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
	"betaalstatus":"betaald",
	"factuurnummer":"20151001",
	"automatische_incasso":"nee",
	"factuurdatum":"2015-09-07",
	"vervaldatum":"2015-09-21",
	"cyclus_id":"37907",
	"volgende_actie_datum":"2015-09-21",
	"volgende_actie":"Herinnering",
	"cyclus_stap":"Standaard",
	"totaal_ex_btw":"195.00",
	"totaal_btw":"40.95",
	"status":"betaald",
	"klant_naam":"Digitalefactuur",
	"klant_adres":"Haagweg 4F12",
	"klant_postcode":"2311AA",
	"klant_plaats":"Leiden",
	"klant_land":"Nederland",
	"klant_email":"support@digitalefactuur.nl",
	"betaaldatum":"14-10-2015",
	"factuurregels":
	[{
		"id":"10029489",
		"quantity":"1.00",
		"item":"Hostingkosten",
		"price":"10.000",
		"vat":"0.210"
	}]
}

Response body 

<factuur>
  <id>1845872</id>
  <extern_id></extern_id>
  <klant_id>1681254</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <contactpersoon_id>1234</contactpersoon_id>
  <contactpersoon_naam>Ravi Chotkan</contactpersoon_naam>
  <sjabloon_id>124410</sjabloon_id>
  <btw_verlegd>nee</btw_verlegd>
  <credit_factuur>nee</credit_factuur>
  <totaalprijs_exclusief_btw>950.00</totaalprijs_exclusief_btw>
  <totaal_btw>0.00</totaal_btw>
  <inclusief_btw>nee</inclusief_btw>
  <referentie>489AAD</referentie>
  <offerte_id>1234</offerte_id>
  <betaalstatus>nog niet verstuurd</betaalstatus>
  <betaaldatum></betaaldatum>
  <factuurnummer_voorloop>1234</factuurnummer_voorloop>
  <factuurnummer>12345</factuurnummer>
  <opmerking>Bedankt voor het vertrouwen in Digitalefactuur</opmerking>
  <opmerking_op_factuur>nee</opmerking_op_factuur>
  <automatische_incasso>ja</automatische_incasso>
  <factuurdatum>2015-11-05</factuurdatum>
  <vervaldatum>2015-11-19</vervaldatum>
  <factuurregel>
   <id>10666052</id>
   <aantal>1.00</aantal>
   <omschrijving>Hostingkosten</omschrijving>
   <prijs>10.00</prijs>
   <btw>0.000</btw>
  </factuurregel>
  <kortingen>
   <id>172396</id>
   <soort>percentage</soort>
   <hoeveelheid>0.0500</hoeveelheid>
   <btw>0.000</btw>
   <omschrijving>Korting</omschrijving>
  </kortingen>
</factuur>

Code example 

<?php
$json = '{
 "id":"1785134",
 "klanten_id":"1654497",
 "sjablonen_id":"124410",
 "btw_verlegd":"nee",
 "credit_factuur":"nee",
 "including_vat":"nee",
 "referentie":"489AAD",
 "opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
 "betaalstatus":"betaald",
 "factuurnummer":"20151001",
 "automatische_incasso":"nee",
 "factuurdatum":"2015-09-07",
 "vervaldatum":"2015-09-21",
 "cyclus_id":"37907",
 "volgende_actie_datum":"2015-09-21",
 "volgende_actie":"Herinnering",
 "cyclus_stap":"Standaard",
 "totaal_ex_btw":"195.00",
 "totaal_btw":"40.95",
 "status":"betaald",
 "klant_naam":"Digitalefactuur",
 "klant_adres":"Haagweg 4F12",
 "klant_postcode":"2311AA",
 "klant_plaats":"Leiden",
 "klant_land":"Nederland",
 "klant_email":"support@digitalefactuur.nl",
 "betaaldatum":"14-10-2015",
 "factuurregels":
  [{
   "id":"10029489",
   "quantity":"1.00",
   "item":"Hostingkosten",
   "price":"10.000",
   "vat":"0.210"
  }]
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
  <id>1845872</id>
  <extern_id></extern_id>
  <klant_id>1681254</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <contactpersoon_id>1234</contactpersoon_id>
  <contactpersoon_naam>Ravi Chotkan</contactpersoon_naam>
  <sjabloon_id>124410</sjabloon_id>
  <btw_verlegd>nee</btw_verlegd>
  <credit_factuur>nee</credit_factuur>
  <totaalprijs_exclusief_btw>950.00</totaalprijs_exclusief_btw>
  <totaal_btw>0.00</totaal_btw>
  <inclusief_btw>nee</inclusief_btw>
  <referentie>489AAD</referentie>
  <offerte_id>1234</offerte_id>
  <betaalstatus>nog niet verstuurd</betaalstatus>
  <betaaldatum></betaaldatum>
  <factuurnummer_voorloop>1234</factuurnummer_voorloop>
  <factuurnummer>12345</factuurnummer>
  <opmerking>Bedankt voor het vertrouwen in Digitalefactuur</opmerking>
  <opmerking_op_factuur>nee</opmerking_op_factuur>
  <automatische_incasso>ja</automatische_incasso>
  <factuurdatum>2015-11-05</factuurdatum>
  <vervaldatum>2015-11-19</vervaldatum>
  <factuurregel>
   <id>10666052</id>
   <aantal>1.00</aantal>
   <omschrijving>Hostingkosten</omschrijving>
   <prijs>10.00</prijs>
   <btw>0.000</btw>
  </factuurregel>
  <kortingen>
   <id>172396</id>
   <soort>percentage</soort>
   <hoeveelheid>0.0500</hoeveelheid>
   <btw>0.000</btw>
   <omschrijving>Korting</omschrijving>
  </kortingen>
 </factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Factuur aanmaken met nieuwe klant POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_aanmaken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

url -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken"

Response body 

[{
 "klant_relatienummer":"197741",
 "klant_btw_nummer":"NL851898841B01",
 "klant_type":"debiteur",
 "klant_naam":"DigitaleFactuurr",
 "klant_contactpersoon_naam":"Ravi Chotkan",
 "klant_verstuurmethode":"mail",
 "klant_contactpersoon_afdeling":"Support",
 "klant_contactpersoon_email":"support@digitalefactuur.nl",
 "klant_email":"support@digitalefactuur.nl",
 "klant_adres":"Haagweg 4F12",
 "klant_postcode":"2311 AA",
 "klant_plaats":"Leiden",
 "klant_telefoonnummer":"071-7110335",
 "klant_faxnummer":"123-4567890",
 "klant_land":"Nederland",
 "klant_rekeningnummer":"NL68INGB0004270579",
 "klant_tenaamstelling":"Mr.",

 "id":"1785134",
 "sjablonen_id":"124410",
 "btw_verlegd":"nee",
 "credit_factuur":"nee",
 "including_vat":"nee",
 "referentie":"489AAD",
 "opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
 "betaalstatus":"betaald",
 "factuurnummer":"20151001",
 "automatische_incasso":"nee",
 "factuurdatum":"2015-09-10",
 "vervaldatum":"2015-09-21",
 "cyclus_id":"37907",
 "volgende_actie_datum":"2015-09-21",
 "volgende_actie":"Herinnering",
 "cyclus_stap":"Standaard",
 "totaal_ex_btw":"195.00",
 "totaal_btw":"40.95",
 "status":"betaald",
 "betaaldatum":"14-10-2015",
 "factuurregels":
  [{
   "id":"10029489",
   "quantity":"1.00",
   "item":"Hostingkosten",
   "price":"10.000",
   "vat":"0.210"
  }]
}]

Response body 

<factuur>
  <klant_id>548941</klant_id>
  <klant_relatienummer>123456789</klant_relatienummer>
  <klant_btw_nummer>NL851898841B01</klant_btw_nummer>
  <klant_type>debiteur</klant_type>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_contactpersoon_naam>Ravi Chotkan</klant_contactpersoon_naam>
  <klant_contactpersoon_afdeling>Support</klant_contactpersoon_afdeling>
  <klant_contactpersoon_email>support@digitalefactuur.nl</klant_contactpersoon_email>
  <klant_email>support@digitalefactuur.nl</klant_email>
  <klant_adres>Haagweg 4F12</klant_adres>
  <klant_postcode>2311 AA</klant_postcode>
  <klant_plaats>Leiden</klant_plaats>
  <klant_telefoonnummer>071-7110335</klant_telefoonnummer>
  <klant_faxnummer>123-4567890</klant_faxnummer>
  <klant_land>Nederland</klant_land>
  <klant_tenaamstelling>Digitalefactuur</klant_tenaamstelling>
  <klant_automatische_incasso>nee</klant_automatische_incasso>
  <klant_mandaat_kenmerk/>1001<klant_mandaat_kenmerk/>
  <klant_mandaat_datum/>31-12-2015<klant_mandaat_datum/>
  <klant_soort>zakelijk</klant_soort>
  <klant_iban/>NL68INGB0004270579<klant_iban/>
  <klant_bic/>INGBNL2A<klant_bic/>
  <klant_voorletters/>S<klant_voorletters/>
  <klant_tussenvoegsel/><klant_tussenvoegsel/>
  <klant_achternaam/>Chotkan<klant_achternaam/>

  <id>1845872</id>
  <extern_id></extern_id>
  <klant_id>1681254</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <contactpersoon_id>1234</contactpersoon_id>
  <contactpersoon_naam>Ravi Chotkan</contactpersoon_naam>
  <sjabloon_id>124410</sjabloon_id>
  <btw_verlegd>nee</btw_verlegd>
  <credit_factuur>nee</credit_factuur>
  <totaalprijs_exclusief_btw>950.00</totaalprijs_exclusief_btw>
  <totaal_btw>0.00</totaal_btw>
  <inclusief_btw>nee</inclusief_btw>
  <referentie>489AAD</referentie>
  <offerte_id>1234</offerte_id>
  <betaalstatus>nog niet verstuurd</betaalstatus>
  <betaaldatum></betaaldatum>
  <factuurnummer_voorloop>1234</factuurnummer_voorloop>
  <factuurnummer>12345</factuurnummer>
  <opmerking>Bedankt voor het vertrouwen in Digitalefactuur</opmerking>
  <opmerking_op_factuur>nee</opmerking_op_factuur>
  <automatische_incasso>ja</automatische_incasso>
  <factuurdatum>2015-11-05</factuurdatum>
  <vervaldatum>2015-11-19</vervaldatum>
  <factuurregel>
   <id>10666052</id>
   <aantal>1.00</aantal>
   <omschrijving>Hostingkosten</omschrijving>
   <prijs>10.00</prijs>
   <btw>0.000</btw>
  </factuurregel>
  <kortingen>
   <id>172396</id>
   <soort>percentage</soort>
   <hoeveelheid>0.0500</hoeveelheid>
   <btw>0.000</btw>
   <omschrijving>Korting</omschrijving>
  </kortingen>
</factuur>"

Code example 

<?php
$json = '{
 "klant_relatienummer":"197741",
 "klant_btw_nummer":"NL851898841B01",
 "klant_type":"debiteur",
 "klant_naam":"DigitaleFactuurr",
 "klant_contactpersoon_naam":"Ravi Chotkan",
 "klant_verstuurmethode":"mail",
 "klant_contactpersoon_afdeling":"Support",
 "klant_contactpersoon_email":"support@digitalefactuur.nl",
 "klant_email":"support@digitalefactuur.nl",
 "klant_adres":"Haagweg 4F12",
 "klant_postcode":"2311 AA",
 "klant_plaats":"Leiden",
 "klant_telefoonnummer":"071-7110335",
 "klant_faxnummer":"123-4567890",
 "klant_land":"Nederland",
 "klant_rekeningnummer":"NL68INGB0004270579",
 "klant_tenaamstelling":"Mr.",

 "id":"1785134",
 "sjablonen_id":"124410",
 "btw_verlegd":"nee",
 "credit_factuur":"nee",
 "including_vat":"nee",
 "referentie":"489AAD",
 "opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
 "betaalstatus":"betaald",
 "factuurnummer":"20151001",
 "automatische_incasso":"nee",
 "factuurdatum":"2015-09-10",
 "vervaldatum":"2015-09-21",
 "cyclus_id":"37907",
 "volgende_actie_datum":"2015-09-21",
 "volgende_actie":"Herinnering",
 "cyclus_stap":"Standaard",
 "totaal_ex_btw":"195.00",
 "totaal_btw":"40.95",
 "status":"betaald",
 "betaaldatum":"14-10-2015",
 "factuurregels":
  [{
   "id":"10029489",
   "quantity":"1.00",
   "item":"Hostingkosten",
   "price":"10.000",
   "vat":"0.210"
  }]
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/37538/b4c52c424afcb089ed61590df868c540/factuur_aanmaken&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
  <klant_id>548941</klant_id>
  <klant_relatienummer>123456789</klant_relatienummer>
  <klant_btw_nummer>NL851898841B01</klant_btw_nummer>
  <klant_type>debiteur</klant_type>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_contactpersoon_naam>Ravi Chotkan</klant_contactpersoon_naam>
  <klant_contactpersoon_afdeling>Support</klant_contactpersoon_afdeling>
  <klant_contactpersoon_email>support@digitalefactuur.nl</klant_contactpersoon_email>
  <klant_email>support@digitalefactuur.nl</klant_email>
  <klant_adres>Haagweg 4F12</klant_adres>
  <klant_postcode>2311 AA</klant_postcode>
  <klant_plaats>Leiden</klant_plaats>
  <klant_telefoonnummer>071-7110335</klant_telefoonnummer>
  <klant_faxnummer>123-4567890</klant_faxnummer>
  <klant_land>Nederland</klant_land>
  <klant_tenaamstelling>Digitalefactuur</klant_tenaamstelling>
  <klant_automatische_incasso>nee</klant_automatische_incasso>
  <klant_mandaat_kenmerk/>1001<klant_mandaat_kenmerk/>
  <klant_mandaat_datum/>31-12-2015<klant_mandaat_datum/>
  <klant_soort>zakelijk</klant_soort>
  <klant_iban/>NL68INGB0004270579<klant_iban/>
  <klant_bic/>INGBNL2A<klant_bic/>
  <klant_voorletters/>S<klant_voorletters/>
  <klant_tussenvoegsel/><klant_tussenvoegsel/>
  <klant_achternaam/>Chotkan<klant_achternaam/>

  <id>1845872</id>
  <extern_id></extern_id>
  <klant_id>1681254</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <contactpersoon_id>1234</contactpersoon_id>
  <contactpersoon_naam>Ravi Chotkan</contactpersoon_naam>
  <sjabloon_id>124410</sjabloon_id>
  <btw_verlegd>nee</btw_verlegd>
  <credit_factuur>nee</credit_factuur>
  <totaalprijs_exclusief_btw>950.00</totaalprijs_exclusief_btw>
  <totaal_btw>0.00</totaal_btw>
  <inclusief_btw>nee</inclusief_btw>
  <referentie>489AAD</referentie>
  <offerte_id>1234</offerte_id>
  <betaalstatus>nog niet verstuurd</betaalstatus>
  <betaaldatum></betaaldatum>
  <factuurnummer_voorloop>1234</factuurnummer_voorloop>
  <factuurnummer>12345</factuurnummer>
  <opmerking>Bedankt voor het vertrouwen in Digitalefactuur</opmerking>
  <opmerking_op_factuur>nee</opmerking_op_factuur>
  <automatische_incasso>ja</automatische_incasso>
  <factuurdatum>2015-11-05</factuurdatum>
  <vervaldatum>2015-11-19</vervaldatum>
  <factuurregel>
   <id>10666052</id>
   <aantal>1.00</aantal>
   <omschrijving>Hostingkosten</omschrijving>
   <prijs>10.00</prijs>
   <btw>0.000</btw>
  </factuurregel>
  <kortingen>
   <id>172396</id>
   <soort>percentage</soort>
   <hoeveelheid>0.0500</hoeveelheid>
   <btw>0.000</btw>
   <omschrijving>Korting</omschrijving>
  </kortingen>
</factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Betaling ongedaan maken POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_ongedaan_maken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_betaling_ongedaan_maken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_ongedaan_maken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_ongedaan_maken"

Response body 

[{
    "id":"1785134"
}]

Response body 

<factuur>
 <id>9595</id>
</factuur>

Code example 

<?php
$json = '{
"id":"1785134"
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_ongedaan_maken&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
  <id>1843157</id>
 </factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_ongedaan_maken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Betaling verwerken POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_betaling_verwerken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken"

Response body 

[{
 "id":"1785134",
 "datum":"2010-01-25"
}]

Response body 

<factuur>
 <id>9595</id>
 <datum>2010-01-25</datum>
</factuur>

Code example 

<?php
$json = '{
"id":"1785134",
"datum":"2010-01-25"
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
 <id>9595</id>
 <datum>2010-01-25</datum>
</factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Deelbetaling ongedaan maken POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_betaling_verwerken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken"

Response body 

[{
 "id":"1857976",
 "deelbetaling":"1",
 "voldaan":"100",
 "datum":"2015-11-20"
}]

Response body 

<factuur>
 <id>9595</id>
 <deelbetaling>1</deelbetaling>
 <voldaan>150</voldaan>
 <datum>2010-01-25</datum>
</factuur>

Code example 

<?php
$json = '{
"id":"1857976",
"deelbetaling":"1",
"voldaan":"100",
"datum":"2015-11-20"
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
 <id>1845925</id>
 <deelbetaling>1</deelbetaling>
 <voldaan>150</voldaan>
 <datum>2010-01-25</datum>
</factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_betaling_verwerken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Factuur Downloaden GET

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_download

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_download

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
facturen_id number Het ID van de factuur
download-type type Hoe je hem wilt downloaden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_download&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_download"

Response body 

[{
 "id":"1857976",
 "datum":"2015-11-20"
}]

Response body 

<factuur>
 <id>1845925</id>
 <datum>2015-11-05</datum>
</factuur>

Code example 

<?php
$json = '{
"id":"1857976",
"datum":"2015-11-20"
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_download&facturen_id=1845944&download_type=base64&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
 <id>1845925</id>
 <datum>2015-11-05</datum>
</factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_download&facturen_id=1845944&download_type=base64";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Factuur Updaten POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_updaten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_updaten

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_updaten&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_updaten"

Response body 

[{
 "id":"1785134",
 "klanten_id":"1654497",
 "sjablonen_id":"124410",
 "btw_verlegd":"nee",
 "credit_factuur":"nee",
 "including_vat":"nee",
 "referentie":"489AAD",
 "opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
 "betaalstatus":"betaald",
 "factuurnummer":"20151001",
 "automatische_incasso":"nee",
 "factuurdatum":"2015-09-07",
 "vervaldatum":"2015-09-21",
 "cyclus_id":"37907",
 "volgende_actie_datum":"2015-09-21",
 "volgende_actie":"Herinnering",
 "cyclus_stap":"Standaard",
 "totaal_ex_btw":"195.00",
 "totaal_btw":"40.95",
 "status":"betaald",
 "klant_naam":"Digitalefactuur",
 "klant_adres":"Haagweg 4F12",
 "klant_postcode":"2311AA",
 "klant_plaats":"Leiden",
 "klant_land":"Nederland",
 "klant_email":"support@digitalefactuur.nl",
 "betaaldatum":"14-10-2015",
 "factuurregels":
  [{
   "id":"10029489",
   "quantity":"1.00",
   "item":"Hostingkosten",
   "price":"10.000",
   "vat":"0.210"
  }]
}]

Response body 

<factuur>
  <id>1845906</id>
  <extern_id>1845872</extern_id>
  <sjabloon_id>124410</sjabloon_id>
  <btw_verlegd>nee</btw_verlegd>
  <credit_factuur>nee</credit_factuur>
  <totaalprijs_exclusief_btw>999.50</totaalprijs_exclusief_btw>
  <totaal_btw>0.00</totaal_btw>
  <inclusief_btw>nee</inclusief_btw>
  <referentie/>
  <offerte_id/>
  <betaalstatus>nog niet verstuurd</betaalstatus>
  <betaaldatum></betaaldatum>
  <factuurnummer_voorloop/>
  <factuurnummer/>
  <opmerking/>
  <opmerking_op_factuur>nee</opmerking_op_factuur>
  <automatische_incasso>ja</automatische_incasso>
  <factuurdatum>2015-11-05</factuurdatum>
  <vervaldatum>2015-11-19</vervaldatum>
  <hoogste_type_verstuurd/>
  <factuurregel>
   <id>10666391</id>
   <aantal>1.00</aantal>
   <omschrijving>Bankje</omschrijving>
   <prijs>1000.000</prijs>
   <btw>0.000</btw>
  </factuurregel>
  <kortingen>
   <id>172397</id>
   <soort>percentage</soort>
   <hoeveelheid>0.0005</hoeveelheid>
   <btw>0.210</btw>
   <omschrijving>Korting</omschrijving>
  </kortingen>
 </factuur>

Code example 

<?php
$json = '{
 "id":"1785134",
 "klanten_id":"1654497",
 "sjablonen_id":"124410",
 "btw_verlegd":"nee",
 "credit_factuur":"nee",
 "including_vat":"nee",
 "referentie":"489AAD",
 "opmerking":"Bedankt voor het vertrouwen in DigitaleFactuur",
 "betaalstatus":"betaald",
 "factuurnummer":"20151001",
 "automatische_incasso":"nee",
 "factuurdatum":"2015-09-07",
 "vervaldatum":"2015-09-21",
 "cyclus_id":"37907",
 "volgende_actie_datum":"2015-09-21",
 "volgende_actie":"Herinnering",
 "cyclus_stap":"Standaard",
 "totaal_ex_btw":"195.00",
 "totaal_btw":"40.95",
 "status":"betaald",
 "klant_naam":"Digitalefactuur",
 "klant_adres":"Haagweg 4F12",
 "klant_postcode":"2311AA",
 "klant_plaats":"Leiden",
 "klant_land":"Nederland",
 "klant_email":"support@digitalefactuur.nl",
 "betaaldatum":"14-10-2015",
 "factuurregels":
  [{
   "id":"10029489",
   "quantity":"1.00",
   "item":"Hostingkosten",
   "price":"10.000",
   "vat":"0.210"
  }]
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_updaten&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Facturen van offerte maken POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_factuur_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/offerte_factuur_aanmaken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
offerte_id int Het id van de offerte waar je een factuur van wilt maken.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_factuur_aanmaken&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_factuur_aanmaken"

Response body

Response body

Code example 

<?php
$json = '';
 
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_factuur_aanmaken&offerte_id=2663&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_factuur_aanmaken&offerte_id=2663";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Versturen per mail POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_versturen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen"

Response body 

[{
"id":"1785134",
"sjablonen_id":"124410",
"methode":"email",
"emailtekst":"hier de tekst in de mail",
"email":"support@digitalefactuur.nl",
"ubl":"nee"
}]

Response body 

<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>email</methode>
 <emailtekst>hier de tekst in de mail</emailtekst>
 <email>support@digitalefactuur.nl</email>
 <ubl>nee</ubl>
</factuur>

Code example 

<?php
$json = '{
"id":"1785134",
"sjablonen_id":"124410",
"methode":"email",
"emailtekst":"hier de tekst in de mail",
"email":"support@digitalefactuur.nl",
"ubl":"nee"
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
 <id>1845928</id>
 <sjablonen_id>124410</sjablonen_id>
 <methode>email</methode>
 <emailtekst>dit is de tekst in de mail</emailtekst>
 <email>support@digitalefactuur.nl</email>
 <ubl>nee</ubl>
</factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Versturen per post POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_versturen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen"

Response body 

[{
	"id":"1876229",
	"sjablonen_id":"124410",
	"methode":"post",
	"post_type":"kleur",
	"email":"support@digitalefactuur.nl",
	"klant_naam":"Ravi Chotkan",
	"klant_adres":"Haagweg 4F12",
	"klant_postcode":"2311AA",
	"klant_plaats":"Leiden"
}]

Response body 

<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>post</methode>
 <post_type>kleur</post_type>
 <klant_naam>Ravi Chotkan</klant_naam>
 <klant_adres>Haagweg 4F12</klant_adres>
 <klant_postcode>2311AA</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
</factuur>

Code example 

<?php
$json = '{
"id":"1876229",
"sjablonen_id":"124410",
"methode":"post",
"post_type":"kleur",
"email":"support@digitalefactuur.nl",
"klant_naam":"Ravi Chotkan",
"klant_adres":"Haagweg 4F12",
"klant_postcode":"2311AA",
"klant_plaats":"Leiden"
}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php
$xml = "<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>post</methode>
 <post_type>kleur</post_type>
 <klant_naam>Ravi Chotkan</klant_naam>
 <klant_adres>Haagweg 4F12</klant_adres>
 <klant_postcode>2311AA</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
</factuur>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_versturen";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Factuur verwijderen POST

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_verwijderen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_verwijderen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
facturen_id int ID van de factuur.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_verwijderen&json=true"

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_verwijderen"

Response body

Response body 

<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>post</methode>
 <post_type>kleur</post_type>
 <klant_naam>Ravi Chotkan</klant_naam>
 <klant_adres>Haagweg 4F12</klant_adres>
 <klant_postcode>2311AA</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
</factuur>

Code example 

<?php
$json = '';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_verwijderen&facturen_id=1785134&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch,
 CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Code example 

<?php

$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_verwijderen&facturen_id=1845928";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
 
$result = curl_exec($ch);
curl_close($ch);
 
echo $result;
exit();
 
?>

Factuur Crediteren POST

XML is nog niet beschikbaar, gebruik JSON.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_crediteren

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/factuur_crediteren

URL parameters

Naam Type Beschrijving
facturen_id int ID van de factuur
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/factuur_crediteren&json=true"

Response body 

{
    "success": true,
    "creditId": "1785134"
}

Bonnetjes

Bonnetjes lijst GET

XML is nog niet beschikbaar, gebruik JSON.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/inkomende_facturen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
page int nummer van de pagina die geselecteerd moet worden.
order_column string Waar er op gesorteerd moet worden; factuurnummer, factuurdatum, vervaldatum, referentie, nummerern_nummer.
order_type asc | desc Hoe het gesorteerd word, oplopend of aflopend.
inkomende_facturen_id int ID van de inkomende factuur.
zoekwoord string Woord waar je op wilt zoeken.
timestamp int Haalt inkomende facturen op die aangemaakt/gewijzigd zijn na het aangegeven tijdstip.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen&json=true"

Response body 

[{
	"klant_naam":"Digitalefactuur",
	"klant_adres":"Haagweg 4F12",
	"klant_postcode":"2311 AA",
	"klant_plaats":"Leiden",
	"klanten_id":"1681222",
	"relatienummer":"1003",
	"id":"159063",
	"factuurnummer":"20151102",
	"factuurdatum":"2015-11-02",
	"vervaldatum":"2015-11-20",
	"referentie":"AWE887",
	"nummerern_nummer":"448",
	"totaal_btw":"25.20",
	"totaal_inclusief_btw":"145.20",
	"totaal_exclusief_btw":"120.00",
	"btw_verlegd":"nee",
	"betaalstatus":"geregistreerd",
	"betaaldatum":"2015-11-10",
	"status":"geregistreerd",
	"bijlage":""
}]

Code example 

<?php
$json = '';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Bonnetje Aanmaken POST

XML is nog niet beschikbaar, gebruik JSON.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/inkomende_facturen_aanmaken

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_aanmaken&json=true"

Response body 

[{
	"klant_naam":"Digitalefactuur",
	"klant_adres":"Haagweg 4F12",
	"klant_postcode":"2311 AA",
	"klant_plaats":"Leiden",
	"klanten_id":"1681222",
	"relatienummer":"1003",
	"id":"159063",
	"factuurnummer":"20151102",
	"factuurdatum":"2015-11-02",
	"vervaldatum":"2015-11-20",
	"referentie":"AWE887",
	"nummerern_nummer":"448",
	"totaal_btw":"25.20",
	"totaal_inclusief_btw":"145.20",
	"totaal_exclusief_btw":"120.00",
	"btw_verlegd":"nee",
	"betaalstatus":"geregistreerd",
	"betaaldatum":"2015-11-10",
	"status":"geregistreerd",
	"bijlage":""
}]

Code example 

<?php
$json = '{"klant_naam":"Digitalefactuur",
    "klant_adres":"Haagweg 4F12",
    "klant_postcode":"2311 AA",
    "klant_plaats":"Leiden",
    "klanten_id":"1681222",
    "relatienummer":"1003",
    "id":"159063",
    "factuurnummer":"20151102",
    "factuurdatum":"2015-11-02",
    "vervaldatum":"2015-11-20",
    "referentie":"AWE887",
    "nummerern_nummer":"448",
    "totaal_btw":"25.20",
    "totaal_inclusief_btw":"145.20",
    "totaal_exclusief_btw":"120.00",
    "btw_verlegd":"nee",
    "betaalstatus":"geregistreerd",
    "betaaldatum":"2015-11-10",
    "status":"geregistreerd",
    "bijlage":""}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_aanmaken&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Bonnetje Updaten POST

XML is nog niet beschikbaar, gebruik JSON.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_updaten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/inkomende_facturen_updaten

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_updaten&json=true"

Response body 

[{
	"klant_naam":"Digitalefactuur",
	"klant_adres":"Haagweg 4F12",
	"klant_postcode":"2311 AA",
	"klant_plaats":"Leiden",
	"klanten_id":"1694344",
	"relatienummer":"1003",
	"id":"162451",
	"factuurnummer":"20151102",
	"factuurdatum":"2015-11-02",
	"vervaldatum":"2015-11-20",
	"referentie":"AWE887",
	"nummerern_nummer":"448",
	"totaal_btw":"25.20",
	"totaal_inclusief_btw":"145.20",
	"totaal_exclusief_btw":"120.00",
	"btw_verlegd":"nee",
	"betaalstatus":"geregistreerd",
	"betaaldatum":"2015-11-10",
	"status":"geregistreerd",
	"bijlage":""
}]

Code example 

<?php
$json = '{"klant_naam":"Digitalefactuur",
    "klant_adres":"Haagweg 4F12",
    "klant_postcode":"2311 AA",
    "klant_plaats":"Leiden",
    "klanten_id":"1694344",
    "relatienummer":"1003",
    "id":"162451",
    "factuurnummer":"20151102",
    "factuurdatum":"2015-11-02",
    "vervaldatum":"2015-11-20",
    "referentie":"AWE887",
    "nummerern_nummer":"448",
    "totaal_btw":"25.20",
    "totaal_inclusief_btw":"145.20",
    "totaal_exclusief_btw":"120.00",
    "btw_verlegd":"nee",
    "betaalstatus":"geregistreerd",
    "betaaldatum":"2015-11-10",
    "status":"geregistreerd",
    "bijlage":""}';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_updaten&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Bonnetje Verwijderen POST

XML is nog niet beschikbaar, gebruik JSON.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_verwijderen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/inkomende_facturen_verwijderen

URL parameters

Naam Type Beschrijving
json boolean 0|1 Laat de API met json antwoorden.
inkomende_facturen_id int ID van de inkomende factuur.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/json' "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_verwijderen?json=true"

Response body

Code example 

<?php
$json = '';
 
// url naar waar de xml gepost moet worden
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/inkomende_facturen_verwijderen?inkomende_facturen_id=162451&json=true";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"json=" . urlencode($json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Periodiek

Periodiek Lijst GET

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/periodieken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/periodieken

URL parameters

Naam Type Beschrijving
page int Er zijn maximaal 25 resultaten per pagina. Door een pagina nummer aan te geven krijg je de resultaten van die pagina.
order_column string Waar er op gesorteerd moet worden.
order_type asc | desc Oplopend of aflopend sorteren.
periodiek_id int ID van de periodieke factuur.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/periodieken"

Response body 

<periodiek>
  <id>21372</id>
  <extern_id/>
  <klant_id>1681254</klant_id>
  <klant_naam>Ravi BV</klant_naam>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124410</sjabloon_id>
  <periode>jaar</periode>
  <volgende_factuur>2015-11-06</volgende_factuur>
  <eind_datum/>
  <aantal_keer_limiet/>
  <automatisch_versturen>nee</automatisch_versturen>
  <referentie/>
  <automatische_incasso>ja</automatische_incasso>
  <btw_verlegd>nee</btw_verlegd>
  <status>actief</status>
  <periodiekregel>
   <id>187556</id>
   <aantal>5.00</aantal>
   <omschrijving> Hostingkosten</omschrijving>
   <prijs>20.000</prijs>
   <btw>0.000</btw>
  </periodiekregel>
 </periodiek>

Code example 

<?php

$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/periodieken";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
 
$result = curl_exec($ch);
curl_close($ch);
 
echo $result;
exit();
 
?>

Periodiek Aanmaken POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/periodiek_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/periodiek_aanmaken

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/periodiek_aanmaken"

Response body 

<periodiek>
 <klant_relatienummer>1</klant_relatienummer>
 <klant_naam>DigitaleFactuur</klant_naam>
 <klant_contactpersoon_naam>Ravi Chotkan</klant_contactpersoon_naam>
 <klant_email>support@digitalefactuur.nl</klant_email>
 <klant_adres>Haagweg 4F12</klant_adres>
 <klant_postcode>2311 AA</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
 <klant_telefoonnummer>071 513 89 85</klant_telefoonnummer>
 
 <btw_verlegd>ja</btw_verlegd>
 <periode>maand</periode>
 <periodiekregel>
  <id>320</id>
  <aantal>1.00</aantal>
  <omschrijving>Hosting</omschrijving>
  <prijs>150.000</prijs>
  <btw>0.190</btw>
 </periodiekregel>
</periodiek>

Code example 

<?php
$xml = "<periodiek>
  <id>21372</id>
  <extern_id/>
  <klant_id>1681254</klant_id>
  <klant_naam>Ravi BV</klant_naam>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124410</sjabloon_id>
  <periode>jaar</periode>
  <volgende_factuur>2015-11-06</volgende_factuur>
  <eind_datum/>
  <aantal_keer_limiet/>
  <automatisch_versturen>nee</automatisch_versturen>
  <referentie/>
  <automatische_incasso>ja</automatische_incasso>
  <btw_verlegd>nee</btw_verlegd>
  <status>actief</status>
  <periodiekregel>
   <id>187556</id>
   <aantal>5.00</aantal>
   <omschrijving> Hostingkosten</omschrijving>
   <prijs>20234.000</prijs>
   <btw>0.000</btw>
  </periodiekregel>
 </periodiek>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/periodiek_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Periodiek Updaten POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/periodiek_updaten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/periodiek_updaten

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/periodiek_updaten"

Response body 

<periodiek>
 <klant_relatienummer>1</klant_relatienummer>
 <klant_naam>DigitaleFactuur</klant_naam>
 <klant_contactpersoon_naam>Ravi Chotkan</klant_contactpersoon_naam>
 <klant_email>support@digitalefactuur.nl</klant_email>
 <klant_adres>Haagweg 4F12</klant_adres>
 <klant_postcode>2311 AA</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
 <klant_telefoonnummer>071 513 89 85</klant_telefoonnummer>
 
 <btw_verlegd>ja</btw_verlegd>
 <periode>kwartaal</periode>
 <id>6893</id>
 <periodiekregel>
  <id>320</id>
  <aantal>1.00</aantal>
  <omschrijving>Hosting</omschrijving>
  <prijs>150.000</prijs>
  <btw>0.190</btw>
 </periodiekregel>
</periodiek>

Code example 

<?php
$xml = "<periodiek>
  <id>21372</id>
  <extern_id/>
  <klant_id>1681254</klant_id>
  <klant_naam>Ravi BV</klant_naam>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124410</sjabloon_id>
  <periode>jaar</periode>
  <volgende_factuur>2015-11-06</volgende_factuur>
  <eind_datum/>
  <aantal_keer_limiet/>
  <automatisch_versturen>nee</automatisch_versturen>
	  <referentie/>
  <automatische_incasso>ja</automatische_incasso>
  <btw_verlegd>nee</btw_verlegd>
  <status>actief</status>
  <periodiekregel>
   <id>187556</id>
   <aantal>5.00</aantal>
   <omschrijving> Hostingkosten</omschrijving>
   <prijs>20234.000</prijs>
   <btw>0.000</btw>
  </periodiekregel>
 </periodiek>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/periodiek_updaten";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Abonnementen

Abonnementen lijst GET

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnementen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/abonnementen

URL parameters

Naam Type Beschrijving
page int Er zijn maximaal 25 resultaten per pagina. Door een pagina nummer aan te geven krijg je de resultaten van die pagina.
order_type asc | desc Oplopend of aflopend sorteren.
abbonement_id int ID van het abonnement.
klanten_id int ID van de klant.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnementen"

Response body 

<abonnement>
  <id>61316</id>
  <extern_id/>
  <abonnement_type_id>0</abonnement_type_id>
  <klant_id>1681087</klant_id>
  <klant_naam>DigitaleFactuur</klant_naam>
  <klant_email>support@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam></contactpersoon_naam>
  <contactpersoon_email></contactpersoon_email>
  <sjabloon_id>124410</sjabloon_id>
  <bedrag>5.00</bedrag>
  <btw>21</btw>
  <referentie></referentie>
  <begin_datum>2015-11-05</begin_datum>
  <eind_datum>2016-01-05</eind_datum>
  <automatische_incasso>nee</automatische_incasso>
  <periode>week</periode>
  <omschrijving>abonnement van BEGIN_DATUM_NUMERIEK tot EIND_DATUM_NUMERIEK</omschrijving>
  <automatisch_versturen>nee</automatisch_versturen>
 </abonnement>

Code example 

<?php
$xml = "";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnementen";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Abonnementen Aanmaken POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnement_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/abonnement_aanmaken

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnement_aanmaken"

Response body 

<abonnement>
 <id>3695</id>
 <klant_naam>Ravi Chotkan</klant_naam>
 <klant_email>support@digitalefactuur.nl</klant_email>
 <update_klanten_veld>email</update_klanten_veld>
 <referentie>1234TEST</referentie>
 <abonnement_type_id>12</abonnement_type_id>
 <btw_verlegd>ja</btw_verlegd>
</abonnement>

Code example 

<?php
$xml = " <abonnement>
  <id>2133</id>
  <extern_id/>
  <abonnement_type_id>0</abonnement_type_id>
  <klant_id>1681087</klant_id>
  <klant_naam>DigitaleFactuur</klant_naam>
  <klant_email>support@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam></contactpersoon_naam>
  <contactpersoon_email></contactpersoon_email>
  <sjabloon_id>124410</sjabloon_id>
  <bedrag>53.00</bedrag>
  <btw>21</btw>
  <referentie></referentie>
  <begin_datum>2015-11-05</begin_datum>
  <eind_datum>2016-01-05</eind_datum>
  <automatische_incasso>nee</automatische_incasso>
  <periode>week</periode>
  <omschrijving>abonnement van BEGIN_DATUM_NUMERIEK tot EIND_DATUM_NUMERIEK</omschrijving>
  <automatisch_versturen>nee</automatisch_versturen>
 </abonnement>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnement_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Abonnementen Verwijderen POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnement_verwijderen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/abonnement_verwijderen

URL parameters

Naam Type Beschrijving
abonnement_id int Id van het abonnement

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnement_verwijderen"

Response body

Code example 

<?php

$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/abonnement_verwijderen&abonnement_id=61408";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
 
$result = curl_exec($ch);
curl_close($ch);
 
echo $result;
exit();
 
?>

Offertes

Offertes Lijst GET

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/offerte

URL parameters

Naam Type Beschrijving
page int Er zijn maximaal 25 resultaten per pagina. Door een pagina nummer aan te geven krijg je de resultaten van die pagina.
order_type asc | desc Oplopend of aflopend sorteren.
offerte_id int ID van de offerte.
klanten_id int ID van de klant.
offertenummer int Nummer van de offerte.
vervaldatum_vanaf int Vanaf welke datum de offertes geselecteerd moeten worden.
relatienummer int Nummer van de relatie
status string De status van de offerte. afgekeurd, goedgekeurd of wachten_op_goedkeuring.
verstuurd string Of de offerte verstuurd is.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte"

Response body 

<offerte>
  <id>121474</id>
  <extern_id/>
  <klant_id>1682588</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_email>info@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124412</sjabloon_id>
  <totaalprijs_exclusief_btw>800.00</totaalprijs_exclusief_btw>
  <totaal_btw>168.00</totaal_btw>
  <referentie/>
  <offertenummer>1000</offertenummer>
  <opmerking/>
  <opmerking_op_offerte>nee</opmerking_op_offerte>
  <offertedatum>2015-11-09</offertedatum>
  <vervaldatum>2015-12-09</vervaldatum>
  <offerte_goedgekeurd/>
  <geaccepteerd_door/>
  <geaccepteerd_datum/>
  <geaccepteerd_ip/>
  <geaccepteerd_opmerking/>
  <offerteregel>
   <id>3487030</id>
   <products_id/>
   <aantal>1.00</aantal>
   <omschrijving>Documentatie</omschrijving>
   <prijs>800.00</prijs>
   <btw>0.210</btw>
  </offerteregel>
 </offerte>

Code example 

<?php
$xml = "";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Offerte Aanmaken POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/offerte_aanmaken

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte"

Response body 

<offerte>
  <id>121474</id>
  <extern_id/>
  <klant_id>1682588</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_email>info@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124412</sjabloon_id>
  <totaalprijs_exclusief_btw>800.00</totaalprijs_exclusief_btw>
  <totaal_btw>168.00</totaal_btw>
  <referentie/>
  <offertenummer>1000</offertenummer>
  <opmerking/>
  <opmerking_op_offerte>nee</opmerking_op_offerte>
  <offertedatum>2015-11-09</offertedatum>
  <vervaldatum>2015-12-09</vervaldatum>
  <offerte_goedgekeurd/>
  <geaccepteerd_door/>
  <geaccepteerd_datum/>
  <geaccepteerd_ip/>
  <geaccepteerd_opmerking/>
  <offerteregel>
   <id>3487030</id>
   <products_id/>
   <aantal>1.00</aantal>
   <omschrijving>Documentatie</omschrijving>
   <prijs>800.00</prijs>
   <btw>0.210</btw>
  </offerteregel>
 </offerte>

Code example 

<?php
$xml = " <offerte>
  <id>12231474</id>
  <extern_id/>
  <klant_id>1682588</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_email>info@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124412</sjabloon_id>
  <totaalprijs_exclusief_btw>800.00</totaalprijs_exclusief_btw>
  <totaal_btw>168.00</totaal_btw>
  <referentie/>
  <offertenummer>1000</offertenummer>
  <opmerking/>
  <opmerking_op_offerte>nee</opmerking_op_offerte>
  <offertedatum>2015-11-09</offertedatum>
  <vervaldatum>2015-12-09</vervaldatum>
  <offerte_goedgekeurd/>
  <geaccepteerd_door/>
  <geaccepteerd_datum/>
  <geaccepteerd_ip/>
  <geaccepteerd_opmerking/>
  <offerteregel>
   <id>3487030</id>
   <products_id/>
   <aantal>1.00</aantal>
   <omschrijving>Documentatie</omschrijving>
   <prijs>800.00</prijs>
   <btw>0.210</btw>
  </offerteregel>
 </offerte>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Offerte Updaten POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_updaten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/offerte_updaten

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_updaten"

Response body 

<offerte>
  <id>12231474</id>
  <extern_id/>
  <klant_id>1682588</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_email>info@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124412</sjabloon_id>
  <totaalprijs_exclusief_btw>800.00</totaalprijs_exclusief_btw>
  <totaal_btw>168.00</totaal_btw>
  <referentie/>
  <offertenummer>1000</offertenummer>
  <opmerking/>
  <opmerking_op_offerte>nee</opmerking_op_offerte>
  <offertedatum>2015-11-09</offertedatum>
  <vervaldatum>2015-12-09</vervaldatum>
  <offerte_goedgekeurd/>
  <geaccepteerd_door/>
  <geaccepteerd_datum/>
  <geaccepteerd_ip/>
  <geaccepteerd_opmerking/>
  <offerteregel>
   <id>3487030</id>
   <products_id/>
   <aantal>1.00</aantal>
   <omschrijving>Documentatie</omschrijving>
   <prijs>800.00</prijs>
   <btw>0.210</btw>
  </offerteregel>
 </offerte>

Code example 

<?php
$xml = " <offerte>
  <id>12231474</id>
  <extern_id/>
  <klant_id>1682588</klant_id>
  <klant_naam>Digitalefactuur</klant_naam>
  <klant_email>info@digitalefactuur.nl</klant_email>
  <contactpersoon_id/>
  <contactpersoon_naam/>
  <sjabloon_id>124412</sjabloon_id>
  <totaalprijs_exclusief_btw>800.00</totaalprijs_exclusief_btw>
  <totaal_btw>168.00</totaal_btw>
  <referentie/>
  <offertenummer>1000</offertenummer>
  <opmerking/>
  <opmerking_op_offerte>nee</opmerking_op_offerte>
  <offertedatum>2015-11-09</offertedatum>
  <vervaldatum>2015-12-09</vervaldatum>
  <offerte_goedgekeurd/>
  <geaccepteerd_door/>
  <geaccepteerd_datum/>
  <geaccepteerd_ip/>
  <geaccepteerd_opmerking/>
  <offerteregel>
   <id>3487030</id>
   <products_id/>
   <aantal>1.00</aantal>
   <omschrijving>Documentatie</omschrijving>
   <prijs>800.00</prijs>
   <btw>0.210</btw>
  </offerteregel>
 </offerte>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Offerte Vesturen POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_versturen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/offerte_versturen

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_versturen"

Response body 

<offerte>
 <id>121479</id>
 <email_tekst>dit is een test</email_tekst>
 <email>Ravi@digitalefactuur.nl</email>
</offerte>

Code example 

<?php
$xml = " <offerte>
 <id>121479</id>
 <email_tekst>dit is een test</email_tekst>
 <email>Ravi@digitalefactuur.nl</email>
</offerte>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_versturen";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Offerte Verwijderen POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_verwijderen

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/offerte_verwijderen

URL parameters

Naam Type Beschrijving
offerte_id int ID van de offerte.

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_verwijderen"

Response body

Code example 

<?php

$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/offerte_verwijderen&offerte_id=121481";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
 
$result = curl_exec($ch);
curl_close($ch);
 
echo $result;
exit();
 
?>

Producten

Producten Lijst GET

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/producten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/producten

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/producten"

Response body 

<producten>
  <id>431829</id>
  <nummer>1</nummer>
  <naam>Water</naam>
  <omschrijving>Water om te drinken</omschrijving>
  <prijs>1.000</prijs>
  <btw>21</btw>
  <inkoopprijs>0.100</inkoopprijs>
  <inkoopprijs_btw>21</inkoopprijs_btw>
 </producten>

Code example 

<?php
$xml = "";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/producten";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Producten Aanmaken POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/product_aanmaken

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/product_aanmaken

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/product_aanmaken"

Response body 

<producten>
  <id>431829</id>
  <nummer>1</nummer>
  <naam>Water</naam>
  <omschrijving>Water om te drinken</omschrijving>
  <prijs>1.000</prijs>
  <btw>21</btw>
  <inkoopprijs>0.100</inkoopprijs>
  <inkoopprijs_btw>21</inkoopprijs_btw>
 </producten>

Code example 

<?php
$xml = "<producten>
  <id>431829</id>
  <nummer>1</nummer>
  <naam>Water</naam>
  <omschrijving>Water om te drinken</omschrijving>
  <prijs>1.000</prijs>
  <btw>21</btw>
  <inkoopprijs>0.100</inkoopprijs>
  <inkoopprijs_btw>21</inkoopprijs_btw>
 </producten>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/product_aanmaken";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Producten Updaten POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/product_updaten

DEPRECATED

https://api.digitalefactuur.nl/api/ACC_ID/API_KEY/product_updaten

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/product_updaten"

Response body 

<producten>
  <id>431829</id>
  <nummer>1</nummer>
  <naam>Water</naam>
  <omschrijving>Water om te drinken</omschrijving>
  <prijs>1.000</prijs>
  <btw>21</btw>
  <inkoopprijs>0.100</inkoopprijs>
  <inkoopprijs_btw>21</inkoopprijs_btw>
 </producten>

Code example 

<?php
$xml = "<producten>
  <id>431829</id>
  <nummer>1</nummer>
  <naam>Water</naam>
  <omschrijving>Water om te drinken</omschrijving>
  <prijs>1.000</prijs>
  <btw>21</btw>
  <inkoopprijs>0.100</inkoopprijs>
  <inkoopprijs_btw>21</inkoopprijs_btw>
 </producten>";
      
$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/product_updaten";
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . urlencode($xml));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL,$url);
 
$result= curl_exec ($ch);
curl_close ($ch);
echo $result;
die();
?>

Producten Verwijderen POST

JSON is nog niet beschikbaar, gebruik XML.

URL

V3

https://api.digitalefactuur.nl/api/v3/ACC_ID/product_verwijderen

DEPRECATED

https://api.digitalefactuur.nl/api/ACCOUNTS_ID/TOEGANGSCODE/product_verwijderen

URL parameters

Naam Type Beschrijving
products_id int ID van het product

Code voorbeelden

Curl example 

curl --user ACC_ID:API_KEY -X POST -H 'Content-Type: application/xml' "https://api.digitalefactuur.nl/api/v3/ACC_ID/product_verwijderen"

Response body

Code example 

<?php

$url = "https://api.digitalefactuur.nl/api/v3/ACC_ID/product_verwijderen&products_id=431833";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_USERPWD, $accountId . ":" . $apiKey);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
 
$result = curl_exec($ch);
curl_close($ch);
 
echo $result;
exit();
 
?>