Obtener la lista de proveedores

Maxim

Maxim

Última actualización el Oct 8, 2026

Devuelve los proveedores de la empresa, ordenados por nombre. Los proveedores eliminados no se incluyen.

v1/suppliers/get_list.php

Parámetros

Campo Tipo Obligatorio Descripción
limit int No Tamaño de página, de 1 a 1000
offset int No Cuántos registros omitir

Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales.

Respuesta

Un array suppliers con los campos del proveedor. El campo total contiene el número total de proveedores.

Campo Tipo Descripción
id int ID del proveedor
name string Nombre
email string Correo electrónico
phone string Teléfono
address string Dirección
agreement string Acuerdo
manager_name string Responsable
manager_post string Puesto del responsable
notes string Notas

Ejemplo de solicitud

{
    "limit": 100,
    "offset": 0
}

Ejemplo de respuesta

{
    "success": true,
    "suppliers": [
        {
            "id": 46,
            "name": "Suministros Herrajes",
            "email": "hardware@example.com",
            "phone": "+34 931 000 170",
            "address": "C/ Paz 14, Sevilla",
            "agreement": "",
            "manager_name": "",
            "manager_post": "",
            "notes": ""
        },
        {
            "id": 45,
            "name": "Maderas García",
            "email": "mayoreo@maderasgarcia.com",
            "phone": "+34 915 000 222",
            "address": "C/ del Puerto 8, Barcelona",
            "agreement": "N.º 7 del 15/02/2026",
            "manager_name": "Óscar Ruiz",
            "manager_post": "Director",
            "notes": "Entregas los martes"
        }
    ],
    "total": 2
}

Errores

Error Motivo
Invalid limit value. Must be between 1 and 1000 limit no válido
Invalid offset value. Must be 0 or greater offset no válido
Offset requires limit se envió offset sin limit