Documentation API Fournisseur

1. URL de l'endpoint API

POST https://solarity-france.com/api/receiveSupplierOrder

2. Méthode d'authentification

Type: Bearer Token

Ajoutez votre clé API dans le header Authorization

Header requis:

Authorization: Bearer VOTRE_CLE_API

3. Headers HTTP requis

Content-Type: application/json

Authorization: Bearer VOTRE_CLE_API

4. Format du payload JSON

Champs obligatoires:

customer_email (string) - Email du client
items (array) - Au moins 1 article
Pour chaque item: provider_product_id, quantity, unit_price

Champs optionnels:

order_reference (string) - Référence de votre commande
delivery_address (string) - Adresse de livraison
notes (string) - Notes ou instructions

Exemple de payload:

{
  "order_reference": "CMD-2026-001",
  "customer_email": "client@example.com",
  "items": [
    {
      "provider_product_id": "REF_PROD_123",
      "quantity": 2,
      "unit_price": 599
    },
    {
      "provider_product_id": "REF_PROD_456",
      "quantity": 1,
      "unit_price": 899
    }
  ],
  "delivery_address": "123 Rue Example, 75001 Paris, France",
  "notes": "Livraison express demandée"
}

5. Réponses API

✅ Succès (201):

{
  "success": true,
  "order_id": "abc123...",
  "order_number": "CMD-1234567890-XYZ",
  "message": "Commande créée avec succès"
}

❌ Erreur (400/401/500):

{
  "error": "Payload invalide",
  "message": "customer_email et items (array) sont requis"
}

6. Exemple d'appel (cURL)

curl -X POST https://solarity-france.com/api/receiveSupplierOrder \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -d '{
  "order_reference": "CMD-2026-001",
  "customer_email": "client@example.com",
  "items": [
    {
      "provider_product_id": "REF_PROD_123",
      "quantity": 2,
      "unit_price": 599
    },
    {
      "provider_product_id": "REF_PROD_456",
      "quantity": 1,
      "unit_price": 899
    }
  ],
  "delivery_address": "123 Rue Example, 75001 Paris, France",
  "notes": "Livraison express demandée"
}'

💡 Note importante: Demandez votre clé API unique à l'administrateur. Elle sera stockée de manière sécurisée et nécessaire pour chaque appel.