OCR API invoiceinvoice extraction APIfreight invoice OCRMCP OCR

Documentar `ocr.cargoffer.com` (OCR facturas + matching con rutas)

Mega-Tutorial: Visión Artificial y Extracción Documental (OCR API)

Las facturas de transporte y las Cartas de Porte (CMR/e-CMR) son documentos caóticos, sucios y multilingües. La API OCR de TRANSCEND (ocr.cargoffer.com) abandona las reglas clásicas basadas en plantillas Zonal-OCR, y utiliza Modelos de Visión y Lenguaje Grandes (VLMs) para inferir semánticamente el contenido.

1. Visión Arquitectónica y Beneficio Principal

Los ERPs y TMS tardan días en registrar facturas. Nuestra API permite procesar:

  • CMRs (Albaranes): Extracción de sellos, firmas de conformidad, bultos y matrículas.
  • Facturas de Flete: Extracción de Line Items (líneas de factura), detección del CIF del proveedor, bases imponibles e IVA.
  • Tickets de Peaje / Combustible: Digitalización instantánea para dietas y gastos.

2. Especificación Técnica Completa (OpenAPI)

El endpoint soporta uploads multipart/form-data para procesar archivos binarios.

POST https://ocr.cargoffer.com/extract

Headers Requeridos

  • Authorization: Bearer <TU_API_KEY>

Request

Soporta JPG, PNG, PDF.

curl -X POST "https://ocr.cargoffer.com/extract" \
     -H "Authorization: Bearer TU_API_KEY" \
     -F "file=@/path/to/invoice_scanned.pdf" \
     -F "document_type=invoice"

JSON Response Extendido

{
  "document_id": "doc_123abc",
  "confidence_score": 0.985,
  "extraction": {
    "supplier": {
      "name": "Transportes Rápidos SL",
      "vat_id": "ESB12345678",
      "address": "Calle Industria 2, Madrid"
    },
    "invoice": {
      "invoice_number": "INV-2026-001",
      "date": "2026-05-10",
      "due_date": "2026-07-10"
    },
    "totals": {
      "total_amount": 1250.00,
      "tax_amount": 262.50,
      "currency": "EUR"
    },
    "line_items": [
      {
        "description": "Porte Carga Completa Madrid - Barcelona",
        "quantity": 1,
        "unit_price": 987.50,
        "tax_rate": 21
      }
    ]
  }
}

3. Integración Directa vía Servidor MCP y Skybridge

Esta API brilla cuando se integra en agentes LLM multimodales que pueden ver imágenes.

Repositorios Oficiales MCP

La lógica documental avanzada reside en el ecosistema Skybridge: cargoffer/ecmr-mcp-skybridge

Tools Expuestas

  • extract_invoice_data: Extrae la información estructurada de un documento local o URL.
  • verify_cmr_signatures: Determina si un albarán CMR tiene el sello del receptor (OK para facturar) o reservas por daños.

4. Patrones de Prompting (System Prompts)

System Prompt Sugerido: "Eres un Administrativo IA Autónomo. Cuando el usuario te pase una imagen de un ticket o factura, invoca extract_invoice_data. Compara silenciosamente el totals.tax_amount extraído contra el totals.total_amount para asegurar que el IVA matemático es correcto. Si detectas descuadres o falta la firma en el CMR (usando verify_cmr_signatures), avisa al usuario de la discrepancia."

5. Siguientes Pasos y Tutoriales Relacionados

Explora cómo combinar esta funcionalidad con otros módulos de TRANSCEND para crear flujos de trabajo avanzados en tu LLM o Agente: