githubEdit

Mapeo de campos de ZUGFeRD + Swiss QR Code

Visión general

Al procesar facturas en PDF que contienen tanto datos XML ZUGFeRD como un Swiss QR Code, DocBits extrae datos de ambas fuentes y los fusiona de manera inteligente.

Cómo funciona

  1. Extracción ZUGFeRD XML - DocBits primero extrae campos del ZUGFeRD XML incrustado

  2. Detección de Swiss QR Code - El barcode detecta y analiza los códigos Swiss QR

  3. Fusión Inteligente (Smart Merge) - Los campos vacíos se llenan con datos de Swiss QR (los campos con valores se conservan)

  4. Audit Trail - Los datos completos del código QR se almacenan en qr_code_data para verificación

Tabla de Mapeo de Campos

Mapeo de Campos Swiss QR Code → DocBits

Campo Swiss QR
Campo DocBits
Descripción

IBAN

supplier_iban

IBAN del acreedor (p. ej., CH9300762011...)

Amount

total_amount

Importe del pago (p. ej., 1234.56)

Currency

currency

Código de moneda (CHF o EUR)

Reference

payment_reference / esr_reference

Referencia QR o número ESR

Creditor.Name

supplier_name

Nombre de la empresa proveedora

Creditor.AddressLine1

supplier_address

Dirección (calle)

Creditor.PostalCode

supplier_plz

Código postal

Creditor.City

supplier_city

Ciudad

Creditor.Country

supplier_country

Código de país (CH)

Debtor.Name

company_name

Nombre de la empresa receptora

Debtor.AddressLine1

company_street

Dirección del receptor

Debtor.PostalCode

company_plz

Código postal del receptor

Debtor.City

company_city

Ciudad del receptor

Ejemplo: Procesamiento de Factura de Muestra

Documento de Entrada

  • PDF: Factura con ZUGFeRD 1.0 XML incrustado + código de barras Swiss QR Code

Datos Extraídos del Swiss QR Code

Resultados de Extracción de Campos

Campo
Valor
Fuente
Método

supplier_iban

CH9300762011623852957

ZUGFeRD XML

ED

total_amount

1234.56

ZUGFeRD XML

ED

currency

CHF

ZUGFeRD XML

ED

supplier_name

Sample Company GmbH

ZUGFeRD XML

ED

supplier_address

Musterstrasse 123

ZUGFeRD XML

ED

payment_reference

210000000003139471430009017

Swiss QR

SWISS_QR

supplier_plz

8000

Swiss QR

SWISS_QR

supplier_city

Zürich

Swiss QR

SWISS_QR

Métodos de Extracción

Código de Método
Descripción

ED

Documento Electrónico (ZUGFeRD/XRechnung/PEPPOL XML)

SWISS_QR

Extracción de código de barras Swiss QR Code

OCR

Reconocimiento Óptico de Caracteres

ML

Extracción por Machine Learning

Prioridad de Fusión (Merge)

  1. ZUGFeRD XML tiene la mayor prioridad (datos estructurados y fiables)

  2. Swiss QR Code rellena campos vacíos (garantizado preciso para datos de pago)

  3. OCR/ML usado para campos no presentes en fuentes electrónicas

Versiones de Swiss QR Code Soportadas

  • Formato Swiss QR Bill (ISO 20022)

  • Formato QR-IBAN (comienza con 30, 31)

  • Formato IBAN Estándar

  • Con/sin referencia estructurada (QRR, SCOR)

Requisito de Versión

Esta función requiere api versión 10.95.6 y barcode versión 1.0.5 o superior.

Versiones de Componentes (Entorno Dev)

Componente
Versión
Descripción

api

10.95.6

API central con soporte de extracción ZUGFeRD 1.0

barcode

1.0.5

Detección y análisis de Swiss QR Code

Auth

1.48.8

Servicio de autenticación

Last updated

Was this helpful?