Precio Base y Precio de Venta

Esta API ofrece la funcionalidad de consultar y gestionar precios base y precios de venta para artículos específicos. Se destaca que la utilización de esta API demanda una comprensión profunda de la manipulación y aplicación de Precios Base y Precios de Venta en el sistema. Para cualquier interrogante técnico o conceptual, los desarrolladores están instados a comunicarse con la empresa cliente de ZetaSoftware. En caso de que la empresa no esté familiarizada con estos conceptos, el material educativo está disponible en el enlace correspondiente.

Detalles de URL y Servicio

• URL Descriptiva: https://api.zetasoftware.com/z.apis.asoappreciosarticulosv2?wsdl
• URL del Servicio: https://api.zetasoftware.com/z.apis.asoappreciosarticulosv2

Método: ObtenerPrecioVenta

Este método está diseñado para recuperar un precio de venta que ha sido asignado previamente a un artículo específico.

Filtros Aplicables

• ArticuloCodigo (T(20)): Es un campo obligatorio que se utiliza para especificar el código del artículo de interés.
• PrecioVentaCodigo (N(3)): También es un campo obligatorio, destinado para definir el código del precio de venta.
• MonedaCodigo (N(2)): Campo opcional que permite especificar la moneda en la cual se quiere obtener el precio.
• ClienteCodigo (T(2)): Campo opcional para definir el código del cliente, en caso de que el precio sea específico para un cliente.
• CondicionPagoCodigo (T(3)): Otro campo opcional, usado para definir las condiciones de pago que podrían afectar el precio del artículo.

Datos de Salida

• PrecioSinIVA: Este es el precio del artículo sin incluir el Impuesto al Valor Agregado (IVA).
• PrecioConIVA: Este precio sí incluye el IVA.

Método: ObtenerPrecioBase

Este método tiene como objetivo la obtención de los precios base asociados a un artículo específico o a todos los artículos en inventario.

Filtros Aplicables

• ArticuloCodigo (T(20)): Campo que permite especificar el código del artículo. Si se deja vacío, el sistema entenderá que la consulta es para todos los artículos.
• PrecioBaseCodigo (N(3)): Este filtro se utiliza para identificar un código de precio base específico.
• FechaRegistroDesde y FechaRegistroHasta (AAAA-MM-DD): Estos campos opcionales son especialmente útiles para restringir la consulta a un rango de fechas. Se recomienda utilizar estos filtros para enfocar la búsqueda en artículos que hayan experimentado cambios en sus datos en el período de tiempo especificado.

Datos de Salida

• CodigoArticulo: Representa el código del artículo al cual está asignado el precio base.
• CodigoMoneda: Este campo especifica la moneda en la que está denominado el precio.
• CodigoPrecio: Corresponde al código identificatorio del precio base.
• PrecioSinIVA: Este valor muestra el precio del artículo sin la inclusión del Impuesto al Valor Agregado (IVA).
• PrecioConIVA: En contraposición, este campo muestra el precio del artículo con la inclusión del IVA.

Método: GrabarPrecioBase

Este método está diseñado para asignar o modificar los precios base de un artículo específico. Es imperativo que el desarrollador entienda la seriedad de este método, ya que la modificación de un precio base puede tener un efecto en cadena sobre los precios de venta que dependen del mismo.

Filtros Aplicables

• ArticuloCodigo (T(20)): Este campo es obligatorio y se usa para especificar a qué artículo se le asignará o modificará el precio base.
• PrecioBaseCodigo (N(3)): También es un campo obligatorio que identifica el código del precio base que se quiere asignar o modificar.
• MonedaCodigo (N(2)): Este campo es obligatorio y define la moneda en la que se establecerá el precio.
• PrecioSinIVA (N(12.5)): Este campo es opcional. Si se envía, no debe enviarse el campo PrecioConIVA.
• PrecioConIVA (N(12.5)): Al igual que el campo anterior, es opcional y mutuamente excluyente con PrecioSinIVA.

Datos de Salida

• Succeed / Mensaje: La API devolverá una de dos cosas: un éxito en la operación o un mensaje detallando la razón del fallo.

Metodología Esperada de Uso

Se recomienda primeramente ejecutar el método ObtenerPrecioBase dejando vacíos los parámetros ArticuloCodigo y PrecioBaseCodigo. Este enfoque recopila todos los registros en una sola consulta. La mejor práctica es hacer esto fuera del horario comercial y utilizar una base de datos propia durante las horas de operación, en lugar de acceder constantemente a la base de datos de ZetaSoftware.

Para saber qué precios han cambiado durante el día, se pueden aplicar los filtros FechaRegistroDesde y FechaRegistroHasta, centrando así la consulta en registros que son nuevos o han sido modificados.

Es crucial notar que cuando se usa el método GrabarPrecioBase, se debe enviar solo uno de los dos campos entre PrecioSinIVA y PrecioConIVA. El otro será calculado en función de la tasa de IVA aplicable al artículo. Si ambos campos se envían con un valor de cero, el sistema eliminará el precio base registrado para el artículo en cuestión.

La comprensión detallada de estos métodos y su correcta implementación pueden significar la diferencia entre una gestión de precios eficiente y una llena de inconsistencias. Es vital que los desarrolladores manejen estos métodos con el cuidado y la precisión que requieren.