Automação do QuickBooks

Automatize operações do QuickBooks Online, incluindo a criação de faturas, gerenciamento de clientes, consulta de contas e listagem de faturas para relatórios financeiros.

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

Configuração

Esta habilidade requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que uma conexão ativa exista para o toolkit quickbooks. Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Fluxos de Trabalho Principais

1. Criar uma Fatura

Crie uma nova fatura para um cliente com itens de linha.

Ferramenta: QUICKBOOKS_CREATE_INVOICE

Parâmetros Chave:

• customer_id (obrigatório) -- ID do cliente (CustomerRef.value)
• lines (obrigatório) -- Array de objetos de item de linha. Cada um deve incluir:
  • DetailType -- por exemplo, "SalesItemLineDetail"
  • Amount -- Total do item de linha
  • SalesItemLineDetail -- Objeto com ItemRef contendo value (ID do item)
• minorversion -- Parâmetro opcional de versão da API

Exemplo:

Tool: QUICKBOOKS_CREATE_INVOICE
Arguments:
  customer_id: "21"
  lines: [
    {
      "DetailType": "SalesItemLineDetail",
      "Amount": 150.00,
      "SalesItemLineDetail": {
        "ItemRef": {"value": "1", "name": "Services"}
      }
    }
  ]

Pré-requisitos: Resolva o ID do cliente usando QUICKBOOKS_READ_CUSTOMER ou crie um com QUICKBOOKS_CREATE_CUSTOMER. Resolva os IDs de item/conta usando QUICKBOOKS_QUERY_ACCOUNT.

2. Gerenciar Clientes

Crie e leia registros de clientes.

Ferramentas:

• QUICKBOOKS_CREATE_CUSTOMER -- Criar um novo cliente
• QUICKBOOKS_READ_CUSTOMER -- Ler um cliente por ID

Parâmetros Chave para QUICKBOOKS_CREATE_CUSTOMER:

• display_name -- Nome de exibição (deve ser único entre clientes, fornecedores, funcionários; máximo de 500 caracteres)
• given_name -- Primeiro nome (máximo de 100 caracteres)
• family_name -- Sobrenome (máximo de 100 caracteres)
• middle_name -- Nome do meio (máximo de 100 caracteres)
• title -- Título, por exemplo, "Mr.", "Dr." (máximo de 16 caracteres)
• suffix -- Sufixo do nome, por exemplo, "Jr." (máximo de 16 caracteres)

Pelo menos um de display_name, title, given_name, middle_name, family_name ou suffix é necessário.

Parâmetros Chave para QUICKBOOKS_READ_CUSTOMER:

• customer_id (obrigatório) -- ID do cliente a ser lido

Exemplo:

Tool: QUICKBOOKS_CREATE_CUSTOMER
Arguments:
  display_name: "Acme Corporation"
  given_name: "John"
  family_name: "Doe"

3. Consultar e Ler Contas

Recupere informações de contas para uso em itens de linha de faturas e relatórios financeiros.

Ferramentas:

• QUICKBOOKS_QUERY_ACCOUNT -- Executar uma consulta em contas
• QUICKBOOKS_READ_ACCOUNT -- Ler uma conta específica por ID

Parâmetros Chave para QUICKBOOKS_QUERY_ACCOUNT:

• query (obrigatório) -- String de consulta semelhante a SQL, por exemplo, "SELECT * FROM Account WHERE AccountType = 'Income'"

Exemplo:

Tool: QUICKBOOKS_QUERY_ACCOUNT
Arguments:
  query: "SELECT * FROM Account WHERE AccountType = 'Income' MAXRESULTS 10"

4. Listar e Filtrar Faturas

Recupere faturas com paginação e filtragem opcionais.

Ferramenta: QUICKBOOKS_LIST_INVOICES

Etapas:

1. Chame QUICKBOOKS_LIST_INVOICES com parâmetros de paginação
2. Use start_position e max_results para percorrer os resultados
3. Filtre por critérios específicos conforme necessário

Plano de Execução Recomendado

1. Resolva o cliente usando QUICKBOOKS_READ_CUSTOMER (se você tiver um ID de cliente) ou crie um com QUICKBOOKS_CREATE_CUSTOMER
2. Resolva os itens/contas de receita usando QUICKBOOKS_QUERY_ACCOUNT e QUICKBOOKS_READ_ACCOUNT para obter os IDs de conta ou item para os itens de linha da fatura
3. Crie a fatura usando QUICKBOOKS_CREATE_INVOICE com o customer_id resolvido e itens de linha bem formatados
4. Verifique a criação usando QUICKBOOKS_LIST_INVOICES para localizar a nova fatura por ID ou DocNumber

Armadilhas Conhecidas

…