Ambiente de Pruebas (Sandbox)
El sandbox es una cuenta de Sheriff para que desarrolles y pruebes tu integración con la API v3 sin consultar fuentes externas y sin consumir tu plan.
El sandbox no es otro ambiente: es la misma API de producción, con una cuenta distinta. Tu integración no cambia nada: ni el host, ni los endpoints, ni la forma de autenticarte. Lo único distinto son las credenciales con las que entras.
Cómo obtener una cuenta sandbox
Solicítala a tu ejecutivo comercial, que la habilita desde la administración de Sheriff. Una vez habilitada, genera las credenciales de API igual que con cualquier otra cuenta: Generar Credenciales de API.
El catálogo de perfiles
Una cuenta sandbox solo puede consultar cinco RUT ficticios. Están siempre disponibles y devuelven siempre lo mismo, así que puedes escribir pruebas automatizadas contra ellos y esperar el mismo resultado en cada corrida.
| RUT | Qué escenario cubre |
|---|---|
99900001-0 | Empresa sin hallazgos |
99900002-9 | Empresa con causas judiciales y procedimiento concursal |
44900003-K | Persona natural con coincidencias de compliance (PEP, funcionario público y familiares) |
99900004-5 | Empresa con bienes raíces, vehículos y conflictos laborales |
99900005-3 | Empresa con medios adversos y morosidad |
El RUT 44900003-K termina en K a propósito, para que pruebes cómo tu integración maneja ese dígito verificador.
Para Cargar perfil en Compliance, que busca por nombre, el catálogo es el mismo: envía en fullName el nombre o la razón social de uno de estos perfiles, tal como aparece en identificacion.razonSocial de su resumen. No importan las mayúsculas, las tildes ni los espacios repetidos.
Nombres, razones sociales, montos, sociedades, domicilios y fechas son inventados: no corresponden a ninguna persona ni empresa real, y las cifras no guardan relación con el escenario que describen. Sirven para validar el formato de la respuesta, no reglas de negocio que dependan de valores reales.
Qué funciona igual que en producción
Todo lo que tu integración necesita probar:
- Los mismos endpoints, con los mismos parámetros, códigos de respuesta y estructura de datos.
- La carga es asíncrona, como siempre: el perfil pasa por los mismos estados y el resultado no es inmediato, aunque el dato no venga de una fuente externa.
- Los webhooks se disparan igual, al mismo endpoint que tengas configurado.
- El análisis Marshal se resuelve con datos del catálogo por el mismo camino asíncrono: la investigación pasa por los mismos estados y llega por los mismos canales que en producción.
Qué no ocurre en una cuenta sandbox
- No se consulta ninguna fuente externa. Ninguna carga del catálogo sale a un proveedor de información, y Marshal no sale al proveedor.
- Las cargas y los análisis Marshal no consumen tu plan. Puedes repetirlos tantas veces como necesites.
- No se envían notificaciones por correo (ni el informe semanal ni los avisos por ayudante), para que las pruebas no generen correos con datos ficticios. La pantalla donde se configuran tampoco aparece en una cuenta sandbox.
Errores propios del sandbox
Son las respuestas que tu integración recibirá si sale del catálogo. Conviene contemplarlas: son parte de lo que estás probando. Los valores entre llaves se reemplazan por el dato real.
| Situación | Código | Mensaje en error |
|---|---|---|
| Cargar un RUT que no está en el catálogo | 400 | Esta cuenta opera en modo sandbox y sólo puede cargar perfiles del catálogo de pruebas. Los siguientes no pertenecen al catálogo: {RUTs}. |
| Cargar un RUT del catálogo que todavía no está disponible | 400 | Estos perfiles del catálogo de pruebas todavía no están disponibles: {RUTs}. |
| Buscar en compliance un nombre que no está en el catálogo | 400 | Esta cuenta opera en modo sandbox y sólo puede consultar los perfiles del catálogo de pruebas. "{nombre}" no pertenece al catálogo. |
Los errores de carga aplican a Carga de RUT y al webhook de resumen cuando el RUT necesita cargarse. En el error de compliance, {nombre} llega en mayúsculas.
Y a la inversa: estos cinco RUT no devuelven información desde una cuenta productiva. Una carga desde una cuenta productiva responde 404 con el mensaje No se encontró información para el RUT indicado., así que no los uses como caso de prueba contra tu cuenta real.