{"id":3509,"date":"2021-11-23T11:42:05","date_gmt":"2021-11-23T10:42:05","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=3509"},"modified":"2025-12-29T10:54:11","modified_gmt":"2025-12-29T09:54:11","slug":"add-invoice-for-transport-document-to-an-order","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/orders\/order-attachments\/add-invoice-for-transport-document-to-an-order\/","title":{"rendered":"Add invoice for transport document to an order"},"content":{"rendered":"\n<p>This method allows to add invoice scan with basic invoice data to an exist\u00ading order. Method avail\u00adable for car\u00adri\u00aders and for\u00adwarders in car\u00adri\u00ader role. Invoice file must be <a href=\"https:\/\/www.trans.eu\/api\/attachments\/uploading-and-downloading-attachments\/\">uploaded<\/a> first.<\/p>\n\n\n\n<!--more-->\n\n\n\n<h2 class=\"wp-block-heading\">Url parameters and connection settings<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>URL:<\/strong>&nbsp;https:\/\/api.platform.trans.eu<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ext\/orders-api\/v1\/orders\/{order-Id}\/invoice<\/li>\n\n\n\n<li><strong>Method:<\/strong>&nbsp;POST<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Headers<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Con\u00adtent-type: application\/json<\/li>\n\n\n\n<li>Accept: application\/json<\/li>\n\n\n\n<li>Autho\u00adriza\u00adtion: Bear\u00ader {access_token}<\/li>\n\n\n\n<li>Api-key: {unique_ap\u00adp_api-key}<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Authorization and access<\/h2>\n\n\n\n<p>Autho\u00adriza\u00adtion process&nbsp;<a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>is described here<\/a>.&nbsp; Each API request must also con\u00adsist of unique Api-key obtained dur\u00ading appli\u00adca\u00adtion reg\u00adis\u00adtra\u00adtion togeth\u00ader with client_id and client_secret.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Structure of adding an invoice<\/h2>\n\n\n\n<figure class=\"wp-block-table has-small-font-size\"><table><tbody><tr><td><strong>Json<\/strong><\/td><td><strong>Exam\u00adple<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Is required<\/strong><\/td><td><strong>Descrip\u00adtion<\/strong><\/td><\/tr><tr><td>invoice_data<\/td><td>Object<\/td><td><\/td><td>Yes<\/td><td>Invoice data<\/td><\/tr><tr><td>invoice_number<\/td><td>13\/12\/1234<\/td><td>String<\/td><td>Yes<\/td><td>Invoice num\u00adber<\/td><\/tr><tr><td>invoice_issuance_date<\/td><td>2021-12-13<\/td><td>String<\/td><td>Yes<\/td><td>Invoice issuance date<\/td><\/tr><tr><td>sales_date<\/td><td>2021-12-13<\/td><td>String<\/td><td>Yes<\/td><td>Sales date<\/td><\/tr><tr><td>net_value<\/td><td>1230<\/td><td>Float<\/td><td>Yes<\/td><td>Net val\u00adue<\/td><\/tr><tr><td>cur\u00adren\u00adcy<\/td><td>PLN<\/td><td>String<\/td><td>Yes<\/td><td><a href=\"https:\/\/www.trans.eu\/api\/general-information\/allowed-values\/\">Cur\u00adren\u00adcy<\/a><\/td><\/tr><tr><td>payment_due_date<\/td><td>2021-12-20<\/td><td>String<\/td><td>Yes<\/td><td>Pay\u00adment term (date)<\/td><\/tr><tr><td>payment_offset_days<\/td><td>7<\/td><td>Int<\/td><td>Yes<\/td><td>Pay\u00adment term (days)<\/td><\/tr><tr><td>gross_value<\/td><td>1512.90<\/td><td>Float<\/td><td>No<\/td><td>Gross val\u00adue<\/td><\/tr><tr><td>tax_value<\/td><td>23<\/td><td>Int<\/td><td>No<\/td><td>Vat type (must be one of fol\u00adlow\u00ading \u2014 0,5,8,23)<\/td><\/tr><tr><td>media_name<\/td><td>Invoice<\/td><td>String<\/td><td>Yes<\/td><td>Attach\u00adment name<\/td><\/tr><tr><td>media_id<\/td><td>72d71c93-355b-4119\u20139c5d-2460f368297b,<\/td><td>String<\/td><td>Yes<\/td><td>Media id (returned after upload\u00ading a file)<\/td><\/tr><tr><td>visible_to_contractor<\/td><td>True<\/td><td>Boolean<\/td><td>Yes<\/td><td>Invoice vis\u00adi\u00adble to con\u00adtrac\u00adtor<\/td><\/tr><tr><td>descrip\u00adtion<\/td><td>Exam\u00adple descrip\u00adtion<\/td><td>String<\/td><td>Yes<\/td><td>File descrip\u00adtion<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Example Json<\/h2>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n  \"invoice_data\": {\n    \"invoice_number\": \"13\/12\/1234\",\n    \"invoice_issuance_date\": \"2021-12-13\",\n    \"sales_date\": \"2021-12-13\",\n    \"net_value\": 1230,\n    \"currency\": \"pln\",\n    \"payment_due_date\": \"2021-12-20\",\n    \"payment_offset_days\": 7,\n    \"gross_value\": 1512.9,\n    \"tax_value\": 23\n  },\n  \"media_name\": \"invoice\",\n  \"media_id\": \"72d71c93-355b-4119-9c5d-2460f368297b\",\n  \"visible_to_contractor\": true,\n  \"description\": \"Example description\"\n}<\/code><\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">This method allows to add invoice scan with basic invoice data to an exist\u00ading order. Method avail\u00adable for car\u00adri\u00aders and \u2026<\/p>\n","protected":false},"author":13,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[104],"tags":[],"class_list":["post-3509","post","type-post","status-publish","format-standard","hentry","category-order-attachments"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":3509},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/3509","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=3509"}],"version-history":[{"count":1,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/3509\/revisions"}],"predecessor-version":[{"id":5495,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/3509\/revisions\/5495"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=3509"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=3509"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=3509"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}