Skip to main content
After the platform requests reverse issuance, it obtains an approval URL and the supplier approves directly within the platform.

​
Workflow

Register the issuer

Call the Register Issuer API to register the supplier as an issuer. Save the returned issuerId.

Issue a certificate registration URL

Use issuerId with the Retrieve Issuer 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 directly. For the redirect return and result verification after registration, see Certificate Registration Integration.

Request reverse issuance

Call the Request Reverse Issuance API.

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. Show the URL from the platform in a new tab or by navigating to the page.

Receive the issuance-complete webhook

Once approval is complete, Bolta sends a webhook notification containing taxInvoiceUrl.

Retrieve the tax invoice (optional)

Check the issuance result with the Retrieve Tax Invoice API.

​
Handling duplicate requests

You can include the optional Bolta-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 reuse rules.

​
Checking request status

Call the Retrieve Reverse Issuance Request Status API to see which stage a reverse issuance request is in. For FAILED, check failure.stage. SUBMISSION means the request never reached the supplier. Send a new request, and if you use Bolta-Client-Reference-Id, set a value you have not used before. ISSUANCE means the supplier approved but issuance failed, so check failure.code and failure.message for the cause.

​
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 API returns HTTP 200.
  • If the request has already been approved, canceled, or issued, the API returns an error. To check the status before canceling, call the Retrieve Reverse Issuance Request Status API.
After the issuance deadline, the API returns a 400 error when you retrieve the approval URL. Update the date and submit the request again. Check the deadline with the Tax Invoice Issuance Deadline API before sending the request.

​
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 within the platform

​
Difference from email-approved reverse issuance