Factur-X by Orvel

Servidor MCP de Factur-X

Genera, valida y lee facturas electrónicas Factur-X / EN 16931 a través de MCP o REST.
Alojado por Orvel. Factur-X PDF/A-3 · CII · UBL 2.1 · Reglas francesas fr-ctc.

Demo y configuración de MCP · Precios y asignaciones · Informes de conformidad · Estado

Endpoint: https://facturx.orvel.dev/mcp (HTTP transmisible)
Identificador de registro: io.github.LeBorgneAntoine/facturx

Para desarrolladores que integran generación, validación o extracción de facturas en un ERP, SaaS o flujo de trabajo de agentes. El servicio produce y verifica archivos; no es una Plateforme Agréée ni un punto de acceso Peppol y no entrega facturas a los destinatarios.

Prueba antes de pagar

Las muestras sintéticas fijas y las herramientas auxiliares funcionan sin clave de API. Prueba el informe de muestra válida y el informe de muestra inválida, o conecta un cliente MCP y pregunta:

Muestra la demo de factura inválida y explica sus hallazgos. No subas ni proceses mis documentos.

La demo solo acepta sus muestras incluidas. No es procesamiento gratuito de tus propias facturas.

Prueba tus propios documentos: las cuentas verificadas elegibles pueden iniciar una prueba limitada de 10 operaciones durante 14 días, con hasta 30 intentos de procesamiento, sin tarjeta y sin renovación. La disponibilidad de lanzamiento es limitada. Comienza en el espacio de trabajo Factur-X. Consulta las asignaciones, precios y términos actuales de pago antes de comprar.

Conectar

Para tus propios documentos con una cuenta: conecta un cliente MCP compatible con OAuth a https://facturx.orvel.dev/mcp/account, autentícate en el navegador y aprueba el acceso a tu plan de prueba o vinculado. Las integraciones existentes de /mcp y las muestras fijas públicas siguen disponibles. Vuelve a autenticarte al cambiar de endpoint; los tokens son específicos de cada endpoint.

Para Cursor, una conexión sin clave en .cursor/mcp.json puede inspeccionar el servicio y ejecutar la demo fija:

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

Para el procesamiento de documentos de pago, añade "headers": { "Authorization": "Bearer YOUR_KEY" } a la configuración del servidor usando tu propia clave. Mantén las credenciales fuera del control de versiones. La misma clave y cuota cubren REST y MCP.

Para la configuración de OAuth, Claude, VS Code y otros clientes, usa la guía de conexión MCP mantenida.

Herramientas

Herramienta	Propósito
view_invoice_demo	Inspecciona muestras sintéticas fijas válidas/inválidas sin subir un documento
get_invoice_example	Obtén ejemplos estructurados de facturas o notas de crédito
explain_finding	Explica una regla de validación
check_party	Verifica una parte de la factura
check_invoice_parties	Verifica vendedor y comprador juntos
generate_invoice	Genera Factur-X PDF/A-3, CII o UBL desde JSON de factura
embed_xml	Incrusta XML CII en un PDF existente
validate_invoice	Verifica tu documento y devuelve hallazgos estructurados
extract_invoice	Extrae campos de factura de PDF/XML
draft_credit_note	Redacta una nota de crédito completa o parcial

Cada herramienta describe sus entradas y requisitos de acceso. Las operaciones de documentos consumen cuota; un cliente no debe reintentar una operación completada a ciegas.

Perfiles de generación: BASIC WL, EN 16931, EXTENDED y EXTENDED-CTC-FR. La generación UBL admite EN 16931 y EXTENDED-CTC-FR. La lectura/validación también admite otros perfiles Factur-X; consulta la referencia de API.

Verifica el resultado

Lee valid, findings, checks_run y checks_skipped en el informe. Una respuesta HTTP exitosa por sí sola no establece qué comprobaciones se ejecutaron, la certificación PDF/A independiente o la entrega exitosa a una PA.

Los archivos de muestra publicados y los informes de validación independientes de Mustangproject están disponibles en la página de conformidad, con alcance y advertencias conocidas.

API REST

El mismo motor está disponible a través de:

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

La generación espera {"invoice": {...}, "options": {...}}, no JSON de factura simple. Usa Accept: application/json para devolver el contenido del archivo en base64 junto con los totales y el informe de validación en una sola solicitud.

OpenAPI · Referencia REST

Flujo de trabajo n8n

Importa el flujo de trabajo de facturas n8n gratuito para generar un PDF y verificar su informe de validación en una sola solicitud de API. La plantilla usa nodos integrados y tus propias credenciales de API. El acceso a la API y la cuota siguen las ofertas de cuenta actuales.

Acerca de

Construido y operado por Orvel. Privacidad · Términos · Soporte: support@orvel.dev.

Este repositorio contiene el manifiesto público, los activos de marca y los ejemplos de conexión del servicio alojado. El motor en sí es de código cerrado.