Inspectores

Un Inspector es un checklist de cumplimiento para un conjunto de documentos relacionados. Listas los documentos que esperas, cada uno extraído por un flow, y armas un checklist de checks sobre sus valores. Cada inspección termina en un veredicto: mismas entradas, mismo veredicto, siempre.

Un ejemplo típico es un embarque de importación: factura comercial, lista de empaque y conocimiento de embarque. El Inspector verifica que los totales cuadren, que el número de factura coincida entre documentos, que las fechas estén en orden y que nada esté vencido. Las reglas las evalúa un motor determinista, no una IA leyendo los documentos, así que el veredicto es reproducible y cada resultado se puede rastrear hasta los valores que lo produjeron.

• Verificaciones entre documentos antes de pagar o liberar algo: factura contra orden de compra y nota de entrega
• Revisión de expedientes de importación y exportación: las mismas referencias, cantidades y totales en todos los documentos
• Reglas de fechas y vencimientos: certificados vigentes hoy, documentos emitidos en el mes actual
• Formato de valores individuales: RUC o identificación fiscal, números de factura, monedas permitidas

Si lo que necesitas es comparar precios línea por línea entre varias versiones del mismo tipo de documento, como cotizaciones de proveedores, usa un Matcher.

1. 1Ve a Inspectores y haz clic en Nuevo inspector. Ponle un nombre (al menos 3 caracteres) y una descripción opcional, y haz clic en Crear. Para partir de un inspector existente, usa Desde plantilla.
2. 2En Documentos esperados, haz clic en Agregar documento por cada documento que requiere el proceso: un Nombre del documento y el Flow de extracción que lo lee.
3. 3Arma el Checklist con Agregar check, Agregar rama o Sugerir checks.
4. 4Pruébalo en el panel Prueba en seco y haz clic en Guardar en el encabezado.
5. 5Asegúrate de que el inspector esté Activo (el switch del encabezado). Los inspectores inactivos no pueden iniciar nuevas inspecciones.

Cada documento esperado tiene estas opciones:

Un check lee los valores que extraen los flows de documentos y aprueba o falla de forma determinista. Los checks corren de arriba hacia abajo; arrástralos para reordenarlos, y el reporte sigue el mismo orden.

Ramas

Una rama divide el checklist según una condición. Su condición Cuando decide qué carril corre: Entonces verifica si se cumple, De lo contrario si no. Si la condición no puede evaluarse (documento ausente, valor inválido), corre el carril De lo contrario. Cada carril puede tener checks y otras ramas, y el nombre de la rama aparece en el reporte. Los checks del carril que no corrió se reportan como omitidos.

Cada condición elige un Documento y un Campo, un operador y un valor. En una columna que se repite (de tabla) se compara el primer valor. En los campos de fecha puedes comparar solo un elemento de la fecha: Fecha completa, Solo fecha, Mes y año o Año.

Los nombres de los operadores aparecen en inglés en la app:

El valor puede ser de cuatro tipos, que eliges con el selector que está al lado:

• Los números ignoran separadores de miles, espacios y símbolos de moneda. El texto se recorta y se compara sin distinguir mayúsculas.
• Dos valores que se leen como fechas se comparan como fechas, así que 09-05-1989 es igual a 09/05/1989. Por eso los campos de texto también pueden usar los operadores de fecha.
• On or after y On or before incluyen la fecha límite; After y Before no.
• Cuando un lado de una comparación entre campos está vacío, el check no da error: Equals solo se cumple si ambos están vacíos, y los operadores de orden como Greater than resultan falsos.
• Matches pattern usa una expresión regular, sin distinguir mayúsculas, en cualquier parte del valor; agrega ^ y $ para exigir el valor completo (^INV-\d+$). Is one of recibe una lista separada por comas y compara los números como números.

Algunos criterios no se pueden escribir como una regla. Los campos de texto ofrecen dos operadores con IA, disponibles solo en las condiciones de los checks (nunca en guardas ni en condiciones de rama):

• AI match compara un valor con el campo de otro documento según tus instrucciones, por ejemplo “¿Son la misma persona? Los nombres pueden omitir un apellido u ordenarse distinto.”
• AI check evalúa un solo valor, por ejemplo “¿Esta dirección está dentro de Panamá?”

Defines las respuestas posibles (al menos dos) y marcas cuáles aprueban; se ven en verde. El modelo responde con exactamente una opción, y la opción elegida y su razonamiento quedan en el reporte. La respuesta queda fija en la inspección, así que el veredicto sigue siendo reproducible.

Cuando ya tengas los documentos esperados, haz clic en Sugerir checks en el checklist. Si quieres, describe qué debe verificar el inspector (por ejemplo “Verifica que el total de la factura coincida con la orden de compra”) y haz clic en Sugerir checks. El asistente lee los campos de cada documento, con valores de muestra del último run completado del flow, y propone checks con su severidad y sus condiciones.

Desmarca lo que no necesites, edita cualquier check con el lápiz y haz clic en Agregar checks. Todo queda editable.

El panel Prueba en seco prueba el checklist contra runs completados: elige un run de muestra para cada documento, o Sin documento (ausente), y el veredicto se reevalúa al instante mientras editas. Usa el mismo motor de reglas que las inspecciones reales. Nada se guarda, y las condiciones con IA se asumen aprobadas porque el modelo solo corre durante inspecciones reales.

1. 1Abre la pestaña Inspecciones del inspector y haz clic en Nueva inspección.
2. 2Suelta los documentos de una inspección (PDF, PNG, JPG, JPEG, JFIF) y haz clic en Iniciar inspección.
3. 3La IA dirige cada archivo al slot de documento correcto, usando su primera página, el nombre del documento, la pista de enrutamiento y el flow, y ejecuta el flow de extracción de ese slot.
4. 4Cuando cada documento requerido tiene un run completado, el checklist se evalúa y la página de la inspección muestra el veredicto y el reporte.

En la página de la inspección puedes seguir agregando documentos mientras está recolectando. Un archivo que la IA no pudo ubicar queda como Sin emparejar: elige un slot en Assign to document… y haz clic en Assign. Cancel detiene una inspección sin evaluarla. (Esta página aún aparece en inglés en la app.)

En Ajustes decides cuándo corre el checklist: Automático evalúa en cuanto cada documento requerido tiene un run completado; Manual sigue recolectando hasta que alguien hace clic en Fire now.

También puedes ejecutar inspecciones:

• Desde un caso de Subject. Un inspector vinculado a un Subject aparece en Checks en la página del caso. Run reutiliza los runs completados del caso, sin volver a subir ni extraer nada. Cada documento requerido necesita un run completado en el caso.
• En un Pipeline, como un nodo después de los flows. Consulta Pipelines.
• Por API, como se explica más abajo.

El Reporte del checklist lista cada check en orden con su resultado (Aprobado, Fallido, Omitido o Error), los valores que se compararon y una breve explicación. Los checks omitidos dicen por qué: no se tomó la rama, no se cumplió la guarda o no se entregó el documento. Una inspección completada se puede descargar como reporte en PDF (PDF report).

En Revisores y HITL, activa Revisión humana y elige a los revisores para pausar cada inspección antes de que el veredicto sea final. Un check que falla también puede pausar la inspección por su cuenta con la acción Solicitar revisión. Los revisores reciben un aviso por correo.

1. 1Abre la inspección pausada. El panel de revisión muestra los checks fallidos y una Vista previa del veredicto.
2. 2Exonera los checks fallidos que sean aceptables, con un motivo (obligatorio). Los checks exonerados ya no cuentan para el veredicto.
3. 3Haz clic en Aprobar para finalizar el veredicto y enviar las salidas, o en Rechazar para cancelar la inspección sin veredicto.

Todos los roles, incluido Solo HITL, pueden revisar. Si hay revisores configurados, solo ellos pueden aprobar o rechazar. Consulta Revisión Humana.

• Notificación en la app con el veredicto para quien inició la inspección.
• Salida por Email: recibe el veredicto y el resultado de cada check, con el reporte en PDF adjunto.
• Webhook: envía por POST un JSON con inspection_id, inspector_id, verdict y el reporte completo en output_json. Consulta Webhooks.
• Las acciones Enviar email y Llamar webhook de cada check se disparan por cada check fallido que no se exoneró.

Con revisión humana, las salidas se envían después de aprobar.

Envía documentos a un inspector con tu API key. Copia el ID desde ID del Inspector en la página del inspector. Cada solicitud agrega un archivo; omite inspection_id en la primera para abrir una inspección nueva y luego envía el ID que recibes con las demás.

curl -X POST https://run.tavnit.io/api/inspectors/<inspector_id>/process \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@commercial_invoice.pdf"

curl -X POST https://run.tavnit.io/api/inspectors/<inspector_id>/process \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@packing_list.pdf" \
  -F "inspection_id=<inspection_id>"

• La respuesta es 202 con inspection_id e inspection_file_id. Un 402 significa que tu organización no puede iniciar trabajo nuevo en este momento; contacta al equipo de Tavnit.
• Con la política Manual, termina con POST https://run.tavnit.io/api/inspections/<inspection_id>/fire. Devuelve 400 con missing_inputs si falta algún documento requerido.
• Configura un Webhook en el inspector para recibir el veredicto y el reporte.

La autenticación está en API.

• Los Administradores y Propietarios crean inspectores. Los Administradores, los Propietarios y quien creó el inspector pueden editarlo o eliminarlo.
• Todos los miembros, excepto Solo HITL, pueden ejecutar inspecciones.
• Todos los roles pueden revisar inspecciones pausadas.
• Eliminar un inspector también elimina sus inspecciones y sus reportes.