Crear artículo

POST /api/common/ventas/articulos V4

✨ Actualizado recientemente

El código de artículo y el tipo ahora se pueden pasar como parámetros para mayor comodidad. Sin embargo, se sigue mantieniendo la opción de enviarlos en el cuerpo de la petición para compatibilidad con versiones anteriores.

Descripción

Endpoint para crear un artículo nuevo en el sistema. Se debe incluir como parámetros los datos mínimos obligatorios del artículo. Se puede incluir como campos adicionales los datos no obligatorios del artículo.

Parámetros de entrada

Parámetro	Tipo	Requerido	Descripción
codigoArticulo	string	✅	Codigo del artículo
tipoArticulo	enum	✅	Tipo de artículo (Material, Inmaterial, Comentario)
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Campos obligatorios *

Campo	Tipo	Requerido	Descripción
codigoArticulo	string	✅	Codigo del artículo
descripcionArticulo	string	✅	Descripcion del artículo
tipoArticulo	string	✅	Tipo del artículo (M, I, C)
...		❌	Resto de campos

Note

Los tipos de artículos pueden ser:

M = Material

I = Inmaterial

C = Comentario

Note

Si el cliente tiene atributos personalizados que no están por defecto en la tabla de Sage, puede incluirlos en el apartado camposAdicionales.

"camposAdicionales": {
  "additionalProp1": "valor1",
  "additionalProp2": "valor2",
  "additionalProp3": "valor3"
}

Sólo hay que modificiar ‘additionalPropX’ por el nombre del campo personalizado y ‘valorX’ por el valor que se quiera asignar.

Ejemplo con filtros

# Crear artículo
curl -X POST "https://api.tandem.com/api/common/ventas/articulos" \
  -H "Authorization: Bearer tu_access_token"
  -H "Content-Type: application/json"
  -d '{
    "codigoArticulo": "ART-001",
    "descripcionArticulo": "Artículo de prueba",
    ...
  }'

Cuerpo de la petición

{
  "codigoArticulo": "string",
  "descripcionArticulo": "string",
  "descripcion2Articulo": "string",
  "tipoArticulo": "M|I|C",
  "codigoAlternativo": "string",
  "codigoArancelario": "string",
  "codigoProveedor": "string",
  "referenciaEdi_": "string",
  "unidadMedida2_": "string",
  "unidadMedidaAlternativa_": "string",
  "factorConversion_": 0,
  "codigoFamilia": "string",
  "codigoSubfamilia": "string",
  "codigoDefinicion_": "string",
  "tratamientoPartidas": 0,
  "colores_": 0,
  "grupoTalla_": 0,
  "ivaIncluido": 0,
  "stockMinimo": 0,
  "stockMaximo": 0,
  "puntoPedido": 0,
  "lotePedido": 0,
  "grupoIva": 0,
  "grupoIvaCompras": 0,
  "precioCompra": 0,
  "precioVenta": 0,
  "margen": 0,
  "precioVentaconIVA1": 0,
  "precioVentaconIVA2": 0,
  "precioVentaconIVA3": 0,
  "precioVentasinIVA1": 0,
  "precioVentasinIVA2": 0,
  "precioVentasinIVA3": 0,
  "descuento": 0,
  "descuento2": 0,
  "descuento3": 0,
  "descuentoCompras": 0,
  "descuentoCompras2": 0,
  "descuentoCompras3": 0,
  "codigoComisionista": 0,
  "comision": 0,
  "pesoBrutoUnitario_": 0,
  "pesoNetoUnitario_": 0,
  "volumenUnitario_": 0,
  "formula": 0,
  "loteFabricacion": 0,
  "nivelCompuesto": 0,
  "trataNumerosSerieLc": 0,
  "sonHorasLc": 0,
  "obsoletoLc": 0,
  "unidadMedidaCompras_": "string",
  "unidadMedidaVentas_": "string",
  "unidadMedidaFabricacion_": "string",
  "unidadMedidaSerie": "string",
  "medida": "string",
  "tipoArticuloPresupuesto": "string",
  "tipoCodificado": 0,
  "codigoPeriodicidadPrecio": "string",
  "partirPeriodos": 0,
  "codigoContaje": "string",
  "precioPorTramos": 0,
  "codigoNacionOrigen": 0,
  "codigoGrupoColores_": "string",
  "pathImagen": "string",
  "idProcesoIME": "guid",
  "movIdentificadorIME": "string",
  "statusTraspasadoIME": 0,
  "tipoImportacionIME": 0,
  "idArticulo": "guid",
  "marcaProducto": "string",
  "publicarInternet": 0,
  "codigoProyecto": "string",
  "codigoDepartamento": "string",
  "codigoSeccion": "string",
  "lote_": 0,
  "temporada": "string",
  "camposAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}