We use cookies to improve your experience and analyze site traffic. By clicking “Accept”, you agree to our use of cookies.

Learn more about our privacy practices
Corvo
English

Checklist de integração

Sequência recomendada do primeiro acesso à produção.

  • Obter uma chave test com escopo adequado — cadastro de empresa/certificado exige full_access; uma chave invoices_read_write pode emitir com cadastro prévio.
  • Cadastrar ou consultar a empresa no ambiente correspondente (POST /v1/companies, GET /v1/companies/:id).
  • Verificar a prontidão da empresa: status deve ser ready e setupGaps vazio — o município fiscal (municipality_code) é obrigatório em todos os ambientes; em live, também é necessário o certificado ativo (certificate).
  • Enviar o certificado A1 (.p12) com POST /v1/companies/:companyId/certificates — o CNPJ deve corresponder ao da empresa.
  • Emitir a primeira nota no ambiente test com POST /v1/invoices, usando Idempotency-Key estável, e guardar id.
  • Acompanhar o status por GET /v1/invoices/:id ou webhooks assinados — a emissão é assíncrona.
  • Registrar um webhook (POST /v1/webhooks), guardar o secret e verificar a assinatura; conferir entregas em GET /v1/webhooks/deliveries.
  • Aguardar os documentos prontos (documentsStatus: "ready") para gerar a URL assinada e solicitar o email; conferir o estado do email separadamente (emailStatus).