Datos de Conexión

Las APIs de ZetaSoftware utilizan un esquema de autenticación por credenciales estáticas estructurado en dos niveles: desarrollador/integrador y empresa cliente. Toda solicitud autenticada debe incluir ambos conjuntos de credenciales en el payload del request.

Modelo de credenciales

Obtención de credenciales

Credenciales del desarrollador

El desarrollador debe solicitar sus credenciales directamente a ZetaSoftware completando el formulario de registro disponible a través de soporte@zetasoftware.com.

ZetaSoftware proveerá DesarrolladorCodigo y DesarrolladorClave de forma directa y confidencial. Estas credenciales son estáticas por defecto y pueden modificarse únicamente a solicitud explícita del desarrollador.

Credenciales de la empresa cliente

EmpresaCodigo y EmpresaClave deben ser provistos por la empresa contratante. La clave se genera de forma individualizada para cada par Desarrollador–Empresa desde Configuración > APIs en el sistema ZetaSoftware.

RolCodigo también debe ser suministrado por la empresa. Debe corresponder a un rol existente en Configuración > Roles de Usuario con estado Activo.

Observaciones importantes

• Validación de RolCodigo: el sistema verifica únicamente que el rol exista y esté activo en la empresa. No se evalúan permisos específicos sobre recursos. Para evitar errores por modificaciones futuras al rol, se recomienda
  usar RolCodigo = 1, que permanece siempre activo.
• Alcance de las credenciales del desarrollador:
  DesarrolladorCodigo y DesarrolladorClave son independientes de la empresa cliente. Un mismo par de credenciales de desarrollador puede operar contra múltiples empresas.
• Campos no utilizados: UsuarioCodigo y UsuarioClave están reservados pero no tienen uso activo. Deben omitirse
  o enviarse vacíos; no deben contener valores operativos.
• Confidencialidad: las claves (DesarrolladorClave y EmpresaClave) no deben exponerse en código fuente accesible públicamente ni transmitirse por canales no seguros.