Mala (Pré-visualização)

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

Este 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 (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Logic Apps Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure Government
     - 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 (CCG)
     - 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 (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contact
Name Mala
URL https://briefcase.so
Email support@briefcase.so
Metadados do conector
Publicador Mala
Website https://briefcase.so
Política de Privacidade https://briefcase.so/privacy-policy
Categories IA; Dados

Mala

A Briefcase é um software de contabilidade para empresas do Reino Unido e seus contabilistas. Lê recibos, faturas e linhas bancárias, codifica-os com a razão mostrada e mantém os livros atualizados no Briefcase Ledger, Xero ou QuickBooks.

Este servidor MCP permite que os agentes do Microsoft 365 Copilot e Copilot Studio trabalhem com a Briefcase como utilizador iniciado: responder a perguntas sobre os livros do cliente, carregar documentos, rever e publicar transações, preparar reclamações de despesas, gerir o fecho financeiro e, para os clientes da Briefcase Ledger, gerir relatórios, publicar diários manuais e emitir faturas de vendas.

Publicador

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

Prerequisites

  • Uma conta Briefcase (https://app.briefcase.so) com acesso a pelo menos um cliente.
  • Assistentes de IA permitidos no espaço de trabalho da Mala. Os administradores do espaço de trabalho controlam isto nos assistentes de IA de Definições > .

Operações suportadas

52 ferramentas, agrupadas por área. Cada ferramenta atua como o utilizador iniciado sessão, nos clientes escolhidos ao ligar-se.

Conta e clientes

  • briefcase_get_connection (Obter ligação): Identifique o utilizador da mala registado, o espaço de trabalho e esta bolsa de assistente.
  • briefcase_list_clients (Listar clientes): Listar clientes que este utilizador pode aceder ao abrigo da bolsa, com contagens pendentes de revisão, processamento, rejeitos e publicados.
  • briefcase_get_client (Obter cliente): Um cliente: nome, tipo do livro razão (Xero, QuickBooks ou Livro de Registo da Mala), email de encaminhamento de documentos, se o Autopilot está ativado e, para os clientes do Livro Maior, a data geral de bloqueio do livro maior.
  • briefcase_list_users (Listar utilizadores): Listar utilizadores permitidos em espaços de trabalho ou clientes com funções, permissões efetivas e atribuições visíveis de clientes. Aplicam-se restrições existentes no diretório de utilizador.
  • briefcase_list_contacts (Listar contactos): Procurar fornecedores, clientes e reclamantes para um cliente.
  • briefcase_get_contact (Obter contacto): Detalhes de contacto para identificação do cliente.
  • briefcase_get_reference_data (Obter dados de referência): Consultar contas, taxas de imposto, rastreio de categorias, moedas, negócios, propriedades, reclamantes ou itens de venda (Livro de Registo da Mala; usado por briefcase_raise_sales_invoice). Devolve até 150 itens com o total total; contas restritas com account_class ou search_term.
  • briefcase_list_ai_memories (Listar memórias de IA): As memórias de IA ativas para um cliente: regras de processamento A Briefcase aplica-se aos seus documentos, como como programar um fornecedor ou qual a convenção de data de vencimento a usar.

Documentos e transações

  • briefcase_create_document_upload (Criar upload de documento): Iniciar um upload: devolve um URL de upload de curta duração, um link de upload do navegador Briefcase e o cliente a encaminhar o email. Quando o ficheiro é fornecido, a Briefcase descarrega esse ficheiro e o upload está pronto para submeter. note contém as instruções de processamento do utilizador, tal como digitadas na aplicação, e a Briefcase aplica-as: a conta ou propósito a codificar, a categoria de rastreio, projeto ou localização (Xero e QuickBooks), divisões percentuais, manter linhas separadas ou combiná-las, e apresentar um recibo como reclamação de despesas do funcionário (adicionado à sua reclamação mensal).
  • briefcase_submit_document (Submeter documento): Submeter um ficheiro carregado através da briefcase_create_document_upload para processamento, exatamente como um upload na aplicação Briefcase. Devolve uma operação a seguir com briefcase_get_operation; um documento que não produz qualquer transação é reportado como falha.
  • briefcase_get_operation (Operação de obtenção): Estado duradouro para uma escrita ou escrita recusada. As leituras bem-sucedidas não são armazenadas.
  • briefcase_get_attachment_download (Obter download do anexo): URL de download de curta duração para um anexo vinculado ao cliente, incluindo um PDF de fatura de vendas elevada (pdf.attachment_id de briefcase_get_sales_invoice). Os links assinados deixam de funcionar ao expires_at.
  • briefcase_list_transactions (Listar transações): Pesquisar e filtrar por revisão, processamento, transações publicadas ou arquivadas.
  • briefcase_get_transaction (Obter transação): Detalhes da transação visíveis pelo cliente, itens de linha, anexos, explicação do Autopilot e bloqueadores de publicação.
  • briefcase_update_transaction (Atualizar transação): Guardar edições de transações sem publicar. A última escrita ganha. Apenas os campos fornecidos são alterados. Quando line_items é fornecida, é o conjunto completo a manter: itens existentes deixados de fora são removidos; omitir line_items mantê-los inalterados.
  • briefcase_publish_transaction (Publicar transação): Publicar uma transação revista no livro de registos. A pré-visualização devolve bloqueadores e a ação do livro-registo; executar publicações no livro de registos da Pasta ou criar o documento Xero/QuickBooks.
  • briefcase_archive_transaction (Transação de arquivo): Arquivar uma transação, revertendo as suas publicações no livro-razão quando aplicável. A pré-visualização mostra a ação do livro razão e o impacto no calendário. A única razão pela qual DELETED é suportado.
  • briefcase_list_archived_documents (Lista de documentos arquivados): Transações arquivadas, candidatos, extratos bancários, extratos de fornecedores e faturas de vendas.
  • briefcase_get_archived_document (Obter documento arquivado): Um item arquivado por ID de arquivo.
  • briefcase_unarchive_document (Desarquivar documento): Restaurar uma transação, candidato ou extrato arquivado. As faturas de venda não podem ser desarquivadas.

Reclamações de despesas

  • briefcase_list_expense_claims (Listar reclamações de despesas): Listar reclamações de despesas para um cliente.
  • briefcase_get_expense_claim (Obter reembolso de despesas): Detalhe da reclamação de despesas, adesão e estado de publicação.
  • briefcase_create_expense_claim (Criar reclamação de despesas): Criar uma reclamação a partir de uma ou mais transações não publicadas.
  • briefcase_add_claim_transactions (Adicionar transações de reivindicação): Adicionar transações não publicadas a uma reivindicação existente.
  • briefcase_remove_claim_transaction (Remover transação de reivindicação): Remover uma transação de uma reivindicação não publicada.
  • briefcase_publish_expense_claim (Publicar reclamação de despesas): Publicar uma reclamação de despesas usando o seu reclamante armazenado, data e moeda, salvo se ultrapassado. A pré-visualização devolve bloqueadores e os valores que seriam utilizados.
  • briefcase_delete_expense_claim (Apagar pedido de despesas): Apagar um pedido de despesas, reverter os seus diários Briefcase ou apagar a fatura Xero se publicada; recusado enquanto for aplicado um pagamento. Os recibos regressam à revisão a menos que archive_transactions seja verdadeiro.

Banco

  • briefcase_list_bank_statements (Listar extratos bancários): Extratos bancários de um cliente, com estado 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): Livro-razão das linhas bancárias para uma conta bancária da Mala, a mais recente primeiro. running_balance é o saldo reconciliado após cada linha reconciliada, como em Briefcase; as linhas não reconciliadas não têm nenhuma. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.

Encerramento financeiro

  • briefcase_list_close_items (Listar itens finais): Listar pagamentos antecipados, rendimentos diferidos, ativos fixos ou acréscimos. Os horários têm um period_summary, não os seus períodos; arranja um com briefcase_get_close_item para os seus períodos. Os acréscimos incluem referências datilografadas dos pais e de ajustes; as leituras de acréscimos arquivados retornam ajustes arquivados, não pais arquivados.
  • briefcase_get_close_item (Item de proximidade): Um item de fecho financeiro para o módulo em questão. Os cronogramas regressam até 120 períodos, começando um ano antes do próximo período não publicado; passam period_start_date e period_end_date para outros. Um anexo criado a partir de um documento tem um primeiro período negativo que transfere o montante não divulgado para o balanço; um que é criado sem documento mantém-no em opening_balance. Para os acréscimos, identifique se o alvo é uma despesa recorrente de um pai-mãe ou um ajuste, incluindo ajustes arquivados.
  • briefcase_get_close_tracker (Rastreio próximo): Grelha de período para pré-pagamento, rendimento diferido e ativos fixos. A matemática do registo de acréscimos não é essa grelha. O intervalo padrão é o ano civil atual.
  • briefcase_create_close_item (Criar item fechado): Criar um rascunho de item fechado à espera de revisão; nada é publicado. O valor necessário para pagamento antecipado e rendimento diferido, start_date, end_date, o contacto e ambas as contas; os períodos são gerados mensalmente, a menos que forem fornecidos. O ativo fixo precisa de quantia (custo), acquisition_date, residual_value, useful_life_months e asset_account_id. O acréscimo precisa de data, descrição, liability_account_id e linhas ou expense_account_id com o montante, e retornos recurring_expense_id mais adjustment_id.
  • briefcase_update_close_item (Atualizar item final): Guardar as edições num item fechado que ainda esteja em análise; nada é publicado. Apenas os campos fornecidos mudam. A alteração do montante, datas, frequência ou saldo inicial regenera os períodos, a menos que sejam fornecidos períodos. As edições de acúmulo visam o ajuste do rascunho (close_item_id é o adjustment_id) e mantêm as reversões de rascunho ligadas em ritmo.
  • briefcase_publish_close_item (Publicar artigo final): Publicar um item final e publicar o seu calendário ou acumulação.
  • briefcase_archive_close_item (Arquivo final): Arquivar um artigo próximo. Os pagamentos antecipados, rendimentos diferidos e ativos fixos são arquivados e os seus diários publicados revertidos. Para acúmulos, apenas os ajustes de rascunho podem ser arquivados, não os ajustes comprometidos ou a despesa recorrente em si.
  • briefcase_unarchive_close_item (Desarquivar item final): Restaurar um item arquivado para que possa ser editado ou publicado novamente. Nada é afixado quando é restaurado.

Relatórios e diários (Livro de Registo da Mala)

  • briefcase_get_profit_and_loss (Obter lucros e prejuízos): Lucros e prejuízos para um cliente da Briefcase Ledger num intervalo de datas, por conta de receitas e despesas, com custo de vendas, lucro bruto e um intervalo opcional de comparação. Contas sem movimento ficam de fora. Os IDs de conta funcionam como account_id em briefcase_list_journals. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_get_balance_sheet (Obter balanço): Balanço de um cliente Briefcase Ledger na data (incumprimento hoje), por conta de ativos, passivos e capital próprio, com lucros retidos e uma data opcional de comparação. Contas com saldo zero ficam de fora. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_get_trial_balance (Obter saldo de verificação): Saldo de verificação para um cliente do Livro de Registos de Pasta numa data (incumprimento hoje): todas as contas com saldo numa coluna de débito ou crédito, contas de receitas e despesas para o ano financeiro até à data, lucros anteriores como lucros retidos antecipados e totais que concordam quando o livro razão balança. Utiliza o final do ano financeiro do cliente, ou 6 de abril para indivíduos e 1 de janeiro para empresas sem ele. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_get_working_paper (Obter papel de trabalho): Documentos de trabalho (período de encerramento) para um cliente do Registo de Malas: os períodos recentes primeiro, mais o mais recente ou o nomeado na íntegra. Mostra o estado de encerramento, o que ainda falta liquidar (bloqueadores bancários, extratos pendentes, pedidos abertos de clientes), faturas não publicadas e ajustes em rascunho datados do período, e a reconciliação de cada conta de balanço: estado, quem assinou e quando, saldo e diferença suportados, e se o saldo mudou desde a assinatura. Contas dormentes são contabilizadas, não listadas. Apenas leitura; a reconciliação e o fecho acontecem na Mala. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_get_aged_report (Relatório de envelhecimento): Credores idosos (ACCOUNTS_PAYABLE) ou devedores idosos (ACCOUNTS_RECEIVABLE) para um cliente do Livro de Registo de Porta-Remas numa data (incumprimento hoje): totais de baldes para cada contacto, depois contratos ordenados por montante em atraso, com até 10 faturas cada. Passe contact_id para um contacto completo. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_list_journals (Listar diários): Diários de registo geral para um cliente do Livro de Registos de Mala, os mais recentes primeiros. Passa account_id para atividade da conta: débito, crédito e totais e depois cobre apenas essa conta. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_get_journal (Obter diário): Um diário de registo geral com as suas linhas, ligações de documentos de origem e ligações de reversão. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_create_manual_journal (Criar diário manual): Publicar um diário manual num cliente do Registo de Malas. As linhas são montantes brutos em unidades principais, uma de débito ou crédito cada; uma tax_rate_id divide o IVA para a conta do IVA. As linhas de receitas, despesas e ativos fixos precisam de uma tax_rate_id (Sem IVA quando nada se aplica); todas as outras linhas devem omitir essa linha. Blocos de pré-visualização bloqueados períodos, linhas desequilibradas, taxas fiscais em falta ou perdidas, contas e linhas reservadas ou eliminadas que abrangem negócios ou propriedades. A reversão é apenas na web. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.

Faturas de vendas (Registo de Mala)

  • briefcase_list_sales_invoices (Listar faturas de vendas): Faturas de venda levantadas na Mala para um cliente do Registo de Malas, as mais recentes primeiro. Os estados padrão são todos. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_get_sales_invoice (Receber fatura de vendas): Uma fatura de vendas levantada com linhas, totais, saldo em aberto, pagamentos e emails. Descarregue o PDF com briefcase_get_attachment_download usando pdf.attachment_id. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_raise_sales_invoice (Aumentar a fatura de vendas): Levantar e colocar uma fatura de venda para um cliente do Livro de Registos de Pasta a partir de artigos de venda (briefcase_get_reference_data tipo). Os dados bancários passam automaticamente à conta de pagamento da empresa. A pré-visualização mostra linhas e totais, blocos de períodos bloqueados e dados em falta do emissor ou do cliente. Nunca envia emails ao cliente; a reversão é apenas online. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.
  • briefcase_create_customer (Criar cliente): Adicionar um cliente a um cliente do Livro de Registos da Mala. A pré-visualização lista contactos existentes com um nome semelhante ou o mesmo email; executar recusas enquanto existem, a menos que confirm_new_despite_candidates seja verdadeira. Um contacto com exatamente o mesmo nome é reutilizado, não duplicado. Os clientes Connect devolvem UNSUPPORTED_CAPABILITY.

Ajuda

  • briefcase_search_help (Pesquisa de ajuda): Pesquise artigos de ajuda publicados.
  • briefcase_get_help_article (Artigo para obter ajuda): Artigo de ajuda publicado ou órgão de atualização do produto.

Obtenção de credenciais

O Briefcase utiliza o OAuth 2.0 com o login do utilizador no Briefcase. Quando uma ligação é criada, o Briefcase pede ao utilizador que faça login, escolha quais os clientes que o assistente pode usar e aprove. Nada precisa de ser preparado na Pasta antes.

Introdução

  1. Adicione a Briefcase ao seu agente e crie uma ligação.
  2. Inicia sessão no Briefcase, escolhe os teus clientes e aprova.
  3. Pergunte, por exemplo:
    • Quem nos deve dinheiro?
    • Que projetos de lei estão à espera de revisão?
    • Quanto gastámos em software este ano?
    • Carregue este recibo na Dunder Mifflin.

Problemas e limitações conhecidos

  • Relatórios (lucros e prejuízos, balanço, balanço de verificação, devedores e credores envelhecidos, documentos de trabalho), diários, diários manuais, linhas de alimentação bancária, faturas de vendas e clientes funcionam apenas para clientes da Briefcase Ledger. Para clientes cujos livros estão guardados em Xero ou QuickBooks, estas ferramentas retornam UNSUPPORTED_CAPABILITY; use os relatórios próprios do livro de registos.
  • O assistente tem as permissões do utilizador iniciado em sessão, nos clientes escolhidos ao ligar-se. Uma ferramenta que o utilizador não pode usar devolve FORBIDDEN. Os administradores do espaço de trabalho podem desligar assistentes de IA ou permitir apenas leituras.
  • Ferramentas que publicam, arquivam ou restauram tomam um mode: preview mostra o efeito sem alterar nada, e execute faz a alteração e precisa de um idempotency_key, para que uma chamada retentada não a repita.
  • Nenhuma ferramenta move dinheiro ou paga contas.
  • Uma resposta lida com mais de 80.000 caracteres é recusada com um pedido de restringimento (um termo de pesquisa, um intervalo de datas ou um tamanho de página menor).
  • Cada ligação está limitada a 120 pedidos por minuto.
  • Os tokens de acesso duram uma hora e atualizam-se automaticamente. Uma ligação que não é usada durante 30 dias tem de iniciar sessão novamente. Desligar no Briefcase (assistentes de IA de definições > ) revoga-o de imediato.
  • As leituras bem-sucedidas não são registadas no registo de atividades da Briefcase; as escritas e pedidos recusados são.

Support

Ações

Mala

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

Mala

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