Skip to main content
POST
Upload your digital certificate
Send the certificate as multipart/form-data: the file in the part file and its password in the part pwsCertificate. It is your organization’s ICP-Brasil A1 certificate (a .pfx or .p12 file of up to 1 MB), which signs each NFSe at the city hall. One certificate serves both the TEST and the LIVE environment, and uploading a new one replaces the previous. Once it is uploaded, hasCertificate is true on Get your tax issuer. If the tax provider rejects the request, the error is returned with the provider’s error code and a status of 400, 409, 422 or 502.

Path Parameters

realmId
string<uuid>
required

ID of your realm.

Format: UUID

organizationId
string<uuid>
required

ID of the organization.

Format: UUID

taxIssuer
string<uuid>
required

ID of your tax issuer — the id returned by Get your tax issuer.

Format: UUID

Body

multipart/form-data
file
file
required

Your digital certificate (ICP-Brasil A1), as a multipart/form-data file part. It must be a .pfx or .p12 file (or be sent with the content type application/x-pkcs12 or application/pkcs12) of up to 1 MB (1,048,576 bytes).

pwsCertificate
string
required

Password of the certificate file.

Minimum string length: 1
Example:

"your-certificate-password"

Response

No Content. The operation succeeded and the response has no body.