Onboarding da integração
Este roteiro apresenta a sequência recomendada para colocar uma integração em funcionamento sem pular etapas importantes.
Ordem recomendada
- Crie sua conta no Conota.
- Gere uma API Key no painel.
- Armazene a chave em um gerenciador de segredos ou variável de ambiente.
- Faça uma primeira chamada de consulta para validar autenticação e conectividade.
- Cadastre o emitente que utilizará a API.
- Envie e valide o certificado digital A1.
- Configure os dados fiscais do tipo de documento que será emitido.
- Monte um primeiro payload seguindo a Referência da API.
- Emita em homologação.
- Guarde o
job_idretornado e acompanhe o processamento até um estado final. - Implemente webhooks ou a estratégia de consulta adequada à sua operação.
- Antes de escalar, valide rejeições, retentativas, idempotência, logs e armazenamento dos arquivos retornados.
Antes da primeira emissão
Confirme que você possui:
- API Key válida;
- emitente cadastrado;
- certificado A1 válido;
- dados fiscais necessários ao documento;
- numeração e série corretas;
- integração preparada para tratar uma resposta assíncrona;
- forma de localizar a emissão depois, pelo
job_idou pela suareferencia_externa.
Confira o número antes de emitir
O Conota emite com o número que você enviar. Para saber em que ponto cada sequência está, existe uma rota dedicada:
GET /v1/empresas/numeracao
Ela devolve o número da última nota autorizada por empresa, tipo, série e ambiente.
Consulta não é reserva
Entre você ler o último número e a nota sair, outra emissão pode ter usado o seguinte. Trate o retorno como fotografia, não como garantia. Homologação e produção são sequências independentes.
Não comece pela emissão em massa
Valide uma emissão completa de ponta a ponta: envio, processamento, autorização, consulta e recuperação de XML/PDF. Depois provoque uma rejeição controlada e veja seu código tratá-la. Só então aumente o volume.