Crear artículo

POST /api/common/ventas/articulos V4

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
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"
  }
}