Una herramienta especializada para generar facturas electrónicas compatibles con ZUGFeRD 2.1 y Factur-X con soporte para la fusión visible de PDFs de varias páginas.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install zugferd-invoice
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar zugferd-invoice usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es zugferd-invoice?
La skill zugferd-invoice es una solución técnica diseñada para desarrolladores y empresas que necesitan cumplir con los mandatos alemanes y europeos de facturación electrónica. Permite la creación de documentos compatibles con ZUGFeRD 2.1 y Factur-X, esenciales para transacciones B2B y gubernamentales. Al utilizar Openclaw Skills, los usuarios pueden automatizar el complejo proceso de incrustar XML legible por máquina en archivos PDF/A-3b legibles por humanos.
Esta skill destaca por ofrecer un flujo de trabajo único que fusiona documentos complementarios, como informes de tiempo o registros de gastos, directamente en las páginas visibles de la factura en PDF. Esto asegura que el documento final sea legalmente conforme bajo los estándares EN16931 y fácil de revisar para los destinatarios humanos. Al aprovechar potentes herramientas de código abierto como MustangProject y GhostScript, esta skill proporciona una alternativa robusta a las costosas API de facturación propietarias.
Casos de uso de zugferd-invoice
- Generación de facturas electrónicas compatibles con ZUGFeRD 2.1 para requisitos alemanes de B2B y sector público (Leitweg-ID).
- Fusión de múltiples documentos PDF en una única factura visible de varias páginas, manteniendo el cumplimiento de PDF/A-3b.
- Automatización de la generación de facturas electrónicas Factur-X para el mercado francés utilizando Openclaw Skills.
- Validación de facturas PDF existentes para asegurar que cumplen con las especificaciones técnicas EN16931 para el intercambio electrónico de datos.
Cómo funciona zugferd-invoice
- La skill primero extrae los metadatos XML ZUGFeRD de la factura electrónica de origen para preservar los datos técnicos.
- Utiliza GhostScript para fusionar el PDF de la factura principal con cualquier adjunto secundario en un documento único de varias páginas.
- El documento fusionado se convierte al formato estricto PDF/A-3b para cumplir con los estándares de archivo y cumplimiento.
- Utilizando la biblioteca MustangProject, el XML extraído previamente se incrusta de nuevo en la estructura del PDF fusionado.
- Se realiza una comprobación de validación final para confirmar que el resultado es un documento ZUGFeRD válido listo para su presentación.
Configuración de zugferd-invoice
Para comenzar con esta skill, primero instale las dependencias necesarias del sistema:
brew install openjdk@21 ghostscript
A continuación, descargue el archivo JAR de MustangProject en el directorio correspondiente:
mkdir -p ~/.openclaw/tools/mustang
curl -L https://github.com/ZUGFeRD/mustangproject/releases/download/core-2.22.0/mustang.jar -o ~/.openclaw/tools/mustang/mustang.jar
Incorpore Java a su PATH y ejecute el flujo de trabajo de Openclaw Skills a través de Python:
export PATH="/opt/homebrew/opt/openjdk@21/bin:$PATH"
python3 scripts/zugferd_pages_workflow.py --invoice Rechnung.pdf --attachment Zeitnachweis.pdf --output Rechnung_komplett.pdf
Esquema de datos y taxonomía de zugferd-invoice
La skill gestiona los datos de facturación mediante un flujo de trabajo estructurado de entrada/salida. Garantiza que se preserven tanto los elementos visuales como los metadados.
| Elemento de Datos | Tipo | Descripción |
|---|---|---|
| Factura PDF | Entrada | La factura PDF/A-3 principal que contiene el XML ZUGFeRD original. |
| Adjunto | Entrada | Archivos PDF adicionales (ej. informes) para ser fusionados o adjuntados. |
| PDF de Salida | Salida | Un archivo PDF/A-3b validado, de varias páginas, con metadados XML incrustados. |
| Esquema XML | Metadatos | Sigue las especificaciones ZUGFeRD 2.1 / Factur-X (EN16931). |
Funciones avanzadas de zugferd-invoice
- Fusión de Páginas Visibles: A diferencia de las herramientas estándar que solo adjuntan archivos, esta utilidad de Openclaw Skills hace que los adjuntos sean visibles como páginas adicionales.
- Flujo de Trabajo de Adjunto Alternativo: Incluye un modo secundario para casos en los que los PDF de origen tienen perfiles ICC incompatibles, asegurando que los archivos se sigan incrustando como adjuntos.
- Validación Automatizada: Validación integrada de MustangProject para proporcionar comentarios inmediatos sobre el estado de cumplimiento de PDF/A y ZUGFeRD.
- Sin Dependencia de API: Lógica totalmente autoalojada y de código abierto, eliminando la dependencia de servicios de facturación externos de pago.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Calendario Económico
Una utilidad de scraping especializada que recupera eventos macroeconómicos e indicadores financieros de Investing.com sin necesidad de una clave API.
Inspector de DevTools del Navegador
Una utilidad automatizada para capturar y analizar datos de consola, red y rendimiento del navegador para la depuración profesional de frontend.
Skill YaCy
Gestione e integre un motor de búsqueda YaCy local y descentralizado en sus flujos de trabajo de IA para búsquedas web privadas.
tokenQrusher
tokenQrusher es un sistema de optimización de alto rendimiento que reduce drásticamente el uso de tokens de agentes de IA mediante el filtrado inteligente de contexto y la gestión de latidos.
Eliminación de Inyección de Prompts
Un sistema de sanitización de confianza cero diseñado para eliminar instrucciones adversas e inyecciones de prompts de contenido externo no confiable.
Fotografía de Retrato Google Imagen 3
Una habilidad de IA de alta fidelidad diseñada para generar fotografía de retrato profesional y headshots utilizando las capacidades avanzadas de renderizado de Google Imagen 3.
Presentado*
