This is the right section for you if you are acting as a supplier and looking to send invoices to your customers.
Throughout this guide you will learn how to send invoices to the Procuros API.
PHP examples are included but you will likely also want to look at the relevant API calls in the API reference.
These are usually the steps taken when sending an invoice to Procuros:
You will need an API token to authenticate. We use a bearer token which has to be included in each request you send to the API.
Please read the Authentication section of our API reference for a detailed description.
The API will return a 2xx
status code for successful requests. Anything else indicates an error.
Please read the Errors section of our API reference for a detailed description plus examples of how to handle them.
The API call Send transaction is used to create transactions, including invoices.
The following fields are required:
type
(Transaction type. In this case INVOICE
)content
(The details of the invoice items.)Inside the content
you will need to build all invoice items. All details can be found in the INVOICE
schema as described in the API reference.
An example request would look like:
Finally, as per the instructions mentioned under Tracking Document Status you must now track the status of the document locally, based on the returned HTTP response.
The document should be marked with either status TRANSMITTED
or NO_ACTION
. If there is an error with the document and it is not accepted, do not mark it with a status so it may be retried. For more information on retrying failed documents, please see: Retrying Documents.
For example:
When it comes to sending invoices, there are a number of advanced cases, such as Invoice Modifications.
Please see the Features section of our API reference for a detailed description of all advanced use cases.
This is the right section for you if you are acting as a supplier and looking to send invoices to your customers.
Throughout this guide you will learn how to send invoices to the Procuros API.
PHP examples are included but you will likely also want to look at the relevant API calls in the API reference.
These are usually the steps taken when sending an invoice to Procuros:
You will need an API token to authenticate. We use a bearer token which has to be included in each request you send to the API.
Please read the Authentication section of our API reference for a detailed description.
The API will return a 2xx
status code for successful requests. Anything else indicates an error.
Please read the Errors section of our API reference for a detailed description plus examples of how to handle them.
The API call Send transaction is used to create transactions, including invoices.
The following fields are required:
type
(Transaction type. In this case INVOICE
)content
(The details of the invoice items.)Inside the content
you will need to build all invoice items. All details can be found in the INVOICE
schema as described in the API reference.
An example request would look like:
Finally, as per the instructions mentioned under Tracking Document Status you must now track the status of the document locally, based on the returned HTTP response.
The document should be marked with either status TRANSMITTED
or NO_ACTION
. If there is an error with the document and it is not accepted, do not mark it with a status so it may be retried. For more information on retrying failed documents, please see: Retrying Documents.
For example:
When it comes to sending invoices, there are a number of advanced cases, such as Invoice Modifications.
Please see the Features section of our API reference for a detailed description of all advanced use cases.