Proveedores (scroll)
GET /api/purchases/suppliers-scroll
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Proveedores con paginación por cursor, ordenados por nombre.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: listado con paginación por cursor {success, data[], pagination: {next_cursor, has_more}}.
Reglas:
limitmáximo 100 (por defecto 15).
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
input |
query | no | Número o nombre (coincidencia parcial). | |
document_type_id |
query | no | 01 |
01 solo proveedores con RUC. |
limit |
query | no | 15 |
Registros por página, de 1 a 100. Por defecto 15. |
cursor |
query | no | Valor de pagination.next_cursor de la respuesta anterior para obtener la página siguiente. |
Respuestas
200 — Página
{
"success": true,
"data": [
{
"id": 14,
"description": "20456789123 - DISTRIBUIDORA DEL SUR S.A.C.",
"name": "DISTRIBUIDORA DEL SUR S.A.C.",
"number": "20456789123",
"identity_document_type_id": "6",
"address": "JR. LOS ANDES 789, CUSCO",
"email": "ventas@distsur.pe",
"selected": false
}
],
"pagination": {
"next_cursor": null,
"has_more": false
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.