Modify a sale recorded in the software

You can modify an order as long as it has not been validated.

Once validated, it is only possible to record the payment(s) for the order via the "payment" field.

Additional information

Create a new customer in the same query

If the customer does not exist, you can create it with the following fields (to be sent directly by 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]

Delivery method

The deliveryMethod field can have values ranging from 0 to 6:

itemsList[] — Structure

The itemsList field is an array of strings, each element of which can be of one of the following types::

• [idArticle] — add an item (quantity 1)
• [idArticle]_[quantite] — specify the quantity
• [idArticle]_[quantite]_[titre personnalisé]_[prix personnalisé] — force the title and price
• [idArticle]_[quantite]_[titre]_[prix]_[idDéclinaison1]_[idDéclinaison2]_[idDéclinaison3]_[idDéclinaison4]_[idDéclinaison5] — add up to 5 variations
• Over-the-counter sale : -[idRayon]_[prix]_[titre] — creates a free line attached to the ray
• Over-the-counter sale : Free_[prix]_[titre] — creates a free line

JavaScript Examples

Add items to an unvalidated order, and validate the order

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);}

Assign a client to an existing unvalidated order

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);}

Record a payment for the order

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);}

Expected JSON response

Order confirmed, but not paid.

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

Order not validated, not paid

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

Order confirmed and paid for.

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

Failure

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