Documentacion de Integracion API Mint Scan

{
  "username": "[email protected]",
  "password": "contrasena"
}

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "coc",
  "category": "M1",
  "images": [
    {
      "base64": "JVBERi0xLjQK...",
      "fileName": "coc_vehiculo.pdf",
      "fileType": "application/pdf"
    }
  ],
  "name": "documento_coc.pdf",
  "externalId": "INSP-2026-001",
  "externalData": { "tipoCombustible": "diesel", "lineaInspeccion": 3 },
  "returnRedirectUrl": true
}

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "success"
}

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "type": "coc",
  "category": "M1",
  "processType": "manual",
  "externalId": "INSP-2026-002",
  "returnRedirectUrl": true
}

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "message": "success",
  "processType": "manual",
  "type": "coc",
  "status": "COMPLETED",
  "externalId": "INSP-2026-002",
  "redirectUrl": "https://scan.mintitv.com?tempToken=xyz789&externalId=INSP-2026-002"
}

{
  "id": "550e8400-e29b-41d4-a716-446655440002",
  "type": "reform-cp",
  "category": "M1",
  "externalId": "INSP-2026-003",
  "returnRedirectUrl": true,
  "subdocuments": {
    "ic": [{ "base64": "...", "fileName": "informe_conformidad.pdf", "fileType": "application/pdf" }],
    "ct": [{ "base64": "...", "fileName": "certificado_taller.pdf", "fileType": "application/pdf" }],
    "titv": [{ "base64": "...", "fileName": "tarjeta_itv.pdf", "fileType": "application/pdf" }],
    "titv_type": "new",
    "pt": [{ "base64": "...", "fileName": "proyecto_tecnico.pdf", "fileType": "application/pdf" }],
    "cdfo": [{ "base64": "...", "fileName": "certificado_final_obra.pdf", "fileType": "application/pdf" }]
  }
}

{
  "id": "...",
  "type": "coc",
  "category": "M1",
  "images": [{ "base64": "...", "fileName": "coc.pdf", "fileType": "application/pdf" }],
  "auxiliaryDocuments": [
    {
      "type": "report",
      "images": [{ "base64": "...", "fileName": "informe.pdf", "fileType": "application/pdf" }]
    }
  ]
}

// Abrir el editor visual en el navegador del operador
Desktop.browse(new URI(response.getRedirectUrl()));

{
  "processes": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "externalId": "INSP-2026-001",
      "externalData": { "tipoCombustible": "diesel", "lineaInspeccion": 3 },
      "status": "COMPLETED",
      "phase": "draft",
      "accessible": true,
      "redirectUrl": "https://scan.mintitv.com?tempToken=abc123&externalId=INSP-2026-001",
      "vehicleLicense": "1234ABC",
      "vin": "WVWZZZ3CZWE123456",
      "documentType": "coc",
      "category": "M1",
      "model": "Golf VIII 2.0 TDI",
      "expedient": "EXP-2026-001",
      "ict": true,
      "serialNumber": null,
      "createdAt": "2026-01-28T10:00:00Z",
      "technicalCard": {
        "E": "WVWZZZ3CZWE123456",
        "D.1": "VOLKSWAGEN",
        "D.2": "GOLF",
        "D.3": "Golf VIII 2.0 TDI",
        "J": "M1",
        "matricula": "1234ABC",
        "certificado": "e1*2018/858*00123",
        "reformas": [],
        "observaciones": ["Vehiculo con enganche homologado"],
        "homologaciones": [],
        "F.1": "2050",
        "F.2": "2350",
        "G": "1450"
      },
      "documents": [
        {
          "type": "original",
          "filename": "coc.pdf",
          "mimeType": "application/pdf",
          "downloadUrl": "https://storage.mintitv.com/signed-url..."
        },
        {
          "type": "processed",
          "filename": "page_1.jpg",
          "mimeType": "image/jpeg",
          "downloadUrl": "https://storage.mintitv.com/signed-url..."
        }
      ]
    }
  ]
}

1. Enviar documento (POST /api/v2/process/pool)
2. Esperar 5 segundos
3. Consultar estado (GET /api/v1/scan-process?externalId=...)
4. Si accessible === true  → datos disponibles, detener polling
5. Si status === "FAILED" o "ABORTED" → error, detener polling
6. Si no → volver al paso 2

{
  "externalId": "INSP-2026-00123",
  "newExternalId": "INSP-2026-00456",
  "vin": "WVWZZZ3CZWE123456",
  "returnRedirectUrl": true
}

{
  "success": true,
  "message": "Draft duplicado exitosamente",
  "draftId": "f1e2d3c4-b5a6-7890-abcd-ef0987654321",
  "scanningId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "externalId": "INSP-2026-00456",
  "externalData": null,
  "redirectUrl": "https://scan.mintitv.com?tempToken=xyz789&externalId=INSP-2026-00456"
}

{
  "title": "Not Authorized",
  "detail": "Token no autorizado",
  "code": "NOT_AUTHORIZED",
  "status": 401
}

{
  "title": "Forbidden",
  "detail": "No tiene permisos para duplicar este scanning",
  "code": "FORBIDDEN"
}

{
  "title": "Not Found",
  "detail": "Scanning no encontrado",
  "code": "SCANNING_NOT_FOUND"
}

{
  "title": "Validation Error",
  "detail": "Al menos uno de scanningId o externalId es requerido",
  "code": "VALIDATION_ERROR"
}

{
  "title": "Servicio no disponible",
  "detail": "Backend service is currently unavailable",
  "code": "SERVICE_UNAVAILABLE",
  "retryAfter": 30
}

{
  "title": "Not Authorized",
  "detail": "Token no autorizado",
  "code": "NOT_AUTHORIZED",
  "status": 401
}

{
  "title": "Proceso no encontrado",
  "detail": "No se encontro ningun proceso con externalId: INSP-2026-00123",
  "code": "DOCUMENT_NOT_FOUND",
  "status": 422
}

{
  "title": "Titulo del error",
  "detail": "Descripcion detallada del error",
  "code": "CODIGO_ERROR"
}

{
  "title": "Not Authorized",
  "detail": "Token no proporcionado",
  "code": "TOKEN_NOT_PROVIDED"
}

{
  "title": "Formato de Peticion Invalida.",
  "detail": "At least one search parameter is required: externalId, vin, or vehicleLicense",
  "code": "INVALID_FORMAT"
}

{
  "title": "Error interno del servidor",
  "detail": "Error interno del servidor. Pongase en contacto con soporte.",
  "code": "INTERNAL_SERVER_ERROR"
}

{
  "title": "Payload Too Large",
  "detail": "El cuerpo de la peticion excede el limite de 50MB",
  "code": "PAYLOAD_TOO_LARGE",
  "status": 413
}

{
  "title": "Too Many Requests",
  "detail": "Too many requests, please try again later.",
  "code": "TOO_MANY_REQUESTS",
  "status": 429
}

{
  "title": "Service Unavailable",
  "detail": "Backend returned status 500",
  "code": "SERVICE_UNAVAILABLE",
  "retryAfter": 30
}

curl -X POST https://rest.mintitv.com/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "[email protected]",
    "password": "contrasena"
  }'

curl -X POST https://rest.mintitv.com/api/v2/process/pool \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "coc",
    "category": "M1",
    "images": [{"base64": "JVBERi0xLjQK...", "fileName": "coc_vehiculo.pdf", "fileType": "application/pdf"}],
    "name": "coc_vehiculo.pdf",
    "externalId": "INSP-2026-001",
    "returnRedirectUrl": true
  }'

curl -X GET "https://rest.mintitv.com/api/v1/scan-process?externalId=INSP-2026-001" \
  -H "Authorization: Bearer eyJhbGciOi..."

curl -X POST https://rest.mintitv.com/api/v2/process/pool \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "type": "titv-new",
    "category": "M1",
    "processType": "manual",
    "externalId": "INSP-2026-002",
    "returnRedirectUrl": true
  }'

curl -X POST https://rest.mintitv.com/api/v2/process/pool \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "type": "reform-cp",
    "category": "M1",
    "externalId": "INSP-2026-003",
    "returnRedirectUrl": true,
    "subdocuments": {
      "ic": [{"base64": "...", "fileName": "informe_conformidad.pdf", "fileType": "application/pdf"}],
      "ct": [{"base64": "...", "fileName": "certificado_taller.pdf", "fileType": "application/pdf"}],
      "titv": [{"base64": "...", "fileName": "tarjeta_itv.pdf", "fileType": "application/pdf"}],
      "titv_type": "new",
      "pt": [{"base64": "...", "fileName": "proyecto_tecnico.pdf", "fileType": "application/pdf"}],
      "cdfo": [{"base64": "...", "fileName": "certificado_final_obra.pdf", "fileType": "application/pdf"}]
    }
  }'

curl -X POST https://rest.mintitv.com/api/v1/duplicate-scanning \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -d '{
    "externalId": "INSP-2026-001",
    "newExternalId": "INSP-2026-004",
    "vin": "WVWZZZ3CZWE123456",
    "returnRedirectUrl": true
  }'

#!/bin/bash
# Ejemplo de polling en bash

TOKEN="eyJhbGciOi..."
EXTERNAL_ID="INSP-2026-001"
MAX_ATTEMPTS=60  # 5 minutos con intervalo de 5 segundos
INTERVAL=5

for i in $(seq 1 $MAX_ATTEMPTS); do
  RESPONSE=$(curl -s -X GET \
    "https://rest.mintitv.com/api/v1/scan-process?externalId=$EXTERNAL_ID" \
    -H "Authorization: Bearer $TOKEN")

  ACCESSIBLE=$(echo "$RESPONSE" | jq -r '.processes[0].accessible // false')
  STATUS=$(echo "$RESPONSE" | jq -r '.processes[0].status // "UNKNOWN"')

  echo "Intento $i: status=$STATUS, accessible=$ACCESSIBLE"

  if [ "$ACCESSIBLE" = "true" ]; then
    echo "Datos disponibles:"
    echo "$RESPONSE" | jq '.processes[0].technicalCard'
    exit 0
  fi

  if [ "$STATUS" = "FAILED" ] || [ "$STATUS" = "ABORTED" ]; then
    echo "El proceso ha terminado con estado: $STATUS"
    exit 1
  fi

  sleep $INTERVAL
done

echo "Timeout: el proceso no se completo en el tiempo esperado"
exit 1

# Generar PDF preview y guardarlo en un archivo
curl -X GET "https://rest.mintitv.com/api/v1/scan-process/pdf?externalId=INSP-2026-001" \
  -H "Authorization: Bearer eyJhbGciOi..." \
  --output preview-INSP-2026-001.pdf