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 |
| 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
- Adicione a Briefcase ao seu agente e crie uma ligação.
- Inicia sessão no Briefcase, escolhe os teus clientes e aprova.
- 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:previewmostra o efeito sem alterar nada, eexecutefaz a alteração e precisa de umidempotency_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
- E-mail: support@briefcase.so
- Centro de ajuda: https://briefcase.so/help
- Política de privacidade: https://briefcase.so/privacy-policy
- Termos de serviço: https://briefcase.so/terms-of-service
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.