consultar_cnpj

Consulta os dados cadastrais de um CNPJ na Receita Federal (razão social, endereço, situação, CNAE). Use para validar dados de emitente ou destinatário antes de emitir.

consultar_cep

Consulta o endereço de um CEP (logradouro, bairro, município, UF).

listar_empresas

Lista as empresas (emitentes) cadastradas na conta, com CNPJ, razão social e município.

Sem parâmetros.

status_certificados

Relatório de validade dos certificados A1 de todas as empresas da conta. Use para saber quais estão vencidos ou perto de vencer — certificado vencido faz TODAS as emissões serem rejeitadas.

Sem parâmetros.

localizar_nota

Encontra uma emissão pela referência externa do cliente OU por atributos de negócio (emitente, destinatário, valor, período). Use quando não se tem o job_id. Zero resultados é forte indício de que a emissão nunca aconteceu.

consultar_emissao

Retorna a situação de uma emissão pelo job_id: status, nota (número, chave de acesso, motivo), arquivos e erro.

itens_da_nota

Retorna os itens de uma emissão pelo job_id, com código, descrição, NCM, CFOP, valores e os grupos tributários de cada item (ICMS, PIS, COFINS e IBS/CBS). Use para descobrir QUAL produto causou uma rejeição: quando o fisco aponta um item, a resposta traz "item_rejeitado" já identificado. Funciona para qualquer status — inclusive rejeitadas e falhas, porque a fonte é o payload enviado, não o XML autorizado. Fluxo típico: notas_rejeitadas → pegue um job_id → itens_da_nota.

consultar_emissoes_em_lote

Consulta o status de até 200 job_ids numa só chamada. Ids desconhecidos voltam como "nao_encontrado".

zips_mensais_disponiveis

Lista os pacotes ZIP mensais de XMLs da conta — um por tipo de documento (NF-e/NFS-e/NFC-e) e por mês, gerados automaticamente no dia 1º com os XMLs do mês anterior e mantidos por 15 meses. Cada item traz competência, tipo, quantidade de arquivos, tamanho e "completo": quando false, o pacote foi gerado antes do fechamento do mês e ainda será refeito. Use antes de baixar_zip_mensal para saber o que existe.

Sem parâmetros.

baixar_zip_mensal

Devolve um LINK de download (válido por 1 hora) do pacote ZIP de XMLs de um mês e tipo de documento. A ferramenta entrega o endereço, não o arquivo: repasse o link para a pessoa baixar. Qualquer um com o link consegue baixar enquanto ele valer — não publique em lugar aberto. Se não existir pacote para o período, use zips_mensais_disponiveis para ver o que há.

baixar_arquivo_da_nota

Devolve um LINK de download (válido por 1 hora) de um arquivo de uma emissão específica: xml (o documento autorizado), pdf (DANFE/DANFSE), xml_cancelamento ou log. A ferramenta entrega o endereço, não o arquivo. Qualquer um com o link baixa enquanto ele valer. Use consultar_emissao ou localizar_nota para obter o job_id.

listar_notas

Lista as notas da conta, da mais recente para a mais antiga, com filtros por tipo, situação e empresa.

resumo_emissoes

Relatório consolidado do período: quantas notas foram EMITIDAS com sucesso e o valor somado, separado por tipo (NF-e/NFS-e/NFC-e), mais as que ficaram COM ERRO e os principais motivos. Use para perguntas do tipo "quanto foi emitido no dia X". Para um único dia, informe a mesma data em de e ate. Sem datas, usa do 1º dia do mês até hoje.

emissoes_com_erro

Lista (ou resume) os jobs que FALHARAM num período — emissões que nem viraram nota. Janela máxima de 90 dias; sem datas, últimos 7 dias. Use formato=resumo para agrupar por motivo.

notas_rejeitadas

Lista (ou resume) as notas que foram REJEITADAS pelo fisco — diferente de emissoes_com_erro, aqui o documento chegou a ser processado. Janela máxima de 90 dias; sem datas, últimos 7 dias.