Skip to content
Documentación API

Buscar artículos

GET /api/common/ventas/articulos/buscararticulo?page={page}&pageSize={pageSize} V4

Descripción

Section titled “Descripción”

Endpoint para buscar artículos de forma avanzada.

Permite realizar búsquedas dinámicas indicando:

  • La columna sobre la que buscar (columnaBusqueda)
  • El valor a buscar (valorBusqueda)
  • El tipo de búsqueda (tipoBusqueda)

Además, se pueden limitar los campos devueltos mediante el parámetro campos.

Parámetros de consulta

Section titled “Parámetros de consulta”
ParámetroTipoRequeridoDescripción
pageint✅Número de página
pageSizeint✅Cantidad de elementos por página
camposstring❌Lista de campos separados por comas
columnaBusquedastring❌Campo sobre el que realizar la búsqueda
valorBusquedastring❌Valor a buscar
tipoBusquedaenum❌Puedes hacer búsquedas exactas, parciales o que no contengan ese o eso valores.
codigoEmpresaint✅ (si es multiempresa)Código de la empresa

El tipoBusqueda puede ser:

Ejemplos de uso

Section titled “Ejemplos de uso”

🔍 Búsqueda por nombre de artículo

Section titled “🔍 Búsqueda por nombre de artículo”
Terminal window
curl -X GET "https://api.tandem.com/api/common/ventas/articulos/buscararticulo?page=1&pageSize=10&columnaBusqueda=descripcion&valorBusqueda=prueba&tipoBusqueda=Parcial&codigoEmpresa=9999" \
  -H "accept: */*" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

Section titled “Respuesta exitosa (200)”
{
  "success": true,
  "message": "Artículos encontrados",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "codigoArticulo": "0000000122",
        "descripcionArticulo": "prueba",
        "descripcion2Articulo": "",
        "descripcionLinea": "",
        "comentarioArticulo": "",
        "marcaProducto": "",
        "codigoAlternativo": "8400250004056",
        "codigoAlternativo2": "00000123",
        "codigoArticuloOferta": "",
        "codigoArancelario": "",
        "codigoProveedor": "",
        "referenciaEdi_": "",
        "publicarInternet": 0,
        "tipoArticulo": "M",
        "utilizado": 0,
        "fechaAlta": "2025-07-17T00:00:00",
        "fechaInicioOferta": null,
        "fechaFinalOferta": null,
        "temporada": "",
        "tipoEnvase_": 0,
        "unidadMedida2_": "",
        "unidadMedidaAlternativa_": "",
        "factorConversion_": 1,
        "codigoFamilia": "",
        "codigoSubfamilia": "",
        "codigoDivisa": "",
        "codigoProyecto": "",
        "codigoSeccion": "",
        "codigoDepartamento": "",
        "codigoDefinicion_": "",
        "valoracionStock": 1,
        "tratamientoPartidas": 0,
        "contadorPartida": 0,
        "colores_": 0,
        "grupoTalla_": 0,
        "acumulaEstadistica_": -1,
        "generaCompraAutomatica_": 0,
        "ivaIncluido": 0,
        "bloqueoCompra": 0,
        "bloqueoPedidoCompra": 0,
        "bloqueoAlbaranVenta": 0,
        "bloqueoPedidoVenta": 0,
        "unidadesMinimasOferta": 0,
        "unidadesRegaloOferta": 0,
        "stockMinimo": 0,
        "stockMaximo": 0,
        "puntoPedido": 0,
        "lotePedido": 0,
        "grupoIva": 1,
        "grupoIvaCompras": 1,
        "precioCompra": 0,
        "precioVenta": 0,
        "%Margen": 0,
        "costeFabricacionUnitario": 0,
        "precioCosteEstandar": 0,
        "precioVentaconIVA1": 0,
        "precioVentaconIVA2": 0,
        "precioVentaconIVA3": 0,
        "precioVentasinIVA1": 0,
        "precioVentasinIVA2": 0,
        "precioVentasinIVA3": 0,
        "precioOfertaconIVA": 0,
        "precioOfertasinIVA": 0,
        "%Descuento": 0,
        "%Descuento2": 0,
        "%Descuento3": 0,
        "%DescuentoCompras": 0,
        "%DescuentoCompras2": 0,
        "%DescuentoCompras3": 0,
        "descuentoOferta": 0,
        "aplicarDescuentos": 0,
        "codigoComisionista": 0,
        "codigoComisionista2_": 0,
        "codigoComisionista3_": 0,
        "codigoComisionista4_": 0,
        "%Comision": 0,
        "%Comision2_": 0,
        "%Comision3_": 0,
        "%Comision4_": 0,
        "pesoBrutoUnitario_": 0,
        "pesoNetoUnitario_": 0,
        "volumenUnitario_": 0,
        "formulaLote": 0,
        "lote_": 0,
        "formula": 0,
        "loteFabricacion": 0,
        "nivelCompuesto": 0,
        "tipoDemanda": "0",
        "generarPlanProd": 0,
        "usarStockSeg": 0,
        "%StockSeguridad": 0,
        "demandaMediaDiaria": 0,
        "factorCrecimiento": 1,
        "periodosPromediar": 0,
        "tasaProduccionDiaria": 0,
        "tiempoMedioReposicion": 0,
        "numDecimalesUnidades": 2,
        "periodoVida": 0,
        "tipoABC": "A",
        "codigoCategoriaLc": "",
        "codigoSubcategoriaLc": "",
        "codigoClaseArticuloLc": "",
        "codigoTipoArticuloLc": "",
        "codigoSubtipoArticuloLc": "",
        "codigoGrupoArticuloLc": "",
        "codigoSubgrupoArticuloLc": "",
        "codigoModoLc": "",
        "codigoFabricanteLc": "",
        "codigoFamiliaFabricanteLc": "",
        "codigoConjuntoLc": "",
        "codigoSubconjuntoLc": "",
        "maximoSinRetencionLc": 0,
        "trataNumerosSerieLc": 0,
        "sonHorasLc": 0,
        "articuloNoCodificadoLc": 0,
        "precioCosteEditableLc": 0,
        "codigoTipoPeriodicidadPrecioLc": "",
        "liquidableLc": 0,
        "codigoTipoCoberturaLc": "",
        "obsoletoLc": 0,
        "codigoAreaCompetenciaLc": "",
        "imagenExt": "00000000-0000-0000-0000-000000000000",
        "gestionCompras": 0,
        "unidadMedidaCompras_": "",
        "unidadMedidaVentas_": "",
        "unidadMedidaFabricacion_": "",
        "codigoSerie": "",
        "unidadMedidaSerie": "",
        "factorPrecioCompra_": 1,
        "factorPrecioVenta_": 1,
        "tipoUnidadCalculo_": 0,
        "medida": "",
        "tipoArticuloPresupuesto": "",
        "tipoCodificado": 0,
        "codigoPeriodicidadPrecio": "",
        "cobrarDevolucionTardia": -1,
        "cobrarEntregaAdelantada": 0,
        "devolverDevolucionAdelantada": 0,
        "devolverEntregaTardia": 0,
        "codigoArticuloFacturacion": "",
        "precioPeriodoRetraso": 0,
        "precioUnidadPerdida": 0,
        "partirPeriodos": 0,
        "tipoArticuloAlquiler": 0,
        "noTraspasarSFA": 0,
        "codigoContaje": "",
        "precioPorTramos": 0,
        "suplido": 0,
        "codigoNacionOrigen": 0,
        "tipoCodigoBarrasSR": 0,
        "pesableSR": 0,
        "imagenTactilSR": "",
        "taraUnitaria_": 0,
        "precioModificableSR": 0,
        "noAgruparSR": 0,
        "enviaraSR": -1,
        "impresionResguardoSR": 0,
        "periodoGarantiaSR": 0,
        "novedadesWeb": 0,
        "idArticulo": "74d647cf-3ee4-4a0e-8de5-9b65cc55f788",
        "publicarGCRM": -1,
        "mesesGarantiaVenta": 24,
        "mesesGarantiaCompra": 24,
        "mesesGarantiaReparacion": 3,
        "codigoAlternativo3": "",
        "cP_CaducidadDias": 0,
        "cP_MostrarTPlant": -1,
        "cP_Nivel": 1,
        "cP_ObservacionesMaquina": "",
        "cP_PedirCorte": 0,
        "cP_TipoConsumo": 0,
        "medidaLitros": 0,
        "observacionesStock": "",
        "tS_PedirPeso": 0,
        "tS_Peso": 0,
        "ubicacion": "",
        "unidadesPorCaja": 1,
        "codigoUPC": "",
        "bultos": 0,
        "grupoArticulos": "",
        "tS_Bultos": -1,
        "tS_PedirFechaCaducidad": 0,
        "ubicacion2": "",
        "tipoPicking": "A",
        "tS_SobrepasarCantidadVentas": -1,
        "tS_PedirUnidadesCopiasCompras": 0,
        "siloAutomatico": "",
        "_ts_codigomarca": 0,
        "tS_TipoArtCompraVenta": 1,
        "tS_CodigoBarras": ""
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}