Automação do Zoho Books

Automatize fluxos de trabalho de contabilidade do Zoho Books -- crie e gerencie faturas, rastreie contas a pagar e pagamentos, consulte contatos, exporte PDFs e lide com configurações multi-organização -- tudo através de linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/zoho_books

Configuração

1. Adicione o servidor Rube MCP ao seu ambiente: https://rube.app/mcp
2. Conecte sua conta Zoho Books quando solicitado (fluxo OAuth via Composio)
3. Comece a emitir comandos em linguagem natural para automação do Zoho Books

Fluxos de Trabalho Principais

1. Descobrir Organizações

Recupere todas as organizações para o usuário autenticado. Este é um pré-requisito, pois organization_id é necessário por quase todos os outros endpoints.

Ferramenta: ZOHO_BOOKS_LIST_ORGANIZATIONS

Nenhum parâmetro necessário. Retorna IDs de organização, nomes e metadados.

Sempre chame isso primeiro para obter o organization_id necessário por todas as outras ferramentas do Zoho Books.

Exemplo de prompt:

"Liste minhas organizações do Zoho Books"

2. Criar e Gerenciar Faturas

Crie faturas com itens de linha, gerencie faturas existentes e exporte-as como PDFs.

Criar: ZOHO_BOOKS_CREATE_INVOICE

Parâmetros chave:

• organization_id -- organização de destino (obrigatório)
• customer_id -- cliente a ser faturado (obrigatório)
• line_items -- array de itens de linha (obrigatório), cada um com:
  • item_id ou name -- referência a item existente ou criação de item ad-hoc
  • quantity, rate -- detalhes de valor
  • description, tax_id, discount -- detalhes opcionais
• date / due_date -- datas no formato YYYY-MM-DD
• invoice_number -- número personalizado (definir ignore_auto_number_generation=true)
• discount / discount_type -- desconto no nível da fatura (entity_level ou item_level)
• notes / terms -- impresso na fatura
• send -- enviar a fatura por e-mail imediatamente após a criação
• payment_terms -- número de dias para pagamento

Listar: ZOHO_BOOKS_LIST_INVOICES

Parâmetros chave:

• organization_id (obrigatório)
• status -- sent, draft, overdue, paid, void, unpaid, partially_paid, viewed
• customer_id / customer_name -- filtrar por cliente
• date_start / date_end -- filtro de intervalo de datas (YYYY-MM-DD)
• search_text -- número da fatura, referência ou nome do cliente para pesquisa
• sort_column / sort_order -- ordenar por date, due_date, total, balance, etc.
• page / per_page -- paginação (máximo de 200 por página)

Obter detalhes: ZOHO_BOOKS_GET_INVOICE -- buscar por invoice_id com formato accept: json, pdf, ou html

Excluir: ZOHO_BOOKS_DELETE_INVOICE -- remover por invoice_id

Exportação em massa: ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF -- mesclar até 25 faturas em um único PDF

Impressão em massa: ZOHO_BOOKS_BULK_PRINT_INVOICES -- gerar um PDF combinado pronto para impressão para até 25 faturas

Exemplo de prompt:

"Crie uma fatura para o cliente 1234567890 com 2 itens de linha: 10 unidades do Widget A a R$ 25 cada, e 5 unidades do Widget B a R$ 50 cada, com vencimento em 30 dias"

3. Rastrear e Gerenciar Contas a Pagar

Listar, visualizar e atualizar contas a pagar de fornecedores com filtragem abrangente.

Listar: ZOHO_BOOKS_LIST_BILLS

Parâmetros chave:

• organization_id (obrigatório)
• status -- paid, open, overdue, void, partially_paid
• vendor_id / vendor_name_contains -- filtrar por fornecedor
• bill_number / bill_number_contains -- filtrar por número da conta
• date_start / date_end -- filtro de intervalo de datas
• total_greater_than / total_less_than -- filtros de intervalo de valor
• sort_column / sort_order -- ordenar por vendor_name, bill_number, date, due_date, total, etc.
• page / per_page -- paginação (máximo de 200)

Obter detalhes: ZOHO_BOOKS_GET_BILL -- buscar conta completa por bill_id e organization_id

Atualizar: ZOHO_BOOKS_UPDATE_BILL -- modificar conta existente (requer bill_id, organization_id, vendor_id, bill_number)

Exemplo de prompt:

"Liste todas as contas a pagar vencidas da minha organização, ordenadas por data de vencimento"

4. Consultar Contatos

Pesquisar e filtrar contatos (clientes e fornecedores) para uso em faturas e contas a pagar.

Ferramenta: ZOHO_BOOKS_LIST_CONTACTS

Parâmetros chave:

• organization_id (obrigatório)
• contact_type -- customer ou vendor
• contact_name_contains / contact_name_startswith -- filtros de nome
• email_contains / email_startswith -- filtros de e-mail
• company_name_contains -- filtro de nome da empresa
• filter_by -- filtro de status: Status.Active, Status.Inactive, Status.Duplicate, etc.

…