Factur-X by Orvel

Servidor MCP Factur-X

Gere, valide e leia faturas eletrônicas Factur-X / EN 16931 via MCP ou REST.
Hospedado pela Orvel. Factur-X PDF/A-3 · CII · UBL 2.1 · Regras francesas fr-ctc.

Demonstração e configuração do MCP · Preços e permissões · Relatórios de conformidade · Status

Endpoint: https://facturx.orvel.dev/mcp (HTTP transmissível)
Identificador do registro: io.github.LeBorgneAntoine/facturx

Para desenvolvedores que integram geração, validação ou extração de faturas em um ERP, SaaS ou fluxo de trabalho de agentes. O serviço produz e verifica arquivos; não é uma Plateforme Agréée nem um ponto de acesso Peppol e não entrega faturas aos destinatários.

Experimente antes de pagar

Amostras sintéticas fixas e ferramentas auxiliares funcionam sem chave de API. Experimente o relatório de amostra válida e o relatório de amostra inválida, ou conecte um cliente MCP e pergunte:

Mostre a demonstração de fatura inválida e explique suas descobertas. Não envie nem processe meus documentos.

A demonstração aceita apenas suas amostras incluídas. Não é processamento gratuito das suas próprias faturas.

Experimente seus próprios documentos: contas verificadas elegíveis podem iniciar uma avaliação limitada de 10 operações em 14 dias, com até 30 tentativas de processamento, sem cartão e sem renovação. A disponibilidade de lançamento é limitada. Comece no espaço de trabalho Factur-X. Consulte as permissões, preços e termos pagos atuais antes da compra.

Conectar

Para seus próprios documentos com uma conta: conecte um cliente MCP compatível com OAuth a https://facturx.orvel.dev/mcp/account, autentique no navegador e aprove o acesso à sua avaliação ou plano vinculado. As integrações /mcp existentes e as amostras fixas públicas permanecem disponíveis. Autentique novamente ao alternar endpoints; os tokens são específicos do endpoint.

Para Cursor, uma conexão sem chave em .cursor/mcp.json pode inspecionar o serviço e executar a demonstração fixa:

{
  "mcpServers": {
    "facturx": {
      "url": "https://facturx.orvel.dev/mcp"
    }
  }
}

Para processamento pago de documentos, adicione "headers": { "Authorization": "Bearer YOUR_KEY" } à configuração do servidor usando sua própria chave. Mantenha as credenciais fora do controle de versão. A mesma chave e cota cobrem REST e MCP.

Para configuração OAuth, Claude, VS Code e outros clientes, use o guia de conexão MCP mantido.

Ferramentas

Ferramenta	Finalidade
view_invoice_demo	Inspecionar amostras sintéticas fixas válidas/inválidas sem enviar um documento
get_invoice_example	Obter exemplos estruturados de fatura ou nota de crédito
explain_finding	Explicar uma regra de validação
check_party	Verificar uma parte da fatura
check_invoice_parties	Verificar vendedor e comprador juntos
generate_invoice	Gerar Factur-X PDF/A-3, CII ou UBL a partir de JSON de fatura
embed_xml	Incorporar XML CII em um PDF existente
validate_invoice	Verificar seu documento e retornar descobertas estruturadas
extract_invoice	Extrair campos de fatura de PDF/XML
draft_credit_note	Elaborar uma nota de crédito total ou parcial

Cada ferramenta descreve suas entradas e requisitos de acesso. Operações de documento consomem cota; um cliente não deve repetir uma operação concluída às cegas.

Perfis de geração: BASIC WL, EN 16931, EXTENDED e EXTENDED-CTC-FR. A geração UBL suporta EN 16931 e EXTENDED-CTC-FR. Leitura/validação também suporta outros perfis Factur-X; consulte a referência da API.

Verifique o resultado

Leia valid, findings, checks_run e checks_skipped no relatório. Uma resposta HTTP bem-sucedida por si só não estabelece quais verificações foram executadas, certificação PDF/A independente ou entrega bem-sucedida a uma PA.

Arquivos de amostra publicados e relatórios de validação independentes do Mustangproject estão disponíveis na página de conformidade, com escopo e avisos conhecidos.

API REST

O mesmo mecanismo está disponível através de:

• POST /v1/invoices/generate
• POST /v1/invoices/embed
• POST /v1/invoices/validate
• POST /v1/invoices/extract

A geração espera {"invoice": {...}, "options": {...}}, não JSON de fatura simples. Use Accept: application/json para retornar o conteúdo do arquivo em base64 junto com totais e o relatório de validação em uma única solicitação.

OpenAPI · Referência REST

Fluxo de trabalho n8n

Importe o fluxo de trabalho de fatura n8n gratuito para gerar um PDF e verificar seu relatório de validação em uma única solicitação de API. O modelo usa nós integrados e suas próprias credenciais de API. O acesso à API e a cota seguem as ofertas de conta atuais.

Sobre

Construído e operado pela Orvel. Privacidade · Termos · Suporte: support@orvel.dev.

Este repositório contém o manifesto público, ativos de marca e exemplos de conexão do serviço hospedado. O mecanismo em si é de código fechado.