Kema Invoice

npx add-mcp 'https://mcp.kema-studio.com/api/mcp'

Conector MCP Kema Invoice

Kema Invoice é um software de faturamento eletrônico em conformidade que agentes de IA podem operar através do Model Context Protocol. Conecte o servidor MCP remoto ao Claude, Cursor ou qualquer cliente MCP, autorize uma vez com OAuth 2.1, e seu agente pode criar, emitir, enviar e rastrear faturas, orçamentos e retenções em linguagem natural. As faturas são geradas como Factur-X (EN 16931) e transmitidas através de uma plataforma credenciada. Nada para instalar: o servidor roda em https://mcp.kema-studio.com/api/mcp.

Website · Documentação · Conecte seu agente · Entrada no Registro MCP · Versão francesa

O que é este repositório

O conector é um servidor MCP remoto (HTTP Streamable + OAuth 2.1). Não há pacote para instalar e o código do servidor não é publicado aqui. Este repositório contém o que um integrador ou diretório precisa:

Arquivo	Finalidade
tools.json	As 41 ferramentas com título, descrição, grupo e dicas de acesso. Gerado a partir do código do servidor, nunca editado manualmente.
server.json	A declaração publicada no Registro MCP oficial (com.kema-studio/invoice).
examples/	Configurações de cliente prontas para colar e um guia de prompts.
scripts/verify-connection.ts	Um pequeno script de código aberto que executa o fluxo OAuth e lista as ferramentas, para verificar uma conexão de ponta a ponta.
CHANGELOG.md	Versões do conector.

Conecte em dois minutos

Cliente	Como
claude.ai / Claude Desktop	Configurações › Conectores › Adicionar conector personalizado, cole https://mcp.kema-studio.com/api/mcp, autorize uma vez.
Claude Code	claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp
Cursor	Adicione examples/cursor-mcp.json ao .cursor/mcp.json.
Qualquer cliente MCP	Transporte HTTP Streamable, URL acima, OAuth 2.1 com PKCE e registro dinâmico de cliente (RFC 7591). Os metadados do servidor de autorização são descobertos em /.well-known/oauth-protected-resource.

A primeira chamada abre uma página de consentimento em auth.kema-studio.com. Você entra com sua conta Kema Invoice, aprova, e o cliente armazena o token. O acesso pode ser revogado a qualquer momento pelo aplicativo ou pelo cliente.

Sem conta ainda? Crie uma: teste de 14 dias com 10 faturas incluídas, um usuário, sem cartão de crédito. Depois, um plano único de €10 por usuário por mês sem IVA, todos os recursos incluídos, cancele quando quiser.

O que seu agente pode fazer

Faturas (16)

Ferramenta	O que faz	Acesso
create_invoice	Cria uma nova fatura no status Rascunho para uma empresa, com itens de linha. A fatura NÃO é enviada ou certificada — um humano a emite pelo aplicativo (ou use issue_invoice). O IVA é calculado automaticamente por regras fiscais estritas do lado do servidor (cenário + padrões) — nunca peça ao usuário uma alíquota de IVA. O cenário fiscal e o instantâneo do cliente são congelados na criação.	gravação
issue_invoice	Emite uma fatura em Rascunho — o ato legal de CRIAR a fatura (o produto chama isso de 'Créer la facture'; o antigo conceito de 'enviar' está obsoleto). O rascunho se torna uma fatura certificada e imutável (status Enviada, exibida como 'Créée') e é IMEDIATAMENTE submetida à certificação fiscal. IRREVERSÍVEL e legalmente vinculante sob a lei francesa — desfeita apenas com uma nota de crédito. SEMPRE mostre ao usuário os detalhes da fatura e obtenha aprovação explícita antes de chamar com confirm:true. Sem confirm, retorna uma prévia do que será certificado.	gravação, destrutivo
list_invoices	Lista as faturas do locatário autenticado, das mais recentes para as mais antigas. Suporta filtragem por status, tipo de documento e busca de texto livre por número da fatura ou nome do cliente, além de paginação.	leitura
get_invoice	Busca uma única fatura por id, incluindo itens de linha, cliente e totais. Retorna erro em formato nulo se a fatura não estiver visível para o chamador.	leitura
get_invoice_pdf	Retorna uma URL de download assinada temporária (1 hora) para o PDF de uma fatura. Funciona para qualquer documento visível ao chamador: faturas importadas retornam o arquivo enviado; faturas emitidas no Kema Invoice (pelo aplicativo ou um agente) são renderizadas no servidor com a marca do espaço de trabalho e, uma vez certificadas, incorporam o XML Factur-X. Rascunhos também são renderizados (marcados is_draft: true), mas ainda não são documentos legais.	leitura
update_invoice	Atualiza campos de uma fatura em Rascunho (datas, condições de pagamento, notas ou reatribui a empresa). Apenas faturas em Rascunho podem ser modificadas — uma fatura Enviada/certificada é imutável.	gravação
delete_invoice	Exclui logicamente uma fatura em Rascunho. Irreversível do ponto de vista do usuário. Chame com confirm:true para excluir de fato; sem isso, retorna uma prévia do que seria excluído.	gravação, destrutivo
cancel_invoice	Cancela uma fatura não paga (status → Cancelada). Irreversível. Para uma fatura certificada (Enviada), a lei francesa geralmente exige uma nota de crédito (create_credit_note) em vez de um cancelamento simples. Chame com confirm:true para agir; caso contrário, retorna uma prévia.	gravação, destrutivo
mark_invoice_paid	Marca uma fatura Enviada ou Vencida como Paga. Opcionalmente define a data de pagamento (padrão: agora).	gravação
add_invoice_item	Adiciona um item de linha a uma fatura em Rascunho. Os totais são recalculados automaticamente.	gravação
update_invoice_item	Atualiza um item de linha em uma fatura em Rascunho. Os totais são recalculados automaticamente. Os ids dos itens vêm de get_invoice ou add_invoice_item.	gravação
delete_invoice_item	Remove um item de linha de uma fatura em Rascunho. Os totais são recalculados automaticamente. Os ids dos itens vêm de get_invoice ou add_invoice_item. Chame com confirm:true para excluir; sem isso, retorna uma prévia do item.	gravação, destrutivo
reorder_invoice_items	Define a ordem de exibição dos itens de linha de uma fatura. Passe a ordem completa desejada: cada id de item com seu display_order baseado em 0. Os ids dos itens vêm de get_invoice ou add_invoice_item.	gravação
update_invoice_matter	Anexa ou desanexa o assunto (dossier) em uma fatura. Puramente organizacional — permitido mesmo após a fatura ser Enviada, mas não em uma fatura Cancelada. Passe matter_id null para desanexar.	gravação
check_certification_status	Atualiza o status de certificação fiscal de uma fatura emitida consultando o provedor de certificação e reconciliando no banco de dados. Use após issue_invoice quando certification_status estiver 'processing' ou parecer desatualizado.	gravação
create_credit_note	Cancela uma fatura Enviada ou Paga emitindo uma nota de crédito (avoir). A nota de crédito é um documento fiscal legal (certificada fiscalmente quando a original foi certificada) e é IMUTÁVEL após a criação. IRREVERSÍVEL. SEMPRE obtenha aprovação explícita do usuário antes de chamar com confirm:true. Sem confirm, retorna uma prévia.	gravação, destrutivo

Retificação e importação (3)

Ferramenta	O que faz	Acesso
rectify_invoice	Cria uma fatura retificadora (facture rectificative) para uma fatura Enviada ou Paga: uma NOVA fatura em Rascunho pré-preenchida a partir da original (mesmo cliente, itens de linha copiados, salvo substituição) e legalmente vinculada a ela. A original é marcada como Retificada apenas quando a retificadora é emitida. Chame com confirm:true para criar; sem isso, retorna uma prévia.	gravação
get_rectification_links	Para uma fatura, retorna a cadeia de retificação: a original que ela substitui (se for uma retificadora) e/ou a retificadora que a substituiu (se foi retificada). Ambos nulos quando a fatura não faz parte de uma cadeia.	leitura
import_external_invoice	Importa uma fatura histórica/externa com SEU PRÓPRIO número de fatura (mantido literalmente), totais e status — sem itens de linha. Use para migrar faturas passadas emitidas fora do Kema Invoice; NÃO para criar novas faturas (use create_invoice).	gravação

Orçamentos (5)

Ferramenta	O que faz	Acesso
create_quote	Cria um orçamento em Rascunho (devis) para uma empresa. Orçamentos não são documentos fiscais — sem certificação. As datas são definidas no servidor (emissão hoje, vencimento/válido +30 dias). Requer um id de assunto (dossier) ao qual o orçamento pertence.	gravação
send_quote	Transiciona um orçamento em Rascunho para Enviado (o estado voltado ao cliente). Não há certificação envolvida — orçamentos são documentos comerciais. A validação B2B francesa (SIREN/IVA) se aplica quando o locatário é francês.	gravação, destrutivo
accept_quote	Marca um orçamento Enviado como Aceito pelo cliente. Acompanhe com convert_quote_to_invoice para faturar.	gravação, destrutivo
reject_quote	Marca um orçamento Enviado como Rejeitado pelo cliente. Isso encerra o ciclo de vida do orçamento. Chame com confirm:true para aplicar; sem isso, retorna uma prévia.	gravação, destrutivo
convert_quote_to_invoice	Cria uma nova fatura em Rascunho a partir de um orçamento Aceito (itens de linha copiados, source_quote_id definido para rastreabilidade). A fatura segue então o ciclo de vida normal (issue_invoice para torná-la legalmente vinculante). Chame com confirm:true para aplicar; sem isso, retorna uma prévia.	gravação

Retenções (6)

Ferramenta	O que faz	Acesso
create_provision	Cria um documento de provisão (avance sur honoraires, retenção) no status Rascunho para uma empresa, opcionalmente vinculado a um assunto. NÃO emitido ou certificado — use send_provision para a emissão legal. O IVA é calculado automaticamente por regras fiscais estritas do servidor — nunca peça ao usuário uma alíquota de IVA. Provisões usam sua própria série de numeração PROV e, uma vez pagas, tornam-se crédito do cliente dedutível da fatura final (apply_provisions_to_invoice).	gravação
send_provision	Emite uma provisão em Rascunho — o ato legal de criá-la. O rascunho se torna um documento certificado (status Enviada) e é IMEDIATAMENTE submetido à certificação fiscal (série PROV). IRREVERSÍVEL e legalmente vinculante sob a lei francesa. SEMPRE mostre ao usuário os detalhes da provisão e obtenha aprovação explícita antes de chamar com confirm:true. Sem confirm, retorna uma prévia do que será certificado.	gravação, destrutivo
mark_provision_paid	Marca uma provisão emitida (status Enviada/Vencida) como Paga. Uma provisão paga torna-se crédito do cliente que pode ser deduzido da fatura final desse cliente com apply_provisions_to_invoice.	gravação
list_available_provisions	Lista provisões PAGAS (avances sur honoraires, retenções) que ainda não foram aplicadas a uma fatura final — o crédito dedutível do cliente. Sem matter_id, lista as retenções independentes (sem assunto), que é o caso normal no Kema Invoice; com matter_id, lista as retenções desse assunto. Use antes de apply_provisions_to_invoice.	leitura
apply_provisions_to_invoice	Deduz uma ou mais provisões PAGAS de uma fatura final em RASCUNHO do mesmo cliente (e do mesmo assunto quando houver um vinculado). Atualiza advances_total e amount_due da fatura. Reversível enquanto a fatura ainda estiver em Rascunho (remove_provision_from_invoice).	gravação
remove_provision_from_invoice	Desanexa uma provisão de uma fatura final em RASCUNHO e recalcula advances_total / amount_due. A provisão fica disponível novamente para aquele assunto.	gravação

Clientes (5)

Ferramenta	O que faz	Acesso
list_companies	Lista as empresas clientes do locatário autenticado (nome, e-mail, IVA/identificação fiscal, país). Útil para resolver um id de empresa antes de outras consultas.	leitura
get_company	Busca uma empresa cliente com o registro completo relevante para faturamento: identidade legal, IVA/SIREN, endereço, dados de contato e classificação de perfil do cliente.	leitura
create_company	Cria uma empresa cliente para o locatário. Um IVA/identificação fiscal é exigido posteriormente para faturá-la como B2B.	gravação
update_company	Atualiza campos de uma empresa cliente existente (nome, informações de contato, endereço, número de IVA, SIREN). Apenas os campos fornecidos são alterados. Corrigir o número de IVA / SIREN / endereço aqui é frequentemente necessário antes que uma fatura para este cliente possa ser certificada.	gravação
delete_company	Exclui logicamente uma empresa cliente. Bloqueado quando contatos ainda estão vinculados a ela. Chame com confirm:true para excluir; sem isso, retorna uma prévia.	gravação, destrutivo

Perfis de cliente (3)

Ferramenta	O que faz	Acesso
get_invoice_client_profile	Padrões de faturamento por empresa (condições de pagamento, canal de entrega, prefixo personalizado de fatura). Retorna {profile: null} quando a empresa não possui nenhum — os perfis são criados de forma lazy.	leitura
upsert_invoice_client_profile	Criar ou atualizar os padrões de faturamento de uma empresa (condições de pagamento, canal de entrega, prefixo de fatura). Esses padrões pré-preenchem futuras faturas para esse cliente.	escrita
delete_invoice_client_profile	Remover os padrões de faturamento de uma empresa (a empresa em si não é alterada). Chame com confirm:true para realmente excluir; sem isso, retorna uma prévia.	escrita, destrutivo

Relatórios (3)

Ferramenta	O que faz	Acesso
get_revenue_summary	Consolidar valores de receita: recebidos no período (por data de pagamento), saldo atual em aberto e vencido (em um ponto no tempo), documentos emitidos no período, quantidade de rascunhos e efeito líquido de notas de crédito. O padrão é o mês atual.	leitura
get_settings	Instantâneo somente leitura das configurações de faturamento do locatário: identidade legal, país e regime fiscal, alíquota padrão de IVA e condições de pagamento, e-mail de cobrança e o idioma da interface do chamador. As configurações só podem ser ALTERADAS pelo aplicativo.	leitura
list_mcp_activity	Registro de atividade recente do agente do locatário: uma entrada por chamada de ferramenta MCP bem-sucedida (nome da ferramenta, número da fatura relacionada quando conhecido, timestamp). Mais recentes primeiro.	leitura

Regras de design que o servidor segue: um título por ferramenta, readOnlyHint em leituras e um destructiveHint explícito em escritas, uma descrição em cada parâmetro, um outputSchema e structuredContent em cada resultado. Os nomes das ferramentas são congelados: seus prompts e automações continuam funcionando entre versões.

Uma chamada recusada (sem assinatura ativa, cota atingida) é retornada como um resultado de ferramenta escrito para o modelo, não como um erro de transporte: o conector permanece conectado e continua listando suas ferramentas.

Experimente

Pergunte ao seu agente, no seu idioma:

• "Fature 3 dias de consultoria para a Dupont SARL a €800 por dia."
• "Liste minhas faturas não pagas e marque FAC-2026-0412 como paga."
• "Transforme o orçamento DEV-2026-0031 em uma fatura e envie-o."

Mais em examples/prompts.md.

Conformidade e dados

• As faturas são geradas como Factur-X (PDF/A-3 com XML EN 16931 incorporado) e transmitidas por meio de uma plataforma acreditada, prontas para o mandato de faturamento eletrônico francês.
• Os dados são hospedados na União Europeia (banco de dados e autenticação na AWS eu-north-1, Estocolmo; edge e armazenamento na UE). Subprocessadores e períodos de retenção estão listados na política de privacidade.
• Cada chamada MCP é registrada no aplicativo em Atividade do agente, para que você sempre veja o que seu agente fez.
• Termos · Aviso legal

Verificar uma conexão

git clone https://github.com/Kema-Studio/kema-invoice-mcp && cd kema-invoice-mcp
npm install
npm run verify        # opens the consent page, then lists the tools

Suporte

• Perguntas sobre sua conta ou suas faturas: suporte pelo aplicativo (botão Ajuda) ou hello@kema-studio.com.
• Bugs do conector em si (uma ferramenta que falha, um problema de esquema): abra um problema.

Licença

O conteúdo deste repositório (documentação, exemplos, scripts) é disponibilizado sob a Licença MIT. O serviço Kema Invoice e seu servidor são software proprietário da Kema Studio.

---

Versão em francês

Kema Invoice é um software de faturamento eletrônico em conformidade que agentes de IA controlam por meio do Model Context Protocol. Conecte o servidor MCP remoto ao Claude, Cursor ou qualquer cliente MCP, autorize uma vez com OAuth 2.1, e seu agente cria, emite, envia e acompanha faturas, orçamentos e provisões em linguagem natural. As faturas são geradas em Factur-X (EN 16931) e transmitidas por uma plataforma acreditada. Nada para instalar: o servidor responde em https://mcp.kema-studio.com/api/mcp.

Conectar

Cliente	Como
claude.ai / Claude Desktop	Configurações › Conectores › Adicionar conector personalizado, colar https://mcp.kema-studio.com/api/mcp, autorizar uma vez.
Claude Code	claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp
Cursor	Adicionar examples/cursor-mcp.json a .cursor/mcp.json.
Outro cliente MCP	Transporte Streamable HTTP, OAuth 2.1 com PKCE e registro dinâmico de cliente (RFC 7591).

Ainda não tem uma conta? Crie uma: teste de 14 dias com 10 faturas incluídas, um usuário, sem cartão de crédito. Depois, uma oferta única de 10 € HT por usuário e por mês, com todos os recursos incluídos, sem fidelidade.

O que seu agente sabe fazer

Faturas (16)

Ferramenta	O que faz	Acesso
create_invoice	Criar uma nova fatura no status Rascunho para uma empresa, com itens de linha. A fatura NÃO é enviada ou certificada — um humano a emite pelo aplicativo (ou use issue_invoice). O IVA é calculado automaticamente por regras fiscais estritas no servidor (cenário + padrões) — nunca peça ao usuário uma alíquota de IVA. O cenário fiscal e o instantâneo do cliente são congelados na criação.	escrita
issue_invoice	Emitir uma fatura em Rascunho — o ato legal de CRIAR a fatura (o produto chama isso de 'Créer la facture'; o antigo conceito de 'enviar' está obsoleto). O rascunho se torna uma fatura certificada e imutável (status Enviada, exibida como 'Créée') e é IMEDIATAMENTE submetida para certificação fiscal. IRREVERSÍVEL e legalmente vinculante sob a lei francesa — desfeita apenas com uma nota de crédito. SEMPRE mostre os detalhes da fatura ao usuário e obtenha sua aprovação explícita antes de chamar com confirm:true. Sem confirm, retorna uma prévia do que será certificado.	escrita, destrutivo
list_invoices	Listar as faturas do locatário autenticado, das mais recentes para as mais antigas. Suporta filtros por status, tipo de documento e busca de texto livre por número de fatura ou nome do cliente, além de paginação.	leitura
get_invoice	Buscar uma única fatura por id, incluindo seus itens de linha, cliente e totais. Retorna erro em formato null se a fatura não estiver visível para o chamador.	leitura
get_invoice_pdf	Retornar uma URL de download assinada temporária (1 hora) para o PDF de uma fatura. Funciona para qualquer documento visível ao chamador: faturas importadas retornam o arquivo enviado; faturas emitidas no Kema Invoice (pelo aplicativo ou um agente) são renderizadas no servidor com a marca do workspace e, uma vez certificadas, incorporam o XML Factur-X. Rascunhos também são renderizados (marcados is_draft: true), mas ainda não são documentos legais.	leitura
update_invoice	Atualizar campos de uma fatura em Rascunho (datas, condições de pagamento, notas ou reatribuir a empresa). Apenas faturas em Rascunho podem ser modificadas — uma fatura Enviada/certificada é imutável.	escrita
delete_invoice	Excluir logicamente uma fatura em Rascunho. Irreversível do ponto de vista do usuário. Chame com confirm:true para realmente excluir; sem isso, retorna uma prévia do que seria excluído.	escrita, destrutivo
cancel_invoice	Cancelar uma fatura não paga (status → Cancelada). Irreversível. Para uma fatura certificada (Enviada), a lei francesa geralmente exige uma nota de crédito (create_credit_note) em vez de um simples cancelamento. Chame com confirm:true para agir; caso contrário, retorna uma prévia.	escrita, destrutivo
mark_invoice_paid	Marcar uma fatura Enviada ou Vencida como Paga. Opcionalmente, defina a data de pagamento (o padrão é agora).	escrita
add_invoice_item	Adicionar um item de linha a uma fatura em Rascunho. Os totais são recalculados automaticamente.	escrita
update_invoice_item	Atualizar um item de linha em uma fatura em Rascunho. Os totais são recalculados automaticamente. Os ids dos itens vêm de get_invoice ou add_invoice_item.	escrita
delete_invoice_item	Remover um item de linha de uma fatura em Rascunho. Os totais são recalculados automaticamente. Os ids dos itens vêm de get_invoice ou add_invoice_item. Chame com confirm:true para excluir; sem isso, retorna uma prévia do item.	escrita, destrutivo
reorder_invoice_items	Definir a ordem de exibição dos itens de linha de uma fatura. Passe a ordem completa desejada: cada id de item com seu display_order baseado em 0. Os ids dos itens vêm de get_invoice ou add_invoice_item.	escrita
update_invoice_matter	Anexar ou desanexar o assunto (dossier) de uma fatura. Puramente organizacional — permitido mesmo após a fatura ser Enviada, mas não em uma fatura Cancelada. Passe matter_id null para desanexar.	escrita
check_certification_status	Atualizar o status de certificação fiscal de uma fatura emitida consultando o provedor de certificação e reconciliando-o no banco de dados. Use após issue_invoice quando certification_status estiver 'processing' ou parecer desatualizado.	escrita
create_credit_note	Cancelar uma fatura Enviada ou Paga emitindo uma nota de crédito (avoir). A nota de crédito é um documento fiscal legal (certificada fiscalmente quando a original foi certificada) e é IMUTÁVEL uma vez criada. IRREVERSÍVEL. SEMPRE obtenha a aprovação explícita do usuário antes de chamar com confirm:true. Sem confirm, retorna uma prévia.	escrita, destrutivo

Retificação e importação (3)

Ferramenta	O que faz	Acesso
rectify_invoice	Criar uma fatura retificadora (facture rectificative) para uma fatura Enviada ou Paga: uma NOVA fatura em Rascunho pré-preenchida a partir da original (mesmo cliente, itens de linha copiados, a menos que substituídos) e legalmente vinculada a ela. A original é marcada como Retificada apenas quando a retificadora é emitida. Chame com confirm:true para criar; sem isso, retorna uma prévia.	escrita
get_rectification_links	Para uma fatura, retornar a cadeia de retificação: a original que ela substitui (se for uma retificadora) e/ou a retificadora que a substituiu (se foi retificada). Ambos null quando a fatura não faz parte de uma cadeia.	leitura
import_external_invoice	Importar uma fatura histórica/externa com SEU PRÓPRIO número de fatura (mantido verbatim), totais e status — sem itens de linha. Use para migrar faturas passadas emitidas fora do Kema Invoice; NÃO para criar novas faturas (use create_invoice).	escrita

Orçamentos (5)

Ferramenta	O que faz	Acesso
create_quote	Criar um orçamento em Rascunho (devis) para uma empresa. Orçamentos não são documentos fiscais — sem certificação. As datas são definidas por padrão no servidor (emissão hoje, vencimento/válido +30 dias). Requer um id de assunto (dossier) ao qual o orçamento pertence.	escrita
send_quote	Transicionar um orçamento em Rascunho para Enviado (o estado voltado ao cliente). Não há certificação envolvida — orçamentos são documentos comerciais. A validação B2B francesa (SIREN/IVA) se aplica quando o locatário é francês.	escrita, destrutivo
accept_quote	Marcar um orçamento Enviado como Aceito pelo cliente. Siga com convert_quote_to_invoice para faturá-lo.	escrita, destrutivo
reject_quote	Marcar um orçamento Enviado como Rejeitado pelo cliente. Isso encerra o ciclo de vida do orçamento. Chame com confirm:true para aplicar; sem isso, retorna uma prévia.	escrita, destrutivo
convert_quote_to_invoice	Criar uma nova fatura em Rascunho a partir de um orçamento Aceito (itens de linha copiados, source_quote_id definido para rastreabilidade). A fatura então segue o ciclo de vida normal (issue_invoice para torná-la legalmente vinculante). Chame com confirm:true para aplicar; sem isso, retorna uma prévia.	escrita

Provisões (6)

Ferramenta	O que faz	Acesso
create_provision	Cria um documento de provisionamento (adiantamento sobre honorários, retainer) no status Rascunho para uma empresa, opcionalmente vinculado a um assunto. NÃO emitido ou certificado — use send_provision para a emissão legal. O IVA é calculado automaticamente por regras fiscais estritas do servidor — nunca pergunte ao usuário pela alíquota de IVA. Provisionamentos usam sua própria série de numeração PROV e, uma vez pagos, tornam-se um crédito do cliente dedutível da fatura final (apply_provisions_to_invoice).	escrita
send_provision	Emite um provisionamento em Rascunho — o ato legal de criá-lo. O rascunho se torna um documento certificado (status Enviado) e é IMEDIATAMENTE submetido à certificação fiscal (série PROV). IRREVERSÍVEL e juridicamente vinculante sob a lei francesa. SEMPRE mostre ao usuário os detalhes do provisionamento e obtenha sua aprovação explícita antes de chamar com confirm:true. Sem confirm, retorna uma prévia do que será certificado.	escrita, destrutivo
mark_provision_paid	Marca um provisionamento emitido (status Enviado/Vencido) como Pago. Um provisionamento pago se torna um crédito do cliente que pode ser deduzido da fatura final desse cliente com apply_provisions_to_invoice.	escrita
list_available_provisions	Lista provisionamentos PAGOS (adiantamentos sobre honorários, retainers) que ainda não foram aplicados a uma fatura final — o crédito dedutível do cliente. Sem matter_id, lista os retainers independentes (sem assunto), que é o caso normal no Kema Invoice; com matter_id, lista os retainers desse assunto. Use antes de apply_provisions_to_invoice.	leitura
apply_provisions_to_invoice	Deduz um ou mais provisionamentos PAGOS de uma fatura final em RASCUNHO do mesmo cliente (e do mesmo assunto quando houver um vinculado). Atualiza advances_total e amount_due da fatura. Reversível enquanto a fatura estiver em Rascunho (remove_provision_from_invoice).	escrita
remove_provision_from_invoice	Desvincula um provisionamento de uma fatura final em RASCUNHO e recalcula seus advances_total / amount_due. O provisionamento fica disponível novamente para aquele assunto.	escrita

Clientes (5)

Ferramenta	O que faz	Acesso
list_companies	Lista as empresas clientes do locatário autenticado (nome, e-mail, IVA/ID fiscal, país). Útil para resolver um ID de empresa antes de outras consultas.	leitura
get_company	Busca uma empresa cliente com o registro completo relevante para cobrança: identidade legal, IVA/SIREN, endereço, dados de contato e classificação do perfil do cliente.	leitura
create_company	Cria uma empresa cliente para o locatário. Um ID de IVA/fiscal é necessário posteriormente para faturá-la como B2B.	escrita
update_company	Atualiza campos de uma empresa cliente existente (nome, dados de contato, endereço, número de IVA, SIREN). Apenas os campos fornecidos são alterados. Corrigir o número de IVA / SIREN / endereço aqui é frequentemente necessário antes que uma fatura para este cliente possa ser certificada.	escrita
delete_company	Exclusão lógica de uma empresa cliente. Bloqueada quando contatos ainda estão vinculados a ela. Chame com confirm:true para excluir; sem isso, retorna uma prévia.	escrita, destrutivo

Perfis de cliente (3)

Ferramenta	O que faz	Acesso
get_invoice_client_profile	Padrões de faturamento por empresa (condições de pagamento, canal de entrega, prefixo personalizado de fatura). Retorna {profile: null} quando a empresa não possui nenhum — os perfis são criados de forma preguiçosa.	leitura
upsert_invoice_client_profile	Cria ou atualiza os padrões de faturamento de uma empresa (condições de pagamento, canal de entrega, prefixo de fatura). Esses padrões pré-preenchem futuras faturas para aquele cliente.	escrita
delete_invoice_client_profile	Remove os padrões de faturamento de uma empresa (a empresa em si não é alterada). Chame com confirm:true para realmente excluir; sem isso, retorna uma prévia.	escrita, destrutivo

Monitoramento (3)

Ferramenta	O que faz	Acesso
get_revenue_summary	Agrega valores de receita: recebidos no período (por data de pagamento), saldo atual em aberto e vencido (em um ponto no tempo), documentos emitidos no período, contagem de rascunhos e efeito líquido de notas de crédito. Padrão para o mês atual.	leitura
get_settings	Instantâneo somente leitura das configurações de faturamento do locatário: identidade legal, país e regime fiscal, alíquota padrão de IVA e condições de pagamento, e-mail de cobrança e o idioma da interface do chamador. As configurações só podem ser ALTERADAS pelo aplicativo.	leitura
list_mcp_activity	Registro de atividade recente do agente do locatário: uma entrada por chamada de ferramenta MCP bem-sucedida (nome da ferramenta, número de fatura relacionado quando conhecido, carimbo de data/hora). Mais recentes primeiro.	leitura

Conformidade e dados

Faturas Factur-X (PDF/A-3 com XML EN 16931) transmitidas por uma plataforma aprovada; dados hospedados na União Europeia (banco de dados e autenticação em AWS eu-north-1, Estocolmo); cada chamada MCP é registrada no aplicativo, seção Atividade do agente. Política de privacidade · Termos de uso · Avisos legais.

Suporte

Conta e faturas: pelo aplicativo (botão Ajuda) ou hello@kema-studio.com. Bug do conector: abrir uma issue.