Fiscal Contora
Fiscal Contora Infraestrutura fiscal
Documentação / Certificados v1
Quickstart OpenAPI IA Health
API REST fiscal

Envie o certificado A1 da empresa com um fluxo direto e previsível.

Esta documentação descreve a versão pública atual da API fiscal da Contora, com base compartilhada de empresas, certificados, chaves, filas, webhooks e artefatos para NF-e, NFC-e, NFS-e, CT-e e MDF-e. NF-e, NFC-e e NFS-e operam em produção regular; CT-e e MDF-e em produção assistida e controlada.

Atualizado em .

Upload do certificado

O certificado A1 é enviado por empresa. A plataforma usa esse material para assinar e transmitir os documentos ao ambiente fiscal correspondente.

POST https://fiscal.contora.com.br/api/v1/companies/{company}/certificate 
Content-Type: multipart/form-data

certificate: certificado.pfx
password: senha-do-certificado

Certificado da matriz em uma filial

O caso padrão é o certificado da própria empresa emitente. Para uma filial, a plataforma também aceita o certificado A1 da matriz da mesma raiz de CNPJ: a SEFAZ valida o CNPJ base (os 8 primeiros dígitos) do certificado contra o emitente, e não os 14 dígitos.

O CNPJ emitente das notas continua sendo sempre o da empresa cadastrada — usar o certificado da matriz altera apenas quem assina o XML, nunca o emitente. O caminho inverso não é aceito: a matriz não pode emitir com o certificado de uma filial.

Boas práticas

  • Prefira o certificado da própria empresa emitente; o da matriz é aceito apenas para filiais da mesma raiz.
  • Valide a senha antes de automatizar emissões em lote.
  • Monitore vencimento do A1 para não interromper a operação.