Entornos

TRATO tiene tres entornos para integradores. Son independientes: cada uno tiene sus propios usuarios, API keys, contratos y plantillas.

Stage, Producción y Producción UE

EntornoURL base de la APIApp (API key en Perfil > Seguridad)Para qué
Stage (pruebas)https://enterprise-stage.api.trato.ioclm-stage.trato.ioIntegración y pruebas. Datos de prueba.
Producciónhttps://enterprise.api.trato.ioclm.trato.ioOperación real, con validez legal.
Producción UEhttps://enterprise-eu.api.trato.ioclm-eu.trato.ioOperación real de clientes en la UE.

El selector Entorno de la cabecera cambia todas las URL de esta documentación: ejemplos, referencia de la API y enlaces a la app. Por defecto muestra Stage.

¿Qué entorno uso?

  • Pruebas e integración: Stage, para todos los clientes, también los de la Unión Europea. Stage está alojado en EE. UU.: usa solo datos ficticios, nunca datos personales reales.
  • Operación real: el entorno de producción donde está tu cuenta de TRATO.
    • Producción si entras en la app por clm.trato.io.
    • Producción UE si entras por clm-eu.trato.io (clientes de la UE; los datos se quedan en la UE).

Si no sabes cuál es el tuyo, mira la dirección con la que entras en la app o pregunta a tu contacto de Customer Success.

Credenciales

  • Tus usuarios de Stage, Producción y Producción UE son cuentas distintas, aunque usen el mismo correo.
  • La API key se obtiene en la app de cada entorno, en Perfil > Seguridad: abrir la del entorno seleccionado.
  • Una API key o un token de un entorno no funcionan en los demás. Tampoco se comparten plantillas ni contratos: los IDs de Stage no existen en Producción ni en Producción UE.

Paso a Producción

  1. Integra y prueba en Stage con tu usuario de Stage.
  2. Valida la integración con TRATO (tu contacto de Customer Success).
  3. Pide acceso a tu entorno de producción (Producción o Producción UE) y obtén allí tu API key.
  4. Crea o identifica en ese entorno las plantillas que usas (sus IDs son distintos).
  5. Cambia solo la URL base, la credencial y los IDs de plantilla. El resto del código no cambia.

Error 401

Si llamas a un entorno con una credencial de otro, la API responde 401 con "code": "INVALID_CREDENTIALS", el entorno que ha respondido (environment) y una pista (hint). Comprueba que la URL base y la credencial son del mismo entorno. Ver Autorización.