Create an account
Ancienne version maintenue pour les applications existantes. Pour une nouvelle intégration, utilisez la création avec identité et courriel confirmé. Documentation actuelle
It is possible to create an account programmatically, by providing an email address and the account name.
Cette API conserve son URL, ses paramètres et la réponse immédiate APIKEY / SHOPID pour les intégrations existantes. Dans l’interface, la création passe par Connexion, avec confirmation du courriel et rattachement à l’identité. Une création par API ne confirme pas le courriel et ne rattache pas automatiquement le compte à une identité.
Attention: you will need to validate your email via the link that will be automatically sent to you, otherwise your account may be deleted after a certain period of inactivity.
1) Create an account
Two methods:
- From the interface : On the Registration page
- By POST request :
https://kash.click/workers/addShop.php
1.1 POST /workers/addShop.php
POST parameters
| Nome | Necessário | Descrição |
|---|---|---|
email | sim | Account email address |
accountTitle | sim | Account title (name of the institution) |
configType | Não | Default dataset ('Bar', 'Ticket-Office', 'Butchery-Delicatessen', 'Bakery', 'Brewery', 'Tobacconist', 'Cafe', 'Camping', 'Liquor-Shop', 'CBD', 'Coffee-shop', 'Coiffeur', 'Shops', 'Street-trade', 'Grocery-store', 'Florist', 'Food-truck', 'Cheese-shop', 'Beauty-institute', 'Library', 'Clothing-store', 'Market', 'Pharmacy', 'Pizzeria', 'Fish-shop', 'For-association', 'Dry-cleaning', 'Restaurant', 'Fast-food', 'Supermarket', 'Perfumery', 'Services', 'Ecommerce', 'Solana', 'ChatGPT', 'Claude', 'Prestashop', 'VivaWallet', 'SumUp', 'GoCardless', 'Sunmi', 'Yavin', 'Pennylane') |
data[companyRegistrationNum] | Não | Company registration number (RCS) |
data[taxRegistrationNum] | Não | Número de IVA |
data[adressline1] | Não | Address line 1 |
data[postCode] | Não | Código Postal |
data[city] | Não | Cidade |
data[country] | Não | Country |
data[lat] | Não | lat |
data[lng] | Não | lng |
data[phone] | Não | Telefone |
data[urlwebsite] | Não | URL of your website (external) |
data[defaultAccountingChapter] | Não | Default accounting chapter |
data[pdffooter] | Não | Footer text for PDF invoices |
data[paymentDueDays] | Não | Délai de paiement en jours (0 = comptant) |
data[recoveryFeeAmount] | Não | Montant de l’indemnité pour frais de recouvrement (0 = aucune) |
data[recoveryFeeCurrency] | Não | Devise de l’indemnité (code à 3 lettres) |
data[latePenaltyMode] | Não | Pénalités de retard : ecb_plus_10, fr_legal_x3 ou custom |
data[latePenaltyRate] | Não | Taux annuel personnalisé des pénalités (%) |
data[earlyPaymentDiscountRate] | Não | Taux d’escompte pour paiement anticipé (%) (0 = aucun) |
data[earlyPaymentDiscountDays] | Não | Délai d’escompte en jours (0 = à l’émission de la facture) |
data[receiptHeader] | Não | Ticket header |
data[receiptFooter] | Não | Ticket footer |
data[defaultVatID] | Não | Default VAT rate identifier |
data[currency] | Não | Moeda |
data[language] | Não | Language |
data[pricesAreProvidedTaxIncluded] | Não | 0 = Prices are entered excluding VAT; 1 = Prices are entered including VAT |
data[paypalAddress] | Não | Your PayPal email address (for collecting payments) |
data[deliv_tablePlan] | Não | Table management |
data[deliv_takeAway] | Não | Takeaway |
data[deliv_drivethru] | Não | Drive thru |
data[deliv_deliver] | Não | Delivery management |
data[deliv_bar] | Não | Counter sales |
data[deliv_relayDeposit] | Não | Delivery to a collection point |
data[deliv_default] | Não | Default delivery method |
data[receipt_showVat] | Não | Display VAT on tickets |
data[receipt_showShopName] | Não | Display the shop name on the tickets |
data[receipt_showCashbox] | Não | Display the cashier's name on the receipts |
data[receipt_showSeller] | Não | Display the seller's name on the tickets |
data[receipt_showClient] | Não | Display the customer's name on the tickets |
data[receipt_showAddress] | Não | Display the store's contact details on the tickets |
data[receipt_showCompanyRegistrationNum] | Não | Display the store's company number on the receipts |
data[receipt_showClientSurname] | Não | Display the customer's first name on the tickets |
data[receipt_showClientAddress] | Não | Display the customer's address on the tickets |
data[receipt_showClientPhone] | Não | Display the customer's phone number on the tickets |
data[receipt_showGlobalVat] | Não | Display the general VAT on the tickets |
data[receipt_showComment] | Não | Show ticket comments |
data[receipt_showPricesBeforeTaxes] | Não | Display prices excluding VAT on tickets |
data[orderRequires_deliveryChoice] | Não | Choosing a delivery method is mandatory for each order. |
data[orderRequires_name] | Não | The customer's name is required for each order. |
data[orderRequires_surname] | Não | The customer's first name is required for each order. |
data[orderRequires_address] | Não | The customer's address is required for each order. |
data[orderRequires_email] | Não | Customer email address is required for each order |
data[orderRequires_phone] | Não | Customer phone number is required for each order |
data[orderRequires_date] | Não | Choosing a date is mandatory for each order. |
data[orderRequires_CompanyRegistrationNum] | Não | The customer's company number is required for each order. |
data[orderRequires_comment] | Não | Comment required for each order |
data[enable_stock] | Não | Activate inventory management |
data[enable_barcodes] | Não | Enable barcode handling |
data[enable_departments] | Não | Activate shelf management |
data[enable_departmentsGroups] | Não | Enable shelf group management |
data[enable_credits] | Não | Enable asset management |
data[enable_descriptionsForItems] | Não | Enable descriptions for items |
data[enable_variations] | Não | Enable variation management |
data[enable_delivShop] | Não | Activate deliveries with Deliv.shop |
data[enable_relayDeposit] | Não | Enable pickup point management |
data[enable_descriptionForVariations] | Não | Enable descriptions for items |
data[enable_dateOfConsumption] | Não | Enable expiration date management |
data[enable_coupons] | Não | Enable coupon management |
data[enable_weightForItems] | Não | Enable item weight management |
data[enable_whiteLabel] | Não | Enable white labeling (note: cannot be disabled) |
data[whiteLabelAdminUserID] | Não | White label administrator user ID |
data[isWebShopEnabled] | Não | Activate the webshop |
data[webShopURL] | Não | Webshop URL |
data[webShopLang] | Não | Webshop language |
data[webShopCol1] | Não | Background color 1 |
data[webShopCol2] | Não | Background color 2 |
data[webShopCol3] | Não | Background color 3 |
data[webShopColT1] | Não | Text color 1 |
data[webShopColT2] | Não | Text color 2 |
data[webShopColT3] | Não | Text color 3 |
data[prestaShopApiKey] | Não | Prestashop API key |
data[prestaShopURL] | Não | Your Prestashop URL |
data[saleWebhookURL] | Não | Webhook URL for sales |
data[openingWebhookURL] | Não | Webhook URL for cashbox closures |
data[enableYavin] | Não | Enable Yavin payment collection |
data[yavinSecret] | Não | Secret code |
data[yavinSerial] | Não | yavinSerial |
data[enableVivaWallet] | Não | Activate payment collection with Viva.com |
data[vivaWalletMerchant] | Não | Viva.com Merchant ID |
data[vivaAccoundID] | Não | Viva.com account ID |
data[whiteLabelManagerSet] | Não | If data[whiteLabelManagerSet]='fromSecret', then it is also possible to provide the parameter $data["whiteLabelManagerSecret"] to assign an existing manager to the account; If data[whiteLabelManagerSet]='new', then it is also possible to provide the parameters $data["whiteLabelData"]["nom"],$data["whiteLabelData"]["rcs"],$data["whiteLabelData"]["vat"],$data["whiteLabelData"]["addressLine1"],$data["whiteLabelData"]["addressLine2"],$data["whiteLabelData"]["codePostal"],$data["whiteLabelData"]["ville"],$data["whiteLabelData"]["pays"],$data["whiteLabelData"]["telephone"],$data["whiteLabelData"]["email"] |
Expected JSON response (success)
{ "success":true, "result":"Here are your credentials", "APIKEY": "[your token]", "SHOPID": "[shop account ID]"}Expected JSON response (failure)
{ "success": false, "result": "Error sending email"}JavaScript example (fetch)
const email = "mon.email@example.com";const accountTitle = "My Shop";fetch("https://kash.click/workers/addShop.php", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ email, accountTitle })}) .then(r => r.json()) .then(data => { if (data.success) { console.log("Token:", data.APIKEY); console.log("Shop:", data.SHOPID); } else { console.error("Auth error", data); } });2) With the API key you can…
- Download your sales data
- Download items, customers, departments, etc.
- Record sales
Spécification OpenAPI de cette ancienne version
Spécification OpenAPI de cette ancienne version
Les nouvelles clés délivrées par authentification ou création de boutique sont des clés gérées, sans expiration et avec toutes les autorisations. Elles apparaissent dans Configuration → Webservices → Clés API et peuvent ensuite être limitées ou révoquées. Les anciennes clés déjà utilisées restent valides.
This document is made available under the terms of the licence Creative Commons Attribution 4.0 International (CC BY 4.0).