Forma 1: Clasificación automática

• No sabes el tipo exacto del documento
• Prefieres que Trébol clasifique en lugar de hardcodear el tipo
• El usuario final puede subir cualquier documento válido y quieres procesarlo de todos modos

1. Envías el item con type: "generic" y el file_url
2. Trébol analiza el documento y lo clasifica al tipo específico
3. Una vez clasificado, Trébol extrae la información
4. Si Trébol no puede clasificar, el item termina como unknown (documento no reconocido) o corrupted_file (archivo dañado)

​

Payload mínimo

{
  "country": "mx",
  "tag": "uuid-cliente-1234",
  "items": [
    {
      "type": "generic",
      "options": {
        "file_url": "https://www.ejemplo.com/documento.pdf"
      }
    }
  ]
}

​

Payload con client_item_type (hint)

{
  "country": "mx",
  "tag": "uuid-cliente-5678",
  "items": [
    {
      "type": "generic",
      "options": {
        "file_url": "https://www.ejemplo.com/acta-constitutiva.pdf",
        "client_item_type": "ac_mx"
      }
    }
  ]
}

​

Resultado

{
  "items": [
    {
      "id": 12345,
      "item_type": "ac_mx",
      "item_status": "complete",
      "item_value": {
        /* estructura según ac_mx */
      }
    }
  ]
}

​

Siguientes pasos

• Tipos técnicos — detalle de generic, unknown, corrupted_file
• Estados de verificación — cómo monitorear el progreso