Quick Start

You must first sign up for a Qvalia account, and contact Sales or Support to get access and API setup!

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an 401 error.

You will get your API key from Qvalia support, or the onboarding team!

Review the API Documentation

API's

Make your first request

To make your first request, send an authenticated request to the /invoices endpoint. This will create an invoice.

Create outgoing invoice

POST https://api.qvalia.com/transaction/{accountRegNo}/invoices/outgoing

Creates a new outgoing invoice that will be sent over the Peppol network

Request Body

See: https://app.gitbook.com/o/-McAY8WYeIvMOpDL_Y9w/s/S4MbRBCDJsKGrYU4ahuP/~/changes/2/sample-data/api-sample-data/invoice#json

200 Invoice successfully created

{
  "status": "success",
  "data": {
    "message": "invoice 12335675 sent",
    "order_id": ""
  }
}

401 Permission denied

Take a look at how you might call this method using our official libraries, or via curl:

curl

curl --location --globoff 'https://api.qvalia.com/transaction/{accountRegNo}/invoices/outgoing' \
--data '{
  "Invoice": {}
}'

Node

const body = {
  Invoice: {...}
};

var requestOptions = {
  method: 'POST',
  body
};

await fetch('https://api.qvalia.com/transaction/{accountRegNo}/invoices/outgoing', requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Python

import requests

url = "https://api.qvalia.com/transaction/{accountRegNo}/invoices/outgoing"

body = "{
  \"Invoice\": {}
}"
headers = {}

response = requests.request("POST", url, headers=headers, data=body)

print(response.text)