Obtener proveedores

GET /api/common/compras/proveedores?page={page}&pageSize={pageSize} V4

Descripción

Endpoint para obtener un listado completo de proveedores registrados en el sistema.

Incluye como campos base “codigoProveedor”, “razonSocial” y “cifDni”. Si se especifica el parámetro “campos”, se añadirán los campos que se indiquen a los campos base.

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	❌	Campos que se quieren añadir a los campos base
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Ejemplo con filtros

# Obtener proveedores
curl -X GET "https://api.tandemsm.dev:8050/api/common/compras/proveedores/buscar?page=1&pageSize=10&nombre=prueba" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Proveedores encontrados",
  "result": {
    "data": [
      {
        "codigoCliente": null,
        "razonSocial": "CLIENTE PRUEBAS",
        "cifDni": "43000002F"
      },
      {
        "codigoCliente": null,
        "razonSocial": "proveedor prueba",
        "cifDni": "A4152633"
      },
      {
        "codigoCliente": null,
        "razonSocial": "Proveedor Prueba S.A.",
        "cifDni": "S1234567"
      },
      {
        "codigoCliente": null,
        "razonSocial": "PRUEBA PROVEEDOR MARIA",
        "cifDni": "12312312K"
      }
    ],
    "totalRecords": 4,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}