Procountor API interface
The Procountor API interface enables importing data to and exporting data from the program via the integrations built for the interface.
The Procountor API interface does not control the content or amount of the data, the customer is responsible for these. As regards the accuracy of data, our API interface uses the same verifications and validations as the saving of similar data manually via the user interface.
How does one ensure that the same amount of data is transferred from the source system to Procountor and from Procountor to the other system?
Importing receipts to procountor from another system
Importing receipts (for example, invoices or journal receipts) successfully via the Procountor API interface (= saving the receipt in Procountor) returns a standard acknowledgment (200 OK) to the interface. The acknowledgement is accompanied by the receipt information that has been saved in Procountor, along with the internal Ids needed for identifying and further processing the receipt (invoiceId, invoice no., ledgerReceiptId).
The aforementioned information that is returned from the Procountor API interface enable the integrator to authenticate the information that has been transferred to Procountor. The integration provider is responsible for collecting this data from the return message, comparing it with the source system data, using it to authenticate the data transfer and displaying it to the integration user.
If the receipt transfer fails (the receipt is not saved in Procountor), the interface displays an error message in real time during the transfer. The validation error codes contained in the error message are listed on the API developer site. The integration provider is responsible for collecting any messages the interface may send, along with their acknowledgements, and show them to the program user, using the method selected by the integration provider.
In short, the Procountor API interface enables the monitoring of data transfer (succeeded or failed), but the integration provider is responsible for the implementation and for presenting the results to the system user. Ultimately, the customer is responsible for data comparison and reconciliation between the source system and Procountor.
Exporting data from procountor to another system
Retrieving data for the Procountor API interface requires specifying the data and implementing the relevant search criteria against the Procountor API interface, taking into account the features that correspond to our API record specifications. The Procountor API interface cannot be used, for example, to update the statuses of retrieved receipts to indicate their successful or failed transfer to an external target system.
The search criteria used in the integration cannot be controlled via Procountor, but the integration provider is responsible for using sufficiently wide search criteria and interpreting the search results. Accountor Finago has documented the most common integration use cases from the point of view of the Procountor API interface, underlining some important details in its electronic instruction manual. The instructions will be complemented and specified further, as needed.
Ultimately, the customer is responsible for data comparison and reconciliation between the Procountor and the target system.