API pública para consultar NF-e e CT-e recebidos e emitidos
· 5 min de leitura
A mesma API pública que já entrega NFS-e recebidas também entrega NF-e e CT-e (recebidos e emitidos) pelo mesmo endpoint de documentos, sem exigir uma integração separada por tipo de documento.
Um endpoint, três tipos de documento
A listagem de documentos aceita o tipo (NFS-e, NF-e ou CT-e) como filtro, então um sistema que já consome NFS-e por essa API só precisa passar a incluir os outros dois tipos na mesma chamada: não é necessário aprender um endpoint novo nem gerenciar uma chave de API diferente para cada documento.
Recebidos e emitidos na mesma consulta
Assim como no acompanhamento de NF-e e CT-e emitidas, a API devolve documentos nos dois papéis (o que a empresa recebeu de terceiros e o que ela mesma emitiu), permitindo montar uma visão completa da exposição fiscal num só lugar.
Perguntas frequentes
Preciso de uma chave de API separada para NF-e e CT-e?
Não. A mesma chave de API usada para NFS-e já dá acesso a NF-e e CT-e, desde que a empresa correspondente tenha esses tipos de documento ligados no cadastro.
A resposta da API muda de formato entre os tipos de documento?
A estrutura geral do documento (identificação, datas, tipo, chave de acesso) é comum aos três tipos; os campos específicos de cada documento (itens de produto, dados de transporte) ficam num bloco próprio, sem interferir na estrutura comum.
A documentação completa dos endpoints, parâmetros e exemplos está na documentação da API pública da IntegroBR.