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

Parámetro	Descripción
CodigoDesde	T(20)	Código inicial.
CodigoHasta	T(20)	Código final.
NombreContiene	T(20)	Filtro por nombre.
CodigoOrigen	T(20)	Código externo.
CodigoBarras	T(30)	Código de barras.
ArticulosActivo	T(1)	S/N.
CategoriaCodigo	T(3)	Categoría.
FamiliaCodigoDesde	T(10)	Familia desde.
FamiliaCodigoHasta	T(10)	Familia hasta.
MarcaCodigo	T(3)	Marca.
ProveedorCodigo	T(10)	Proveedor.
ConceptoCodigo	T(10)	Concepto.
IVACodigo	N(2)	IVA.
UnidadPrincipalCodigo	T(3)	Unidad.
MonedaCodigo	N(2)	Moneda.
FechaRegistroDesde	AAAA-MM-DD	Fecha inicial.
FechaRegistroHasta	AAAA-MM-DD	Fecha final.
Page	N(2)	Paginación (500 registros).

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.

Campo	Descripción
Código	Código del artículo
Nombre	Nombre del artículo
Abreviacion	Abreviación
ArticulosActivo	"S" o "N"
IVACodigo	Código de IVA válido. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
ContabilizarStock	"S" o "N"
TrabajaDobleCantidad	"S" o "N"
IncluirListaPrecios	"S" o "N"
Lotes	"S" o "N"
Vencimiento	"S" o "N"

 

Datos opcionales

Campo	Descripción
CodigoOrigen	Código utilizado por el sistema de origen
CodigoBarras	Código de barras
CategoriaCodigo	Código de categoría. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
FamiliaCodigo	Código de familia. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
MarcaCodigo	Código de marca. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
ProveedorCodigo	Código del proveedor. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
ConceptoCodigo	Código del concepto asociado. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
PercepcionCodigo	Código de percepción. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
CodigoContableCompras	Cuenta contable para compras. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
CodigoContableVentas	Cuenta contable para ventas. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
CodigoContableProduccion	Cuenta contable para producción. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
UnidadPrincipalCodigo	Código de la unidad principal. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
UnidadSecundariaCodigo	Código de la unidad secundaria. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
CantidadPorUnidad	Equivalencia entre las unidades
CostoFecha	Fecha correspondiente al costo
MonedaCodigo	Código de moneda del costo. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
Costo	Costo del artículo
PorcentajeUtilidadSobreCosto	Porcentaje de utilidad sobre el costo
TextoPredefinidoCodigo	Código de texto predefinido. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.
Web	Dirección web o información relacionada
Notas	Observaciones del artículo

 

{
"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.