Skip to main content
GET
/
api
/
proveedores
Listar Proveedores
curl --request GET \
  --url https://api.example.com/api/proveedores
{
  "500": {},
  "success": true,
  "data": [
    {
      "proveedor_id": 123,
      "ruc": "<string>",
      "razon_social": "<string>",
      "direccion": "<string>",
      "telefono": "<string>",
      "email": "<string>",
      "departamento": "<string>",
      "provincia": "<string>",
      "distrito": "<string>",
      "ubigeo": "<string>",
      "id_empresa": 123,
      "estado": 123,
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ]
}

​
Autenticación

Este endpoint requiere autenticación mediante token Bearer y el permiso proveedores.view.

​
Parámetros de Query

​
busqueda
string
Término de búsqueda para filtrar proveedores por RUC, razón social, teléfono o email

​
Respuesta

​
success
boolean
Indica si la operación fue exitosa
​
data
array
Lista de proveedores activos ordenados alfabéticamente por razón social

​
Ejemplo de Respuesta

{
  "success": true,
  "data": [
    {
      "proveedor_id": 1,
      "ruc": "20123456789",
      "razon_social": "DISTRIBUIDORA LIMA S.A.C.",
      "direccion": "Av. Industrial 890",
      "telefono": "01-2345678",
      "email": "[email protected]",
      "departamento": "Lima",
      "provincia": "Lima",
      "distrito": "Ate",
      "ubigeo": "150103",
      "id_empresa": 1,
      "estado": 1,
      "created_at": "2024-01-10T08:00:00.000000Z",
      "updated_at": "2024-01-10T08:00:00.000000Z"
    },
    {
      "proveedor_id": 2,
      "ruc": "20987654321",
      "razon_social": "IMPORTACIONES PERU E.I.R.L.",
      "direccion": "Jr. Los Olivos 456",
      "telefono": "01-8765432",
      "email": "[email protected]",
      "departamento": "Lima",
      "provincia": "Lima",
      "distrito": "San Borja",
      "ubigeo": "150130",
      "id_empresa": 1,
      "estado": 1,
      "created_at": "2024-02-05T10:30:00.000000Z",
      "updated_at": "2024-02-05T10:30:00.000000Z"
    }
  ]
}

​
Búsqueda

El parámetro busqueda utiliza el scope buscar() del modelo Proveedor que realiza búsqueda parcial en:
  • RUC
  • Razón social
  • Teléfono
  • Email
Ejemplo de búsqueda: 
GET /api/proveedores?busqueda=DISTRIBUIDORA
GET /api/proveedores?busqueda=20123456
GET /api/proveedores?busqueda=ventas@

​
Filtrado Automático

  • Solo retorna proveedores con estado = 1 (activos)
  • Filtra automáticamente por la empresa del usuario autenticado (id_empresa)
  • Los resultados se ordenan alfabéticamente por razon_social ascendente

​
Endpoints Relacionados

  • GET /api/proveedores/{id} - Ver detalles de un proveedor específico
  • GET /api/proveedores/{id}/detalles - Ver estadísticas y compras del proveedor
  • POST /api/proveedores - Crear nuevo proveedor
  • PUT /api/proveedores/{id} - Actualizar proveedor
  • DELETE /api/proveedores/{id} - Eliminar proveedor (soft delete)

​
Códigos de Error

​
500
object
Error interno del servidor
{
  "success": false,
  "message": "Error al obtener proveedores: [mensaje específico]"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us