> For the complete documentation index, see [llms.txt](https://yutax.gitbook.io/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yutax.gitbook.io/developer/getting-started/quickstart.md).

# Inicio rápido

Esta guía te llevara desde 0 → Reportar información , Realizar consultas soft-hard e Integrar alertas.

✅ **Paso 1 - Contacta a Yutax para verificar la identidad de tu empresa y crear un pre-registro.**

1. Ir a [business.yutax.net](https://business.yutax.net/)
2. Ingresa con su **correo electrónico comercial** ya registrado por YUTAX y completa el registro. 

***

### <sup><sub>✅ Paso 2 - Reporta cuentas<sub></sup>

Para comenzar a integrar, recibir alertas futuras de riesgo y reportar elementos negativos de tus usuarios, primero debes de reportar sus cuentas.&#x20;

{% hint style="info" %}
Los detalles de las cuentas reportadas son visibles para el propietario verificado de todas ellas y solo es accesible solicitando su archivo en Yutax Membership.&#x20;
{% endhint %}

{% hint style="warning" %}
Las empresas no tienen acceso a los detalles que componen una cuenta reportada, como el nombre de la empresa reportante, nombre o ID de la cuenta, teléfono, correo electrónico u otros datos que permitan identificar a la persona o la empresa.
{% endhint %}

{% hint style="info" %}
Las empresas solo reciben valores de conteo sobre la cantidad de cuentas reportadas en el archivo de cada usuario.

No se comparten detalles individuales como nombre de la empesa que reporta, nombre, correo, telefono y otros.

Además, se informa la edad de la cuenta más antigua, utilizada para determinar la antigüedad del perfil de confianza.

Ejemplo de información que reciben las empresas acerca de las cuentas reportadas:

`{ "reported_accounts": 7, "oldest_account_age_months": 64 }`
{% endhint %}

*Tienes mas información completa sobre la característica: Reportar cuentas en esta documentación → Características →* [*Reporte de información*](/developer/caracteristicas/reporte-de-informacion.md)

***

* Para comenzar a reportar tus cuentas accede al [**dashboard de empresa**](https://business.yutax.net/)  → **Reportar cuentas**&#x20;

Tendrás dos opciones :&#x20;

1- Importación ( CSV / XLSX )  ([*⚠️*](#user-content-fn-1)[^1] <mark style="background-color:orange;">Requerido actualización mensual</mark>)&#x20;

2- API Batch (✅ <mark style="background-color:green;">Recomendado</mark>) : *Visite la documentacion para integrar → Reportar cuentas API*

✅ **Paso 3 - Configurar Webhook y copiar la clave de la API**

1. Vaya a **Integraciones →  Webhooks.** &#x20;
2. Agregue su **URL de Webhook y suscribete a los tipos de alertas** (Yutax publicará actualizaciones de estado en vivo aquí)
3. Copie su **clave API** (manténgalo seguro, no lo exponga en el código frontend)

✅ **Paso 4 - Integra las verificaciones de identidad y prevención de fraude con consultas suaves (soft-inquiry) o consultas duras (hard-inquiry) en tu solución.**&#x20;

1. Puede encontrar todo acerca de : Verificación de identidad, consultas suabes, consultas fuertes, extracción del archivo del consumidor y mas en esta documentación *→ Características →* [*Verificacion de identidad*](/developer/caracteristicas/verificacion-de-identidad.md) *y* [*Perfil de riesgo*](/developer/caracteristicas/perfil-de-riesgo.md)*.*&#x20;
2. *Para integrar visite la documentación API → Consultas*

### <sup><sub>✅  Paso 5 - Reciba alertas en tiempo real<sub></sup>

Una vez que termine su integracion , Yutax enviará eventos de webhook a su punto final

Enviamos webhooks para los siguientes tipos de eventos:

`risk.changed:`\
Se activa cuando el nivel de riesgo o el YUTAX SCORE de un usuario cambia de forma relevante. Permite a las empresas tomar acciones inmediatas como limitar operaciones, solicitar verificación adicional o enviar el caso a revisión.

`alert.created:`\
Se activa cuando Yutax genera una alerta de riesgo o fraude asociada a un usuario, como chargebacks, impagos, fraude confirmado o incidentes críticos. Ayuda a prevenir pérdidas antes de que el riesgo se materialice en la plataforma.

`shared_event.detected:`\
Se activa cuando un usuario registrado en tu plataforma es reportado por un evento negativo en otro servicio integrado a Yutax. Esto permite anticiparse a fraudes recurrentes sin revelar información sobre la empresa reportante.

`identity.flagged:`\
Se activa cuando un proveedor reporta que una persona o negocio ha sido víctima de robo de identidad o suplantación. Permite aplicar medidas adicionales de verificación y proteger al usuario legítimo.

✅ **Paso 6 - Realiza investigaciónes profundas con nustra herramienta de análisis Yutax Insight**

1. Vaya a → Centro de investigación → Herramienta de analizis&#x20;
2. Ingrese datos verificables de un consumidor para obtener mas datos probablisticos relacionados, personas vinculadas, contactos, direcciones y mucha mas información si se encuentra disponible.&#x20;

*Puede encontrar todo acerca de la herramienta de análisis de yutax en esta documentación → Características →* [*Investigación* ](/developer/caracteristicas/investigacion.md)

✅ **Paso 7 -** Gestionar y monitorear en el dashboard&#x20;

* Vea los tipos de consultas realzadas, sus status y la información obtenida
* Descargar informes del consumidor en PDF / CSV para el cumplimiento

### 🤝 ¿Necesitas ayuda?

* 💬 **WhatsApp (más rápido, recomendado):** [Whatsapp](https://api.whatsapp.com/send/?phone=%2B34681310687)
* 📧 **Correo electrónico:** <business@yutax.net>

[^1]: