API Datos Comerciales de Cliente

Esta API permite gestionar los datos comerciales asociados a clientes, incluyendo condiciones de venta, categorización, límites de crédito y parámetros operativos utilizados en procesos comerciales.

La funcionalidad asociada en el sistema se encuentra en Configuración > Contactos, Clientes y Proveedores > Datos Comerciales de Cliente.

Casos de uso

• Consultar configuración comercial de clientes.
• Definir condiciones de venta y listas de precios.
• Gestionar límites de crédito y condiciones financieras.
• Sincronizar datos comerciales con sistemas externos.

Endpoint del servicio

• WSDL: https://api.zetasoftware.com/z.apis.asoapclientev3?wsdl
• Servicio: https://api.zetasoftware.com/z.apis.asoapclientev3

Método Query

Permite obtener un listado de clientes con sus datos comerciales.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
CodigoDesde	T(10)	No	Código inicial.
CodigoHasta	T(10)	No	Código final.
NombreContiene	T(20)	No	Texto a buscar.
FechaRegistroDesde	AAAA-MM-DD	No	Fecha desde.
FechaRegistroHasta	AAAA-MM-DD	No	Fecha hasta.

Estructura del response

Codigo
Nombre
Activo
CategoriaCodigo
CategoriaNombre
LocalCodigo
LocalNombre
ComprobantesPorCliente
VendedorCodigo
VendedorNombre
PrecioVentaCodigo
PrecioVentaNombre
CondicionCodigo
CondicionNombre
TextoPredefinidoCodigo
TextoPredefinidoAbreviacion
TextoPredefinidoNombre
PorcentajeDto1
PorcentajeDto2
PorcentajeDto3
CodigoContable
EmailAdministracion
ExentoIVA
MonedaCodigo
AbreviacionMoneda
SimboloMoneda
TopeCreditoMonto
TopACreditoDias
FechaRegistro

Método Load

Permite obtener los datos comerciales de un cliente específico.

Parámetro

• Codigo – Obligatorio.

Resultado

Devuelve los mismos campos que el método Query para un único cliente.

Método Save

Permite crear o actualizar los datos comerciales de un cliente.

Parámetros de entrada

Campo	Tipo	Obligatorio	Descripción
Codigo	T(10)	Sí	Código del cliente.
CategoriaCodigo	T(3)	No	Categoría comercial.
LocalCodigo	N(3)	Sí	Local asociado.
ComprobantesPorCliente	T(1)	Sí	Visibilidad por local (S/N).
VendedorCodigo	T(3)	No	Vendedor asignado.
PrecioVentaCodigo	N(3)	No	Lista de precios.
CondicionCodigo	T(3)	No	Condición de pago.
TextoPredefinidoCodigo	T(3)	No	Texto comercial.
PorcentajeDto1	N(3.2)	No	Descuento 1.
PorcentajeDto2	N(3.2)	No	Descuento 2.
PorcentajeDto3	N(3.2)	No	Descuento 3.
CodigoContable	T(10)	No	Código contable.
EmailAdministracion	T(500)	No	Email administrativo.
ExentoIVA	T(1)	Sí	Exoneración de IVA (S/N).
MonedaCodigo	N(3)	Sí	Moneda del cliente.
TopeCreditoMonto	T	No	Límite de crédito.
CTopeCreditoDias	N(3)	No	Días de crédito.

Resultado

Succeed
Error
Mensaje

Método Delete

Permite eliminar los datos comerciales de un cliente.

Parámetro

• Codigo – Obligatorio.

Restricción

No es posible eliminar si el cliente tiene movimientos asociados (comprobantes, cobros u otros registros).

Resultado

Succeed
Error
Mensaje

Observaciones

• El método Query permite consultas masivas.
• El método Load es para consultas puntuales.
• El método Save permite alta y modificación.
• Estos datos impactan directamente en ventas, facturación y crédito.

Consideraciones de integración

• Validar previamente la existencia del cliente en la API de contactos.
• Controlar dependencias antes de eliminar registros.
• Sincronizar condiciones comerciales con procesos de ventas.
• Verificar límites de crédito antes de automatizar operaciones.