Escaneo Prompt

Endpoint

https://api.verifik.co/v2/ocr/scan-prompt

Escaneo Prompt con Integración de IA es una herramienta poderosa diseñada para optimizar la extracción de texto de documentos legales, apoyando tu proceso de Conoce a tu Cliente (KYC). Este servicio utiliza IA avanzada para detectar automáticamente tipos de documentos y emplea tecnología propietaria para una extracción de datos precisa.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description
image	string	Yes	Imagen en formato Base64 codificado o una URL donde está alojada la imagen.
cropFace	boolean	No	Si quieres recortar la cara del documento, pasa esto como true.
documentType	string	No	Puedes especificar el documentType para que la IA no tenga que adivinar qué tipo de documento estamos extrayendo.

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.post("https://api.verifik.co/v2/ocr/scan-prompt", {
  image: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
  cropFace: true,
  documentType: "DNI"
}, {
  headers: { 
    "Content-Type": "application/json", 
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` 
  },
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/ocr/scan-prompt"
headers = {"Content-Type": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
payload = {
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
    "cropFace": True,
    "documentType": "DNI"
}
r = requests.post(url, json=payload, headers=headers)
print(r.json())

Respuesta

200

{
  "id": "xjicp",
  "data": {
    "__v": 0,
    "_id": "64d3ed6aed1c7d7ea391e617",
    "url": "https://cdn.verifik.co/ocr/64404b1f9856cc8cebd762e7/1691610471704-image.jpeg",
    "type": "ocr",
    "client": "64404b1f9856cc8cebd762e7",
    "status": "ACTIVE_BUT_UNVERIFIED",
    "deleted": false,
    "createdAt": "2023-08-09T19:47:54.214Z",
    "updatedAt": "2023-08-09T19:47:54.214Z",
    "requires2FA": false,
    "documentType": "CUSTOM",
    "OCRExtraction": {
      "fullName": "Juan Miguel Rodríguez López",
      "lastName": "Rodríguez López",
      "firstName": "Juan Miguel",
      "documentNumber": "01101101 01100001"
    },
    "documentNumber": "01101101 01100001",
    "imageValidated": false,
    "validationMethod": "SCAN_GPT"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "August 9, 2023 7:47 PM"
  }
}

404

{
  "message": "Document not found",
  "code": "DOCUMENT_NOT_FOUND"
}

Características

1. Extracción de Tipo de Documento con IA: Identifica automáticamente el tipo de documento legal.
2. Extracción de datos precisa: Emplea tecnología personalizada para extraer información relevante con alta precisión.
3. Plantillas de prompts flexibles: Utiliza prompts del sistema pre-diseñados para una extracción eficiente lista para usar. También permite a los usuarios crear plantillas personalizadas para refinar la lógica, ajustar campos extraídos, o mejorar el proceso agregando/eliminando puntos de datos.

Coincidencia del documento

Cuando documentType es CC (cédula colombiana) o DRCC (licencia de conducción colombiana), OCRExtraction incluye documentClassification:

"documentClassification": {
  "requestedDocumentType": "CC",
  "detectedDocumentType": "DRCC",
  "detectedDocumentName": "Licencia de Conducción",
  "isMatch": false,
  "confidence": 1,
  "reason": "El documento es una licencia de conducción del Ministerio de Transporte."
}

• detectedDocumentType es CC, DRCC o UNKNOWN.
• isMatch es true solo cuando la foto es el documento que pediste.
• Una licencia enviada como CC sigue respondiendo HTTP 200, y documentType permanece CC. isMatch es false. Rechaza esa foto en tu aplicación.
• Una cédula enviada como DRCC funciona igual en el otro sentido.
• Un pasaporte, una tarjeta de vehículo (TLCC) o una clasificación que no pudo ejecutarse es UNKNOWN, con isMatch en false.

El mismo escaneo puede continuar en un SmartCheck desde Smart Agent. Se lee la foto, y una verificación configurada en ese tipo de documento, como la consulta de cédula colombiana, puede ejecutarse con el número que extrajo el OCR.

Notas

• Usa imágenes codificadas en Base64 o URLs directas para el parámetro image.
• El parámetro cropFace ayuda a mejorar la precisión enfocándose en el contenido del documento.
• Especifica documentType cuando conozcas el tipo de documento para mejores resultados.