Invoice APIs

Operations related to Invoices

Get incoming invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/invoices/incoming

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoices/incoming

GET /transaction/{accountRegNo}/invoices/incoming HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Create incoming invoices [transaction-type: Invoice]

post

/transaction/{accountRegNo}/invoices/incoming

The request can be either JSON or XML. Each individual message must be POST'ed as an object, JSON Array is not suported!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

overwritebooleanOptional

For POST requests, chose to overwrite upon a 409 Conflict response to reprocess the message with the same document ID and receiver (i.e. send the same message again)

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

Content-TypestringOptional

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

Default: application/json

Body

InvoiceobjectOptional

Responses

200

statusstringOptionalExample: success

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/transaction/{accountRegNo}/invoices/incoming

POST /transaction/{accountRegNo}/invoices/incoming HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "Invoice": {}
}

{
  "status": "success",
  "data": {
    "message": "{transaction-type} 100-1000 sent",
    "{transaction-type}_id": "100-1000",
    "integrationId": "4725a033-e501-4e2f-afa5-3a5c24eb5e28"
  }
}

Read incoming invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/invoices/incoming/readinvoices

Through this endpoint you will get any unread (=previously fetched) message(s). After you have fetched through this request the message will be automatically marked as read

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoices/incoming/readinvoices

GET /transaction/{accountRegNo}/invoices/incoming/readinvoices HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Get outgoing invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/invoices/outgoing

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoices/outgoing

GET /transaction/{accountRegNo}/invoices/outgoing HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Create outgoing invoices [transaction-type: Invoice]

post

/transaction/{accountRegNo}/invoices/outgoing

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

overwritebooleanOptional

For POST requests, chose to overwrite upon a 409 Conflict response to reprocess the message with the same document ID and receiver (i.e. send the same message again)

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

Content-TypestringOptional

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

Default: application/json

Body

InvoiceobjectOptional

Responses

200

statusstringOptionalExample: success

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/transaction/{accountRegNo}/invoices/outgoing

POST /transaction/{accountRegNo}/invoices/outgoing HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "Invoice": {}
}

{
  "status": "success",
  "data": {
    "message": "{transaction-type} 100-1000 sent",
    "{transaction-type}_id": "100-1000",
    "integrationId": "4725a033-e501-4e2f-afa5-3a5c24eb5e28"
  }
}

Read outgoing invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/invoices/outgoing/readinvoices

Through this endpoint you will get any unread (=previously fetched) message(s). After you have fetched through this request the message will be automatically marked as read

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoices/outgoing/readinvoices

GET /transaction/{accountRegNo}/invoices/outgoing/readinvoices HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Get incoming invoice responses [transaction-type: InvoiceResponse]

get

/transaction/{accountRegNo}/invoiceresponses/incoming

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoiceresponses/incoming

GET /transaction/{accountRegNo}/invoiceresponses/incoming HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Create incoming invoice responses [transaction-type: InvoiceResponse]

post

/transaction/{accountRegNo}/invoiceresponses/incoming

The request can be either JSON or XML. Each individual message must be POST'ed as an object, JSON Array is not suported!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

overwritebooleanOptional

For POST requests, chose to overwrite upon a 409 Conflict response to reprocess the message with the same document ID and receiver (i.e. send the same message again)

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

Content-TypestringOptional

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

Default: application/json

Body

ApplicationResponseobjectOptional

Responses

200

statusstringOptionalExample: success

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/transaction/{accountRegNo}/invoiceresponses/incoming

POST /transaction/{accountRegNo}/invoiceresponses/incoming HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "ApplicationResponse": {}
}

{
  "status": "success",
  "data": {
    "message": "{transaction-type} 100-1000 sent",
    "{transaction-type}_id": "100-1000",
    "integrationId": "4725a033-e501-4e2f-afa5-3a5c24eb5e28"
  }
}

Read incoming invoice responses [transaction-type: InvoiceResponse]

get

/transaction/{accountRegNo}/invoiceresponses/incoming/readinvoice responses

Through this endpoint you will get any unread (=previously fetched) message(s). After you have fetched through this request the message will be automatically marked as read

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoiceresponses/incoming/readinvoice responses

GET /transaction/{accountRegNo}/invoiceresponses/incoming/readinvoice responses HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Get outgoing invoice responses [transaction-type: InvoiceResponse]

get

/transaction/{accountRegNo}/invoiceresponses/outgoing

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoiceresponses/outgoing

GET /transaction/{accountRegNo}/invoiceresponses/outgoing HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Create outgoing invoice responses [transaction-type: InvoiceResponse]

post

/transaction/{accountRegNo}/invoiceresponses/outgoing

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

overwritebooleanOptional

For POST requests, chose to overwrite upon a 409 Conflict response to reprocess the message with the same document ID and receiver (i.e. send the same message again)

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

Content-TypestringOptional

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

Default: application/json

Body

ApplicationResponseobjectOptional

Responses

200

statusstringOptionalExample: success

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/transaction/{accountRegNo}/invoiceresponses/outgoing

POST /transaction/{accountRegNo}/invoiceresponses/outgoing HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "ApplicationResponse": {}
}

{
  "status": "success",
  "data": {
    "message": "{transaction-type} 100-1000 sent",
    "{transaction-type}_id": "100-1000",
    "integrationId": "4725a033-e501-4e2f-afa5-3a5c24eb5e28"
  }
}

Read outgoing invoice responses [transaction-type: InvoiceResponse]

get

/transaction/{accountRegNo}/invoiceresponses/outgoing/readinvoice responses

Through this endpoint you will get any unread (=previously fetched) message(s). After you have fetched through this request the message will be automatically marked as read

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoiceresponses/outgoing/readinvoice responses

GET /transaction/{accountRegNo}/invoiceresponses/outgoing/readinvoice responses HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Get incoming self billing invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/selfbillinginvoices/incoming

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/selfbillinginvoices/incoming

GET /transaction/{accountRegNo}/selfbillinginvoices/incoming HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Create incoming self billing invoices [transaction-type: Invoice]

post

/transaction/{accountRegNo}/selfbillinginvoices/incoming

The request can be either JSON or XML. Each individual message must be POST'ed as an object, JSON Array is not suported!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

overwritebooleanOptional

For POST requests, chose to overwrite upon a 409 Conflict response to reprocess the message with the same document ID and receiver (i.e. send the same message again)

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

Content-TypestringOptional

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

Default: application/json

Body

InvoiceobjectOptional

Responses

200

statusstringOptionalExample: success

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/transaction/{accountRegNo}/selfbillinginvoices/incoming

POST /transaction/{accountRegNo}/selfbillinginvoices/incoming HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "Invoice": {}
}

{
  "status": "success",
  "data": {
    "message": "{transaction-type} 100-1000 sent",
    "{transaction-type}_id": "100-1000",
    "integrationId": "4725a033-e501-4e2f-afa5-3a5c24eb5e28"
  }
}

Read incoming self billing invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/selfbillinginvoices/incoming/readselfbillinginvoices

Through this endpoint you will get any unread (=previously fetched) message(s). After you have fetched through this request the message will be automatically marked as read

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/selfbillinginvoices/incoming/readselfbillinginvoices

GET /transaction/{accountRegNo}/selfbillinginvoices/incoming/readselfbillinginvoices HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Get outgoing self billing invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/selfbillinginvoices/outgoing

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/selfbillinginvoices/outgoing

GET /transaction/{accountRegNo}/selfbillinginvoices/outgoing HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Create outgoing self billing invoices [transaction-type: Invoice]

post

/transaction/{accountRegNo}/selfbillinginvoices/outgoing

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

To get new messages only, use the "Read" endpoint instead!

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

overwritebooleanOptional

For POST requests, chose to overwrite upon a 409 Conflict response to reprocess the message with the same document ID and receiver (i.e. send the same message again)

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

Content-TypestringOptional

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

Default: application/json

Body

InvoiceobjectOptional

Responses

200

statusstringOptionalExample: success

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/transaction/{accountRegNo}/selfbillinginvoices/outgoing

POST /transaction/{accountRegNo}/selfbillinginvoices/outgoing HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "Invoice": {}
}

{
  "status": "success",
  "data": {
    "message": "{transaction-type} 100-1000 sent",
    "{transaction-type}_id": "100-1000",
    "integrationId": "4725a033-e501-4e2f-afa5-3a5c24eb5e28"
  }
}

Read outgoing self billing invoices [transaction-type: Invoice]

get

/transaction/{accountRegNo}/selfbillinginvoices/outgoing/readselfbillinginvoices

Through this endpoint you will get any unread (=previously fetched) message(s). After you have fetched through this request the message will be automatically marked as read

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).

With JSON, use the limit parameter to change the number of returned messages and combine it with offset to traverse through your available messages.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

Header parameters

AuthorizationstringRequired

API key

Default: ""

AcceptstringOptional

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

Default: application/json

Responses

200

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/selfbillinginvoices/outgoing/readselfbillinginvoices

GET /transaction/{accountRegNo}/selfbillinginvoices/outgoing/readselfbillinginvoices HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

{
  "status": "success",
  "data": [
    {
      "{transaction-type}": {},
      "integrationId": "text"
    }
  ]
}

Get incoming invoice statuses [transaction-type: Invoice]

get

/transaction/{accountRegNo}/invoices/incoming/status

Returns lightweight delivery/processing status metadata for the matching messages — the message uuid, the incoming readAt timestamp and a metadata object whose status reflects the latest message-log status — WITHOUT the heavy document payload.

Uses the same query-string filters as the resource's GET on /incoming and /outgoing. By default only unread messages are returned; set includeRead=true to also include previously read messages.

The response is always JSON (an array of status objects); there is no XML representation for this endpoint.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

Responses

200

application/json

uuidstring · uuidOptional

Qvalia unique identifier for the transaction/message

Example: a1b2c3d4-5678-90ab-cdef-1234567890ab

readAtstring · date-time · nullableOptional

When the (incoming) message was marked as read, or null if unread/not applicable

Example: 2024-01-01T12:00:00.000Z

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoices/incoming/status

GET /transaction/{accountRegNo}/invoices/incoming/status HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "readAt": "2024-01-01T12:00:00.000Z",
    "metadata": {
      "status": "sent"
    }
  }
]

Get outgoing invoice statuses [transaction-type: Invoice]

get

/transaction/{accountRegNo}/invoices/outgoing/status

Uses the same query-string filters as the resource's GET on /incoming and /outgoing. By default only unread messages are returned; set includeRead=true to also include previously read messages.

The response is always JSON (an array of status objects); there is no XML representation for this endpoint.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

Responses

200

application/json

uuidstring · uuidOptional

Qvalia unique identifier for the transaction/message

Example: a1b2c3d4-5678-90ab-cdef-1234567890ab

readAtstring · date-time · nullableOptional

When the (incoming) message was marked as read, or null if unread/not applicable

Example: 2024-01-01T12:00:00.000Z

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoices/outgoing/status

GET /transaction/{accountRegNo}/invoices/outgoing/status HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "readAt": "2024-01-01T12:00:00.000Z",
    "metadata": {
      "status": "sent"
    }
  }
]

Get incoming invoice response statuses [transaction-type: InvoiceResponse]

get

/transaction/{accountRegNo}/invoiceresponses/incoming/status

Uses the same query-string filters as the resource's GET on /incoming and /outgoing. By default only unread messages are returned; set includeRead=true to also include previously read messages.

The response is always JSON (an array of status objects); there is no XML representation for this endpoint.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

Responses

200

application/json

uuidstring · uuidOptional

Qvalia unique identifier for the transaction/message

Example: a1b2c3d4-5678-90ab-cdef-1234567890ab

readAtstring · date-time · nullableOptional

When the (incoming) message was marked as read, or null if unread/not applicable

Example: 2024-01-01T12:00:00.000Z

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoiceresponses/incoming/status

GET /transaction/{accountRegNo}/invoiceresponses/incoming/status HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "readAt": "2024-01-01T12:00:00.000Z",
    "metadata": {
      "status": "sent"
    }
  }
]

Get outgoing invoice response statuses [transaction-type: InvoiceResponse]

get

/transaction/{accountRegNo}/invoiceresponses/outgoing/status

Uses the same query-string filters as the resource's GET on /incoming and /outgoing. By default only unread messages are returned; set includeRead=true to also include previously read messages.

The response is always JSON (an array of status objects); there is no XML representation for this endpoint.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

Responses

200

application/json

uuidstring · uuidOptional

Qvalia unique identifier for the transaction/message

Example: a1b2c3d4-5678-90ab-cdef-1234567890ab

readAtstring · date-time · nullableOptional

When the (incoming) message was marked as read, or null if unread/not applicable

Example: 2024-01-01T12:00:00.000Z

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/invoiceresponses/outgoing/status

GET /transaction/{accountRegNo}/invoiceresponses/outgoing/status HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "readAt": "2024-01-01T12:00:00.000Z",
    "metadata": {
      "status": "sent"
    }
  }
]

Get incoming self billing invoice statuses [transaction-type: Invoice]

get

/transaction/{accountRegNo}/selfbillinginvoices/incoming/status

Uses the same query-string filters as the resource's GET on /incoming and /outgoing. By default only unread messages are returned; set includeRead=true to also include previously read messages.

The response is always JSON (an array of status objects); there is no XML representation for this endpoint.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

Responses

200

application/json

uuidstring · uuidOptional

Qvalia unique identifier for the transaction/message

Example: a1b2c3d4-5678-90ab-cdef-1234567890ab

readAtstring · date-time · nullableOptional

When the (incoming) message was marked as read, or null if unread/not applicable

Example: 2024-01-01T12:00:00.000Z

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/selfbillinginvoices/incoming/status

GET /transaction/{accountRegNo}/selfbillinginvoices/incoming/status HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "readAt": "2024-01-01T12:00:00.000Z",
    "metadata": {
      "status": "sent"
    }
  }
]

Get outgoing self billing invoice statuses [transaction-type: Invoice]

get

/transaction/{accountRegNo}/selfbillinginvoices/outgoing/status

Uses the same query-string filters as the resource's GET on /incoming and /outgoing. By default only unread messages are returned; set includeRead=true to also include previously read messages.

The response is always JSON (an array of status objects); there is no XML representation for this endpoint.

Authorizations

AuthorizationstringRequired

Path parameters

accountRegNostringRequired

Account registration number issued by Qvalia

Default: ""

Query parameters

limitnumberOptional

How many messages to return in Array (XML is always one!)

Default: 3Example: 5

offsetnumberOptional

Where to start index for using limit/offset listing

Default: 0Example: 0

includeReadbooleanOptional

If you are using the "read" enpoints, make it include previously read messages

Default: falseExample: false

integrationIdstringOptional

Qvalia unique identifier for the transaction/message

Default: ""

documentIdstringOptional

The document identifier of teh message, e.g. Invoice number

Default: ""

fromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

tostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtFromstringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

updatedAtTostringOptional

YYYY-MM-DD, e.g. 2024-01-01

Default: ""

Header parameters

AuthorizationstringRequired

API key

Default: ""

Responses

200

application/json

uuidstring · uuidOptional

Qvalia unique identifier for the transaction/message

Example: a1b2c3d4-5678-90ab-cdef-1234567890ab

readAtstring · date-time · nullableOptional

When the (incoming) message was marked as read, or null if unread/not applicable

Example: 2024-01-01T12:00:00.000Z

204

No content

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/transaction/{accountRegNo}/selfbillinginvoices/outgoing/status

GET /transaction/{accountRegNo}/selfbillinginvoices/outgoing/status HTTP/1.1
Host: api-qa.qvalia.com
Authorization: 
Accept: */*

[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "readAt": "2024-01-01T12:00:00.000Z",
    "metadata": {
      "status": "sent"
    }
  }
]

PreviousTransaction API NextCredit Note APIs

Last updated 1 month ago

Was this helpful?