Arquivos: XML e DANFE

Depois da autorização, os arquivos ficam disponíveis por job_id.

GET /v1/nfe/{job_id}/file/{tipo}

tipo	Conteúdo
xml	XML autorizado (com o protocolo)
pdf	DANFE em A4
xml_cancelamento	XML do evento de cancelamento, quando houver
log	log técnico do processamento

Existem também rotas genéricas por job, válidas para qualquer tipo de documento:

GET /v1/jobs/{job_id}/arquivos          # o que existe para este job
GET /v1/jobs/{job_id}/file/{tipo}       # baixa o arquivo
GET /v1/jobs/{job_id}/download/{tipo}   # devolve a URL assinada, sem baixar

Não sabe o que o job produziu? Pergunte

GET /v1/jobs/{job_id}/arquivos lista o que existe, com tamanho e URL pronta. Um job de cancelamento, por exemplo, tem xml_cancelamento e log, mas não tem xml — pedir o xml dele devolve 404.

Guarde o XML

O XML é o documento fiscal — o PDF é só a representação

A obrigação de guarda recai sobre o XML autorizado. O DANFE pode ser regerado a partir dele; o contrário não é verdade.

A retenção dos arquivos no Conota depende do plano. Sua operação deve armazenar os XMLs no próprio ambiente — não trate a API como arquivo definitivo.

Pacotes mensais

Para fechamento contábil, o Conota gera pacotes ZIP com os XMLs do mês anterior:

GET /v1/arquivos/zips                                       # o que está disponível
GET /v1/arquivos/zip-mensal?tipo=nfe&competencia=2026-08    # baixa

Os pacotes são gerados no dia 1º de cada mês e o download vem por URL assinada, com validade curta.