Proveedores

Listar proveedores

GET /api/v1/catalog/suppliers

Parámetros:

Nombre	Tipo	Descripción
cursor	string	Cursor de paginación
limit	int	Items por página (default 25)

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "name": "Proveedor ABC",
      "code": "PROV-001",
      "email": "[email protected]",
      "phone": "+51 999 888 777",
      "address": { "street": "Av. Principal 123", "city": "Lima", "country": "PE" },
      "metadata": {},
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z"
    }
  ],
  "meta": { "pagination": { "cursor": "eyJ...", "has_next": true, "total": 10 } }
}

---

Crear proveedor

POST /api/v1/catalog/suppliers

{
  "name": "Proveedor ABC",
  "code": "PROV-001",
  "email": "[email protected]",
  "phone": "+51 999 888 777"
}

Campo	Requerido	Descripción
name	Sí	Nombre del proveedor
code	No	Código interno
email	No	Email de contacto
phone	No	Teléfono

Respuesta 201: objeto Supplier completo.

---

Obtener proveedor

GET /api/v1/catalog/suppliers/:id

---

Actualizar proveedor

PATCH /api/v1/catalog/suppliers/:id

Todos los campos opcionales. Omite los que no quieras cambiar.

{
  "name": "Proveedor ABC S.A.",
  "email": "[email protected]",
  "address": { "street": "Av. Nueva 456", "city": "Lima" },
  "metadata": { "category": "textiles" }
}

---

Eliminar proveedor

DELETE /api/v1/catalog/suppliers/:id

Respuesta 204 No Content