Qvalia

Qvalia Developer Tools

JSON/XML or JSON to XML

Attachments to messages

SFTP-Integration

Invoice APIs

Get incoming invoices

Post incoming invoice

Get incoming read invoices

Post outgoing invoice

Get outgoing invoices

Post outgoing invoices as batch

Credit Note APIs

Get incoming credit notes

Post incoming credit note

Get incoming read credit notes

Post outgoing credit note

Post outgoing credit notes as batch

Order APIs

Get incoming orders

Post incoming order

Get incoming read orders

Post outgoing order

Post outgoing orders as batch

Order Response APIs

Get incoming order responses

Post incoming order response

Get incoming read order responses

Post outgoing order response

Post outgoing order response as batch

Catalogue APIs

Get incoming catalogues

Post incoming catalogue

Get incoming read catalogues

Post outgoing catalogue

Post outgoing catalogue as batch

Account Functions

Invoice Functions

Sample Data

Operator

Qvalia API

Access APIs and technical requirements and get connected in no time!

Our APIs and onboarding team ensures a swift integration into your systems and processes. Qvalia integrates with major ERPs and accounting software.

 based and we use both JSON and XML request and response payloads. All message formats are based upon 

 and our JSON format is a representation of the XML called UBL JSON by OASIS Open group. We strive to use the REST standards for response codes and “verbs” (e.g. GET and POST).

The Qvalia API has two separate endpoints for our Production and a Test (Quality Assurance) environment.

You must obtain a Qvalia account prior to using (or testing) the API!

We use API keys for the Authentication of requests. You can get your API key from our Support team and you’ll get a separate key and URL for Production and Test environments. All requests are using HTTPS with a minimum of TLS 1.2

Parameters
Some of our API's has the possibility to provide parameters for e.g. filtering. These parameters are sent as a query string and the options are listed per endpoint under the technical API documentation.

We offer various error codes based upon the type of error, along with a descriptive error message (in JSON or XML). Like any other API codes in the range of 2xx is a successful request while a status of 4xx indicates an error that occurred because of the data sent or a parameter missing/in error. In the 5xx range indicate an error with our server/service and you should contact the Qvalia Support if you ever would end up getting any 5xx code as response.

You can always contact Qvalia Support through your Qvalia Sales representative or by using our Support e-mail (see your Qvalia Account for details).

We use Node.js inhouse, and JSON is our format of choice, however, as many ERP and Financial systems are using XML we have opted to add support for both formats in our API. You can freely swap between XML and JSON, just by using different headers:

Node.js sample code for calling the API for sending a JSON request could look like:

Invoice

JSON Sample 1

_declaration

XML Sample

<p class="slate-p" placeholder="Type / for widgets">We follow a standard API REST-ish interface on our endpoints and try to adhere to the standard/common return codes and behaviors of any standard API.</p><p class="slate-p" placeholder="Type / for widgets">We are using the UBL standard messaging formats for our integrations through the API, but you should note that we only use a subset of UBL as specified by Peppol (peppol.eu)</p><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">As many of Qvalia&apos;s services are compatible with Peppol the data validation is also done using the Peppol standards. For example the Invoice endpoint strictly follows BIS Billing 3.0, <a href="https://docs.peppol.eu/poacc/billing/3.0/" target="_blank">https://docs.peppol.eu/poacc/billing/3.0/</a></p><p class="slate-p" placeholder="Type / for widgets">This means that, although the JSON format is based upon UBL JSON we only allow the subset stated from <a href="https://docs.peppol.eu/poacc/billing/3.0/" target="_blank">https://docs.peppol.eu/poacc/billing/3.0/</a> for the Invoice and CreditNote message types, see the “Syntax” section!</p><p class="slate-p" placeholder="Type / for widgets">For Order and OrderResponse you&apos;ll find the documentation at: <a href="https://docs.peppol.eu/poacc/upgrade-3/" target="_blank">https://docs.peppol.eu/poacc/upgrade-3/</a></p></div></div><h3 class="slate-h3">
Authentication</h3><p class="slate-p" placeholder="Type / for widgets">We use API keys for the Authentication of requests. You can get your API key from our Support team and you’ll get a separate key and URL for Production and Test environments. All requests are using HTTPS with a minimum of TLS 1.2</p><p class="slate-p" placeholder="Type / for widgets">Each request made to the API will contain your <code class="slate-code">registration number</code> which is your account identifier for your Qvalia account. Your account identifier will be provided to you from the Support team during the onboarding process.</p><p class="slate-p" placeholder="Type / for widgets">Your requests must use the registration number as e.g. <code class="slate-code">POST /{registration_number}/invoices/outgoing</code></p><h3 class="slate-h3">
UBL JSON Representation standard</h3><p class="slate-p" placeholder="Type / for widgets">For the JSON representation of the format please refer to <a href="http://docs.oasis-open.org/ubl/UBL-2.1-JSON/v2.0/UBL-2.1-JSON-v2.0.html" target="_blank">http://docs.oasis-open.org/ubl/UBL-2.1-JSON/v2.0/UBL-2.1-JSON-v2.0.html</a></p><p class="slate-p" placeholder="Type / for widgets">UBL JSON samples and schemas can be found here: <a href="http://docs.oasis-open.org/ubl/UBL-2.1-JSON/v2.0/cnd01/" target="_blank">http://docs.oasis-open.org/ubl/UBL-2.1-JSON/v2.0/cnd01/</a></p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3">UBL XML Representation standard</h3><p class="slate-p" placeholder="Type / for widgets">
For the XML representation, <a href="https://docs.oasis-open.org/ubl/UBL-2.1.html" target="_blank">https://docs.oasis-open.org/ubl/UBL-2.1.html</a></p><p class="slate-p" placeholder="Type / for widgets">The UBL version 2.1 has been selected due to the many compliant standars with UBL 2.1, mainly the Peppol standard (peppol.eu).</p><p class="slate-p" placeholder="Type / for widgets">XML samples and XML schemas can be found here: <a href="http://docs.oasis-open.org/ubl/os-UBL-2.1/" target="_blank">http://docs.oasis-open.org/ubl/os-UBL-2.1/</a></p><h3 class="slate-h3">Required</h3><p class="slate-p" placeholder="Type / for widgets">As the UBL JSON schema is fairly big, we only list the <code class="slate-code">required</code> attributes in the sample request and response data. You can browse the complete <code class="slate-code">JSON schema</code> viewing the <code class="slate-code">UBL-Invoice-2.1</code>.</p><p class="slate-p" placeholder="Type / for widgets">Note the difference in objects below, only IssueDate is required, and thus IssueTime won&apos;t be listed in the sample request/responses:</p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3">Attachments</h3><p class="slate-p" placeholder="Type / for widgets">
Often our customers wants to add, or request, attached documents to their messages, e.g. their invoices.</p><p class="slate-p" placeholder="Type / for widgets">We support all the same attachments as Peppol does: Peppol media types</p><p class="slate-p" placeholder="Type / for widgets">See more under Attachments to messages</p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3">SFTP Integration</h3><p class="slate-p" placeholder="Type / for widgets">
Qvalia is also offering integration through SFTP. If you have opted for the SFTP integration please read more here: SFTP Integration</p><p class="slate-p" placeholder="Type / for widgets"></p>

We follow a standard API REST-ish interface on our endpoints and try to adhere to the standard/common return codes and behaviors of any standard API.

We are using the UBL standard messaging formats for our integrations through the API, but you should note that we only use a subset of UBL as specified by Peppol (peppol.eu)

Each request made to the API will contain your 

 which is your account identifier for your Qvalia account. Your account identifier will be provided to you from the Support team during the onboarding process.

Your requests must use the registration number as e.g. 

POST /{registration_number}/invoices/outgoing

For the JSON representation of the format please refer to 

UBL JSON samples and schemas can be found here: 

The UBL version 2.1 has been selected due to the many compliant standars with UBL 2.1, mainly the Peppol standard (peppol.eu).

XML samples and XML schemas can be found here: 

As the UBL JSON schema is fairly big, we only list the 

 attributes in the sample request and response data. You can browse the complete 

Note the difference in objects below, only IssueDate is required, and thus IssueTime won't be listed in the sample request/responses:


Often our customers wants to add, or request, attached documents to their messages, e.g. their invoices.

We support all the same attachments as Peppol does: Peppol media types


Qvalia is also offering integration through SFTP. If you have opted for the SFTP integration please read more here: SFTP Integration

200 - OK

Everything worked as expected, but we didn't find any data to return

204 - No content

400 - Invalid request

401 - Unauthorized

The API key doesn't have permissions to perform the request.

403 - Forbidden

The requested resource does not exist. This can be either the URI, or query parameters.

404 - Not Found

The request cause some conflict, normally a duplicate

409 - Conflict

The posted data is invalid, in the wrong format or missing

422 - Unprocessable Entity

Internal Server Error (It's not you, it's us)

500 - Internal error

<p class="slate-p" placeholder="Type / for widgets">As we support both the Peppol UBL and XML standards you can freely choose between then, and even mix them, with creating a message as XML but fetching it using JSON, or the other way round.</p><p class="slate-p" placeholder="Type / for widgets">The response, in JSON, will always include the three latest messages, per default. Using XML you always only get one (as there&apos;s no &quot;array&quot; function for XML).</p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3">Transformation between JSON and XML</h3><p class="slate-p" placeholder="Type / for widgets">
Our API is developed closely to the UBL and Peppol specifications why we&apos;ve opted to include both the <code class="slate-code">XML</code> and <code class="slate-code">JSON</code> representations of the formats.</p><p class="slate-p" placeholder="Type / for widgets">The two representations are &quot;interchangeble&quot; through a transform but if you are a &quot;Node.js&quot; shop you should opt for the <code class="slate-code">JSON</code> format. Other programming languages might have an easier time to work with XML instead.</p><p class="slate-p" placeholder="Type / for widgets">There is a limitation in XML as there is no <code class="slate-code">batch</code> function for XML, meaning the <code class="slate-code">XML</code> format only supports one invoice per request!</p><p class="slate-p" placeholder="Type / for widgets">Using the <code class="slate-code">npm</code> module xml2js you can transform between <code class="slate-code">JSON</code> and <code class="slate-code">XML</code> as the format is bi-directional.</p><p class="slate-p" placeholder="Type / for widgets"></p><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-3-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-javascript keep-markup drop-tokens"><div class="slate-code_line">const xml2js = require(&apos;xml2js&apos;);</div><div class="slate-code_line">// Convert from JSON -&gt;&gt; XML
</div><div class="slate-code_line">const convertUblJsonToUblXml = async (json) =&gt; {</div><div class="slate-code_line">  const builder = new xml2js.Builder();</div><div class="slate-code_line">  return builder.buildObject(json);</div><div class="slate-code_line">};</div><div class="slate-code_line">// Convert from XML (string) -&gt;&gt; JSON
</div><div class="slate-code_line">const convertUblXmlToUblJson = async (xmlString) =&gt; {</div><div class="slate-code_line">  const parser = new xml2js.Parser({ explicitArray: true, explicitCharkey: true });</div><div class="slate-code_line">  return parser.parseStringPromise(xmlString);</div><div class="slate-code_line">};</div></code></pre><h2 class="slate-h2">Limit</h2><p class="slate-p" placeholder="Type / for widgets">The XML has no “envelope” so we only ever return one message, meaning the <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">limit</code></span> parameter is set to <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">1</code></span>. Using JSON you can set any limit you like, but the response size is limited to 6 MB.</p><p class="slate-p" placeholder="Type / for widgets">For JSON, we return the <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">integrationId</code></span> as part of the message, while with XML you&apos;ll find it as a returned HTTP header named <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">integrationId</code></span>. When you do a <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">POST</code></span> (creating something) we return the message about the message created along with the <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">integrationId</code></span>.</p><p class="slate-p" placeholder="Type / for widgets">The <span style="color:var(--dark-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--dark-text-content-color);font-size:12px" class="slate-code">integrationId</code></span> is the unique identifier for the message in our database and you can store that as an external permanent link to the message with us.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

As we support both the Peppol UBL and XML standards you can freely choose between then, and even mix them, with creating a message as XML but fetching it using JSON, or the other way round.

The response, in JSON, will always include the three latest messages, per default. Using XML you always only get one (as there's no "array" function for XML).


Our API is developed closely to the UBL and Peppol specifications why we've opted to include both the 

The two representations are "interchangeble" through a transform but if you are a "Node.js" shop you should opt for the 

 format. Other programming languages might have an easier time to work with XML instead.

There is a limitation in XML as there is no 

 format only supports one invoice per request!

 module xml2js you can transform between 

The XML has no “envelope” so we only ever return one message, meaning the 

. Using JSON you can set any limit you like, but the response size is limited to 6 MB.

 as part of the message, while with XML you'll find it as a returned HTTP header named 

 (creating something) we return the message about the message created along with the 

 is the unique identifier for the message in our database and you can store that as an external permanent link to the message with us.

<p class="slate-p" placeholder="Type / for widgets">Often our customers wants to add, or request, attached documents to their messages, e.g. their invoices.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets">We support all the same attachments as Peppol does: <a href="https://docs.peppol.eu/poacc/billing/3.0/bis/#media-type" target="_blank">Peppol media types</a></p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><th class="slate-th"><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets">SUPPORTED FILE TYPES</p></th><th class="slate-th"><p class="slate-p" placeholder="Type / for widgets"></p></th></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><strong style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-bold">Documents</strong></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><em style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-italic">application/pdf</em></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><strong style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-bold">Images</strong></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><em style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-italic">image/png image/jpeg</em></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><strong style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-bold">Text</strong></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><em style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-italic">text/csv</em></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><strong style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-bold">Spreadsheet</strong></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-color"><span style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-backgroundColor"><em style="background-color:rgb(255, 255, 255);color:var(--light-text-content-color);font-size:14px" class="slate-italic">application/vnd.openxmlformats-officedocument.spreadsheetml.sheet application/vnd.oasis.opendocument.spreadsheet</em></span></span></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets"></p><h2 class="slate-h2"><a href="https://api.qvalia.io/docs/public-api/ZG9jOjI4NzIyMjYx-attachments-to-messages#technical-details" target="_blank">Technical details</a></h2><p class="slate-p" placeholder="Type / for widgets">Any attachment has to be <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">base64</code></span> encoded and added under the <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">AdditionalDocumentReference</code></span> element; <a href="https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AdditionalDocumentReference/cac-Attachment/" target="_blank">https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AdditionalDocumentReference/cac-Attachment/</a></p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets">JSON</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets">XML</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-166-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-json keep-markup drop-tokens"><div class="slate-code_line">&quot;AdditionalDocumentReference&quot;:[{</div><div class="slate-code_line">  &quot;ID&quot;:[{&quot;_&quot;:&quot;InvocieSpecification01&quot;}],</div><div class="slate-code_line">  &quot;DocumentType&quot;:[{&quot;_&quot;:&quot;Specification&quot;}],</div><div class="slate-code_line">  &quot;Attachment&quot;:[{</div><div class="slate-code_line">    &quot;EmbeddedDocumentBinaryObject&quot;:[</div><div class="slate-code_line">      {</div><div class="slate-code_line">        &quot;_&quot;:&quot;UjBsR09EbGhjZ0dTQUxNQUFBUUNBRU1tQ1p0dU1GUXhEUzhi&quot;,</div><div class="slate-code_line">        &quot;mimeCode&quot;:&quot;application/pdf&quot;,</div><div class="slate-code_line">        &quot;filename&quot;:&quot;InvocieSpecification01.pdf&quot;</div><div class="slate-code_line">      }</div><div class="slate-code_line">    ]</div><div class="slate-code_line">  }]</div><div class="slate-code_line">}]</div></code></pre></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-167-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-xml keep-markup drop-tokens"><div class="slate-code_line">&lt;cac:AdditionalDocumentReference&gt;</div><div class="slate-code_line">    &lt;cbc:ID&gt;InvocieSpecification01&lt;/cbc:ID&gt;</div><div class="slate-code_line">    &lt;cac:Attachment&gt;</div><div class="slate-code_line">        &lt;cbc:EmbeddedDocumentBinaryObject mimeCode=&quot;application/pdf&quot; filename=&quot;InvocieSpecification01.pdf&quot;&gt;UjBsR09EbGhjZ0dTQUxNQUFBUUNBRU1tQ1p0dU1GUXhEUzhi&lt;/cbc:EmbeddedDocumentBinaryObject&gt;</div><div class="slate-code_line">    &lt;/cac:Attachment&gt;</div><div class="slate-code_line">&lt;/cac:AdditionalDocumentReference&gt;</div></code></pre></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets">
</p>

Often our customers wants to add, or request, attached documents to their messages, e.g. their invoices.

We support all the same attachments as Peppol does: 

<p class="slate-p" placeholder="Type / for widgets">The Qvalia SFTP integration handles all Peppol XML <a href="https://docs.peppol.eu/edelivery/codelists/" target="_blank">Document types</a> by default but we also support &quot;custom&quot; formats.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets">&quot;Custom format&quot; means we can add a transformation for your required format both for outbound (sending) and inbound (receiving) documents. For example, if you use SAP IDoc we can transform incoming Peppol XML to SAP IDoc for you and you&apos;d pick up the ready-made SAP format from our SFTP. Likewise, if you are using outbound, you can upload your SAP IDoc and we will transform it for you.</p><p class="slate-p" placeholder="Type / for widgets">The SFTP setup is done by our helpdesk, and you will require a Qvalia account prior to being able to test the SFTP integration.</p><p class="slate-p" placeholder="Type / for widgets">Qvalia hosts an SFTP Server, and both sending and receiving is done through an SFTP client from your environment.</p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3"><a href="https://api.qvalia.io/docs/public-api/ZG9jOjUwNDQ0NTQ2-sftp-integration#sending-and-receiving" target="_blank">Sending and receiving</a></h3><p class="slate-p" placeholder="Type / for widgets">Any inbound (receiving) documents will be uniquely named according to a predefined format including, e.g., the document date and document number, and place in the root directory of your SFTP account.</p><p class="slate-p" placeholder="Type / for widgets">We recommend that you follow the common SFTP renaming standards for downloading received files to avoid downloading duplicates in case connection would be interrupted:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Connect to the SFTP server</div></li><li class="slate-li"><div style="position:relative">List files</div></li><li class="slate-li"><div style="position:relative">Start processing file list by:</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Rename the first file in the list to <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}.downloading</code></span></div></li><li class="slate-li"><div style="position:relative">Start download of <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}.downloading</code></span></div></li><li class="slate-li"><div style="position:relative">Once download is completed, delete <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}.downloading</code></span> from SFTP Server</div></li><li class="slate-li"><div style="position:relative">Rename <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}.downloading</code></span> locally back to <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}</code></span></div></li></ul></li></ul><p class="slate-p" placeholder="Type / for widgets">Outbound (sending) documents will be uploaded by you to the sub-directory named <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">/send</code></span>. The <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">send</code></span> directory is created automatically for you when you opt for the outbound functionality from Qvalia.</p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3"><a href="https://api.qvalia.io/docs/public-api/ZG9jOjUwNDQ0NTQ2-sftp-integration#error-handling-and-processing" target="_blank">Error handling and processing</a></h3><p class="slate-p" placeholder="Type / for widgets">When you upload your outbound documents and they should happen to be faulty in some way (e.g. invalid Peppol XML) the file uploaded will be renamed to <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}.error</code></span> and while the file is being inspected and processed by us it will be renamed as <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">{original-filename}.processing</code></span>.</p><p class="slate-p" placeholder="Type / for widgets">Once the processing is completed the file will be moved, and again renamed, in a sub-directory called <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">processed</code></span>, meaning you will find your already processed files in <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">/send/processed/{original-filename}.processed</code></span>.</p><p class="slate-p" placeholder="Type / for widgets">When, and if, you remove (delete) the files form <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">/processed</code></span> is up to you but please note that some SFTP clients can&apos;t read too large file lists why we recommend emptying the <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">/processed</code></span> sub-directory at a set interval, depending on the number of files you send.</p>

The Qvalia SFTP integration handles all Peppol XML 

 by default but we also support "custom" formats.

"Custom format" means we can add a transformation for your required format both for outbound (sending) and inbound (receiving) documents. For example, if you use SAP IDoc we can transform incoming Peppol XML to SAP IDoc for you and you'd pick up the ready-made SAP format from our SFTP. Likewise, if you are using outbound, you can upload your SAP IDoc and we will transform it for you.

The SFTP setup is done by our helpdesk, and you will require a Qvalia account prior to being able to test the SFTP integration.

Qvalia hosts an SFTP Server, and both sending and receiving is done through an SFTP client from your environment.

Any inbound (receiving) documents will be uniquely named according to a predefined format including, e.g., the document date and document number, and place in the root directory of your SFTP account.

We recommend that you follow the common SFTP renaming standards for downloading received files to avoid downloading duplicates in case connection would be interrupted:

Outbound (sending) documents will be uploaded by you to the sub-directory named 

 directory is created automatically for you when you opt for the outbound functionality from Qvalia.

When you upload your outbound documents and they should happen to be faulty in some way (e.g. invalid Peppol XML) the file uploaded will be renamed to 

 and while the file is being inspected and processed by us it will be renamed as 

Once the processing is completed the file will be moved, and again renamed, in a sub-directory called 

, meaning you will find your already processed files in 

/send/processed/{original-filename}.processed

When, and if, you remove (delete) the files form 

 is up to you but please note that some SFTP clients can't read too large file lists why we recommend emptying the 

 sub-directory at a set interval, depending on the number of files you send.

<p class="slate-p" placeholder="Type / for widgets">APIs related to invoice handling</p><p class="slate-p" placeholder="Type / for widgets"></p>

<p class="slate-p" placeholder="Type / for widgets">The response, in JSON, will always include the three latest messages, per default. Using XML you always only get one (as there&apos;s no &quot;array&quot; function for XML).</p><p class="slate-p" placeholder="Type / for widgets">Use <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">limit</code></span> parameter to change the number of returned messages and combine it with <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">offset</code></span> to traverse down the list, e.g: <a href="https://api-qa.qvalia.com/transaction/%7BaccountRegNo%7D/invoices/incoming?limit=10&amp;offset=10" target="_blank">https://api-qa.qvalia.com/transaction/{accountRegNo}/invoices/incoming?limit=10&amp;offset=10</a></p><p class="slate-p" placeholder="Type / for widgets">To get new messages only, use the <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">&quot;Get incoming read invoices&quot;</code></span> endpoint instead.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

 parameter to change the number of returned messages and combine it with 

Authorization

Either "application/json" (default) or "application/xml"

Accept

accountRegNo

limit

includeRead

offset

documentId

from

updatedAtFrom

updatedAtTo

integrationId

status

data

statusCode

error

message

type

metadata

Content-Type

<p class="slate-p" placeholder="Type / for widgets">The response, in JSON, will always include the three latest messages, per default. Using XML you always only get one (as there&apos;s no &quot;array&quot; function for XML).</p><p class="slate-p" placeholder="Type / for widgets">Use <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">limit</code></span> parameter to change the number of returned messages and combine it with <span style="color:var(--light-text-content-color);font-size:12px" class="slate-color"><code style="color:var(--light-text-content-color);font-size:12px" class="slate-code">offset</code></span> to traverse down the list, e.g: <a href="https://api-qa.qvalia.com/transaction/%7BaccountRegNo%7D/invoices/outgoing?limit=10&amp;offset=10" target="_blank">https://api-qa.qvalia.com/transaction/{accountRegNo}/invoices/outgoing?limit=10&amp;offset=10</a></p><p class="slate-p" placeholder="Type / for widgets">
</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

Invoices

<p>APIs related to credit note handing</p><p></p>

<p>APIs related to order handing</p><p></p>

<p>APIs related to order response handing</p><p></p>

<p>APIs related to catalogue handing</p><p></p>

<p>A collection of endpoints where Qvalia account information is gathered, such as Invoice status, and automation tasks, e.g. creating an outgoing Invoice from an incoming Order.</p><p></p>

A collection of endpoints where Qvalia account information is gathered, such as Invoice status, and automation tasks, e.g. creating an outgoing Invoice from an incoming Order.


As the request and response sample data are quite big, and scrolling through each sample on every endpoint would get quite tedious, we've opted to add sample data for the various messages here instead of in the actual Endpoint data.

Regardless if you are POST'in or GET'ing data the message structure of the messages will be the same.

 section of the documentation, and under 

 all our transaction messages are bidirectional and can be transformed to/from JSON/XML.f

<p class="slate-p" placeholder="Type / for widgets">For Swedish operators Qvalia can offer support for the legacy formats Svefaktura 1.0 (Basic Invoice) as well as Svefaktura 2 (Peppol BIS2/4A).</p><p class="slate-p" placeholder="Type / for widgets"><strong class="slate-bold">Qvalia is primarily using the protocol </strong><code class="slate-code"><strong class="slate-bold">SFTI Transportprofil Bas 2.0</strong></code><strong class="slate-bold"> over </strong><code class="slate-code"><strong class="slate-bold">HTTP POST</strong></code><strong class="slate-bold"> for the Swedish legacy formats. SFTP transportation can also be accepted, and configured, for any Operator who wants to send legacy formats.</strong></p><p class="slate-p" placeholder="Type / for widgets">We <strong class="slate-bold">strongly</strong> encourage the usage of <strong class="slate-bold">Peppol</strong> instead of legacy formats, but we do understand that some older systems still needs to fall back on older versions of specifications, and we try our best to meet the needs of our customers.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"><strong class="slate-bold">Please reach out to peppol@qvalia.com if you are an Operator who wants to use any of the legacy formats!</strong></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets">SFTI Transportprofil Bas 2.0 is an old and not supported standard, but as some companies and Operators in Sweden still cling to it Qvalia has the option of POST&apos;ing Transportprofil Bas 2.0 over HTTP.</p><p class="slate-p" placeholder="Type / for widgets">As we would like to follow the recommendation of the Swedish Government and the IT authorities of Sweden we have deprecated the usage of Svefaktura, and try to move all our customers over to Peppol.</p><p class="slate-p" placeholder="Type / for widgets">After the 1st of March 2021, no new established Svefaktura connections should be added according to DIGG&apos;s recommendations and mandate <code class="slate-code">MDFFS 2021:1</code>. See article from SFTI/DIGG here (in Swedish) for more information: <a href="https://sfti.se/sfti/standarder/rekommenderadestandarder/avfordameddelanden.52834.html" target="_blank">https://sfti.se/sfti/standarder/rekommenderadestandarder/avfordameddelanden.52834.html</a></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><code class="slate-code"><strong class="slate-bold">Sample of a Transportprofil Bas 2.0 Envelope with Svefaktura</strong></code></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-728-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="keep-markup drop-tokens"><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets">Content-Type: multipart/related; boundary=&quot;BoundarY&quot;; type=&quot;text/xml&quot;;
soapaction: ebXML</p></code></pre></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-729-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="keep-markup drop-tokens"><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets">--BoundarY
Content-ID: &lt;ebxhmheader1@avsandare.com&gt;
Content-Type: text/xml

&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;SOAP:Envelope xmlns:xlink=&quot;http://www.w3.org/1999/xlink&quot;
	xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
	xmlns:SOAP=&quot;http://schemas.xmlsoap.org/soap/envelope/&quot;
	xmlns:eb=&quot;http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd&quot;
	xsi:schemaLocation=&quot;http://schemas.xmlsoap.org/soap/envelope/ http://www.oasis-open.org/committees/ebxml-msg/schema/envelope.xsd http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd&quot;&gt;
	&lt;SOAP:Header&gt;
	  &lt;eb:MessageHeader SOAP:mustUnderstand=&quot;1&quot; eb:version=&quot;2.0&quot;&gt;
		  &lt;eb:From&gt;
			  &lt;eb:PartyId eb:type=&quot;countrycode:organizationid&quot;&gt;SE1234567890&lt;/eb:PartyId&gt;
		  &lt;/eb:From&gt;
			&lt;eb:To&gt;
			  &lt;eb:PartyId eb:type=&quot;countrycode:organizationid&quot;&gt;SE9876543210&lt;/eb:PartyId&gt;
			&lt;/eb:To&gt;
			&lt;eb:CPAId&gt;20160214:SE1234567890:SE9876543210&lt;/eb:CPAId&gt;
			&lt;eb:ConversationId&gt;20160214:4567:SE1234567890&lt;/eb:ConversationId&gt;
			&lt;eb:Service&gt;urn:sfti:services:documentprocessing:BasicInvoice&lt;/eb:Service&gt;
			&lt;eb:Action&gt;incomingBasicInvoice&lt;/eb:Action&gt;
		  &lt;eb:MessageData&gt;
			  &lt;eb:MessageId&gt;20160214-102030-28572@foretag.se&lt;/eb:MessageId&gt;
				&lt;eb:Timestamp&gt;2016-02-14T11:12:12&lt;/eb:Timestamp&gt;
			&lt;/eb:MessageData&gt;
		&lt;/eb:MessageHeader&gt;
		&lt;eb:AckRequested SOAP:mustUnderstand=&quot;1&quot; eb:version=&quot;2.0&quot; eb:signed=&quot;false&quot; SOAP:actor=&quot;urn:oasis:names:tc:ebxml-msg:actor:toPartyMSH&quot;/&gt;
		&lt;eb:SyncReply eb:id=&quot;&quot; eb:version=&quot;2.0&quot; SOAP:mustUnderstand=&quot;1&quot; SOAP:actor=&quot;http://schemas.xmlsoap.org/soap/actor/next&quot;&gt;
		&lt;/eb:SyncReply&gt;
	&lt;/SOAP:Header&gt;
	&lt;SOAP:Body&gt;
	  &lt;eb:Manifest eb:version=&quot;2.0&quot;&gt;
		  &lt;eb:Reference xlink:href=&quot;cid:ebxmlpayload1@avsandare.com&quot; xlink:type=&quot;simple&quot;&gt;
			  &lt;eb:Description xml:lang=&quot;se&quot;&gt;Fritext beskrivning av meddelande&lt;/eb:Description&gt;
				&lt;eb:Schema eb:location=&quot;urn:se:sfti:collaborationprocesses:BasicInvoice.xsd&quot; eb:version=&quot;1.0&quot;&gt;&lt;/eb:Schema&gt;
			&lt;/eb:Reference&gt;
		&lt;/eb:Manifest&gt;
	&lt;/SOAP:Body&gt;
&lt;/SOAP:Envelope&gt;

--BoundarY
Content-ID: &lt;ebxmlpayload1@avsandare.se&gt;
Content-Type: text/xml

&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;StandardBusinessDocument xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xmlns=&quot;http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader&quot;&gt;
  &lt;StandardBusinessDocumentHeader&gt;
    &lt;HeaderVersion&gt;1.0&lt;/HeaderVersion&gt;
    &lt;Sender&gt;
      &lt;Identifier
        Authority=&quot;iso6523-actorid-upis&quot;&gt;0088:7301234567890&lt;/Identifier&gt;
    &lt;/Sender&gt;
    &lt;Receiver&gt;
      &lt;Identifier
        Authority=&quot;iso6523-actorid-upis&quot;&gt;0007:1234567890&lt;/Identifier&gt;
    &lt;/Receiver&gt;
    &lt;DocumentIdentification&gt;
      &lt;Standard&gt;urn:oasis:names:specification:ubl:schema:xsd:Invoice-2&lt;/Standard&gt;
      &lt;TypeVersion&gt;2.1&lt;/TypeVersion&gt;
      &lt;InstanceIdentifier&gt;2016021401022&lt;/InstanceIdentifier&gt;
      &lt;Type&gt;Invoice&lt;/Type&gt;
      &lt;CreationDateAndTime&gt;2016-02-14T14:40:38.4644993+02:00&lt;/CreationDateAndTime&gt;
    &lt;/DocumentIdentification&gt;
    &lt;BusinessScope&gt;
      &lt;Scope&gt;
        &lt;Type&gt;DOCUMENTID&lt;/Type&gt;
        &lt;InstanceIdentifier&gt;urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1&lt;/InstanceIdentifier&gt;
      &lt;/Scope&gt;
      &lt;Scope&gt;
        &lt;Type&gt;PROCESSID&lt;/Type&gt;
        &lt;InstanceIdentifier&gt;urn:fdc:peppol.eu:2017:poacc:billing:01:1.0&lt;/InstanceIdentifier&gt;
      &lt;/Scope&gt;
    &lt;/BusinessScope&gt;
  &lt;/StandardBusinessDocumentHeader&gt;
  &lt;Invoice xmlns:cac=&quot;urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2&quot; xmlns:cbc=&quot;urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2&quot; xmlns=&quot;urn:oasis:names:specification:ubl:schema:xsd:Invoice-2&quot;&gt;
    &lt;cbc:CustomizationID&gt;urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0&lt;/cbc:CustomizationID&gt;
    &lt;cbc:ProfileID&gt;urn:fdc:peppol.eu:2017:poacc:billing:01:1.0&lt;/cbc:ProfileID&gt;
    &lt;cbc:ID&gt;...&lt;/cbc:ID&gt;
    &lt;cbc:IssueDate&gt;2016-02-14&lt;/cbc:IssueDate&gt;
    &lt;cbc:DueDate&gt;2016-03-31&lt;/cbc:DueDate&gt;
    &lt;cbc:InvoiceTypeCode&gt;380&lt;/cbc:InvoiceTypeCode&gt;
    &lt;cbc:DocumentCurrencyCode&gt;SEK&lt;/cbc:DocumentCurrencyCode&gt;
    &lt;cbc:BuyerReference&gt;...&lt;/cbc:BuyerReference&gt;
    &lt;cac:AccountingSupplierParty&gt;
      ...
    &lt;/cac:AccountingSupplierParty&gt;
    &lt;cac:AccountingCustomerParty&gt;
      ...
    &lt;/cac:AccountingCustomerParty&gt;
    &lt;cac:PaymentMeans&gt;
      ...
    &lt;/cac:PaymentMeans&gt;
    &lt;cac:PaymentTerms&gt;
      ...
    &lt;/cac:PaymentTerms&gt;
    &lt;cac:TaxTotal&gt;
      ...
    &lt;/cac:TaxTotal&gt;
    &lt;cac:LegalMonetaryTotal&gt;
      ...
    &lt;/cac:LegalMonetaryTotal&gt;
    &lt;cac:InvoiceLine&gt;
      ...
    &lt;/cac:InvoiceLine&gt;
  &lt;/Invoice&gt;
&lt;/StandardBusinessDocument&gt;

--BoundarY––
</p></code></pre></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets"><code class="slate-code"><strong class="slate-bold">Sample of a Transportprofil Bas 2.0 Acknowledgement Response</strong></code></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-730-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-xml keep-markup drop-tokens"><div class="slate-code_line">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;SOAP:Envelope
	xmlns:SOAP=&quot;http://schemas.xmlsoap.org/soap/envelope/&quot;
	xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
  xsi:schemaLocation=&quot;http://schemas.xmlsoap.org/soap/envelope/ http://www.oasis-
  open.org/committees/ebxml-msg/schema/envelope.xsd&quot;
	xmlns:eb=&quot;http://www.oasis-
  open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd&quot;&gt;
	&lt;SOAP:Header xsi:schemaLocation=&quot;http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd
    http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd&quot;&gt;
		&lt;eb:MessageHeader SOAP:mustUnderstand=&quot;1&quot; eb:version=&quot;2.0&quot;&gt;
			&lt;eb:From&gt;
				&lt;eb:PartyId eb:type=&quot;countrycode:organizationid&quot;&gt;SE1234567890&lt;/eb:PartyId&gt;
			&lt;/eb:From&gt;
			&lt;eb:To&gt;
				&lt;eb:PartyId eb:type=&quot;countrycode:organizationid&quot;&gt;SE9876543210&lt;/eb:PartyId&gt;
			&lt;/eb:To&gt;
			&lt;eb:CPAId&gt;20160214:SE1234567890:SE9876543210&lt;/eb:CPAId&gt;
			&lt;eb:ConversationId&gt;20160214:4567:SE1234567890&lt;/eb:ConversationId&gt;
			&lt;eb:Service&gt;urn:oasis:names:tc:ebxml-msg:service&lt;/eb:Service&gt;
			&lt;eb:Action&gt;Acknowledgment&lt;/eb:Action&gt;
			&lt;eb:MessageData&gt;
				&lt;eb:MessageId&gt;bba2674a-4bf3-453e-a129-4f2a2da7f004@b2b.qvalia.com&lt;/eb:MessageId&gt;
				&lt;eb:Timestamp&gt;2016-02-14T08:56:56.390Z&lt;/eb:Timestamp&gt;
				&lt;eb:RefToMessageId&gt;20160214-102030-28572@foretag.se&lt;/eb:RefToMessageId&gt;
			&lt;/eb:MessageData&gt;
		&lt;/eb:MessageHeader&gt;
		&lt;eb:Acknowledgment SOAP:mustUnderstand=&quot;1&quot; eb:version=&quot;2.0&quot;
      SOAP:actor=&quot;urn:oasis:names:tc:ebxml-msg:actor:toPartyMSH&quot;&gt;
			&lt;eb:Timestamp&gt;2016-02-14T08:56:56.390Z&lt;/eb:Timestamp&gt;
			&lt;eb:RefToMessageId&gt;20160214-102030-28572@foretag.se&lt;/eb:RefToMessageId&gt;
			&lt;eb:From&gt;
				&lt;eb:PartyId eb:type=&quot;countrycode:organizationid&quot;&gt;SE9876543210&lt;/eb:PartyId&gt;
			&lt;/eb:From&gt;
		&lt;/eb:Acknowledgment&gt;
	&lt;/SOAP:Header&gt;
	&lt;SOAP:Body xsi:schemaLocation=&quot;http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd
    http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd&quot;/&gt;
&lt;/SOAP:Envelope&gt;</div></code></pre></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

For Swedish operators Qvalia can offer support for the legacy formats Svefaktura 1.0 (Basic Invoice) as well as Svefaktura 2 (Peppol BIS2/4A).

 for the Swedish legacy formats. SFTP transportation can also be accepted, and configured, for any Operator who wants to send legacy formats.

 instead of legacy formats, but we do understand that some older systems still needs to fall back on older versions of specifications, and we try our best to meet the needs of our customers.

Please reach out to peppol@qvalia.com if you are an Operator who wants to use any of the legacy formats!

SFTI Transportprofil Bas 2.0 is an old and not supported standard, but as some companies and Operators in Sweden still cling to it Qvalia has the option of POST'ing Transportprofil Bas 2.0 over HTTP.

As we would like to follow the recommendation of the Swedish Government and the IT authorities of Sweden we have deprecated the usage of Svefaktura, and try to move all our customers over to Peppol.

After the 1st of March 2021, no new established Svefaktura connections should be added according to DIGG's recommendations and mandate 

. See article from SFTI/DIGG here (in Swedish) for more information: 