OCR de Facturas de Proveedor

El módulo de OCR de facturas permite subir documentos de proveedores (PDF, XML, imagen o ZIP) para que el motor de inteligencia artificial extraiga los datos fiscales CFDI 4.0. El usuario revisa y confirma la extracción antes de que el documento ingrese al flujo de cuentas por pagar.

Requisitos y permisos

Permiso requerido	Acción
compras.ocr_subir	Subir nuevos documentos para procesamiento
compras.ocr_confirmar	Revisar, corregir y confirmar o rechazar documentos

Las pantallas se encuentran en:

• Cola OCR: /compras/ocr
• Subir factura: /compras/ocr/upload
• Revisión de documento: /compras/ocr/{id}

Cola de documentos OCR

La cola muestra todos los documentos procesados o en proceso para el tenant actual, con paginación de 20 registros por página.

Filtros disponibles

Filtro	Descripción
Búsqueda de texto	Filtra por número de folio u otros datos del documento
Estado	PENDIENTE, EN_PROCESO, REQUIERE_REVISION, CONFIRMADA, RECHAZADA, ERROR_IA, ERROR_PARSER
Origen	UPLOAD_INTERNO (subido por el usuario), PORTAL_PROVEEDOR (enviado desde el portal)
Confianza mínima	Deslizador para filtrar por nivel de confianza de la extracción (%)
Ordenamiento	Más reciente, más antiguo, mayor confianza, menor confianza

Estados del documento

Estado	Significado
PENDIENTE	El archivo fue recibido y está en cola de procesamiento
EN_PROCESO	La IA está extrayendo los datos
REQUIERE_REVISION	La extracción completó pero hay campos de baja confianza
CONFIRMADA	Un usuario revisó y confirmó los datos extraídos
RECHAZADA	El documento fue rechazado por el usuario
ERROR_IA	El motor de IA no pudo procesar el documento
ERROR_PARSER	El parser del archivo encontró un error de formato

Flujo: subir una factura

1. Desde la cola OCR, haga clic en Subir Factura o acceda directamente a /compras/ocr/upload.
2. En la zona de carga, seleccione o arrastre el archivo. Formatos aceptados: PDF, XML, imagen (JPG/PNG), ZIP.
3. Haga clic en Subir.
4. El sistema confirma la recepción con el mensaje “Archivo recibido. Procesando extracción con IA…” y redirige automáticamente a la pantalla de revisión del documento.

Nota

Los archivos ZIP pueden contener múltiples facturas. El sistema crea un registro independiente para cada documento detectado dentro del ZIP.

Flujo: revisar y confirmar un documento

La pantalla de revisión presenta un diseño lado a lado:

• Panel izquierdo — Vista del documento original (PDF renderizado o imagen).
• Panel derecho — Datos extraídos por la IA con indicadores de confianza por campo.

Indicadores de confianza

Cada campo extraído muestra un indicador de nivel de confianza (porcentaje). Los campos con confianza baja aparecen resaltados para facilitar la revisión.

Validación SAT

La pantalla también muestra el resultado de la validación del CFDI ante el SAT con los siguientes estados posibles:

Estado SAT	Significado
VIGENTE	El CFDI existe y está vigente en el SAT
CANCELADO	El CFDI fue cancelado en el SAT
NO_ENCONTRADA	El UUID no se encontró en el SAT
PENDIENTE	La validación aún está en proceso
INCOMPLETO	Faltan datos para realizar la consulta
ERROR	Error al consultar el SAT

Confirmar o rechazar

1. Revise todos los campos extraídos. Corrija los valores incorrectos directamente en el formulario.
2. Haga clic en Confirmar para aprobar el documento. Este pasa a estado CONFIRMADA y queda disponible para el flujo de cuentas por pagar.
3. O haga clic en Rechazar para descartar el documento. Este pasa a estado RECHAZADA.

Precaución

Solo los documentos con estado CONFIRMADA ingresan al flujo de cuentas por pagar. Los documentos en otros estados permanecen en la cola hasta ser confirmados o rechazados.

Reglas y validaciones

• Los archivos se validan por magic bytes (no solo por extensión) para garantizar que el tipo real coincida con el declarado.
• El tamaño máximo de archivo es de 10 MB por documento.
• Los datos extraídos se validan con un esquema CFDI 4.0 antes de presentarse al usuario. Si la respuesta de la IA no cumple el esquema, el documento pasa a ERROR_IA.
• tenantId se deriva del JWT del usuario autenticado; no es posible acceder a documentos de otro tenant.

Casos frecuentes

El documento quedó en estado ERROR_IA La calidad del archivo puede ser insuficiente (imagen borrosa, PDF sin capa de texto). Intente con una versión de mejor resolución o cargue el XML directamente si el proveedor lo proporciona.

Los datos extraídos difieren del documento original Corrija manualmente los campos incorrectos en el panel derecho antes de confirmar. El sistema permite editar cualquier campo extraído.

El estado SAT muestra CANCELADO No confirme el documento. Contacte al proveedor para que emita un CFDI de sustitución o una nota de crédito según corresponda.