Convertir documentos logísticos en JSON
Cómo diseñar una salida JSON útil y verificable a partir de documentos logísticos.
Respuesta directa
Convertir a JSON no consiste en volcar texto: hay que definir un esquema, conservar unidades y procedencia, representar incertidumbre y validar campos obligatorios antes de entregar el objeto a otro sistema.
¿Para quién es?
Desarrolladores e integradores que conectan OCR con TMS, ERP o flujos internos.
Entradas
- Documento original y tipo documental.
- Esquema JSON versionado y campos obligatorios.
Salidas esperadas
- Objeto JSON validado, con valores y metadatos de revisión.
- Errores explícitos cuando un campo no puede extraerse.
Flujo operativo paso a paso
- Define el esquema y separa valor, confianza o estado de revisión.
- Procesa el documento con autenticación Bearer según la documentación.
- Mapea campos sin perder texto original, unidades ni fechas.
- Valida tipos, formatos y relaciones como subtotal-impuestos-total.
- Entrega solo objetos aprobados y registra la versión del esquema.
Limitaciones y seguridad
- No conviertas ausencia en null silencioso si el negocio requiere revisión.
- JSON válido no significa dato correcto.
- Versiona cambios y limita quién puede consultar documentos y resultados.
Guías relacionadas
Preguntas frecuentes
¿El OCR sustituye la revisión humana?
No. El resultado debe revisarse antes de incorporarlo a un sistema o documento operativo, especialmente cuando hay importes, matrículas o datos fiscales.
¿Qué ocurre con documentos ilegibles?
La calidad, orientación y resolución afectan a la extracción. Un documento ilegible debe marcarse para revisión o volver a capturarse; no conviene rellenar valores por inferencia.
¿Puedo usar cualquier documento?
El flujo documentado contempla documentos logísticos como PDF, XLSX, EML e imágenes, sujeto al formato y a las condiciones del servicio.
¿Se pueden eliminar los duplicados?
La deduplicación documentada usa una huella SHA-256 del archivo para detectar reenvíos idénticos. No demuestra que dos documentos distintos representen la misma operación.
¿Dónde consulto el acceso?
La documentación pública de Cargoffer OCR está en docs.ocr.cargoffer.com. El acceso y la autenticación deben configurarse según esa documentación.
Siguiente paso
Consulta la documentación pública de Cargoffer OCR para confirmar el flujo disponible y sus requisitos antes de integrarlo.