🎯 Objectif
Cette intégration permet d'envoyer automatiquement chaque nouvelle commande de votre boutique vers le système CasaTawsil, afin d'assurer une gestion rapide, fiable et centralisée des livraisons.
🔹 Méthode de Transmission
Lorsqu'une commande est validée dans la boutique, une requête HTTP GET doit être envoyée automatiquement vers l'adresse suivante :
https://casatawsil.com/api/addorder.php
📋 Paramètres à Transmettre
Les paramètres suivants doivent être inclus dans chaque requête :
| Paramètre | Type | Description |
|---|---|---|
| tk OBLIGATOIRE | String | Clé publique (Token Key) fournie par CasaTawsil |
| sk OBLIGATOIRE | String | Clé secrète (Secret Key) fournie par CasaTawsil |
| business FACULTATIF | String | Identifiant de l'entreprise (signature) associé au compte |
| fullname OBLIGATOIRE | String | Nom complet du client |
| phone OBLIGATOIRE | String | Numéro de téléphone du client |
| whatsapp FACULTATIF | String | Numéro WhatsApp du client |
| city OBLIGATOIRE | String | Ville de livraison |
| address OBLIGATOIRE | String | Adresse complète du client |
| price OBLIGATOIRE | Number | Montant total de la commande en dirhams |
| product OBLIGATOIRE | String | Nom ou description du produit commandé |
| qty OBLIGATOIRE | Number | Quantité commandée |
| note FACULTATIF | String | Remarque ou instruction spéciale |
| change OBLIGATOIRE | Integer (0/1) | 1 = échange/remplacement, 0 = commande classique |
| openpackage OBLIGATOIRE | Integer (0/1) | 1 = client autorisé à ouvrir le colis, 0 = non |
| try OBLIGATOIRE | Integer (0/1) | 1 = client peut essayer le produit, 0 = non |
| code2 FACULTATIF | String | Code interne ou référence de commande |
| worker FACULTATIF | String | Identifiant du livreur ou employé associé |
| source OBLIGATOIRE | String | Nom de la boutique ou plateforme d'origine |
💻 Exemple Complet de Requête
https://casatawsil.com/api/addorder.php?tk=751f3951fa300206fcf423f82d67c9ff&sk=de6d7652ef93f6&business=123456789&fullname=Oumaima%20El%20Amrani&phone=0648766637&whatsapp=0648766637&city=Casablanca&address=Oulfa%20Jnane%20Louz&price=480&product=Parfum%20Massibell&qty=1¬e=Livrer%20avant%2018h&change=0&openpackage=1&try=1&code2=CMD4567&worker=14&source=MassibellShop
📡 Réponse du Serveur
✅ En cas de succès :
{ "status": "success", "message": "Commande enregistrée avec succès", "order_id": "12584" } ❌ En cas d'erreur :
{ "status": "error", "message": "Clés d'accès invalides ou paramètre manquant" } ⚙️ Comportement Attendu
- L'envoi de la requête doit se déclencher automatiquement au moment de la validation d'une commande
- Une seule configuration initiale suffit pour que toutes les commandes soient transmises automatiquement
- Les commandes reçues sont immédiatement enregistrées et traitées par le système CasaTawsil
⚠️ Remarques Importantes
Points de vigilance :
- Les clés tk et sk sont obligatoires et doivent être obtenues depuis le compte CasaTawsil
- Les champs business et worker sont facultatifs, mais également disponibles dans le compte CasaTawsil pour une meilleure identification
- Le paramètre source permet de connaître la provenance de chaque commande
- Tous les paramètres doivent être encodés en UTF-8 avant l'envoi
- Les clés d'accès doivent rester strictement confidentielles et ne doivent jamais être partagées publiquement