Pasta (versão prévia)

Pergunte aos seus livros qualquer coisa: transações, IVA, contas, declarações e relatórios.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Logic Apps Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Azure Governamental regiões
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Name Maleta
URL https://briefcase.so
Email support@briefcase.so
Metadados do conector
Publicador Maleta
Website https://briefcase.so
Política de Privacidade https://briefcase.so/privacy-policy
Categories IA; Dados

Maleta

A pasta é um software contábil para empresas do Reino Unido e seus contadores. Ele lê recibos, faturas e linhas bancárias, codifica-os com o raciocínio mostrado e mantém os livros atualizados em Briefcase Ledger, Xero ou QuickBooks.

Esse servidor MCP permite que Microsoft 365 Copilot e Copilot Studio agentes trabalhem com a Briefcase como o usuário conectado: responda perguntas sobre livros de um cliente, carregue documentos, revise e publique transações, prepare declarações de despesas, gerencie o fechamento financeiro e, para clientes do Razão de Pasta, execute relatórios, poste diários manuais e gere faturas de vendas.

Publicador

Briefcase Tech Ltd (https://briefcase.so)

Prerequisites

  • Uma conta de pasta (https://app.briefcase.so) com acesso a pelo menos um cliente.
  • Assistentes de IA permitidos no workspace da Pasta. Os administradores do workspace controlam isso nos assistentes de IA de Configurações > .

Operações com suporte

52 ferramentas, agrupadas por área. Cada ferramenta atua como o usuário conectado, nos clientes escolhidos ao se conectar.

Conta e clientes

  • briefcase_get_connection (Obter conexão): identifique o usuário conectado da Pasta, o workspace e essa concessão de assistente.
  • briefcase_list_clients (Listar clientes): Listar clientes que esse usuário pode acessar sob a concessão, com contagens aguardando revisão, processamento, com falha e publicadas.
  • briefcase_get_client (Obter cliente): um cliente: nome, tipo de razão (Xero, QuickBooks ou Razão de Pasta), email de encaminhamento de documentos, se o Autopilot está ativado e, para clientes do Razão de Pasta, a data de bloqueio geral do razão.
  • briefcase_list_users (Listar usuários): listar usuários de workspace ou cliente permitidos com funções, permissões efetivas e atribuições de cliente visíveis. As restrições de diretório de usuário existentes se aplicam.
  • briefcase_list_contacts (Listar contatos): pesquise fornecedores, clientes e reclamantes por um cliente.
  • briefcase_get_contact (Obter contato): contate os detalhes de uma ID associada ao cliente.
  • briefcase_get_reference_data (Obter dados de referência): contas de pesquisa, taxas de impostos, categorias de acompanhamento, moedas, empresas, propriedades, reclamantes ou itens de vendas (Razão de Pasta; usado por briefcase_raise_sales_invoice). Retorna até 150 itens com o total total; restringir contas com account_class ou search_term.
  • briefcase_list_ai_memories (Listar memórias de IA): as memórias de IA ativas para um cliente: a pasta de regras de processamento se aplica a seus documentos, como codificar um fornecedor ou qual convenção de data de conclusão usar.

Documentos e transações

  • briefcase_create_document_upload (Criar upload de documento): inicie um upload: retorna uma URL de upload de curta duração, um link de upload do navegador de pasta e o email de encaminhamento do cliente. Quando o arquivo é fornecido, a Pasta baixa esse arquivo em si e o upload está pronto para ser enviado. A observação carrega as instruções de processamento do usuário, conforme digitado no aplicativo, e a Pasta as aplica: a conta ou a finalidade de codificar, a categoria de acompanhamento, o projeto ou o local (Xero e QuickBooks), divisões percentuais, manter linhas separadas ou combiná-las e arquivar um recibo como declaração de despesa de um funcionário (adicionada à declaração mensal).
  • briefcase_submit_document (Enviar documento): envie um arquivo carregado por meio de briefcase_create_document_upload para processamento, exatamente como um upload no aplicativo Briefcase. Retorna uma operação a ser seguida com briefcase_get_operation; um documento que não produz nenhuma transação é relatado como uma falha.
  • briefcase_get_operation (Obter operação): status durável para uma gravação ou gravação negada. Leituras bem-sucedidas não são armazenadas.
  • briefcase_get_attachment_download (Obter download de anexo): URL de download de curta duração para um anexo associado ao cliente, incluindo um PDF da fatura de vendas aumentada (pdf.attachment_id de briefcase_get_sales_invoice). Os links assinados param de funcionar no expires_at.
  • briefcase_list_transactions (Listar transações): pesquise e filtre aguardando revisão, processamento, transações publicadas ou arquivadas.
  • briefcase_get_transaction (Obter transação): detalhes da transação visível ao cliente, itens de linha, anexos, explicação do Autopilot e bloqueadores de publicação.
  • briefcase_update_transaction (Atualizar transação): salvar edições de transação sem publicação. A última gravação vence. Somente os campos fornecidos são alterados. Quando line_items é fornecido, é o conjunto completo a ser mantido: os itens de linha existentes deixados de fora são removidos; omita line_items para deixá-los inalterados.
  • briefcase_publish_transaction (Publicar transação): Publique uma transação revisada no razão. A versão prévia retorna bloqueadores e a ação do razão; execute postagens no razão de pasta ou crie o documento Xero/QuickBooks.
  • briefcase_archive_transaction (Transação de arquivo morto): arquive uma transação, revertendo suas postagens de razão quando aplicável. A visualização mostra a ação do razão e o impacto do agendamento. Há suporte apenas para DELETED.
  • briefcase_list_archived_documents (Listar documentos arquivados): transações arquivadas, candidatos, extratos bancários, demonstrativos de fornecedores e faturas de vendas.
  • briefcase_get_archived_document (Obter documento arquivado): um item arquivado por ID de arquivo morto.
  • briefcase_unarchive_document (Documento não abrangente): restaure uma transação, um candidato ou uma instrução arquivados. As faturas de vendas não podem ser desarquivadas.

Declarações de despesas

  • briefcase_list_expense_claims (Listar declarações de despesas): listar declarações de despesas para um cliente.
  • briefcase_get_expense_claim (Obter declaração de despesa): Detalhes da declaração de despesas, associação e estado de publicação.
  • briefcase_create_expense_claim (Criar declaração de despesa): crie uma declaração de uma ou mais transações não publicadas.
  • briefcase_add_claim_transactions (Adicionar transações de declaração): adicione transações não publicadas a uma declaração existente.
  • briefcase_remove_claim_transaction (Remover transação de declaração): remova uma transação de uma declaração não publicada.
  • briefcase_publish_expense_claim (Declaração de despesa de publicação): publique uma declaração de despesa usando seu requerente armazenado, data e moeda, a menos que seja substituído. A versão prévia retorna bloqueadores e os valores que seriam usados.
  • briefcase_delete_expense_claim (Excluir declaração de despesa): exclua uma declaração de despesa, revertendo seus diários de pasta ou excluindo sua fatura Xero se publicada; recusou enquanto um pagamento é aplicado. Os recibos retornam para revisão, a menos que archive_transactions seja verdadeira.

Banco

  • briefcase_list_bank_statements (Listar extratos bancários): extratos bancários para um cliente, com status de correspondência.
  • briefcase_get_bank_statement (Obter extrato bancário): detalhes e linhas do extrato bancário.
  • briefcase_list_bank_transactions (Listar transações bancárias): Linhas de alimentação bancária do razão para uma conta bancária de pasta, a mais recente primeiro. running_balance é o equilíbrio reconciliado após cada linha reconciliada, como na Pasta; Linhas não reconciliadas não têm nenhuma. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.

Fechamento financeiro

  • briefcase_list_close_items (Listar itens de fechamento): listar pagamentos antecipados, renda adiada, ativos fixos ou acréscimos. Os agendamentos têm um period_summary, não seus períodos; obter um com briefcase_get_close_item por seus períodos. Os acréscimos incluem referências pai e ajuste tipada; leituras acumuladas arquivadas retornam ajustes arquivados, não pais arquivados.
  • briefcase_get_close_item (Obter item de fechamento): um item de fechamento financeiro para o módulo especificado. Os agendamentos retornam até 120 períodos, começando um ano antes do próximo período não definido; passar period_start_date e period_end_date para outras pessoas. Um agendamento criado a partir de um documento tem um primeiro período negativo movendo o valor não lançado para o balanço; um criado sem um documento o mantém em opening_balance. Para acumulações, identifique se o destino é uma despesa recorrente pai ou um ajuste, incluindo ajustes arquivados.
  • briefcase_get_close_tracker (Obter rastreador de fechamento): Grade de período para pagamento antecipado, renda adiada e ativos fixos. A matemática do rastreador de acumulação não é essa grade. O intervalo padrão é o ano civil atual.
  • briefcase_create_close_item (Criar item close): criar um item de fechamento de rascunho aguardando revisão; nada de postagens. O pagamento antecipado e a renda adiada precisam de valor, start_date, end_date, o contato e ambas as contas; os períodos são gerados mensalmente, a menos que sejam fornecidos. Valor de necessidades fixas do ativo (custo), acquisition_date, residual_value, useful_life_months e asset_account_id. Data, descrição, liability_account_id e linhas ou expense_account_id com quantidade e retorna recurring_expense_id mais adjustment_id.
  • briefcase_update_close_item (Atualizar item de fechamento): salvar edições em um item de fechamento que ainda está em revisão; nada de postagens. Somente os campos fornecidos são alterados. Alterar a quantidade, as datas, a frequência ou o saldo de abertura regenera os períodos, a menos que os períodos sejam fornecidos. As edições de acumulação destinam-se ao ajuste de rascunho (close_item_id é o adjustment_id) e mantêm as reversões de rascunho vinculadas em etapas.
  • briefcase_publish_close_item (Publicar item de fechamento): Publique um item de fechamento e poste sua agenda ou acréscimo.
  • briefcase_archive_close_item (Item de fechamento de arquivo morto): arquive um item de fechamento. Pagamentos antecipados, renda adiada e ativos fixos são arquivados e seus diários postados invertidos. Para acréscimos, somente ajustes de rascunho podem ser arquivados, ajustes não confirmados ou a própria despesa recorrente.
  • briefcase_unarchive_close_item (Item de fechamento unarquivo): restaure um item de fechamento arquivado para que ele possa ser editado ou publicado novamente. Nada é postado quando ele é restaurado.

Relatórios e diários (Razão da Pasta)

  • briefcase_get_profit_and_loss (Obter lucro e perda): Lucro e perda para um cliente razão de pasta em um intervalo de datas, por conta de receita e despesas, com custo de vendas, lucro bruto e intervalo de comparação opcional. Contas sem movimentação são deixadas de fora. As IDs da conta funcionam como account_id em briefcase_list_journals. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_get_balance_sheet (Obter balanço): balanço de um cliente do Razão de Pasta como em uma data (padrão hoje), por ativo, responsabilidade e conta de capital próprio, com ganhos retidos e uma data de comparação opcional. Contas com saldo zero são deixadas de fora. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_get_trial_balance (Obter saldo de avaliação): saldo de avaliação para um cliente do Razão de Pasta como em uma data (padrão hoje): cada conta com um saldo em uma coluna de débito ou crédito, contas de receita e despesas do exercício até o momento, lucro anterior como lucro retido apresentado e totais que concordam quando o razão é balanceado. Usa o final do ano financeiro do cliente, ou 6 de abril para pessoas físicas e 1º de janeiro para empresas sem um. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_get_working_paper (Obter papel de trabalho): documentos de trabalho (fechamento de período) para um cliente do Razão de Pasta: os períodos mais recentes mais recentes primeiro, mais o mais recente ou aquele nomeado na íntegra. Mostra o status de fechamento, o que resta desmarcar (bloqueadores bancários, instruções pendentes, solicitações de cliente abertas), faturas não publicadas e ajustes de rascunho datados no período e reconciliação de cada conta do balanço: status, quem assinou e quando, saldo e diferença com suporte e se o saldo mudou desde a aprovação. Contas inativas são contadas, não listadas. Somente leitura; a reconciliação e o fechamento ocorrem na Pasta. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_get_aged_report (Obter relatório antigo): Credores idosos (ACCOUNTS_PAYABLE) ou devedores antigos (ACCOUNTS_RECEIVABLE) para um cliente razão de pasta como em uma data (padrão hoje): totais de bucket para cada contato e contatos ordenados por valor pendente com até 10 faturas cada. Passe contact_id para um contato na íntegra. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_list_journals (Listar diários): diários de razão geral para um cliente do Razão de Pasta, o mais recente primeiro. Passe account_id para a atividade de conta: débito, crédito e totais e, em seguida, cubra apenas essa conta. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_get_journal (Obter diário): um diário de razão geral com suas linhas, links de documento de origem e links de reversão. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_create_manual_journal (Criar diário manual): poste um diário manual em um cliente do Razão de Pasta. As linhas são valores brutos em unidades principais, uma de débito ou crédito cada; um tax_rate_id divide o IVA para a conta de IVA. As linhas de receita, despesas e ativos fixos precisam de um tax_rate_id (sem IVA quando nada se aplica); todas as outras linhas devem omitê-la. A visualização bloqueia períodos bloqueados, linhas desequilibradas, taxas de impostos ausentes ou incorretas, contas reservadas ou excluídas e linhas que abrangem empresas ou propriedades. A reversão é somente na Web. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.

Faturas de vendas (Razão de Pasta)

  • briefcase_list_sales_invoices (Listar faturas de vendas): faturas de vendas geradas em Pasta para um cliente do Razão de Pasta, a mais recente primeiro. Os status padrão são todos. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_get_sales_invoice (Obter fatura de vendas): uma fatura de vendas gerada com linhas, totais, saldo pendente, pagamentos e emails. Baixe o PDF com briefcase_get_attachment_download usando pdf.attachment_id. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_raise_sales_invoice (Aumentar fatura de vendas): crie e poste uma fatura de vendas para um cliente do Razão de Pasta de itens de vendas (itens de tipo briefcase_get_reference_data). Os detalhes bancários são padrão para a conta de pagamento da empresa. A versão prévia mostra linhas e totais e bloqueia períodos bloqueados e detalhes do emissor ou do cliente ausentes. Nunca enviar emails ao cliente; A reversão é somente da Web. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.
  • briefcase_create_customer (Criar cliente): adicione um cliente a um cliente do Razão de Pasta. A versão prévia lista os contatos existentes com um nome semelhante ou o mesmo email; execute recusa enquanto houver, a menos que confirm_new_despite_candidates seja verdadeira. Um contato com exatamente o mesmo nome é reutilizado, não duplicado. Os clientes de conexão retornam UNSUPPORTED_CAPABILITY.

Ajuda

  • briefcase_search_help (Ajuda de pesquisa): pesquisar artigos de ajuda publicados.
  • briefcase_get_help_article (Obter artigo de ajuda): Artigo de ajuda publicado ou corpo da atualização do produto.

Obtendo credenciais

A pasta usa o OAuth 2.0 com a entrada da Pasta do usuário. Quando uma conexão é criada, a Pasta solicita que o usuário entre, escolha quais clientes o assistente pode usar e aprove. Nada precisa ser configurado na Pasta de antemão.

Introdução

  1. Adicione a Pasta ao agente e crie uma conexão.
  2. Entre na Pasta, escolha seus clientes e aprove.
  3. Pergunte, por exemplo:
    • Quem nos deve dinheiro?
    • Quais contas estão aguardando revisão?
    • O que gastamos em software este ano?
    • Carregue esse recibo no Dunder Mifflin.

Limitações e problemas conhecidos

  • Relatórios (lucro e perda, balanço, saldo de avaliação, devedores e credores antigos, papéis de trabalho), diários, diários manuais, linhas de alimentação bancária, faturas de vendas e clientes funcionam apenas para clientes da Pasta Razão. Para clientes cujos livros são mantidos em Xero ou QuickBooks, essas ferramentas retornam UNSUPPORTED_CAPABILITY; use os próprios relatórios do razão.
  • O assistente tem as permissões do usuário conectado, nos clientes escolhidos ao se conectar. Uma ferramenta que o usuário não tem permissão para usar retorna FORBIDDEN. Os administradores do workspace podem desativar os assistentes de IA ou permitir somente leituras.
  • As ferramentas que publicam, arquivam ou restauram usam um mode: preview mostra o efeito sem alterar nada e execute faz a alteração e precisa de uma idempotency_key, portanto, uma chamada repetida não a repete.
  • Nenhuma ferramenta move dinheiro ou paga contas.
  • Uma resposta de leitura com mais de 80.000 caracteres é recusada com uma solicitação para restringi-la (um termo de pesquisa, um intervalo de datas ou um tamanho de página menor).
  • Cada conexão é limitada a 120 solicitações por minuto.
  • Os tokens de acesso duram uma hora e são atualizados automaticamente. Uma conexão que não é usada por 30 dias precisa entrar novamente. Desconectar-se em pastas (assistentes de IA de configurações > ) revoga-o de uma vez.
  • As leituras bem-sucedidas não são registradas no log de atividades da Pasta; gravações e solicitações recusadas são.

Suporte

Ações

Maleta

Pergunte aos seus livros qualquer coisa: transações, IVA, contas, declarações e relatórios.

Maleta

Pergunte aos seus livros qualquer coisa: transações, IVA, contas, declarações e relatórios.