Crear una verificación de empresa

Trébol ofrece un servicio de OCR y validación para procesos de Know Your Business (KYB). Esta guía proporciona los pasos necesarios para integrar nuestro producto en tu flujo de trabajo, asegurando que los documentos se procesen de manera eficiente y precisa.

​

Preparación de Documentos

Antes de iniciar una verificación, asegúrate de preparar los documentos conforme a las siguientes especificaciones:

1. Tipo de Documento

   • Cada documento debe enviarse con un tipo específico. Aunque el tipo genérico (generic) es suficiente, especificar el tipo del documento optimiza la validación.
     Si nos envías el document en generic, Trébol se encarga de identificar el tipo de documento

2. URL Descargable

   • Proporciona una URL desde donde se pueda descargar el documento.
     La URL debe estar disponible por al menos 5 minutos para garantizar la descarga exitosa por parte de Trébol.

3. Guía del Tipo de Documento (Opcional)

   • Puedes incluir una guía opcional para el tipo de documento mediante el atributo item_type_guide.
   • Ejemplo de guía:
     • ac_mx: Acta constitutiva.
     • person_id: INE o pasaportes. Puedes consultar la lista completa de tipos de documentos en Tipos de Documentos

​

Preparación del Alcance (scope)

• Define el alcance de la información que deseas extraer del documento.
• Ejemplo: Si el documento contiene poderes legales de un firmante, utiliza el scope powers.

Los scopes disponibles son:

​

Preparación de Firmantes (key_people)

• Si necesitas buscar información de personas específicas (como poderes legales), incluye un arreglo con los nombres completos y el scope deseado. Puedes agregar estas personas por medio de su nombre completo o por medio del documento de identificación.
• Ejemplo:

  "key_people": [
    {
      "names": "Juan Pérez",
      "scope": ["powers"]
    }
  ]
  

​

Crear una Verificación

Para crear una verificación, envía una solicitud a la API de Trébol con la información requerida. A continuación se detallan los componentes de la solicitud y la respuesta esperada.

​

Solicitud

Envía una solicitud POST al endpoint correspondiente con los siguientes parámetros:

• country: Código del país (e.g., mx).
• tag: Identificador único para la verificación.
• tax_id: Identificador fiscal (opcional, dependiendo del flujo).
• flow_id: Identificador del flujo de verificación.
• options: Opciones adicionales para la verificación.
• metadata: Información adicional personalizada.
• items: Arreglo de documentos a verificar.
• key_people: Arreglo de personas clave y sus scopes (opcional).

​

Respuesta

Después de crear una verificación, Trébol responde con un objeto que incluye:

• verification_id: Identificador único de la verificación, utilizado para consultar el estado y los datos extraídos.
• status: Estado inicial de la verificación (e.g., pending).
• created_at: Timestamp de creación de la verificación.

​

Ejemplos de Solicitudes

​

Verificación Simple (Consulta de RFC)

Este ejemplo muestra cómo crear una verificación para consultar un RFC sin documentos adicionales. Con estos items se consultará la FIEL, la FIEL del represennte legal , y la razón social en el SIGER o registro publico de la propiedad y el comercio.

{
  "tax_id": "CMT2404303V2",
  "tag": "tu uuid de este cliente o verificación",
  "country": "mx",
  "items": [
    {
      "type": "public_sat_signatures",
      "options": {
        "type": "representatives"
      }
    },
    {
      "type": "public_sat_signatures",
      "options": {
        "type": "business",
        "tax_id_number": "CMT2404303V2"
      }
    }
  ],
  "options": {
    "advanced_siger": true
  }
}'

​

Verificación con Documentos

Este ejemplo ilustra cómo crear una verificación que incluye documentos para validación adicional.

{
  "country": "mx",
  "tag": "uuid-company-5678",
  "items": [
    {
      "type": "generic",
      "options": {
        "file_url": "https://www.ejemplo.com/acta-constitutiva.pdf",
        "item_type_guide": "ac_mx" //opcional
      }
    },
    {
      "type": "generic",
      "options": {
        "file_url": "https://www.ejemplo.com/ine-rep-legal.pdf",
        "item_type_guide": "person_id", //opcional
        "peopleScope": ["powers"] 
      }
    }
  ],
  "metadata": {
    "custom_key": "custom_value" //opcional
  },
  "key_people": [
    {
      "names": "Juan Pérez", // apoderados solicitados por medio de nombre completo y no por medio del documento
      "scope": ["powers"]
    }
  ]
}