Extracción del QR de AEAT con Región de Recorte para Facturas Españolas en C

¿Cómo encontrar las coordenadas y el tamaño de la región de recorte en una imagen?

Hay muchas formas de encontrar las coordenadas de un punto en una imagen. Una forma es cargar la imagen utilizando la aplicación Paint del ordenador. Para obtener la primera coordenada de la Región de Recorte, mueva el cursor al lugar preferido, que será la esquina superior izquierda del Rectangle, y tome la coordenada x, y proporcionada por la aplicación en la parte inferior izquierda de la pantalla. Luego, localice el segundo punto, que será la esquina inferior derecha del Rectangle. Consulte la imagen a continuación para una comprensión más clara.

Para escenarios más avanzados, también puede considerar el uso de software de edición de imágenes como GIMP o Photoshop, que proporcionan coordenadas de píxeles precisas y herramientas de medición. Algunos desarrolladores prefieren utilizar herramientas de búsqueda de coordenadas en línea o crear sencillas utilidades HTML/JavaScript que muestren las coordenadas del ratón al pasar el ratón por encima de una imagen.

Configuración de la referencia de CropRegion

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-instantiate-CropRegion.cs

using IronBarCode;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2-x1, height: y2-y1);

Imports IronBarCode

Private x1 As Integer = 62
Private y1 As Integer = 29
Private x2 As Integer = 345
Private y2 As Integer = 522

Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2-x1, height:= y2-y1)

¿Cómo aplicar CropRegion y leer BarCodes?

Una vez que haya definido el CropRegions donde desea que IronBarcode lea, puede aplicar el objeto dentro de BarcodeReaderOptions como una de las propiedades, junto con otras configuraciones. Esto puede luego usarse como un parámetro en el método BarcodeReader.Read(). El fragmento de código a continuación muestra este proceso:

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-apply-CropRegion.cs

using IronBarCode;
using System;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2 - x1, height: y2 - y1);

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    CropArea = crop1
};

var result = BarcodeReader.Read("sample.png", options);
foreach (var item in result)
{
    Console.WriteLine(item.Value);
}

Imports IronBarCode
Imports System

Private x1 As Integer = 62
Private y1 As Integer = 29
Private x2 As Integer = 345
Private y2 As Integer = 522

Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2 - x1, height:= y2 - y1)

Private options As New BarcodeReaderOptions() With {.CropArea = crop1}

Private result = BarcodeReader.Read("sample.png", options)
For Each item In result
	Console.WriteLine(item.Value)
Next item

Técnicas avanzadas para regiones de cultivo

Para aplicaciones de producción, considere estas estrategias avanzadas:

1. Regiones de recorte dinámicas: Calcule áreas de recorte basadas en plantillas de documentos o resultados de OCR
2. Regiones múltiples: Procese varias regiones de recorte en una sola imagen para diseños complejos
3. Optimización del rendimiento: Combine regiones de cultivo con procesamiento asíncrono para obtener el máximo rendimiento
4. Manejo de errores: Implementación de estrategias de emergencia cuando los códigos de barras no se encuentran en las regiones esperadas

Al trabajar con documentos PDF, puede aplicar regiones de recorte a páginas específicas, lo que reduce drásticamente el tiempo de procesamiento de archivos de gran tamaño. Esto resulta especialmente útil para facturas, etiquetas de envío o formularios en los que las posiciones de los códigos de barras están estandarizadas.

Bestes prácticas para la definición de regiones de cultivo

Para maximizar la eficacia de las regiones de cultivo:

• Añadir relleno: Incluya de 10 a 20 píxeles alrededor de las ubicaciones de los códigos de barras previstos para tener en cuenta ligeras variaciones
• Prueba a fondo: Verifique que las regiones de recorte funcionan en todo el conjunto de documentos
• Documentar coordenadas: Mantenga una hoja de referencia de las regiones de cultivo comunes para su aplicación
• Considere el escalado: Tenga en cuenta las diferentes resoluciones de imagen o configuraciones de PPP
• Supervisar el rendimiento: realizar un seguimiento de los tiempos de procesamiento para validar la eficacia de la región de cultivo

Para las aplicaciones que requieran tolerancia a fallos, implemente un enfoque de dos pasadas: primero escanee la región de recorte y, a continuación, vuelva a escanear la imagen completa si no se encuentran códigos de barras en las regiones esperadas.

Región de recorte para el procesamiento masivo de facturas españolas

El uso de CropArea es especialmente valioso en los sistemas de procesamiento de facturas en España:

Servicio de reconciliación SII: Un servicio que procesa miles de facturas PDF escaneadas para la reconciliación con el SII de la AEAT puede configurar la región de recorte al 20% inferior derecho de cada página. Dado que el Real Decreto 1007/2023 posiciona el QR de AEAT en esa zona, el tiempo de procesamiento se reduce hasta 5 veces respecto al escaneo completo de la imagen:

// Para una factura A4 escaneada a 300 DPI (2480x3508 píxeles)
// El QR de AEAT ocupa el 20% inferior derecho
int imgAncho = 2480;
int imgAlto = 3508;
var regionQRAEAT = new IronSoftware.Drawing.Rectangle(
    x: (int)(imgAncho * 0.7),
    y: (int)(imgAlto * 0.75),
    width: (int)(imgAncho * 0.3),
    height: (int)(imgAlto * 0.25)
);
var opts = new BarcodeReaderOptions { CropArea = regionQRAEAT };
var results = BarcodeReader.Read("factura-verifactu.png", opts);
string urlAEAT = results.FirstOrDefault()?.Value ?? "";

// Para una factura A4 escaneada a 300 DPI (2480x3508 píxeles)
// El QR de AEAT ocupa el 20% inferior derecho
int imgAncho = 2480;
int imgAlto = 3508;
var regionQRAEAT = new IronSoftware.Drawing.Rectangle(
    x: (int)(imgAncho * 0.7),
    y: (int)(imgAlto * 0.75),
    width: (int)(imgAncho * 0.3),
    height: (int)(imgAlto * 0.25)
);
var opts = new BarcodeReaderOptions { CropArea = regionQRAEAT };
var results = BarcodeReader.Read("factura-verifactu.png", opts);
string urlAEAT = results.FirstOrDefault()?.Value ?? "";

Imports IronSoftware.Drawing

' Para una factura A4 escaneada a 300 DPI (2480x3508 píxeles)
' El QR de AEAT ocupa el 20% inferior derecho
Dim imgAncho As Integer = 2480
Dim imgAlto As Integer = 3508
Dim regionQRAEAT As New Rectangle(
    x:=CInt(imgAncho * 0.7),
    y:=CInt(imgAlto * 0.75),
    width:=CInt(imgAncho * 0.3),
    height:=CInt(imgAlto * 0.25)
)
Dim opts As New BarcodeReaderOptions With {.CropArea = regionQRAEAT}
Dim results = BarcodeReader.Read("factura-verifactu.png", opts)
Dim urlAEAT As String = If(results.FirstOrDefault()?.Value, "")

Tíquets TicketBAI (País Vasco): Los tíquets de Bizkaia, Gipuzkoa y Araba suelen imprimir el QR de TicketBAI en la parte inferior. El mismo patrón de región de recorte aplica para los lectores de tíquets de los sistemas de TPV del País Vasco.

DataMatrix SILICIE: Las etiquetas de medicamentos del sistema SILICIE colocan el DataMatrix en una posición estandarizada según las guías del Ministerio de Sanidad. Configurar la región de recorte según las guías de diseño de SILICIE mejora la precisión y reduce los falsos positivos al leer otros códigos de barras de la etiqueta.

Consejo de rendimiento SII: Para el procesamiento en lotes de facturas conforme a los plazos de cuatro días del SII, combine regiones de recorte con procesamiento paralelo (Parallel.ForEach con MaxParallelThreads) para maximizar el rendimiento en los servidores Linux o los contenedores Docker de la infraestructura fiscal.

Conclusión

La definición de regiones de recorte es una potente técnica para optimizar el rendimiento de la lectura de códigos de barras en sus aplicaciones .NET. Al limitar el área de escaneo a regiones específicas, se pueden lograr mejoras significativas en la velocidad al tiempo que se reducen los falsos positivos. Tanto si procesa imágenes individuales como si realiza operaciones por lotes, las regiones de cultivo ofrecen la precisión y el rendimiento necesarios para los entornos de producción.