Saltar al contenido
Facturador

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:

  • limit má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.