Suppliers API

Endpoints pour accéder à la liste et aux détails de vos fournisseurs.

Lister les fournisseurs

GET /v1/public-api/suppliers

Scope requis: read:suppliers

Paramètres de requête

Exemple de requête

curl -X GET "https://api.nerpsuite.com/v1/public-api/suppliers?search=techno" \
  -H "X-API-Key: sk_live_xxx"

Réponse

{
  "data": [
    {
      "id": "sup_001",
      "name": "TechnoDistrib SARL",
      "email": "contact@technodistrib.com",
      "phone": "+229 97 12 34 56",
      "address": "Zone Industrielle, Cotonou",
      "createdAt": "2024-01-05T09:00:00Z"
    },
    {
      "id": "sup_002",
      "name": "TechnoImport",
      "email": "info@technoimport.com",
      "phone": "+229 96 78 90 12",
      "address": null,
      "createdAt": "2024-02-20T14:00:00Z"
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}

---

Obtenir un fournisseur

GET /v1/public-api/suppliers/:id

Scope requis: read:suppliers

Paramètres de chemin

Exemple de requête

curl -X GET "https://api.nerpsuite.com/v1/public-api/suppliers/sup_001" \
  -H "X-API-Key: sk_live_xxx"

Réponse

{
  "id": "sup_001",
  "name": "TechnoDistrib SARL",
  "email": "contact@technodistrib.com",
  "phone": "+229 97 12 34 56",
  "address": "Zone Industrielle, Cotonou",
  "createdAt": "2024-01-05T09:00:00Z"
}

Champs de réponse

Cas d'usage

Analyse des fournisseurs avec Power BI

Combinez les fournisseurs avec les commandes fournisseurs pour analyser vos coûts d'approvisionnement :

async function getSuppliersWithOrders() {
  const [suppliers, orders] = await Promise.all([
    fetch('/v1/public-api/suppliers', {
      headers: { 'X-API-Key': apiKey }
    }).then(r => r.json()),
    fetch('/v1/public-api/supplier-orders', {
      headers: { 'X-API-Key': apiKey }
    }).then(r => r.json())
  ]);

  // Joindre les données pour Power BI
  return suppliers.data.map(s => ({
    ...s,
    totalOrders: orders.data.filter(o => o.supplierId === s.id).length
  }));
}