Crear factura SwissQR
Código de barras → Crear factura SwissQR
El Crear factura SwissQR API genera un suizo QR-factura PDF que cumpla con el estándar oficial suizo. Usted envía una base PDF (docContent, docName), detalles del acreedor (IBAN, nombre, dirección), datos del deudor, cantidad, divisa, referenceType, languageType, seperatorLiney opcionalmente IsAsync. El API devuelve un PDF Con la factura SwissQR adjunta. Utilice el probador que aparece a continuación para comprobar su funcionamiento; encontrará más detalles en las secciones siguientes.
Pruebe la función Crear factura SwissQR API
:::nota Referencia rápida
Punto final: POST /api/v2/CreateSwissQrBill · Requerido: api-key, docContent, docName, iban, crName, crAddressType, crStreetOrAddressLine1/2, crPostalCode, crCity, cantidad, moneda, udName, udAddressType, udStreetOrAddressLine1/2, udPostalCode, udCity, referenceType, languageType, seperatorLine, IsAsync
:::
Utiliza el formulario a continuación para enviar tu solicitud API llave, PDF (Base64), y todos los campos de acreedor/deudor y pago. La respuesta es la PDF con los suizos QR-factura. No se requiere código, complete los campos y haga clic. Enviar solicitud.
Descripción general, parámetros y casos de uso
- Overview
- Parameters
- Use cases
¿Qué es crear una factura SwissQR?
Este punto final crea un Swiss QR-factura PDF que cumple con la norma oficial suiza (junio de 2020). Usted proporciona una base PDF y datos de pago completos: acreedor (IBAN, nombre, dirección), deudor final, importe, moneda, tipo de referencia, idioma y estilo de separador. El API devuelve un PDF con los suizos QR-Factura adjunta, lista para ser depositada en el banco y para pago digital.
Características principales
- Cumple con la norma suiza: Información de pago estructurada, detalles del acreedor/deudor, incrustada QR codey una disposición adecuada.
- Datos de pago completos: IBAN, cantidad, moneda (CHF, EUR, USD), tipo de referencia (QRR, NON, SCOR), idioma (inglés, alemán, francés, italiano).
- Opciones de separador: seperatorLine: LíneaConTijera, LíneaDiscontinuaConTijera o LíneaSólida para cortar/rasgar.
Usar para facturas, recibos o cualquier documento suizo que deba llevar un sello suizo QR-factura. Combinar con Lea el código SwissQR para verificar o extraer datos de pago de sistemas suizos existentes QR-facturas.
API parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| api-key | cadena | Sí | Su PDF4me API llave, Base64 codificado. Consíguelo desde el panel. |
| docContent | base64 | Sí | PDF contenido del archivo (Base64). |
| docName | cadena | Sí | PDF Nombre del archivo con extensión .pdf. |
| iban | cadena | Sí | Suizo IBAN para el acreedor (p. ej. CH0200700110003765824). |
| crName, crAddressType, crStreetOrAddressLine1, crStreetOrAddressLine2, crPostalCode, crCity | cadena | Sí | Nombre del acreedor, tipo de dirección (S/K), calle, código postal, ciudad. |
| cantidad | cadena | Sí | Importe del pago (sin ceros iniciales). |
| divisa | cadena | Sí | CHF, EUR, o USD. |
| udName, udAddressType, udStreetOrAddressLine1, udStreetOrAddressLine2, udPostalCode, udCity | cadena | Sí | Nombre y dirección del deudor final. |
| referenceType | cadena | Sí | QRR, NON, o SCOR. |
| languageType | cadena | Sí | Inglés, alemán, francés o italiano. |
| seperatorLine | cadena | Sí | LíneaConTijera, LíneaDiscontinuaConTijera o LíneaContinua. |
| IsAsync | booleano | Sí | Habilitar el procesamiento asíncrono. |
Cuándo usar Create SwissQR Bill
- Facturas y recibos: Añadir suizo QR- Facturas a facturas para pago digital en Suiza.
- Procesamiento de pagosGenerar facturas que cumplan con los requisitos para flujos de trabajo de pago automatizados.
- Banca y contabilidadIntegrar Suiza QR-creación de factura en el sistema bancario o ERP sistemas.
- Cumplimiento normativo: Cumpla con los estándares bancarios y de pago suizos con el diseño oficial y QR code.
Para ver esquemas de solicitud/respuesta y ejemplos de código, consulte Crear factura SwissQR en el PDF4me API documentos.
Requisitos previos
Antes de utilizar este punto final, asegúrese de tener:
- Un válido PDF4me API llave (Consigue tu API Llave)
- A PDF documento para adjuntar la factura SwissQR a
- Toda la información de pago requerida (IBAN(datos del acreedor, datos del deudor, importe, moneda)
- El PDF archivo codificado en Base64 formato
Formato de respuesta
El API devuelve un PDF Presentar la solicitud junto con la factura SwissQR. Estado 200 devuelve el PDF en el cuerpo de la respuesta; Estado 202 significa que el procesamiento es asíncrono, sondear el Location encabezado URL hasta que el PDF está listo.