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 |
| 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
- Adicione a Pasta ao agente e crie uma conexão.
- Entre na Pasta, escolha seus clientes e aprove.
- 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:previewmostra o efeito sem alterar nada eexecutefaz a alteração e precisa de umaidempotency_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
- 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
| 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.