Saltar al contenido principal

¿Cómo se crea una factura ZUGFeRD en Power Automate? Un flujo de trabajo paso a paso con Dropbox y JSON.

· 16 min de lectura
SEO and Content Writer

Esta guía muestra una guía completa. Power Automate flujo de trabajo que lee un PDF base y factura JSON desde Dropbox, genera un ZUGFeRD/Factor-X factura utilizando PDF4me Crear factura ZUGFeRDy guarda el archivo final en Dropbox.

La secuencia de capturas de pantalla utiliza estas rutas de ejemplo:

  • PDF base: /blog data/zugferd invoice/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • Carpeta de salida: /blog datos/zugferd factura/salida
La versión corta

1. Activar flujo manualmente → 2. Obtener archivo PDF base (Dropbox) → 3. Obtener archivo JSON (Dropbox) → 4. Crear factura ZUGFeRD (PDF4me, formato de entrada = JSON, modo de salida = PDF con XML) → 5. Crear archivo (carpeta de salida de Dropbox).

Recuerda esto cuando configures el paso 4.

Colocar Formato de entrada = JSON, entonces solo el mapa Datos JSON de la factura. Mantener Datos XML de la factura y Datos CSV de facturas vacío en esta carrera. Para PDF con XML, Contenido del archivo PDF es obligatorio y debe provenir del paso PDF base.

Lo que estás construyendo

Usted produce un Factura híbrida en formato PDF A partir de una plantilla PDF y datos JSON estructurados, el resultado es adecuado para equipos que necesitan un PDF legible con datos de factura en formato legible por máquina, empaquetados según las convenciones ZUGFeRD/Factur-X.


De un vistazo: los cinco pasos

1Trigger
2Get PDF
3Get JSON
4Create ZUGFeRD
5Save output

Por qué funciona este diseño de flujo de trabajo

Entradas separadas

Los archivos PDF y JSON se obtienen de forma independiente, por lo que puede actualizar los archivos de carga útil sin modificar el flujo visual de la plantilla PDF.

Paso de generación única

Crear factura ZUGFeRD Recibe ambas fuentes de contenido en un solo lugar y devuelve un archivo de salida que Dropbox puede utilizar directamente. Crear archivo.

Fácil de ramificar más adelante

Tras la generación, puede añadir validación, notificaciones, entrega a ERP/API o enrutamiento de archivos sin necesidad de reestructurar el flujo principal.


Antes de empezar

Lista de verificación
  • Power Automate entorno con permiso para crear flujos en la nube.
  • Clave API de PDF4meConfiguración inicial: Conectar PDF4me con Power Automate.
  • Conexión a Dropbox con acceso de lectura a los archivos de origen y acceso de escritura a la carpeta de salida.
  • Una carga útil JSON de factura válida y un archivo PDF base disponibles en Dropbox.

Archivos de entrada utilizados en este tutorial

Vista previa del documento PDF base utilizado como entrada PDF para la acción Crear factura ZUGFeRD

Archivo PDF base de entrada.

Contenido de la carga útil JSON de la factura que muestra los campos de la factura asignados a la generación ZUGFeRD

Entrada de datos JSON de la factura.


El flujo en resumen (cinco pasos)

  1. Activar manualmente un flujo: Se ejecuta bajo demanda durante la configuración.
  2. Obtener archivo PDF base (Dropbox): Lee los bytes del PDF de la plantilla.
  3. Obtener archivo JSON (Dropbox): Lee los bytes/contenido JSON de la factura.
  4. Crear factura ZUGFeRD (PDF4me): Combina entradas utilizando el modo JSON.
  5. Crear archivo (Dropbox): Almacena la salida generada en la carpeta de destino.

Descripción general del flujo

Flujo de Power Automate: Activar manualmente un flujo, Obtener archivo PDF base, Obtener archivo JSON, Crear factura ZUGFeRD, Crear archivo

Cadena de flujo completa utilizada para este patrón de generación ZUGFeRD.


Paso 1: Obtener el archivo PDF base (Dropbox)

Flujo hasta ahora: Activador → Obtener archivo PDF base.

  1. Agregar Dropbox Acción para obtener el contenido del archivo por ruta.
  2. Colocar Ruta del archivo a la plantilla base PDF (ejemplo: /blog data/zugferd invoice/simplepdf.pdf).
  3. En opciones avanzadas, mantenga Inferir tipo de contenido = Sí.
  4. Guarda y prueba este paso; asegúrate de que devuelve el contenido del archivo/salida binaria.
Acción Dropbox Obtener archivo PDF base que muestra la ruta del archivo datos del blog zugferd factura simplepdf.pdf e Inferir tipo de contenido Sí

Captura de pantalla del paso 1: ruta base del PDF e inferencia de contenido configuradas.


Paso 2: Obtener el archivo JSON (Dropbox)

Flujo hasta ahora: Activador → Obtener PDF base → Obtener archivo JSON.

  1. Agregar otra acción de contenido de archivos de Dropbox.
  2. Colocar Ruta del archivo a los datos JSON de su factura (ejemplo: /blog data/zugferd invoice/sample-invoice.json).
  3. Mantener Inferir tipo de contenido = Sí.
  4. Guarda y prueba; confirma que el contenido JSON esté disponible para el mapeo en el paso 3.
Dropbox Obtener archivo JSON Acción que muestra la ruta del archivo datos del blog zugferd factura sample-invoice.json e Inferir tipo de contenido Sí

Captura de pantalla del paso 2: Archivo fuente JSON de Dropbox.


Paso 3: Crear factura ZUGFeRD (PDF4me)

Flujo hasta ahora: Activador → Obtener PDF base → Obtener JSON → Crear ZUGFeRD.

Configurar PDF4me, Crear factura ZUGFeRD como se muestra:

  1. Nombre del archivo: nombre del PDF de origen (ejemplo: Prueba.pdf).
  2. Contenido del archivo PDF: mapa de Obtener archivo PDF base.
  3. Nombre del archivo de salida: nombre del archivo de salida deseado (ejemplo: Factura de Zugferd.pdf).
  4. Formato de entrada: establecido en JSON.
  5. Modo de salida: establecido en PDF con XML.
  6. Datos JSON de la factura: mapa de Obtener archivo JSON.
  7. Nivel de conformidad: ejemplo: BÁSICO.
  8. Versión ZUGFeRD: ejemplo: 1.0 (o la versión que necesite).
  9. Generar factura en PDF: ejemplo: .
Crear acción de factura ZUGFeRD mostrando nombre de archivo, contenido del archivo PDF, nombre del archivo de salida, formato de entrada JSON, modo de salida PDF con XML, datos JSON de la factura, conformidad BASIC, versión ZUGFeRD 1.0, renderizar factura en PDF Sí

Captura de pantalla del paso 3: asignación completa de parámetros para la generación de ZUGFeRD basada en JSON.


Paso 4: Crear archivo (Dropbox)

Flujo hasta ahora: Activar → Leer PDF + JSON → Generar ZUGFeRD → Guardar archivo.

  1. Agregar Dropbox: Crear archivo.
  2. Ruta de la carpeta: carpeta de destino de salida (ejemplo: /blog datos/zugferd factura/salida).
  3. Nombre del archivo: mapear el nombre del archivo de salida desde Crear factura ZUGFeRD.
  4. Contenido del archivo: mapear contenido de archivo generado desde Crear factura ZUGFeRD.
  5. Guarda y ejecuta el flujo completo.
Dropbox Crear acción de archivo con ruta de carpeta datos del blog salida de factura zugferd y nombre de archivo asignado y contenido del archivo de Crear factura ZUGFeRD

Captura de pantalla del paso 4: escritura del archivo de salida en Dropbox.


Verificación de salida

Ejemplos de salida abiertos
Salida visual del PDF de la factura ZUGFeRD generada después de la acción Crear factura ZUGFeRD

Factura generada en formato PDF.

La salida se abrió con un panel adjunto que muestra los datos XML incrustados en el PDF de la factura ZUGFeRD generada.

Vista adjunta que muestra los datos estructurados de la factura incrustados.


Referencia rápida

#PasoMapeo de claves
1Get Base PDF FileFile path to template PDF + Infer Content Type = Yes
2Get JSON FileFile path to invoice JSON + Infer Content Type = Yes
3Create ZUGFeRD InvoicePDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2
4Create fileFile Name and File Content from Create ZUGFeRD Invoice output

Referencias de parámetros profundos: Crear factura ZUGFeRD, Validar PDF.


Solución de problemas

La generación falla debido a la asignación de entrada.

Si Formato de entrada = JSON, solo mapa Datos JSON de la factura. Borrar los campos XML/CSV para esta ejecución.

Desajuste del modo de salida

Con PDF con XML, desaparecido Contenido del archivo PDF provoca errores. Mapea los bytes del archivo desde el paso PDF base.

Errores 401, 402 o problemas de conexión.

Ver Solución de problemas de PDF4me para comprobaciones de clave API, créditos y autorización del conector.


¿Qué probar a continuación?

Endurecimiento opcional: agregue un Condición Después del paso 3 para comprobar la presencia de la salida, se realiza una bifurcación hacia las notificaciones de éxito/fracaso antes de la escritura final del archivo.