Linha de comando

Atualizado em: 17/10/2026

O nanci faz pelo terminal o mesmo que o aplicativo e usa o mesmo banco. O instalador não traz o CLI; compile com Go:

git clone https://github.com/vasfvitor/nanci
cd nanci
go build -o nanci.exe ./cmd/nanci

As opções de cada comando estão no --help, por exemplo nanci nfe list --help.

Primeiros passos

nanci company add --cnpj 12345678000199 --name "Minha Empresa" --cert C:\certs\empresa.pfx --uf SP

nanci pull --cnpj 12345678000199        # NFS-e
nanci nfe pull --cnpj 12345678000199    # NF-e
nanci cte pull --cnpj 12345678000199    # CT-e

nanci export xlsx --cnpj 12345678000199 --competencia 2026-09 --out setembro.xlsx

A senha do certificado é pedida no terminal na primeira vez e depois fica guardada no Windows. Em rotinas sem terminal, defina NANCI_CERT_PASSWORD.

Comandos

Comando	O que faz
`init`	Cria ou atualiza o banco e a pasta de dados.
`company add`, `update`, `list`	Cadastra, altera e lista empresas.
`company assign-credential --cnpj <cnpj> --credential-id <id>`	Liga a empresa a um certificado já cadastrado. O ID sai em `credential list`.
`credential add`, `list`, `update-path`	Cadastra certificados e atualiza o caminho do arquivo.
`pull`, `status`, `list`	Sincroniza, mostra a situação e lista as NFS-e.
`export xlsx`, `csv`, `zip`, `xml`, `danfse`, `danfse-zip`	Exporta as NFS-e. Nos formatos em lote, `--chave` (pode repetir) limita às notas informadas.
`nfe pull`, `status`, `list`, `pendentes`	Sincroniza e lista as NF-e e as manifestações pendentes.
`nfe ciencia`, `manifestar`	Registra a Manifestação do Destinatário.
`nfe export zip`, `xml`, `csv`, `xlsx`, `danfe-zip`, `danfe`	Exporta as NF-e em XML, planilha ou DANFE (PDF). O DANFE não sai para resumos.
`nfe import <arquivo>...`	Importa arquivos XML de NF-e e de eventos que a empresa já tem, sem consultar a SEFAZ.
`nfe buscar --chave <chave>`	Busca uma NF-e na SEFAZ pela chave de acesso.
`cte pull`, `status`, `list`	Sincroniza e lista os CT-e. `cte list --nfe <chave>` acha o frete de uma NF-e.
`cte export zip`, `xml`, `csv`, `xlsx`, `dacte`, `dacte-zip`	Exporta os CT-e. O DACTE só existe para o CT-e modelo 57.
`cte import <arquivo>...`	Importa arquivos XML de CT-e e de eventos que a empresa já tem, sem consultar a SEFAZ.
`nfe testar-conexao`, `cte testar-conexao`	Testa o certificado sem gastar consultas.
`nfe reset`, `cte reset`	Apaga as notas da empresa e recomeça a sincronização.

Atenção

nfe ciencia, nfe manifestar e os reset só simulam. Para executar, repita com --confirmar. Uma manifestação enviada não pode ser cancelada.

Cada nfe buscar gasta uma das 20 consultas por hora de NF-e da empresa, as mesmas do nfe pull.

Rotina agendada

Para o Agendador de Tarefas do Windows:

$cnpj = "12345678000199"
nanci pull --cnpj $cnpj
nanci nfe pull --cnpj $cnpj
nanci cte pull --cnpj $cnpj
nanci export zip --cnpj $cnpj --incremental --out "D:\fiscal\nfse-$(Get-Date -Format yyyyMMdd).zip"

Rodar de hora em hora é seguro: se a SEFAZ ainda não permitir nova consulta, o comando avisa e não envia nada. Os logs vão para o terminal; redirecione com 2>> nanci.log se quiser guardá-los.

CT-e Certificado A1