Saltar al contenido principal

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.

No es otra URL

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.

RUTQué escenario cubre
99900001-0Empresa sin hallazgos
99900002-9Empresa con causas judiciales y procedimiento concursal
44900003-KPersona natural con coincidencias de compliance (PEP, funcionario público y familiares)
99900004-5Empresa con bienes raíces, vehículos y conflictos laborales
99900005-3Empresa 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.

Los datos son ficticios

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ónCódigoMensaje en error
Cargar un RUT que no está en el catálogo400Esta 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á disponible400Estos perfiles del catálogo de pruebas todavía no están disponibles: {RUTs}.
Buscar en compliance un nombre que no está en el catálogo400Esta 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.