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.asoapclientev4?wsdl
• Servicio: https://api.zetasoftware.com/z.apis.asoapclientev4

Método Query

Permite obtener un listado de clientes con sus datos comerciales.

Parámetros de entrada

Ejemplo de request

{
  "CodigoDesde": "",
  "CodigoHasta": "",
  "NombreContiene": "",
   "RUT": "",
  "FechaRegistroDesde": "2026-01-01",
  "FechaRegistroHasta": "2026-01-31"
}

Ejemplo de response

[
  {
    "Codigo": "P0001",
    "Nombre": "Proveedor Demo S.A.",
    "Rut": 040349070015,
    "Activo": "S",
    "CategoriaCodigo": "001",
    "CategoriaNombre": "Nacional",
    "CondicionCodigo": "030",
    "CondicionNombre": "30 días",
    "PorcentajeDto1": 2.50,
    "PorcentajeDto2": 0.00,
    "PorcentajeDto3": 0.00,
    "IVA": "01",
    "LocalCodigo": 1,
    "LocalNombre": "Casa Central",
    "CodigoContable": "211001",
    "ContribuyenteEBoleta": "N",
    "FechaRegistro": "2026-01-15"
    "IsLastPage:true
  }
]

Método Load

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

Parámetro

• Codigo – Obligatorio.

Resultado

Codigo
CategoriaCodigo
LocalCodigo
ComprobantesPorCliente
VendedorCodigo
PrecioVentaCodigo
CondicionCodigo
TextoPredefinidoCodigo
PorcentajeDto1
PorcentajeDto2
PorcentajeDto3
CodigoContable
EmailAdministracion
ExentoIVA
MonedaCodigo
TopeCreditoMonto
TopACreditoDias

Método Save

Permite crear o actualizar los datos comerciales de un cliente.

Al actualizar los datos comerciales, los campos que no se envían en el payload no conservan automáticamente su valor anterior.

El sistema toma como referencia únicamente la información recibida. Por este motivo, los campos que no se incluyen en  la solicitud quedan sin valor.

Por lo tanto, al realizar una actualización, es necesario enviar también los datos que se desean conservar.

Parámetros de entrada

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.