API Reference
Panier
Gestion du panier, ajout d'articles, calcul des frais de port.
Les endpoints panier sont sous /api/v1/cart. Le panier est depot-specifique — changer de depot cree un nouveau panier.
Endpoints
| Methode | Path | Description |
|---|---|---|
| GET | /cart | Contenu du panier actuel |
| POST | /cart/items | Ajouter un article |
| POST | /cart/items/configured | Ajouter un produit configure (couleur/longueur) |
| POST | /cart/items/linked | Ajouter des articles lies |
| PATCH | /cart/items/{id} | Modifier quantite ou commentaire |
| DELETE | /cart/items/{id} | Supprimer un article |
| DELETE | /cart | Vider le panier |
| GET | /cart/shipping-quote | Calcul frais de port (depot-based) |
| POST | /cart/zone-shipping-quote | Calcul frais de port (zone-based) |
| GET | /cart/shipping-options | Options de livraison disponibles |
| GET | /cart/delivery-estimate | Estimation de la date de livraison |
Ajouter un article
POST /api/v1/cart/items
Content-Type: application/json
{
"product_code": "C12008129",
"quantity": 5,
"comment": "Lot pour chantier A"
}Si le produit a des articles lies obligatoires, ils sont ajoutes automatiquement.
Panier et depot
Le panier est lie au depot selectionne par l'utilisateur (User.selected_deposit_id). Quand le client change de depot :
- Le panier actuel est conserve (mais invisible)
- Un nouveau panier est cree pour le nouveau depot
- Les prix et stocks sont recalcules pour le nouveau depot
Calcul du shipping
POST /api/v1/cart/zone-shipping-quote
Content-Type: application/json
{
"department_code": "14"
}Renvoie les frais de port, le seuil franco et le montant restant pour atteindre la livraison gratuite.