Portal de desarrolladores
REST SOAP Cliente local

SincronizarTerminal ahora recibe metadata del cliente y devuelve parametros globales

La sincronizacion de terminal permite reportar datos del cliente local con un bloque simplificado, devolver parametros globales bajo demanda y cachearlos localmente.

Nueva funcionalidad 14/03/2026 SOAP Version: v1

Endpoints afectados

  • SOAP SincronizarTerminal

Migracion recomendada

Los campos nuevos son opcionales. Los clientes existentes pueden seguir enviando solo RutEmisor, CodComercio y CodTerminal. Los clientes nuevos pueden adjuntar DatosConexion y aprovechar ParametrosClienteLocal en la respuesta.

Que cambia

La operacion SincronizarTerminal ahora admite un bloque opcional DatosConexion para que el cliente local reporte al servidor informacion de su instalacion, por ejemplo:

  • version del cliente
  • sistema operativo
  • espacio ocupado por la base local
  • estado de firma local
  • vencimiento del certificado

Ademas, la respuesta ahora incluye un bloque ParametrosClienteLocal con parametros globales que el agente puede descargar y cachear localmente, como el valor UI, el tope UI para envio a DGI y la URL de publicacion para QR.

El request tambien admite el campo opcional IncluirParametrosClienteLocal:

  • si vale true o no se envia, el servidor devuelve ParametrosClienteLocal
  • si vale false, el servidor omite ese bloque y solo devuelve la configuracion operativa de la terminal

Impacto para integradores

No rompe compatibilidad.

  • Los clientes actuales pueden seguir usando la operacion sin cambios.
  • Los clientes que quieran diagnostico mas rico en el servidor pueden empezar a enviar DatosConexion.
  • Los clientes locales ahora pueden tomar ParametrosClienteLocal desde la respuesta y evitar configuraciones hardcodeadas.
  • El contrato ya no incluye campos especificos de SQL Server o .NET Framework que no aplican al modulo local actual.
  • Los agentes que sincronicen muy seguido ya no necesitan descargar parametros globales en cada llamada; pueden pedirlos solo al iniciar o segun su TTL local.

Migracion recomendada

  1. Mantener el request actual si no se necesita metadata del cliente.
  2. Si se desea trazabilidad por punto de emision, enviar DatosConexion.
  3. Consumir ParametrosClienteLocal cuando se quiera sincronizar valor UI, tope UI y URL de publicacion DGI desde el servidor.
  4. Si el cliente sincroniza frecuentemente, usar IncluirParametrosClienteLocal=false cuando el cache local siga vigente.