Online Factureren

De API gebruiken bij het importeren en exporteren van uw facturen

Digitaal (of elektronisch) factureren kan u tijd en geld besparen: binnen enkele minuten is een factuur (of facturen) online opgemaakt, verstuurd en binnen bij uw klant. De ontvanger kan gelijk veilig betalen via een iDeal Factuur en u kunt automatisch controleren of uw facturen betaald zijn. DigitaleFactuur: zo makkelijk kan facturatie zijn.

Facturen API

Met de API van DigitaleFactuur beheert u gemakkelijk uw facturen. Schrijf hiervoor uw eigen code of gebruik de voorbeeldcode op deze pagina. Kies hieronder de code die u wilt bekijken.

Actie	URL	Methode	Import of export
Factuur aanmaken	/factuur_aanmaken	POST	Import
Factuur betaling verwerken - deelbetaling verwerken - betaling ongedaan maken	/factuur_betaling_verwerken /factuur_deelbetaling_verwerken /factuur_betaling_ongedaan_maken	POST	Import
Factuur versturen	/factuur_versturen	POST	Import
Factuur bijwerken	/factuur_update	POST	Import
Factuur verwijderen	/factuur_verwijderen	POST	Import
Facturen ophalen	/factuur_ophalen	GET	Export
Factuur downloaden	/factuur_downloaden	GET	Export

Factuur aanmaken

Bij het aanmaken van de factuur kunt u een bestaande klant van uw account gebruiken of een nieuwe klant laten aanmaken. Bij een nieuwe klant moet u de klantgegevens meesturen en bij een bestaande klant moet u het klant_id meegeven (zie voorbeelden hieronder). Wanneer CURL deze actie succesvol heeft uitgevoerd, krijgt u naast de resultaaat code ook het factuur_id terug.

Let op: deze actie kan slechts op één factuur per keer uitgevoerd worden!

XML-structuur

<factuur>
 <id>160</id>
 
 <!-- bestaande klant gebruiken -->
 <klant_id>73807</klant_id>
 <!-- bestaande klant gebruiken -->
 
 <!-- nieuwe klant invoeren -->
 <klant_relatienummer>0123456</klant_relatienummer>
 <klant_btw_nummer>NL2937</klant_btw_nummer>
 <klant_naam>Digitalefactuur</klant_naam>
 <klant_contactpersoon_naam>Ravi Chotkan</klant_contactpersoon_naam>
 <klant_contactpersoon_afdeling>Programmeer-afdeling</klant_contactpersoon_afdeling>
 <klant_email>info@digitalefactuur.nl</klant_email>
 <klant_adres>Middelstegracht 87e</klant_adres>
 <klant_postcode>2312TT</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
 <klant_telefoonnummer>071 513 89 85</klant_telefoonnummer>
 <klant_faxnummer>084 83 12 235</klant_faxnummer>
 <klant_land>Nederland</klant_land>
 <klant_rekeningnummer>12345678</klant_rekeningnummer>
 <klant_tenaamstelling>Digitalefactuur</klant_tenaamstelling>
 <!-- nieuwe klant invoeren -->

 <factuurdatum>2010-02-06</factuurdatum>

<!-- overige velden -->
<sjabloon_id>1234</sjabloon_id>
<btw_verlegd>ja/nee</btw_verlegd>
<credit_factuur>ja/nee</credit_factuur>
<referentie>ABC 123</referentie>
<betaalstatus>betaald</betaalstatus>
<factuurnummer_voorloop>2011</factuurnummer_voorloop>
<factuurnummer>1023</factuurnummer>
<opmerking>ABC 123</opmerking>
<opmerking_op_factuur>ja/nee</opmerking_op_factuur>
<automatische_incasso>ja/nee</automatische_incasso>
<factuurdatum>2011-01-31</factuurdatum>
<vervaldatum>2011-02-28</vervaldatum>
<payment_rules_id>2</payment_rules_id>
<inclusief_btw>ja/nee</inclusief_btw>
<direct_versturen>ja/nee</direct_versturen>
<!-- overige velden -->

  <factuurregel>
  <aantal>1.00</aantal>
  <omschrijving>Domeinnaam</omschrijving>
  <prijs>40.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
 
 <factuurregel>
  <aantal>1.00</aantal>
  <omschrijving>Hosting</omschrijving>
  <prijs>150.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
</factuur>

Voorbeeld PHP-script

<?php

// url naar waar de xml gepost moet worden
$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/factuur_aanmaken";

// Factuur aanmaken (bestaande klant: klant_id meegeven, nieuwe klant: klantgegevens meegeven )
$xml = "
<factuur>
 <id>160</id>
 
 <!-- bestaande klant gebruiken -->
 <klant_id>73807</klant_id>
 <!-- bestaande klant gebruiken -->
 
 <!-- nieuwe klant invoeren -->
 <klant_relatienummer>0123456</klant_relatienummer>
 <klant_btw_nummer>NL2937</klant_btw_nummer>
 <klant_naam>Digitalefactuur</klant_naam>
 <klant_contactpersoon_naam>Ravi Chotkan</klant_contactpersoon_naam>
 <klant_contactpersoon_afdeling>Programmeer-afdeling</klant_contactpersoon_afdeling>
 <klant_email>info@digitalefactuur.nl</klant_email>
 <klant_adres>Middelstegracht 87e</klant_adres>
 <klant_postcode>2312TT</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
 <klant_telefoonnummer>071 513 89 85</klant_telefoonnummer>
 <klant_faxnummer>084 83 12 235</klant_faxnummer>
 <klant_land>Nederland</klant_land>
 <klant_rekeningnummer>12345678</klant_rekeningnummer>
 <klant_tenaamstelling>Digitalefactuur</klant_tenaamstelling>
 <!-- nieuwe klant invoeren -->
 
 <factuurnummer_voorloop>2010</factuurnummer_voorloop>
 <factuurnummer>160</factuurnummer>
 <factuurdatum>2010-02-06</factuurdatum>

 <factuurregel>
  <aantal>1.00</aantal>
  <omschrijving>Domeinnaam</omschrijving>
  <prijs>40.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
 
 <factuurregel>
  <aantal>1.00</aantal>
  <omschrijving>Hosting</omschrijving>
  <prijs>150.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
</factuur>";

// CURL starten
$ch = curl_init();

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

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

Factuur betaling

U kunt een factuurbetaling verwerken, een deelbetaling van een factuur verwerken of een factuurbetaling ongedaan maken. Het verwerken van een deelbetaling is dezelfde actie als een volledige betaling, maar u stuurt ook het bedrag van de deelbetaling mee. Bij het ongedaan maken van een betaling is slechts het factuur_id nodig.

Let op: deze actie kan slechts op één factuur per keer uitgevoerd worden!

XML-structuur

Volledige betaling:
<factuur>
 <id>9595</id>
 <datum>2010-01-25</datum>
</factuur>


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

Betaling ongedaan maken:
<factuur>
 <id>9595</id>
</factuur>

Voorbeeld PHP-script

<?php

// Actie bij (deel)betaling verwerken: factuur_betaling_verwerken
// Actie bij betaling ongedaan maken: factuur_betaling_ongedaan_maken

// url waar de xml naartoe gestuurd moet worden
$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/factuur_betaling_verwerken";

// volledige betaling
$xml = "
<factuur>
 <id>9595</id>
 <datum>2010-01-25</datum>
</factuur>";

// deelbetaling
$xml = "
<factuur>
 <id>9595</id>
 <deelbetaling>1</deelbetaling>
 <voldaan>150</voldaan>
 <datum>2010-01-25</datum>
</factuur>";

// betaling ongedaan maken
$xml = "
<factuur>
 <id>9595</id>
</factuur>";

// CURL starten
$ch = curl_init();

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

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

?>

Factuur versturen

Een factuur kan per email of per post verstuurd worden. Kies hiervoor in het blok 'methode' in de XML de waarde 'email' of 'post'. Kiest u voor email, dan gebruikt DigitaleFactuur de klant, de emailtekst en het sjabloon dat u bij de factuur hebt opgegeven. Wanneer u één of meerdere van deze velden meegeeft, dan worden die gebruikt. Kiest u voor post, dan is alleen het veld post_type (kleur of zwartwit) verplicht, de velden klant_naam, klant_adres, klant_postcode en klant_plaats verplicht zijn optioneel.

Let op: deze actie kan slechts op één factuur per keer uitgevoerd worden!

XML-structuur

// factuur versturen per email
<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>email</methode>
 <emailtekst>dit is een test</emailtekst>
 <email>ravi@projectie.com</email>
 <ubl>nee</ubl>
</factuur>

// factuur versturen per post
<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>post</methode>
 <post_type>kleur</post_type>
 <klant_naam>Klant Naam</klant_naam>
 <klant_adres>Middelstegracht 87e</klant_adres>
 <klant_postcode>2312TT</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
</factuur>

Voorbeeld PHP-script

<?php

// url naar waar de xml gepost moet worden
$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/factuur_versturen";

// factuur versturen per email
$xml = "
<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>email</methode>
 <emailtekst>dit is een test</emailtekst>
 <email>ravi@projectie.com</email>
 <ubl>nee</ubl>
</factuur>";

// factuur versturen per post
$xml = "
<factuur>
 <id>9595</id>
 <sjablonen_id>859</sjablonen_id>
 <methode>post</methode>
 <post_type>kleur</post_type>
 <klant_naam>Klant Naam</klant_naam>
 <klant_adres>Middelstegracht 87e</klant_adres>
 <klant_postcode>2312TT</klant_postcode>
 <klant_plaats>Leiden</klant_plaats>
</factuur>";

// CURL starten
$ch = curl_init();

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

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

?>

Factuur bijwerken

Let op: deze actie kan slechts op één factuur per keer uitgevoerd worden!

XML-structuur

<factuur>
 <id>9595</id>
 <klant_id>74333</klant_id>
 
 <factuurnummer_voorloop>2010</factuurnummer_voorloop>
 <factuurnummer>1111</factuurnummer>
 <factuurdatum>2004-02-06</factuurdatum>
 
 <factuurregel>
  <id>319</id>
  <aantal>1.00</aantal>
  <omschrijving>Domeinnaam aangepast</omschrijving>
  <prijs>40.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
 
 <factuurregel>
  <id>320</id>
  <aantal>1.00</aantal>
  <omschrijving>Hosting aangepast</omschrijving>
  <prijs>150.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
</factuur>

Voorbeeld PHP-script

<?php

// url naar waar de xml gepost moet worden
$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/factuur_updaten";

$xml = "
<factuur>
 <id>9595</id>
 <klant_id>74333</klant_id>
 
 <factuurnummer_voorloop>2010</factuurnummer_voorloop>
 <factuurnummer>1111</factuurnummer>
 <factuurdatum>2004-02-06</factuurdatum>

 <factuurregel>
  <id>319</id>
  <aantal>1.00</aantal>
  <omschrijving>Domeinnaam aangepast</omschrijving>
  <prijs>40.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
 
 <factuurregel>
  <id>320</id>
  <aantal>1.00</aantal>
  <omschrijving>Hosting aangepast</omschrijving>
  <prijs>150.000</prijs>
  <btw>0.190</btw>
 </factuurregel>
</factuur>";

// CURL starten
$ch = curl_init();

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"xml=" . $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

Let op: deze actie kan slechts op één factuur per keer uitgevoerd worden!

Voorbeeld PHP-script

<?php

// url naar waar de xml gepost moet worden
$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/factuur_verwijderen&facturen_id=1234";

// CURL instellen
$ch = curl_init();
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 ophalen

Deze actie kan zowel op één factuur als op meerdere facturen uitgevoerd worden, tot een limiet van 50.

U kunt de volgende aanvullende parameters in de URL plaatsen:

facturen_id - alleen cijfers
betaalstatus - betaald of openstaand
factuurnummer - alleen cijfers

Voorbeeld PHP-script

<?php

$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/facturen";

// curl instellen
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);

// curl en resultaat opvangen in $xml
$xml = curl_exec($ch);
curl_close($ch);

// controleren of een fout is opgetreden (begint altijd met een driecijferige foutcode)
if(is_numeric(substr($xml, 0, 3)))
{
	die("<b>Foutmelding van DigitaleFactuur</b>:<br />" . $xml);
}

if(!empty($xml))
{
	// de xml inlezen in een XML object van PHP
	$xml_obj = new SimpleXMLElement($xml);
	
	// door alle facturen heen loopen
	for($i = 0; $i < count($xml_obj->factuur); $i++)
	{
		// huidige factuur
		$factuur = $xml_obj->factuur[$i];
		
		// factuurgegevens op het scherm tonen
		echo
			$factuur->id . "<br />" . 
			$factuur->extern_id . "<br />" . 
			$factuur->klant_id . "<br />" . 
			$factuur->klant_naam . "<br />" . 
			$factuur->contactpersoon_id . "<br />" . 
			$factuur->contactpersoon_naam . "<br />" . 
			$factuur->sjabloon_id . "<br />" . 
			$factuur->btw_verlegd . "<br />" . 
			$factuur->credit_factuur . "<br />" . 
			$factuur->totaalprijs_exclusief_btw . "<br />" . 
			$factuur->totaal_btw . "<br />" . 
			$factuur->totaalprijs_exclusief_btw . "<br />" .
			$factuur->referentie . "<br />" .
			$factuur->offerte_id . "<br />" .
			$factuur->betaalstatus . "<br />" .
			$factuur->factuurnummer_voorloop . "<br />" .
			$factuur->factuurnummer . "<br />" .
			$factuur->opmerking . "<br />" .
			$factuur->opmerking_op_factuur . "<br />" . 
			$factuur->automatische_incasso . "<br />" .
			$factuur->factuurdatum . "<br />" .
			$factuur->vervaldatum . "<br />" .
			$factuur->automatisch_herinnering . "<br />" .
			$factuur->hoogste_type_verstuurd . "<br /><br />";
		
		echo "Factuurregels:<br />";
		
		foreach($xml_obj->factuur[$i]->factuurregel as $factuurregel)
		{
			echo 
				"    " . $factuurregel->aantal . " " . $factuurregel->omschrijving . " " . $factuurregel->prijs . " " . $factuurregel->btw . "<br />";
		}
		
		echo "<br />---------------------------------------<br /><br />";
	}
}

?>

Factuur downloaden

Let op: deze actie kan slechts op één factuur per keer uitgevoerd worden!

Voorbeeld PHP-script

<?php

// url om de facturen op te halen
$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/factuur_download&facturen_id=123";

// CURL starten
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);

// curlen en resultaat opvangen
$pdf_string = curl_exec($ch);
curl_close($ch);

// controleren of een fout is opgetreden (begint altijd met een driecijferige foutcode)
if(is_numeric(substr($pdf_string, 0, 3)))
{
	die("<b>Foutmelding van DigitaleFactuur</b>:<br />" . $pdf_string);
}

// u kunt de factuur vervolgens in een bestand wegschrijven (door de comments weg te halen uit de volgende code)
/*
$handle = fopen("test.pdf", "w+");
fwrite($handle, $pdf_string);
fclose($handle);
*/

// verstuur PDF naar scherm
header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename=factuur.pdf; ');
header("Cache-Control: public");
header("Pragma: public");
echo $pdf_string;
exit();

?>

Overige documentatie: Algemene API info Klanten API

Contact

Heeft u vragen? Wij helpen u graag! Neem contact op via support@digitalefactuur.nl
Copyright © DigitaleFactuur

Haagweg 4 G5
2311 AA Leiden

telefoon 071 5138985
email info@digitalefactuur.nl
kvk 28087176

Social Media

Mogelijkheiden

Abonnementenbeheer

Overzicht

Facturen

Offertes

Projecten

Huisstijl

Abonnementen

Support

Online Factureren

De API gebruiken bij het importeren en exporteren van uw facturen

Facturen API

Factuur aanmaken

Factuur betaling

Factuur versturen

Factuur bijwerken

Factuur verwijderen

Facturen ophalen

Factuur downloaden

Contact

Handig

Support

Achtergronden

Mogelijkheiden

Facturen

Offertes

Huisstijl

Projecten

Abonnementenbeheer