Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Insertar un código QR de factura suiza en un número de página personalizado en Power Automate (flujo de Dropbox de 4 acciones con PDF4me)

· 22 min de lectura
Sankalp Mishra
SEO and Content Writer

La mayoría de los tutoriales de billetes QR suizos colocan el comprobante de pago en página 1 (o agregarlo al final). Las facturas reales a menudo lo necesitan. en algún punto intermedio: un paquete de contrato de 10 páginas donde la factura QR va justo después del resumen, o un estado de cuenta trimestral donde el comprobante debe seguir a la página de portada. El conector PDF4me Power Automate maneja eso en una sola acción a través de Opciones de paginación = personalizadas más un Número de página campo. Esta guía describe la ejecución exacta capturada en el lienzo: /pdf4metest/sample/10 page.pdf se convierte en un archivo compatible con Suiza con la factura QR insertada como página 3, luego subido a /pdf4meoutput con un nombre con prefijo GUID para que las ejecuciones repetidas no entren en conflicto. 4 acciones, cero código, se ejecuta en segundos.

El flujo de un vistazo
1. Manually trigger a flow
Manual trigger for testing. Swap for any storage trigger in production.
2. Dropbox Get file content
Reads /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Output Format Type PNG (try PDF for hybrid). Paging Options custom, Page Number 3. All payment fields filled.
4. Dropbox Create file
Writes to /pdf4meoutput. File Name built from guid() plus headers/FileName so every run lands as a unique file.
La versión corta

Cuatro acciones de Power Automate. El activador manual inicia el flujo. Dropbox Obtener el contenido del archivo lecturas /pdf4metest/muestra/página 10.pdf con Inferir tipo de contenido configurado en Sí. PDF4me Código de barras - Crear factura SwissQR adjunta una página de factura QR compatible con los estándares de pago suizos con Tipo de formato de salida PNG (en esta carrera; elegir PDF para el contenedor híbrido, además JPEG y Pelea disponible), IBAN CH4431999123000889012, Cantidad 5253531, Divisa insuficiencia cardíaca congestiva, Tipo de referencia QRR, Idioma Inglés, Línea separadora Línea con tijeras, Acreedor Var Schneider AG (Dirección S, biel 2501), Deudor final Pia-Maria Rutschmann-Schnyder (Dirección S, Biel 9400), Referencia 210000000003139471430009017, además de los parámetros completos del esquema alternativo AV1 y AV2. En Parámetros avanzados: Opciones de paginación costumbre y Número de página 3Dropbox Crear archivo escribe a /pdf4meoutput con Nombre del archivo construido a partir de guid() + encabezados/nombre de archivo para garantizar su unicidad. Salida: un archivo escaneable por bancos suizos en la carpeta de archivo.

Tres factores que determinan si su documento es apto para escaneo bancario Y aparece en la página correcta.

Primero, el El IBAN debe comenzar con CH o LI. y tener un máximo de 21 caracteres. Para el tipo de referencia QRR, el IBAN debe ser un QR-IBAN, no un IBAN estándar. En segundo lugar, cuando el tipo de referencia es QRR, la referencia es un Número de 27 dígitos con dígito de control módulo 10.. Si no tienes uno, cambia a PUNTUACIÓN o NO. Tercero, Las opciones de paginación y el número de página solo se aplican cuando el tipo de formato de salida es PDF.Los tipos de formato de imagen (PNG, JPEG, Tiff) ignoran ambos porque la salida es una imagen independiente, no un documento de varias páginas.

Esto resuelve preguntas comunes del mundo real.​

La gente busca este problema exacto con frases como:

  • "¿Cómo puedo insertar un código QR de un billete suizo en una página específica de mi PDF en Power Automate?" Utilice el tipo de formato de salida PDFOpciones de paginación customy el número de página con el índice de páginas basado en 1 (3 en esta guía).
  • "¿Puedo generar el código QR suizo como una imagen PNG en lugar de una página PDF?" Sí. Establezca el tipo de formato de salida en PNG, JPEG, o Tiff y la acción devuelve una imagen independiente del recibo, sin tener en cuenta las opciones de paginación.
  • "¿Cómo puedo asegurarme de que el nombre de mi archivo de salida no entre en conflicto al ejecutarlo de nuevo?" Utilice un guid() Expresión de Power Automate en el campo Nombre de archivo de la carga de Dropbox, opcionalmente concatenada con headers/FileName a partir de la salida de PDF4me.
  • "¿Qué se incluye en los parámetros avanzados de la acción de Power Automate?" Cuatro campos: Número de página, Opciones de paginación, Contenido del archivo (PDF de origen), Nombre del archivo. Haga clic. Mostrar todo en parámetros avanzados para exponerlos.
  • "¿Escanearán los bancos suizos un billete con código QR en formato PNG?" Sí. La codificación QR es idéntica tanto para archivos PDF como para imágenes. PNG es la opción adecuada para correos electrónicos o comprobantes integrados en la web; PDF para la factura completa y el comprobante de entrega.

Lo que estás construyendo​

Un flujo reutilizable de Power Automate de 4 acciones que produce una factura escaneable por bancos suizos con el código QR en la factura. cualquier página que elijasEl mismo flujo se aplica al caso de imágenes independientes (se omite el PDF de origen y se cambia el tipo de formato de salida a PNG/JPEG/TIFF) para los recordatorios de pago integrados en el correo electrónico.

Lienzo de flujo de Power Automate con cuatro acciones: Activar manualmente un flujo, Dropbox Obtener contenido de archivo, Código de barras - Crear factura SwissQR, Dropbox Crear archivo.

Cuatro acciones, de arriba a abajo. El activador manual facilita las pruebas del flujo; en producción, puede sustituirse por cualquier activador de almacenamiento.

Lo que necesitas​

  • Power Automate cuenta con un flujo abierto. Abrir Power Automate.
  • Clave API de PDF4me. Obtén tu clave APIInicie sesión en el conector PDF4me Connect la primera vez que arrastre la acción.
  • Dropbox con /pdf4metest/muestra como la carpeta de origen y /pdf4meoutput como destino. Cualquier almacenamiento funciona: SharePoint, OneDrive, Dataverse se asignan de la misma manera.
  • Una factura en formato PDF. Descargue la muestra de 10 páginas. A partir de las capturas de pantalla, siga las instrucciones al pie de la letra.
  • Datos de pago suizos: CH o LI IBAN (máximo 21 caracteres), Importe, Moneda (insuficiencia cardíaca congestiva o EUR), bloques completos de nombre/dirección del acreedor + deudor final. Referencia completa del campo en el documentos de acción.

Referencia rápida: los 4 campos que determinan el resultado.​

Output Format Type
PDF (hybrid), PNG, JPEG, or Tiff. Picks the container of the populated output.
Paging Options
first, last, add at end, or custom. PDF Output Format Type only.
Page Number
1-based page index. Required when Paging Options is custom; ignored otherwise. Set to 3 in this run.
File Content + File Name
The source PDF, mapped from a previous action. Skip both for a standalone QR-slip from payment data alone.

Construye el flujo​

Acción 1: Activar manualmente un flujo​

Disparador manual para pruebas. En producción, cambiar por Dropbox Cuando se crea un archivo, SharePoint Cuando se crea un archivo, OneDrive Cuando se crea un archivo, Outlook Cuando llega un nuevo correo electrónico, Reaparición, o Webhooks dependiendo de tu flujo de trabajo de AR.

Acción 2: Dropbox - Obtener el contenido del archivo​

Extraiga la factura original de su carpeta de entrada.

CampoValor utilizado en esta ejecución
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Acción Obtener contenido de archivo de Dropbox de Power Automate con Archivo /pdf4metest/sample/10 page.pdf y parámetro avanzado Inferir tipo de contenido Sí.

Acción 3: Código de barras PDF4me - Crear factura SwissQR​

La acción que realiza el trabajo. Buscar PDF4me en el selector de acciones y selección Código de barras - Crear factura SwissQR. La acción tiene los campos de pago en el panel principal y 4 campos debajo Parámetros avanzados (Opciones de paginación, número de página, contenido del archivo, nombre del archivo). Configurar:

GrupoCampoValor
OutputOutput Format TypePNG
PaymentIBANCH4431999123000889012
PaymentAmount5253531
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeperator LineLineWithScissor
CreditorCreditor NameVar Schneider AG
CreditorCreditor Address TypeS
CreditorCreditor: Address Line 1Var Schneider AG
CreditorCreditor: Address Line 223
CreditorCreditor PostalCode2501
CreditorCreditor Citybiel
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor AddressTypeS
DebtorUltimate Debtor: Address Line 1Grosse Marktgasse
DebtorUltimate Debtor: Address Line 233
DebtorUltimate Debtor PostalCode9400
DebtorUltimate Debtor Citybiel
Ref/MsgReference210000000003139471430009017
Ref/MsgUnstructured MessageInstruction of 15.09.2019
Ref/MsgBilling InfoS1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
Ref/MsgAV1 ParametersName AV1: UV;UltraPay005;12345
Ref/MsgAv2 ParametersName AV2: XY;XYService;54321
AdvancedPaging Optionscustom
AdvancedPage Number3
AdvancedFile ContentFile Content (from Action 2)
AdvancedFile Nameabc.pdf

Acción 4: Dropbox - Crear archivo​

Guarde el archivo con el contenido asignado y con un nombre único que comience con un GUID para evitar conflictos al ejecutarlo de nuevo.

CampoValor utilizado en esta ejecución
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3 dynamic content)
Acción Crear archivo de Dropbox de Power Automate con Ruta de carpeta /pdf4meoutput, Nombre de archivo creado a partir de guid() y encabezados/expresión de nombre de archivo, y Contenido de archivo contenido dinámico de la acción Crear factura SwissQR de PDF4me.

El guid() La expresión en el nombre del archivo garantiza un nombre único en cada ejecución. Concatenación encabezados/nombre de archivo La salida de PDF4me conserva el nombre de la factura original dentro del nuevo nombre de archivo.

Guardar y hacer clic PruebaEl archivo escaneable por el banco suizo llega a /pdf4meoutput.

Get your API KeyFull action reference

Las 4 opciones de tipo de formato de salida, una al lado de la otra.​

PDF
Hybrid output: QR-bill page inserted into your source invoice. Most common for outgoing AR. Uses Paging Options + Page Number.
PNG
Standalone raster image of the QR-bill slip. Best for inline email embeds and web previews. Ignores Paging Options.
JPEG
Compressed raster image. Smaller file size than PNG. Still bank-scannable.
Tiff
Lossless raster archive format. Use when the recipient needs print-grade quality.

Solución de problemas​

QR-bill landed on the wrong page
Check Paging Options. custom uses Page Number. first puts the slip as the new page 1. last appends at the end. Only applies when Output Format Type is PDF.
Page Number is greyed out / ignored
Paging Options is something other than custom. Switch Paging Options to custom and the Page Number field becomes active.
QR-bill page is blank or unreadable
IBAN is invalid (must start with CH or LI, max 21 chars) or Currency is something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Bank rejects a QRR reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
Create file writes an empty file
File Content on Action 4 is not bound to the PDF4me File Content output. Click the field and re-pick the dynamic content from Action 3.
Want a standalone QR slip without a source invoice
Skip Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters and the action returns a standalone Swiss QR-bill in the chosen Output Format Type.

Cuándo utilizar este patrón​

Slip on a specific mid-document page
Quarterly statement where the QR-bill belongs right after the cover page. Contract pack with the slip after the summary.
Inline email PNG payment reminders
Output Format Type PNG, skip the source PDF, embed the slip image directly in an Outlook Send email body.
High-volume AR archival
guid()-prefixed Dropbox upload makes every run uniquely addressable for downstream search and audit.
Subscription billing
QR-IBAN plus QRR Reference identifies the customer or contract every recurring run.

¿Qué leer a continuación?​

Preguntas frecuentes​

How do I insert the Swiss QR-bill on a specific page in Power Automate?+
Click Show all on Advanced parameters in the PDF4me Barcode - Create SwissQR Bill action. Set Paging Options to custom, then set Page Number to the 1-based page index where the QR-bill should land (3 in this guide). Output Format Type must be PDF for Paging Options to take effect.
What is the difference between Paging Options values first, last, add at end, and custom?+
first inserts the QR-bill as the new page 1 (everything else shifts down by one). last appends at the very end of the source PDF. add at end is a functional alias for last. custom uses the Page Number field to insert at a specific 1-based position.
Why does the QR-bill not move when I change Paging Options?+
Output Format Type is set to PNG, JPEG, or Tiff. Image formats ignore Paging Options because the output is a standalone slip image, not a multi-page document. Switch Output Format Type to PDF.
Can I generate a Swiss QR-bill image (PNG) without a source invoice?+
Yes. Set Output Format Type to PNG (or JPEG / Tiff). Skip the File Content and File Name fields under Advanced parameters. The action returns a standalone QR-bill image you can embed inline in an Outlook email or display on a web page.
Why use guid() in the Dropbox Create file File Name?+
It guarantees every run lands as a unique file in /pdf4meoutput so re-runs do not silently overwrite previous outputs. Concatenating headers/FileName from the PDF4me output keeps the original invoice name inside the new filename for traceability.
My IBAN starts with DE / FR / IT, can I still use this?+
No. Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs use the Generate EPC QR Code for SEPA action instead.
Address Type S vs K, which one should I pick?+
S (Structured) is the modern default and the recommended choice for new integrations. PostalCode and City go in separate fields; Address Line 1 / 2 carries the street. K (Combined) puts the full address into two free-text Address Line fields and leaves PostalCode and City empty.
Same flow in Make, Zapier, or n8n?+
Yes. The same PDF4me Create Swiss QR Bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the action reference page.

Comience​

Get your API KeyPDF4me ConnectAction reference