Saltar al contenido principal

Crear factura SwissQR en Make

Lo que hace este módulo

PDF4me Crear factura SwissQR adjunta un suizo conforme QR Comprobante de pago de factura a un existente PDF documento. Añade la sección estandarizada completa requerida por las Normas de Pago Suizas (ISO 20022) para facturación dentro de Suiza y Liechtenstein. Proporcione su factura. PDF, los detalles del acreedor y del deudor, IBANSe introducen el importe y la referencia, y el módulo devuelve el mismo documento con el comprobante de pago adjunto. Todos los bancos suizos aceptan este resultado para iniciar el pago a través de su aplicación de banca móvil.

Entradas de blog relacionadas(2)
Documento Word, factura con código QR suizo y un PDF base. Make los combina en uno solo. ¡Seis módulos, listo!
Escenario de creación: Dropbox Descargar Word, PDF4me Convertir a PDF, Crear factura SwissQR, Descargar PDF base, Combinar superposiciones de PDF, Cargar. Paso a paso con capturas de pantalla y metadatos de imagen.
Leer la publicación
Agregar un código QR suizo a cualquier factura en formato PDF en Make: un flujo de trabajo de Dropbox de 3 módulos.
Escenario de creación de tres módulos: Descarga un archivo con Dropbox, luego PDF4me crea una factura QR suiza y, finalmente, Dropbox carga un archivo. Añade una página de factura QR compatible con los estándares de pago suizos a cualquier PDF de factura con todos los campos de acreedor, deudor, IBAN y referencia. Capturas de pantalla reales, valores de campo exactos.
Leer la publicación

Autenticando su API Pedido

Cada PDF4me módulo en Make requiere un válido Conexión. Crea o selecciona uno que contenga tu PDF4me API clave para que el escenario pueda autenticar Swiss QR Generación segura de facturas.

Datos importantes que no debes perderte

Adjunta un comprobante de pago a su cuenta existente. PDF y no crea una imagen independiente
A diferencia de Crear código de barras, que devuelve un Base64 imagen, este módulo modifica su documento fuente agregando el Swiss completo QR sección de factura con un QR código y campos de pago legibles por humanos directamente al PDFIntroduce tu plantilla de factura y obtendrás una factura suiza lista para enviar con el comprobante de pago.
Los tipos de dirección S y K requieren campos diferentes.
Tanto el Acreedor como el Deudor Final tienen un campo Tipo de Dirección: S (Estructurada) o K (Combinada). Con S, complete por separado PostalCode y City campos. Con K, utilice los dos AddressLine Campos para escribir la dirección completa como texto libre. El tipo que elijas determina qué campos de la dirección se validan, así que rellena solo los campos que coincidan con el tipo seleccionado.
IBAN debe ser suizo o de Liechtenstein y la moneda es CHF o EUR solo
La sugerencia del módulo indica que IBAN debe comenzar con CH o LI, con un máximo de 21 caracteres. La moneda está estrictamente limitada a CHF o EURPara Europa SEPA pagos con monedas no suizas IBANs, usar Generar EPC QR Código para SEPA en cambio.

Parámetros

El módulo expone 26 campos agrupados en cuatro bloques lógicos: conexión + archivo fuente, Elementos esenciales para el pago, bloqueo de acreedores, bloqueo de deudores, y referencia de pagoLas capturas de pantalla a continuación reflejan el orden exacto de los campos en el Make UI.

Obligatorio (asterisco rojo en el UI): Conexión, Tipo de formato, Opciones de paginación, Moneda, Tipo de referencia, Idioma, Línea separadora, Importe, IBANTipo de dirección del acreedor, Nombre del acreedor, Deudor final AddressType. Condicional: Nombre de archivo + documento cuando el archivo está configurado en Map; Número de página solo cuando las opciones de paginación están configuradas en Personalizado (número de página). Opcional: todos los campos restantes de dirección del acreedor/deudor más Referencia, Mensaje no estructurado, Información de facturación y AV1/AV2 Parámetros.

Make Create SwissQR Bill module: Block 1: Connection, Format Type, File source, Paging Options, Currency
Block 1: Connection, Format Type, File source, Paging Options, Currency
Make Create SwissQR Bill module: Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Make Create SwissQR Bill module: Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Make Create SwissQR Bill module: Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Make Create SwissQR Bill module: Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
ParámetroRequeridoLo que haceEjemplo
ConnectionYesPDF4me connection. Click Add and paste your API key the first time, then reuse the connection across every PDF4me module.test prod account
Format TypeYesOutput container format. PDF for printable invoices and email attachments; PNG, JPEG, or TIFF for image output (no Paging Options applies in image modes). Empty falls back to the connector default. See the dropdown reference card below.PDF
FileConditionalHow the source PDF arrives. Radio: Dropbox - Download a File (or any other storage module), PDF4me Dev - Create Swiss QR Bill (chain from a prior PDF4me action), or Map (bind File Name and Document from a prior module manually). Skip the source file entirely for a standalone payment slip.Map
File NameConditionalFilename of the source PDF including .pdf extension. Required when File is set to Map. Mapped from the prior module File Name output.1. File Name
DocumentConditionalBinary content of the source PDF. Required when File is set to Map. Mapped from the prior module Data / binary output.1. Data
Paging OptionsYesWhere the Swiss QR-bill page is inserted (PDF Format Type only). Options: Empty (default), First (new page 1), Last (appended), Add page at the end (alias for Last), Custom (page number) (insert at the page number you supply in the Page Number field). See the dropdown reference card below.Custom (page number)
Page NumberConditionalThe 1-based page number where the Swiss QR-bill is inserted. Required when Paging Options is Custom (page number); ignored for every other Paging Options value. Page indexing starts at 1.3
CurrencyYesPayment currency. Only CHF and EUR are permitted by the Swiss Payment Standards.CHF
Reference TypeYesFormat of the payment reference. QRR (Swiss QR Reference, 27-digit numeric, used with QR-IBAN), SCOR (ISO 11649 creditor reference), NON (no reference).QRR
LanguageYesLanguage for the printed QR-bill text (Payment part labels: Account / Payable to, Reference, Currency, Amount). German, French, Italian, English.English
Separator LineYesSeparator line style displayed in the QR-bill section. Line With Scissor (line + scissor pictogram, standard print), Only Line (line, no pictogram), or No Line (eBill / e-invoice). Note: the Make UI labels the field "Seperator Line" (the engine accepts either spelling.Line With Scissor
AmountYesPayment amount in two decimal places without leading zeroes. Use the locale decimal separator your Culture & Language Settings expect.35345436
IBANYesIBAN or QR-IBAN of the creditor. Maximum 21 characters with CH or LI country codes only. QR-IBAN required when Reference Type is QRR.CH4431999123000889012
Creditor Address TypeYesAddress format for the creditor: S (Structured, separate PostalCode and City fields) or K (Combined, two free-text AddressLine fields).S
Creditor NameYesCreditor name or company according to the bank account. Maximum 70 characters.Var Schneider AG
Creditor AddressLine1NoCreditor primary address line. Maximum 70 characters.Var Schneider AG
Creditor AddressLine2NoCreditor secondary address line. 16 characters when address type is S; 70 characters when type is K.23
Creditor PostalCodeNoCreditor postal code. Maximum 16 characters.2501
Creditor CityNoCreditor town or city. Maximum 35 characters.biel
Ultimate Debtor AddressTypeYesAddress format for the debtor: S (Structured) or K (Combined). Same rules as Creditor Address Type.S
Ultimate Debtor NameNoDebtor name or company according to the bank account. Maximum 70 characters.Pia-Maria Rutschmann-Schnyder
Ultimate Debtor AddressLine1NoDebtor primary address line. Maximum 70 characters.Grosse Marktgasse
Ultimate Debtor AddressLine2NoDebtor secondary address line. 16 characters (S) or 70 characters (K).32
Ultimate Debtor PostalCodeNoDebtor postal code. Maximum 16 characters.9400
Ultimate Debtor CityNoDebtor town or city. Maximum 35 characters.Rorschach
ReferenceNoPayment reference number. Maximum 27 characters. Format depends on Reference Type (QRR: 27-digit numeric with mod-10 check; SCOR: ISO 11649; NON: leave empty).210000000003139471430009017
Unstructured MessageNoFree-text payment description shown in the Additional information block. Maximum 140 characters.Instruction of 15.09.2019
Billing InfoNoStructured billing information (Swico, etc) shown alongside the Unstructured Message. Maximum 140 characters.S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
AV1 ParametersNoAlternative scheme parameter 1 (e.g. eBill identifier). Maximum 100 characters. Convention: "Name AV1: UV;…".Name AV1: UV;UltraPay005;12345
AV2 ParametersNoAlternative scheme parameter 2. Maximum 100 characters. Same convention as AV1 when a second alternative scheme is required.Name AV2: XY;Service002;67890

Opciones de tipo de formato

El Make UI expone 5 valores. Elija PDF para facturas imprimibles y archivos adjuntos de correo electrónico; los formatos de imagen son útiles cuando se insertan QR deslizarse en una plantilla PDF más tarde o insertarlo directamente en el cuerpo del correo electrónico.

PDF
Standard. Hybrid PDF/A-compatible page appended to the source invoice. Use with the Paging Options field below to choose where the slip lands.
PNG
Raster image of the QR-bill slip alone. Useful for inline email images or web previews.
JPEG
Compressed raster output. Slightly smaller than PNG; the QR code stays scannable.
TIFF
Lossless raster archive format. Best when the recipient needs print-grade quality.
Empty
No value set; the connector falls back to its default (PDF).

Referencia de opciones de paginación

Se aplica solo cuando el tipo de formato es PDF. Tipos de formato de imagen (PNG, JPEG, TIFF) Ignorar las opciones de paginación porque no hay ningún documento de varias páginas en el que insertar.

First
Insert the QR-bill as the new page 1 of the output. The original first page becomes page 2.
Last
Insert the QR-bill at the end, after the original last page.
Add page at the end
Functional alias for Last. Picks whichever phrasing matches your downstream documentation.
Custom (page number)
Insert the QR-bill at a specific 1-based page index. Requires the Page Number field to be filled with the desired index (e.g. 3 inserts the slip as the new page 3).
Empty
No value set; the connector falls back to its default (First).

Configuración rápida

  1. Agregar PDF4me a Crear factura SwissQR en tu Make escenario.
  2. Seleccionar Conexión (o haga clic Agregar para crear uno con tu API llave).
  3. Colocar Tipo de formato a PDF (o PNG / JPEG / TIFF para salida de imagen). Establecer Opciones de paginación a First, Last, Add page at the end, o Custom (page number)Si eliges Personalizado (número de página), también rellenar Número de página con el índice basado en 1 donde debería aterrizar el deslizamiento (por ejemplo, 3).
  4. Colocar Archivo a un módulo de almacenamiento como Dropbox - Descargar un archivoo elegir Map y unir Nombre del archivo y Documento del paso anterior. Omita el grupo de archivos por completo para una opción independiente. QR deslizar.
  5. Rellene los campos de pago obligatorios con los valores que aparecen en las capturas de pantalla anteriores: Divisa (CHF o EUR), Tipo de referencia (QRR), Idioma (English), Línea separadora (Line With Scissor), Cantidad, IBAN (máximo 21 caracteres, CH o LI), Tipo de dirección del acreedor (S o K), Nombre del acreedor, y Deudor final AddressType.
  6. Agregue los campos de dirección del acreedor y del deudor, luego complete opcionalmente Referencia, Mensaje no estructurado, Información de facturación, y AV1 / AV2 Parámetros para obtener datos de pago más completos.
  7. Guarda y ejecuta. Salida del módulo Doc Data contiene la fuente PDF con los suizos QR-página de factura insertada en la posición elegida en el paso 3 (o una página independiente) QR error cuando no se proporcionó ningún archivo fuente).

Ejemplos de flujo de trabajo

Ejemplos de flujo de trabajoCommon Make scenario patterns using Create SwissQR Bill.
Automatice la generación de facturas suizas desde una hoja de cálculo de Google.
  1. Se activa este escenario al añadir una nueva fila al registro de facturas de Google Sheets.
  2. Google Drive descarga la factura en blanco. PDF plantilla.
  3. Crear factura SwissQR asigna todos los campos de pago, incluido el importe, IBAN, Referencia y detalles del acreedor y del deudor, directamente de las columnas de la hoja.
  4. Gmail envía la factura completada con el suizo QR Factura adjunta a la dirección de correo electrónico del cliente desde la hoja.
Facturación de suscripción mensual para clientes suizos
  1. Se ha programado un evento que se ejecuta el primer día de cada mes.
  2. Airtable devuelve todos los registros de suscripción activos.
  3. Un iterador procesa a cada suscriptor individualmente. La función Crear factura SwissQR genera una factura personalizada con el importe de la suscripción, los datos del cliente como deudor final y una referencia única por registro.
  4. Gmail envía la factura a cada cliente. Airtable se actualiza con la fecha y hora de envío.
Cuentas por cobrar: adjuntar QR proyecto de ley sobre ERP aprobación
  1. Un webhook se activa cuando se aprueba una factura en el ERP sistema.
  2. HTTP descarga la factura aprobada PDF.
  3. Crear factura SwissQR adjunta el comprobante de pago utilizando el ERP-suministrado IBAN, importe y número de referencia.
  4. La factura completada se carga en el SharePoint carpeta de cuentas por cobrar y el equipo de contabilidad es notificado a través de Microsoft Teams.

Preguntas frecuentes

What does this module actually add to my PDF?+
It appends the complete Swiss QR bill payment slip section to your existing PDF. This is a standardized block containing the QR code with all encoded payment data, plus the human-readable payment fields (amount, IBAN, reference, creditor details). The output is a ready-to-send invoice accepted by Swiss banks for payment via mobile banking app.
What is the difference between Address Type S and K?+
S (Structured) means you fill separate PostalCode and City fields alongside AddressLine1 for the street. K (Combined) means you write the complete address across two free-text AddressLine fields with no separate city or postal code. Choose whichever matches how your data is structured, since both are valid under Swiss Payment Standards.
What Reference Type should I use?+
QRR (QR Reference) is the most common and uses a 27-character numeric string with a check digit for automated bank reconciliation in Switzerland. SCOR follows the international ISO 11649 creditor reference format. NON means no reference is included. Check with your bank which format your account supports for incoming payment matching.
Why is the IBAN restricted to CH or LI?+
Swiss QR bills are a payment standard specific to Switzerland and Liechtenstein. The module hint confirms: "Max 21 characters with CH or LI only." For SEPA payments across the EU and EEA using other country IBANs, use the Generate EPC QR Code for SEPA module instead.
What does the module return?+
Name (the output filename) and Doc Data (the binary PDF buffer of your source document with the Swiss QR bill section appended). Route Doc Data into Gmail as an attachment, upload it to Dropbox or Google Drive, or POST it to your ERP system.

Módulos relacionados

Obtén ayuda