Module Boutique (Store)

Le module Store permet de gérer toutes les fonctionnalités e-commerce de votre application : produits, commandes, vendeurs, promotions, et plus encore.

Accès : client.app.store

Sous-modules

• Produits : Gestion du catalogue produits avec variantes et images.
• Catégories : Organisation hiérarchique des produits.
• Collections : Groupements de produits (manuels ou automatiques).
• Vendeurs : Gestion multi-vendeurs.
• Commandes : Suivi et gestion des commandes clients.
• Promotions : Codes promo et réductions.
• Options : Attributs de produits (taille, couleur, etc.).
• Badges : Labels et badges produits.
• Tags : Étiquettes pour organiser les produits.
• Taxes : Configuration fiscale par région.
• Livraison : Profils et zones de livraison.

Exemple d’utilisation

import { AppliteUI } from '@applite/js-sdk';
 
const client = new AppliteUI({ baseUrl: 'https://api.applite.com' });
 
// Lister les produits
const products = await client.app.store.product.list({
  appId: "app_id",
  apiKey: "user_api_key",
  page: 1,
  limit: 20
});
 
// Créer une commande
const order = await client.app.store.order.create({
  appId: "app_id",
  apiKey: "user_api_key",
  customerId: "customer_id",
  sellerId: "seller_id",
  items: [
    { variantId: "variant_id", productId: "product_id", quantity: 2 }
  ]
});

Architecture

Le module Store suit une architecture multi-vendeurs où chaque entité (produit, catégorie, etc.) est associée à un vendeur (sellerId). Cela permet de gérer plusieurs boutiques au sein d’une même application.

Relations entre entités

Vendeur (Seller)
├── Produits (Products)
│   ├── Variantes (Variants)
│   │   └── Images
│   ├── Catégorie
│   ├── Collections
│   ├── Tags
│   └── Options (attributs)
├── Catégories (Categories)
├── Collections
├── Options
├── Badges
├── Taxes
├── Promotions (Discounts)
└── Profils de livraison (Shipping)

Commandes (Orders)
├── Client (Customer)
├── Vendeur
└── Articles (CartItems)
    └── Variantes

Authentification

Toutes les requêtes nécessitent deux paramètres :

• appId : L’identifiant de votre application
• apiKey : La clé API de l’utilisateur authentifié

Pagination

Les endpoints de liste supportent la pagination :

La réponse inclut des métadonnées :

{
  "success": true,
  "data": [...],
  "meta": {
    "total": 150,
    "page": 1,
    "limit": 20,
    "totalPages": 8
  }
}