Changelog

Here you will find all changes made to the AzoraOne API. We update and introduce new features to the service regularly, so stay tuned!

April 2021

Precognition

We have added the precognition item to the company model. This allows you to extract supplier invoices using precognition knowledge.

{
"companyID": "10",
"companyName": "SmallCorp",
"companyProxy": "Account Group Inc",
"active": true,
"precognition": {
"active": false
},
"corporateIdentityNumber": "556754-9273",
"bankAccountNumber": "310-6093",
"plusGiroNumber": "477451-9",
"iban": ""
}

February 2021

Periodicity

We have added the periodicity item to account item to allow extraction of periodicity data on both supplier invoices and receipts.

{
"account": "1790",
"periodicity": {
"offsetAccount": "6210",
"startDate": "2020-04-01",
"endDate": "2021-03-31"
},
"debit": "2495,29",
"credit": "0,00"
}

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/receipts
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/receipts
GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

October 2020

Memories

We have added a new resource that lets users delete all prior memories on a specific company.

This allows users to relearn the robot from the start, which can be useful when presenting demonstrations on how the robot learns.

New resources:

DELETE ...{api}/{version}/companies/{companyID}/memories
Company proxy

We have added the companyProxy parameter to the company model.

This will allow users to group companies together, which can be useful for tracking user activity.

{
"companyID": "10",
"companyName": "SmallCorp",
"companyProxy": "Account Group Inc",
"active": true,
"corporateIdentityNumber": "556754-9273",
"bankAccountNumber": "310-6093",
"plusGiroNumber": "477451-9",
"iban": ""
}

Affected resources:

GET ...{api}/{version}/companies
POST ...{api}/{version}/companies
GET ...{api}/{version}/companies/{companyID}
PUT ...{api}/{version}/companies/{companyID}

June 2020

XML-invoices

We have improved the accuracy when extracting data from the following XML-invoice types.

  • Svefaktura 1.0

  • PEPPOL BIS Billing 3.0

    • Invoice

    • Credit Note

With this update, basic information will be extracted even if the company has any previous memories. This behavior will be overwritten if the client bookkeeps the files differently.

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

May 2020

Company billing information

We have added company specific billing information to the meta object when retrieving a company.

This information may be useful when explaining how your customer is billed.

{
"created": "2020-10-30 10:51:28",
"subscriptionStart": "2020-10-30 10:51:28",
"lastActivated": "2020-10-30 10:51:28",
"lastDeactivated": "",
"cycleLength": "0100",
"cycleEnd": "2020-11-30 10:51:28",
"lastDebited": "",
"debitable": true
}

Affected resources:

GET ...{api}/{version}/companies/{companyID}

April 2020

Supplier invoices

We have added the ourRef and yourRef parameters to the supplier invoice model. This will allow users to extract these parameters from their invoices along with the previous parameters.

{
"supplierID": "1",
"description": "Phone invoice",
"verificationSeries": "A",
"invoiceDate": "2020-05-01",
"dueDate": "2020-05-31",
"invoiceNumber": "",
"ocrNumber": "707902514856",
"ourRef": "Emma Example",
"yourRef": "Tony Test",
"totalSum": "3119.00",
"vat": "623.82",
"accounts": [
{
"account": "6210",
"debit": "2495.29",
"credit": "0.00"
},
{
"account": "3740",
"debit": "0.00",
"credit": "0.11"
}
]
}

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

Email addresses

We have added email addresses to the supplier invoice extended response. You can use this to identify all email addresses that are found in the document.

{
"corporateIdentityNumbers": [
"556421-0309"
],
"bankAccountNumbers": [
"5331-1338"
],
"plusGiroNumbers": [
"4792603-5"
],
"ibans": [
"SE2195000099603447926035"
],
"currencies": [
"SEK"
],
"emails": [
"info@arkimera.se"
]
}

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

January 2020

Currencies

We have added currencies to the supplier invoice extended response. You can use this to identify all currencies that are found in the document.

{
"corporateIdentityNumbers": [
"556421-0309"
],
"bankAccountNumbers": [
"5331-1338"
],
"plusGiroNumbers": [
"4792603-5"
],
"ibans": [
"SE2195000099603447926035"
],
"currencies": [
"SEK"
]
}

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices
Svefaktura and PEPPOL

We now allow uploading XML-files of the Svefaktura 1.0 and PEPPOL BIS Billing 3 formats. These files can be extracted just like any other document type.

Affected resources:

POST ...{api}/{version}/companies/{companyID}/files

December 2019

Supplier invoices

We have added the description and verificationSeries parameters to the supplier invoice model. This will allow users to extract these parameters from their invoices along with the previous parameters.

{
"supplierID": "1",
"description": "Phone invoice",
"verificationSeries": "A",
"invoiceDate": "2019-05-01",
"dueDate": "2019-05-31",
"invoiceNumber": "",
"ocrNumber": "707902514856",
"totalSum": "3119.00",
"vat": "623.82",
"accounts": [
{
"account": "6210",
"debit": "2495.29",
"credit": "0.00"
},
{
"account": "3740",
"debit": "0.00",
"credit": "0.11"
}
]
}

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

April 2019

Description

We have increased the accuracy on the description parameter in the receipts resource. Unlike most parameters in AzoraOne, it works by a pretty static extraction mechanism. By comparing the text of the extracted document to what has previously been entered as description on similar documents it will return a description only if a match can be confirmed. If the description contains more than one word, only words matching the current document will be returned.

We also added the ability to include the description parameter in the supplier invoice endpoint. Get in contact with us if you want this parameter in your API.

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/receipts
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/receipts
GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

Mars 2019

OCR

We have increased the backend OCR accuracy, while decreasing the time for OCR conversion.

Some files will now get processed quicker than before.

Affected resources:

POST ...{api}/{version}/companies/{companyID}/files

November 2018

Credit invoices

We have improved the accuracy on supplier invoices. Specifically credit invoices where the amounts did not always exist on the invoice.

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices
PUT ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

October 2018

Invoice number

We have improved the accuracy and validation techniques of the invoiceNumber parameter in the supplier invoice response format.

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices

September 2018

OCR

We have increased the back end OCR accuracy, while decreasing the time for OCR conversion.

Some files will now get processed quicker than before.

Affected resources:

POST ...{api}/{version}/companies/{companyID}/files

July 2018

Extended

We have improved the accuracy of the following parameters in the extended object:

  • corporateIdentityNumbers

  • bankAccountNumbers

  • plusGiroNumbers

Affected resources:

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices?extended=true
GET ...{api}/{version}/companies/{companyID}/files/{fileID}/receipts?extended=true

May 2018

Progenitors

The progenitors resource will allow you to share memories between companies.

{
"progenitorID": "c1",
"startDateTime": "2018-01-01 00:00:00",
"stopDateTime": "2018-12-31 23:59:59",
"supplierInvoices": true,
"receipts": true
}

Add a progenitor

POST ...{api}/{version}/companies/{companyID}/progenitors

Retreive all progenitors

GET ...{api}/{version}/companies/{companyID}/progenitors

Retreive a progenitor

GET ...{api}/{version}/companies/{companyID}/progenitors/{progenitorID}

Update a progenitor

PUT ...{api}/{version}/companies/{companyID}/progenitors/{progenitorID}

Delete a progenitor

DELETE ...{api}/{version}/companies/{companyID}/progenitors/{progenitorID}
Added PATCH files

We have added another operation on the files resource that allows users to change how the file was sorted.

You can change the type and verificationSeries parameters in the files resource as you wish.

PATCH ...{api}/{version}/companies/{companyID}/files/{fileID}
{
"type": "Receipt",
"verificationSeries": "A"
}
Svefaktura

The files resource now accepts Svefaktura as a format. This feature is still in BETA but will be worked upon further.

January 2018

Extended

We have added extended information to responses.

{
"success": true,
"data": "",
"extended": "",
"meta": "",
"time": "2018-01-12 07:40:48"
}

In order to receive any information in extended, set the query parameter extended to true when extracting information from supplier invoices or receipts.

GET ...{api}/{version}/companies/{companyID}/files/{fileID}/supplierInvoices?extended=true
GET ...{api}/{version}/companies/{companyID}/files/{fileID}/receipts?extended=true
Due Date

We have added due date to supplier invoices as an optional parameter.

{
"supplierID": "1",
"invoiceDate": "2018-01-01",
"dueDate": "2018-01-27",
"invoiceNumber": "",
"ocrNumber": "707902514856",
"totalSum": "3119.00",
"vat": "623.82",
"accounts": [
{
"account": "6210",
"debit": "2495.29",
"credit": "0.00"
},
{
"account": "3740",
"debit": "0.00",
"credit": "0.11"
}
]
}
PlusGiro

We have also added plusgiro to the company and supplier resources.

{
"companyID": "10",
"companyName": "Flyttservice Kalmar Lan AB",
"active": true,
"corporateIdentityNumber": "556754-9273",
"bankAccountNumber": "",
"plusGiroNumber": "123456-6",
"iban": ""
}
{
"supplierID": "20",
"supplierName": "City Network",
"corporateIdentityNumber": "556630-7806",
"bankAccountNumber": "670-7525",
"plusGiroNumber": "123456-6",
"iban": ""
}

September 2017

Files

We have added more parameters to this resource in order to provide more detailed information about a file and its current state.

{
"fileID": "100",
"fileName": "samplereceipt.jpg",
"status": "READY",
"type": "Receipt",
"verificationSeries": "A"
}

The parameter status can be used to identify if a file is ready to be extracted from.

We have added another operation on the files resource that returns detailed information about the file.

GET ...{api}/{version}/companies/{companyID}/files/{fileID}
Webhooks

Webhooks are now available for testing.

May 2017

The API has only gone through minor changes this month.

We have added a requested response element that will help you when an extraction fails due to missing supplier

Meta data

If AzoraOne fails to match a supplier invoice to an existing supplier upon extraction, guiding information will be supplied in the response. At element in the data object you will find all corporate identity numbers, bank account numbers and IBAN numbers that have been possible to extract from the document.

You might use this data to update an existing supplier with more information or, more likely, to add a non-existent supplier to your application.

April 2017

There have been some changes to the API this month. Here you can read about all of the changes in order to understand them better.

Receipts

Now you will be able to extract data from yet another document type, receipts. Upload a file and extract data directly from it within seconds. There is no need for adding suppliers with this resource. Simply upload, extract and bookkeep.

The new resource can be reached in the same way as supplier invoices.

Extract:

GET ...{api}/api/companies/{companyID}/files/{fileID}/receipts

Bookkeep:

PUT ...{api}/api/companies/{companyID}/files/{fileID}/receipts
Multiple suppliers

Added operation for adding multiple suppliers in a single request

Send multiple suppliers to:

…{api}/api/companies/{companyID}/suppliers/multiple

This feature currently only applies to the suppliers resource. Other resources, such as files and companies, only support one entity per request.

More file formats supported

A POST to the files resource now supports the following formats:

  • PDF

  • PNG

  • JPG

  • JPEG

In order to handle those formats, the Content-Type has to be set in the request body.

AzoraOne is a product developed by Arkimera Robotics.