Workflow
Register the issuer
Call the Register Issuer API to register the supplier as an issuer.
Request reverse issuance
Call the Request Reverse Issuance API. Set the approval email recipient in
supplier.manager.email in the request body.Send the approval-request email
Bolta sends the approval-request email. The supplier clicks the link in the email and approves on Bolta.
Supplier approval
The supplier accesses Bolta through the email link and approves the tax invoice.
Receive the issuance-complete webhook
Once approval is complete, a webhook sends a notification that includes
taxInvoiceUrl.Retrieve the tax invoice (optional)
Check the issuance result with the Retrieve Tax Invoice API.
Handling duplicate requests
You can include the optionalBolta-Client-Reference-Id header in a reverse issuance request. Enter a non-blank value between 1 and 255 characters, and use a new value for each issuance request.
If the same API key reuses a value, the API returns HTTP 400 with INVALID_REQUEST, even when the request body is identical. If you do not receive a response, do not submit the reverse issuance request again. Check whether it was accepted with the client reference status API. See the Authentication guide for the full rules.
Canceling a reverse issuance request
Before approval, you can cancel the reverse issuance request by calling the Cancel Reverse Issuance Request API.- On a successful cancellation, the response is returned with HTTP 200.
- If the request has already been approved, canceled, or issued, an error is returned.
When this fits
- When it is difficult to obtain the supplier’s certificate in advance
- When the supplier prefers a simple email-based approval
- When the platform wants to delegate approval to Bolta rather than building its own approval UI