{"id":2315,"date":"2019-05-15T09:22:06","date_gmt":"2019-05-15T08:22:06","guid":{"rendered":"https:\/\/eenvoudigfactureren.be\/info\/?page_id=2315"},"modified":"2019-08-26T15:33:29","modified_gmt":"2019-08-26T14:33:29","slug":"coda","status":"publish","type":"page","link":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/","title":{"rendered":"CODA-bestanden importeren via API"},"content":{"rendered":"<p><!-- .container --><\/p>\n<div class=\"wrap-container60 border-bottom reading-text\">\n<div class=\"container\">\n<h4>EenvoudigFactureren API CODA-bestanden<\/h4>\n<p>CODA-bestanden kunnen via de website worden ge\u00efmporteerd en gekoppeld aan openstaande facturen. Via de API kunt u deze CODA-bestanden ook geautomatiseerd inlezen en koppelen.<\/p>\n<p>Op deze pagina krijgt u een overzicht van alle technische details van de CODA-API.<\/p>\n<\/p><\/div>\n<\/div>\n<div class=\"wrap-container60 border-bottom reading-text\">\n<div class=\"container\">\n<h4>Toegang<\/h4>\n<p>De API maakt gebruikt van REST met basic authentication. U dient dus steeds uw e-mailadres en wachtwoord op EenvoudigFactureren in te geven om toegang tot de API te hebben.<\/p>\n<p>U stuurt de inhoud van een CODA-bestand door naar de API en deze zal automatisch een koppeling met openstaande facturen maken.<\/p>\n<p>Het is aan te raden om een afzonderlijke gebruiker aan uw account toe te voegen die enkel bij API-toegang wordt gebruikt. Zo heeft u geen nood aan de credentials van de normale gebruikers.<\/p>\n<p>Indien een gebruiker toegang heeft tot verschillende accounts kunt u de gewenste account doorgeven in de header via &#8220;X-AccountId&#8221;. Het account-nummer (AccountId) van een account kunt u opvragen langs &#8220;Account&#8221; (menu rechtsboven). Wordt er geen account-nummer opgegeven dan wordt de standaard account van de gebruiker gebruikt (in te stellen langs &#8220;Gebruiker&#8221; (menu rechtsboven).<\/p>\n<\/p><\/div>\n<\/div>\n<div class=\"wrap-container60 border-bottom reading-text\">\n<div class=\"container\">\n<h4>CODA-bestand doorsturen<\/h4>\n<p>Een CODA-bestand is een verzameling van \u00e9\u00e9n of meerdere bankverrichtingen. Deze hebben een vast formaat waarbij elke lijn in het bestand exact 128 karakters lang is.<\/p>\n<p>Om een CODA-bestand te importeren stuurt u de inhoud van het CODA-bestand in de body van een POST-method door naar de URL: <a>https:\/\/eenvoudigfactureren.be\/coda\/import<\/a>.<\/p>\n<\/p><\/div>\n<\/div>\n<div class=\"wrap-container60 border-bottom reading-text\">\n<div class=\"container\">\n<h4>Resultaat<\/h4>\n<p>Volgende resultcodes kunnen worden teruggegeven<\/p>\n<ul>\n<li>200: Actie verwerkt<\/li>\n<li>400: Geen toegang<\/li>\n<li>401: Authenticatie gebruiker niet aanvaard<\/li>\n<li>500: Interne fout<\/li>\n<\/ul>\n<p>Als resultaat worden de ingelezen bankverrichtingen en hun koppeling in JSON-formaat teruggegeven<\/p>\n<p>Een voorbeeld:<\/p>\n<blockquote><p>\n{<br \/>\n&nbsp;&nbsp;&#8220;transactions_count&#8221;: 1,<br \/>\n&nbsp;&nbsp;&#8220;transactions_success_count&#8221;: 1,<br \/>\n&nbsp;&nbsp;&#8220;transactions_with_error_count&#8221;: 0,<br \/>\n&nbsp;&nbsp;&#8220;transactions&#8221;: [<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;{<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;account&#8221;: {<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;name&#8221;: &#8220;BVBA.BAKKER PIET&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;number&#8221;: &#8220;BE54805480215856&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;bic&#8221;: &#8220;GEBCEEBB&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;country&#8221;: &#8220;&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;currency&#8221;: &#8220;EUR&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8220;summary&#8221;: &#8220;BVBA.BAKKER PIET (BE54805480215856)&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;},<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;transaction_date&#8221;: &#8220;2014-12-25&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;valuta_date&#8221;: &#8220;2014-12-25&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;message&#8221;: &#8220;618\/1416\/12542   813  ANOTHER MESSAGE  MESSAGE&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;amount&#8221;: 1767.82,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;amount_negative&#8221;: false,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;structured_message&#8221;: &#8220;&#8221;,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;transaction_index&#8221;: 1,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;document_id&#8221;: 359403,<br \/>\n&nbsp;&nbsp;&nbsp;&nbsp;&#8220;payment_id&#8221;: &#8220;263566&#8221;<br \/>\n&nbsp;&nbsp;}]<br \/>\n}\n<\/p><\/blockquote>\n<p>Loopt de verwerking verkeerd door een blokkerende fout (bvb. foutieve inhoud) dan wordt in het veld &#8220;error&#8221; de reden teruggegeven. (Opmerking: De resultcode is in deze situatie nog steeds 200).<\/p>\n<blockquote><p>\n{<br \/>\n&nbsp;&nbsp;&#8220;error&#8221;: &#8220;no content found&#8221;<br \/>\n}\n<\/p><\/blockquote><\/div>\n<\/div>\n<div class=\"wrap-container60 border-bottom reading-text\">\n<div class=\"container\">\n<h4>Voorbeeld (PHP)<\/h4>\n<pre class=\"brush: php; title: ; notranslate\" title=\"\">$email = 'luc@mymail.com';\r\n$password = '123456';\r\n\r\n$codaContent = file_get_contents('my_coda_file.txt');\r\n\r\n$p = curl_init('https:\/\/eenvoudigfactureren.be\/coda\/import');\r\ncurl_setopt($p, CURLOPT_HTTPHEADER, &#x5B;'Accept: application\/json']);\r\ncurl_setopt($p, CURLOPT_USERPWD, $email . ':' . $password);\r\ncurl_setopt($p, CURLOPT_POSTFIELDS, $codaContent);\r\ncurl_setopt($p, CURLOPT_RETURNTRANSFER, TRUE);\r\n$result = json_decode(curl_exec($p));\r\n<\/pre>\n<\/p><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>EenvoudigFactureren API CODA-bestanden CODA-bestanden kunnen via de website worden ge\u00efmporteerd en gekoppeld aan openstaande facturen. Via de API kunt u deze CODA-bestanden ook geautomatiseerd inlezen en koppelen. Op deze pagina krijgt u een overzicht van alle technische details van de CODA-API. Toegang De API maakt gebruikt van REST met basic authentication. U dient dus steeds &hellip; <a href=\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/\" class=\"more-link\">Lees verder<span class=\"screen-reader-text\"> &#8220;CODA-bestanden importeren via API&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":41,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"footnotes":""},"class_list":["post-2315","page","type-page","status-publish","hentry","wpautop"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.1.1 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>CODA-bestanden importeren via API<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/\" \/>\n<meta property=\"og:locale\" content=\"nl_BE\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CODA-bestanden importeren via API\" \/>\n<meta property=\"og:description\" content=\"EenvoudigFactureren API CODA-bestanden CODA-bestanden kunnen via de website worden ge\u00efmporteerd en gekoppeld aan openstaande facturen. Via de API kunt u deze CODA-bestanden ook geautomatiseerd inlezen en koppelen. Op deze pagina krijgt u een overzicht van alle technische details van de CODA-API. Toegang De API maakt gebruikt van REST met basic authentication. U dient dus steeds &hellip; Lees verder &quot;CODA-bestanden importeren via API&quot;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/\" \/>\n<meta property=\"og:site_name\" content=\"EenvoudigFactureren\" \/>\n<meta property=\"article:modified_time\" content=\"2019-08-26T14:33:29+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/eenvoudigfactureren.be\/info\/wp-content\/uploads\/2021\/09\/Logo-EenvoudigFactureren.png\" \/>\n\t<meta property=\"og:image:width\" content=\"500\" \/>\n\t<meta property=\"og:image:height\" content=\"222\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Geschatte leestijd\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minuten\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/\",\"url\":\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/\",\"name\":\"CODA-bestanden importeren via API\",\"isPartOf\":{\"@id\":\"https:\/\/eenvoudigfactureren.be\/info\/#website\"},\"datePublished\":\"2019-05-15T08:22:06+00:00\",\"dateModified\":\"2019-08-26T14:33:29+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/#breadcrumb\"},\"inLanguage\":\"nl-BE\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/eenvoudigfactureren.be\/info\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Help\",\"item\":\"https:\/\/eenvoudigfactureren.be\/info\/help\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"API\",\"item\":\"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"CODA-bestanden importeren via API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/eenvoudigfactureren.be\/info\/#website\",\"url\":\"https:\/\/eenvoudigfactureren.be\/info\/\",\"name\":\"EenvoudigFactureren\",\"description\":\"Online facturatie\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/eenvoudigfactureren.be\/info\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"nl-BE\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"CODA-bestanden importeren via API","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/","og_locale":"nl_BE","og_type":"article","og_title":"CODA-bestanden importeren via API","og_description":"EenvoudigFactureren API CODA-bestanden CODA-bestanden kunnen via de website worden ge\u00efmporteerd en gekoppeld aan openstaande facturen. Via de API kunt u deze CODA-bestanden ook geautomatiseerd inlezen en koppelen. Op deze pagina krijgt u een overzicht van alle technische details van de CODA-API. Toegang De API maakt gebruikt van REST met basic authentication. U dient dus steeds &hellip; Lees verder \"CODA-bestanden importeren via API\"","og_url":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/","og_site_name":"EenvoudigFactureren","article_modified_time":"2019-08-26T14:33:29+00:00","og_image":[{"width":500,"height":222,"url":"https:\/\/eenvoudigfactureren.be\/info\/wp-content\/uploads\/2021\/09\/Logo-EenvoudigFactureren.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Geschatte leestijd":"3 minuten"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/","url":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/","name":"CODA-bestanden importeren via API","isPartOf":{"@id":"https:\/\/eenvoudigfactureren.be\/info\/#website"},"datePublished":"2019-05-15T08:22:06+00:00","dateModified":"2019-08-26T14:33:29+00:00","breadcrumb":{"@id":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/#breadcrumb"},"inLanguage":"nl-BE","potentialAction":[{"@type":"ReadAction","target":["https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/coda\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/eenvoudigfactureren.be\/info\/"},{"@type":"ListItem","position":2,"name":"Help","item":"https:\/\/eenvoudigfactureren.be\/info\/help\/"},{"@type":"ListItem","position":3,"name":"API","item":"https:\/\/eenvoudigfactureren.be\/info\/help\/api\/"},{"@type":"ListItem","position":4,"name":"CODA-bestanden importeren via API"}]},{"@type":"WebSite","@id":"https:\/\/eenvoudigfactureren.be\/info\/#website","url":"https:\/\/eenvoudigfactureren.be\/info\/","name":"EenvoudigFactureren","description":"Online facturatie","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/eenvoudigfactureren.be\/info\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"nl-BE"}]}},"_links":{"self":[{"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/pages\/2315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/comments?post=2315"}],"version-history":[{"count":19,"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/pages\/2315\/revisions"}],"predecessor-version":[{"id":2612,"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/pages\/2315\/revisions\/2612"}],"up":[{"embeddable":true,"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/pages\/41"}],"wp:attachment":[{"href":"https:\/\/eenvoudigfactureren.be\/info\/wp-json\/wp\/v2\/media?parent=2315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}