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.tandem.com/api/common/compras/proveedores?page=1&pageSize=5" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Proveedores encontrados",
  "result": {
    "data": [
      {
        "codigoProveedor": "000001",
        "razonSocial": "DEMO TANDEN INTERCOPANY",
        "cifDni": "12345678Z"
      },
      {
        "codigoProveedor": "000002",
        "razonSocial": "PROVEEDOR DEMO",
        "cifDni": "B0000000"
      },
      {
        "codigoProveedor": "000003",
        "razonSocial": "proveedor divisa",
        "cifDni": "A121313"
      },
      {
        "codigoProveedor": "000004",
        "razonSocial": "AMAZON SPAIN",
        "cifDni": "B84170926"
      },
      {
        "codigoProveedor": "000005",
        "razonSocial": "PROVEEDOR RETENCION DE OBRA",
        "cifDni": "000005"
      }
    ],
    "totalRecords": 23,
    "totalPages": 5,
    "currentPage": 1,
    "pageSize": 5
  }
}