Para desenvolvedores

Sua empresa a um cfy de distância

A CLI da Contabilify leva os mesmos agentes do app para o terminal. Emita notas, importe extratos e consulte o saldo sem sair do editor, ou automatize tudo em scripts.

Node.js 20 ou superior
macOS, Linux e Windows
Pagamentos sempre confirmados
$npm install -g @contabilify/cli
~ zsh
❯
Login

Sem senha no terminal

O cfy login abre uma conversa na Contabilify com um código. Você digita o código no chat, o Agente de Suporte mostra qual máquina pediu e você autoriza.

  • A sessão aparece em Minha Conta → Dispositivos como “Contabilify no terminal (CLI)”.
  • cfy logout encerra a sessão no servidor, não só na sua máquina.
  • Perfis separados para contas diferentes ou o domínio da sua contabilidade.
~ zsh
❯
Automação

Feita para scripts e CI

Com --quieto o cfy imprime só a resposta final, e as listas saem em JSON. Sem terminal, a mensagem vem da entrada padrão. Na CI, o token e o endereço vêm de variáveis de ambiente.

  • CONTABILIFY_TOKEN e CONTABILIFY_URL substituem o perfil salvo.
  • --sim confirma sozinho só a importação de extratos e os ajustes contábeis.
  • Configuração em ~/.config/contabilify, legível só pelo seu usuário.
~ zsh
❯
Referência

Os comandos do cfy

Tudo em português, com ajuda em cfy --ajuda. Os ids de conversa aceitam só o começo, como no git.

Conta

  • cfy login

    Conecta esta máquina digitando um código no chat.

  • cfy whoami

    Mostra a conta e a empresa em uso.

  • cfy logout

    Desconecta e encerra a sessão no servidor.

Empresas

  • cfy empresas

    Lista as empresas, com CNPJ e o seu papel.

  • cfy empresas usar <CNPJ>

    Define a empresa padrão (nome, CNPJ ou id).

  • --empresa <CNPJ>

    Usa outra empresa só neste comando.

Chat

  • cfy

    Chat interativo, com /anexar, /novo, /abrir-web e /sair.

  • cfy "<pedido>"

    Qualquer frase vira um pedido: responde e sai.

  • cfy chat -a fiscal -f nota.pdf

    Chama um agente e anexa arquivos de até 4 MB.

Conversas

  • cfy chats

    Lista as conversas recentes (--arquivadas para as arquivadas).

  • cfy chats abrir <id>

    Continua uma conversa; aceita o começo do id.

  • cfy chats arquivar <id>

    Tira da lista sem apagar. Também renomear e desarquivar.

Arquivos

  • cfy importar ofx <arquivo>

    Envia o extrato para o Agente Financeiro importar.

  • cfy baixar <url> -o <pasta>

    Baixa PDF e XML de notas e comprovantes, sem sobrescrever.

Avisos

  • cfy notificacoes

    Pix recebido, contas a vencer, respostas da contabilidade.

  • cfy notificacoes --seguir

    Acompanha os avisos novos em tempo real.

Segurança

Dinheiro nunca sai sem você

Pagamentos, notas, pedidos e conexões de banco sempre perguntam “Confirmar? (s/N)”, mesmo com --sim. Num script sem terminal, essas ações são canceladas em vez de confirmadas.

  • O token salvo nunca é enviado para outro endereço.
  • Quem não pode movimentar dinheiro na empresa também não pode pelo terminal.
  • Cada máquina conectada pode ser desconectada pelo app.
~ zsh
❯
Do terminal à contabilidade

Os mesmos agentes do app

O cfy conversa com a mesma Contabilify do app: o que você faz no terminal aparece nas conversas da web e do celular.

Notas fiscais

Emita e consulte NFS-e com o Agente Fiscal e baixe o PDF e o XML.

Conta digital

Saldo, extrato, Pix e boletos com o Agente Bancário.

Entradas e despesas

Importe OFX e pergunte como foi o mês ao Agente Financeiro.

Avisos

Acompanhe Pix recebidos e respostas da contabilidade no terminal.

Perguntas

Perguntas frequentes

Pronto para o primeiro cfy login?

Abra seu CNPJ grátis e use a Contabilify no app, no celular, no Chrome e no terminal.