API Artículos

Esta API permite gestionar artículos de la empresa, incluyendo consultas, alta, modificación, eliminación y obtención de campos adicionales. Está orientada a la administración de productos, servicios e inventario desde sistemas externos.

La funcionalidad asociada en el sistema se encuentra en Configuración > Stock > Artículos.

Endpoint del servicio

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

Método Query

Permite obtener artículos de la empresa aplicando filtros.

Requisitos previos

• Se recomienda mantener una base de datos local de artículos para evitar consultas frecuentes.
• Utilizar filtros por fecha para sincronización incremental.

Parámetros de entrada

Estructura del response

Codigo
Nombre
Abreviacion
CodigoOrigen
CodigoBarras
ArticulosActivo
CategoriaCodigo
CategoriaNombre
FamiliaCodigo
FamiliaNombre
MarcaCodigo
MarcaNombre
ProveedorCodigo
ProveedorNombre
ConceptoCodigo
ConceptoNombre
IVACodigo
IVANombre
IVATasa
IVATipo
PercepcionCodigo
PercepcionNombre
CodigoContableCompras
CodigoContableVentas
CodigoContableProduccion
ContabilizarStock
UnidadPrincipalCodigo
UnidadPrincipalNombre
UnidadPrincipalSimbolo
UnidadSecundariaCodigo
UnidadSecundariaNombre
UnidadSecundariaSimbolo
CantidadPorUnidad
TrabajaDobleCantidad
IncluirListaPrecios
Lotes
Vencimiento
CostoFecha
MonedaCodigo
MonedaSimbolo
Costo
PorcentajeUtilidadCosto
TextoPredefinidoCodigo
TextoPredefinidoNombre
Web
Notas
FechaRegistro

Método Load

Permite obtener un único artículo.

Parámetro de entrada

• Codigo – Obligatorio.

Método Save

Permite crear o actualizar artículos.

Al actualizar el artículo, 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.

Datos obligatorios.

Datos opcionales

{
"SaveIn": {
"Connection": {
"DesarrolladorCodigo": "DESARROLLADOR",
"DesarrolladorClave": "CLAVE_DESARROLLADOR",
"EmpresaCodigo": "EMPRESA",
"EmpresaClave": "CLAVE_EMPRESA",
"UsuarioCodigo": ,
"UsuarioClave": "",
"RolCodigo": 1
},
"Data": {
"Codigo": "ART0001",
"Nombre": "Artículo de ejemplo",
"Abreviacion": "ART EJEMPLO",
"CodigoOrigen": "ERP-0001",
"CodigoBarras": "7730123456789",
"ArticulosActivo": "S",
"CategoriaCodigo": "001",
"FamiliaCodigo": "FAM001",
"MarcaCodigo": "001",
"ProveedorCodigo": "PROV001",
"ConceptoCodigo": "ARTICULO",
"IVACodigo": 2,
"PercepcionCodigo": "",
"CodigoContableCompras": "",
"CodigoContableVentas": "",
"CodigoContableProduccion": "",
"ContabilizarStock": "S",
"UnidadPrincipalCodigo": "UN",
"UnidadSecundariaCodigo": "",
"CantidadPorUnidad": 0,
"TrabajaDobleCantidad": "N",
"IncluirListaPrecios": "S",
"Lotes": "N",
"Vencimiento": "N",
"CostoFecha": "2026-07-17",
"MonedaCodigo": 1,
"Costo": 1500.50,
"PorcentajeUtilidadSobreCosto": 30,
"TextoPredefinidoCodigo": "",
"Web": "",
"Notas": "Artículo creado mediante integración REST"
}
}
}

Resultado

Succeed
Error
Mensaje

Método Delete

Permite eliminar un artículo.

Parámetro de entrada

• Codigo – Obligatorio.

Restricción

Un artículo no puede eliminarse si ya fue utilizado en operaciones. En ese caso debe marcarse como inactivo.

Método CamposAdicionales

Permite obtener campos personalizados de artículos.

Parámetro de entrada

• ArticuloCodigo – Opcional.

Resultado

Codigo
CodigoCampo
Valor

Método StockMínimo

Permite obtener el Stock Mínimo de artículos.

Parámetro de entrada

• ArticuloCodigo – Opcional.

Resultado

CodigoArticulo
CodigoLocal
StockMinimo

Observaciones

• Se recomienda utilizar filtros de fecha para detectar altas o modificaciones.
• El método Query puede devolver grandes volúmenes de datos.
• El método Load es más eficiente para consultas puntuales.
• El método Delete tiene restricciones operativas según uso del artículo.

Consideraciones de integración

• Persistir artículos en base local para reducir consumo de API.
• Utilizar sincronización incremental mediante fechas.
• Evitar consultas completas frecuentes sin filtros.
• Validar dependencias antes de eliminar artículos.