Online Factureren
De mogelijkheden en documentatie van de DigitaleFactuur-API.
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.
De DigitaleFactuur API
Met de API van DigitaleFactuur kunt u een koppeling maken tussen uw eigen programma's en uw DigitaleFactuur-account. Met behulp van uw toegangscode en simpele PHP-code importeert u nu uw gegevens in uw account. DigitaleFactuur helpt u bij het invoeren van de gegevens. Hieronder vindt u alle informatie die u nodig heeft bij het gebruiken van de API.
Toegang tot de API
De API is beveiligd met een inlogcode en een wachtwoord. Deze verschillen per gebruiker. Om toegang te krijgen tot de API, kunt u een email sturen naar info@digitalefactuur.nl. Wij maken een code voor u aan en sturen deze per mail naar u op.
Communiceren met de API
Om te communiceren met de API kunt u gebruik maken van de PHP-methode Client URL Library (CURL). U voorziet CURL van een URL en de benodigde gegevens (bij een import stuurt u de gegevens in XML-formaat mee). In die URL staan uw gebruikersnaam, uw wachtwoord en de actie die u wilt uitvoeren. CURL maakt verbinding met DigitaleFactuur en afhankelijk van de actie die u in de URL hebt meegegeven, krijgt u het gewenste resultaat terug.
Het resultaat van CURL
Het resultaat van CURL hangt af van de actie en van het succes van de actie. Na het succesvol invoeren van gegevens in DigitaleFactuur krijgt u een resultaat code terug. Na het succesvol ophalen van gegevens krijgt u de gegevens in XML-formaat terug. En wanneer er een fout opgetreden is, krijgt u een resultaat code terug.
Resultaat codes
Na het uitvoeren van een actie, geeft CURL het resultaaat van die actie terug. Bij een succesvolle import-actie, krijgt u een resultaat code terug. Bij een succesvolle export-actie, krijgt u de gegevens in XML-formaat terug. En wanneer er een fout optreeft, krijgt u een resultaat code terug waarin de fout staat. In de tabel hieronder vindt u de mogelijke resultaat codes met een beschrijving. Hoe de XML-bestanden eruit zien, kunt u lezen bij de uitleg van de verschillende acties.
| Code | Beschrijving |
|---|---|
| 200 succes | Uw actie is met succes uitgevoerd. |
| 400 account niet gevonden | Kon de opgegeven account niet vinden, mogelijk omdat u niet ingelogd bent op de API van DigitaleFactuur. |
| 401 ongeldige XML | Er is geen geldige XML meegegeven; de XML kon niet ingelezen worden door DigitaleFactuur. |
| 402 ongeldige XML | Er zijn geen geldige waarden meegegeven in de XML. |
| 403 ongeldige actie | Er is een foute actie meegegeven in de url of de actie ontbreekt. |
| 404 ongeldige id | De meegegeven id bestaat niet of hoort niet bij uw account. |
| 401 Ongeldige XML | Er is geen geldige XML meegegeven; de XML kon niet ingelezen worden door DigitaleFactuur. |
| 401 Ongeldige XML | Er is geen geldige XML meegegeven; de XML kon niet ingelezen worden door DigitaleFactuur. |
Voorbeeld PHP scripts
Stuur een mail naar support@digitalefactuur.nl en vraag naar onze PHP-scripts!
Overige documentatie: Factuur API 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
