Artículos por cliente

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

Descripción

Devuelve una lista paginada de las referencias de artículos por cliente. Si se especifica el parámetro opcional campos (lista de campos separados por comas), se devuelven únicamente esos campos. Si no se especifica, se devuelven todos los campos. Los parámetros page y pageSize son obligatorios para controlar la paginación.

Permite además filtrar por cualquier columna mediante columnaBusqueda, valorBusqueda y tipoBusqueda.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`page`	int	✅	Número de página
`pageSize`	int	✅	Cantidad de elementos por página
`campos`	string	❌	Lista de campos separados por comas
`columnaBusqueda`	string	❌	Campo sobre el que realizar la búsqueda
`valorBusqueda`	string	❌	Valor a buscar
`tipoBusqueda`	enum	❌	Tipo de búsqueda. Por defecto `Parcial`
`codigoEmpresa`	int	✅ (si es multiempresa)	Código de la empresa

Ejemplo con filtros

curl -X GET "https://api.tandem.com/api/common/ventas/articulos/articulocliente?page=1&pageSize=10&columnaBusqueda=codigoCliente&valorBusqueda=0000002&tipoBusqueda=Completa&codigoEmpresa=9999" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Artículos de cliente encontrados",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "codigoArticulo": "Z1016",
        "codigoCliente": "0000002",
        "comentario": "",
        "codigodelCliente": "REF-Z1016",
        "automatico": 0,
        "fechaInicio": null,
        "fechaFin": null,
        "enEuros_": -1,
        "codigoDivisa": "",
        "precioOferta": 12.5,
        "%Descuento": 0,
        "%Descuento2": 0,
        "%Descuento3": 0,
        "ejercicioUltimoPedido": 2026,
        "serieUltimoPedido": "",
        "numeroUltimoPedido": 125,
        "fechaUltimoPedido": "2026-09-20T00:00:00",
        "unidadesUltimoPedido": 10,
        "precioUltimoPedido": 12.5,
        "ejercicioUltimoAlbaran": 2026,
        "serieUltimoAlbaran": "",
        "numeroUltimoAlbaran": 340,
        "fechaUltimoAlbaran": "2026-09-22T00:00:00",
        "unidadesUltimoAlbaran": 10,
        "precioUltimoAlbaran": 12.5,
        "formula": 0,
        "idArticuloCliente": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}