Workflow
Register the supplier
Call the Register Supplier API to register the supplier’s information with Bolta. Save the
supplierKey returned after registration.Issue a certificate registration URL
Call the Retrieve Certificate Registration URL API to obtain a URL where the supplier can register their certificate.
Supplier registers the certificate
The supplier accesses the issued URL and registers their certificate. This step must be performed by the supplier directly. For the redirect return and result verification after registration, see Certificate Registration Integration.
Request reverse issuance
Call the Request Reverse Issuance API. Pass the supplier’s
supplierKey in the Supplier-Key header.Obtain the approval URL
Call the Retrieve Reverse Issuance Approval URL API to obtain the approval page URL. The generated URL is valid for 10 minutes.
Simple approval
The supplier accesses the approval URL and approves the tax invoice. Expose the URL from the platform by opening a new tab, navigating to the page, and so on.
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.
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 you want to complete the approval process within the platform’s UX
- When the supplier has already registered a certificate
- When you need to track the approval status in real time