General
User rights and approval circulation settings of Procountor (if used) will affect to the process of purchase invoice handling via Procountor API too.
When posting and/or updating purchase invoices via API, “invoiceApprovalInformation” part of the invoice (json) request will be validated and checked in Procountor API interface as follows:
- If the "invoiceApprovalInformation" element is not imported at all in the API request (POST / invoices), environment-specific circulation settings (if set) are used.
- If the invoice is targeted to a supplier with partnerId, the default verifiers / approvers set behind the supplier (if set) are used.
- If the "invoiceApprovalInformation" element is left blank in the API request: {}, approvers and verifiers are not set on the invoice at all, regardless of the environment settings or any defaults.
Endpoints to be used and other requirements
GET /company/invoicecirculation/settings endpoint returns the circulation settings of the Procountor environment.
GET /company/invoicecirculation/verifierlists endpoint returns the verifier lists, if created in the Procountor environment
GET /company/invoicecirculation/verifierlists/{id} endpoint returns a separate list of verifiers, if created.
Setting of verifiers and approvers to purchase invoice in API request does not require any verifiers lists in Procountor, but verifiers can be set also without lists. But note, that it is not easy to retrieve ids of the all users through the API interface.