Modifier une vente enregistrée dans le logiciel

Vous pouvez modifier une commande tant qu'elle n'est pas validée.

Une fois validée, il est uniquement possible d'enregistrer le ou les paiements de la commande via le champ "payment".

Informations complémentaires

Créer un nouveau client dans la même requête

Si le client n'existe pas, vous pouvez le créer avec les champs suivants (à envoyer directement en POST) :

client[nom]=[nom]client[prenom]=[Prénom]client[email]=[Email]client[telephone]=[nom]client[adresseligne1]=[Adresse ligne 1]client[adresseligne2]=[Adresse ligne 2]client[commentaireadresse]=[nom]client[codepostal]=[Code postal]client[ville]=[Ville]client[pays]=FRclient[numtva]=[Numéro TVA]client[rcs]=[Numéro RC]client[codeBarre]=[Code barre]client[telephone2]=[Téléphone secondaire]client[lat]=[latitude]client[lng]=[longitude]

Méthode de livraison

Le champ deliveryMethod peut avoir des valeurs allant de 0 à 6 :

itemsList[] — Structure

Le champ itemsList est un tableau de chaines de caractères, chaque élément pouvant être de l'un des types suivants:

• [idArticle] — ajoute un article (quantité 1)
• [idArticle]_[quantite] — préciser la quantité
• [idArticle]_[quantite]_[titre personnalisé]_[prix personnalisé] — forcer le titre et le prix
• [idArticle]_[quantite]_[titre]_[prix]_[idDéclinaison1]_[idDéclinaison2]_[idDéclinaison3]_[idDéclinaison4]_[idDéclinaison5] — ajouter jusqu'à 5 déclinaisons
• Vente libre en rayon : -[idRayon]_[prix]_[titre] — crée une ligne libre rattachée au rayon
• Vente libre : Free_[prix]_[titre] — crée une ligne libre

Exemples JavaScript

Ajouter des articles à une commande existante non validée

async function recordSaleWithExistingClient(){ const body = new URLSearchParams({  shopID: SHOPID,  key: APIKEY,  orderID: 123456,  payment: -1 }); body.append("itemsList[]", "Free_12.99_Item"); body.append("itemsList[]", "Free_9.99_Other item"); const res = await fetch("https://kash.click/workers/editOrder.php", {  method: "POST",  headers: { "Content-Type": "application/x-www-form-urlencoded" },  body }); let payload; try{ payload = await res.json(); }catch{ payload = await res.text(); } console.log(payload);}

Associer un client à une commande existante non validée

async function recordSaleWithExistingClient(){ const body = new URLSearchParams({  shopID: SHOPID,  key: APIKEY,  payment: -2,  orderID: 123456,  idClient: 123 }); const res = await fetch("https://kash.click/workers/editOrder.php", {  method: "POST",  headers: { "Content-Type": "application/x-www-form-urlencoded" },  body }); let payload; try{ payload = await res.json(); }catch{ payload = await res.text(); } console.log(payload);}

Enregistrer un paiement pour une commande

async function recordSaleWithNewClient(){ const body = new URLSearchParams({  shopID: SHOPID,  key: APIKEY,  orderID: 123456,  payment: 123456 }); const res = await fetch("https://kash.click/workers/editOrder.php", {  method: "POST",  headers: { "Content-Type": "application/x-www-form-urlencoded" },  body }); let payload; try{ payload = await res.json(); }catch{ payload = await res.text(); } console.log(payload);}

Réponse JSON attendue

Commande validée, non payée

{ "success": true, "orderID":17724460, "paymentLink":"A link the client can use to pay the order", "invoice":"URL of the PDF invoice"}

Commande non validée, non payée

{ "success": true, "orderID":17724461, "paymentLink":"A link the client can use to pay the order", "quote":"URL of the PDF qduote"}

Commande validée, payée

{ "success": true, "orderID":17724461, "invoice":"URL of the PDF qduote"}

Echec

{ "success": false, "result": "Error message"}