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.