Online Factureren

Voorbeelden van het importeren en exporteren van uw klanten

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.

Klanten API

Met de API van DigitaleFactuur beheert u gemakkelijk uw klanten. 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
Klanten aanmaken	/klant_aanmaken	POST	Import
Klanten bijwerken	/klant_bijwerken	POST	Import
Klanten verwijderen	/klant_verwijderen	POST	Import
Klanten ophalen	/klant_ophalen	POST	Import

Klant aanmaken

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

XML-structuur

<klant>
 <id>5</id>
 <relatienummer>0123456789</relatienummer>
 <type>debiteur</type>
 <naam>API TEST</naam>
 <contactpersoon_naam>Piet klaas jan</contactpersoon_naam>
 <contactpersoon_afdeling>AFDELING TEST</contactpersoon_afdeling>
 <contactpersoon_email>apitest@nexa.nl</contactpersoon_email>
 <adres>API test 11</adres>
 <postcode>1234 AP</postcode>
 <plaats>Alluphen API TEst</plaats>
 <rekeningnummer>242124214</rekeningnummer>
 <tenaamstelling>Api's Test</tenaamstelling>
</klant>

Voorbeeld PHP-script

<?php

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

// xml voorbeeld
$xml = "
<klant>
 <id>5</id>
 <relatienummer>0123456789</relatienummer>
 <type>debiteur</type>
 <naam>API TEST</naam>
 <contactpersoon_naam>Piet klaas jan</contactpersoon_naam>
 <contactpersoon_afdeling>AFDELING TEST</contactpersoon_afdeling>
 <contactpersoon_email>apitest@nexa.nl</contactpersoon_email>
 <adres>API test 11</adres>
 <postcode>1234 AP</postcode>
 <plaats>Alluphen API TEst</plaats>
 <rekeningnummer>242124214</rekeningnummer>
 <tenaamstelling>Api's Test</tenaamstelling>
</klant>
";

// 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;
exit();

?>

Klant bijwerken

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

XML-structuur

<klant>
 <id>74333</id>
 <relatienummer>0123456789</relatienummer>
 <type>debiteur</type>
 <naam>API TEST aangepast</naam>
 <contactpersoon_naam>Piet klaas jan</contactpersoon_naam>
 <contactpersoon_afdeling>AFDELING TEST</contactpersoon_afdeling>
 <contactpersoon_email>apitest@nexa.nl</contactpersoon_email>
 <adres>API test 11</adres>
 <postcode>1234 AP</postcode>
 <plaats>Alluphen API TEst</plaats>
 <rekeningnummer>242124214</rekeningnummer>
 <tenaamstelling>Api's Test</tenaamstelling>
</klant>

Voorbeeld PHP-script

<?php

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

// klant update
$xml = "
<klant>
 <id>74333</id>
 <relatienummer>0123456789</relatienummer>
 <type>debiteur</type>
 <naam>API TEST aangepast</naam>
 <contactpersoon_naam>Piet klaas jan</contactpersoon_naam>
 <contactpersoon_afdeling>AFDELING TEST</contactpersoon_afdeling>
 <contactpersoon_email>apitest@nexa.nl</contactpersoon_email>
 <adres>API test 11</adres>
 <postcode>1234 AP</postcode>
 <plaats>Alluphen API TEst</plaats>
 <rekeningnummer>242124214</rekeningnummer>
 <tenaamstelling>Api's Test</tenaamstelling>
</klant>
";

// 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();

?>

Klant verwijderen

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

Voorbeeld PHP-script

<?php

// accounts_id, wachtwoord en actie invullen
$accounts_id = 1;
$password = "wachtwoord";
$action = "klant_verwijderen";

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

$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();

?>

Klantenlijst ophalen

De standaardactie is alle klanten ophalen tot een limiet van 50. U kunt ervoor kiezen slechts één klant op te halen. Hiervoor geeft u de klant-id, de email van de klant of het relatienummer van de klant mee in de url (zie het PHP voorbeeld).

Let op: deze actie kan slechts op één klant 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>/klanten";

/* eventuele parameters
  	specifieke klant ophalen (klanten_id)
	$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/klanten&klanten_id=1234";

	specifieke klant ophalen (email)
	$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/klanten&email=info@digitalefactuur.nl";

	specifieke klant ophalen (relatienummer)
	$url = "http://www.digitalefactuur.nl/api/<accounts_id>/<password>/klanten&relatienummer=123456789";
*/

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

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

// controleren of een fout is opgetreden (begint altijd met een 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 klanten heen loopen
	for($i = 0; $i < count($xml_obj->klant); $i++)
	{
		// huidige klant
		$klant = $xml_obj->klant[$i];
	
		// klant tonen
		echo
			$klant->id . "<br />" .  
		    $klant->relatienummer  . "<br />" . 
		    $klant->btw_nummer  . "<br />" . 
		    $klant->type  . "<br />" . 
		    $klant->naam  . "<br />" . 
		    $klant->contactpersoon_naam  . "<br />" . 
		    $klant->contactpersoon_afdeling  . "<br />" . 
		    $klant->contactpersoon_email  . "<br />" . 
		    $klant->adres . "<br />" . 
		    $klant->postcode . "<br />" . 
		    $klant->plaats . "<br />" . 
		    $klant->telefoonnummer . "<br />" . 
		    $klant->faxnummer . "<br />" . 
		    $klant->land . "<br />" . 
		    $klant->rekeningnummer . "<br />" . 
		    $klant->tenaamstelling  . "<br />-------<br /><br />";
	}
}

?>

Overige documentatie: Algemene API info Facturen 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

Voorbeelden van het importeren en exporteren van uw klanten

Klanten API

Klant aanmaken

XML-structuur

Voorbeeld PHP-script

Klant bijwerken

XML-structuur

Voorbeeld PHP-script

Klant verwijderen

Voorbeeld PHP-script

Klantenlijst ophalen

Voorbeeld PHP-script

Contact

Handig

Support

Achtergronden

Mogelijkheiden

Facturen

Offertes

Huisstijl

Projecten

Abonnementenbeheer