Saltar al contenido
Facturador

Buscar proveedores

GET /api/purchases/search-suppliers

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Busca proveedores por número o nombre. Con document_type_id = 01 (factura) solo devuelve proveedores con RUC.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado sin envoltura: devuelve directamente el objeto o arreglo (sin success). Arreglo sin envoltura ni límite.

Reglas:

  • La coincidencia por número se combina con OR: puede devolver personas que no son proveedores si su número coincide. Prefiere Proveedores (scroll).

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
input query sí 20456789123 Número o nombre (coincidencia parcial).
document_type_id query no 01 Tipo de comprobante de la compra: 01 solo RUC; otro valor admite DNI, CE, RUC, pasaporte y sin documento.

Respuestas

200 — Proveedores

[
  {
    "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
  }
]

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.