Hulp bij het gebruik van de kassa

Webservices

Enregistrement des ventes réalisées sur un outil externe dans ce logiciel

De webservices zijn in deze software beschikbaar om op een geautomatiseerde manier verkopen in de software te kunnen registreren.
Dit kan worden gebruikt om verkopen in uw eigen software of website vast te leggen.
Om de webservices te kunnen gebruiken, moet u geabonneerd zijn op een uitgebreide licentie.
Wanneer de webservices zijn geactiveerd, verschijnt er een nieuw tabblad op de configuratiepagina, genaamd Webservices.
Op deze pagina kunt u een voorbeeldverzoek opstellen om een verkoop vast te leggen, evenals uw interfacetoegangssleutel.
Een bestelling kan in de software worden opgenomen met een enkele oproep naar een bepaalde URL, bijvoorbeeld:

 /workers/webapp.php?idboutique=ID_SHOP&key=KEYPARAM&payment=ID_PAYMENTMETHOD&deliveryMethod=ID_DELIVERYMETHOD&idUser=ID_USER& client [name] = TestClientName & client [firstname] = TestClientAchternaam & client [email] =contact@testclient.fr&client [land] = FR& itemsList [] = - ID_DEPT_1_TestDept& itemsList [] = ID_ITEM1_1_TestItem & itemsList [] = ID_ITEM2_2_AnotherTestItem& dateValue = TIMESTAMP_DATE

U kunt verschillende parameters in het verzoek specificeren (mogelijk moet u de identificatiegegevens van uw catalogus ophalen via deze Webservices-pagina):
- ID_SHOP en KEYPARAM zijn parameters die zijn ingesteld voor uw winkelaccount.
- ID_PAYMENTMETHOD is de identificatie van de gekozen betaalmethode
- ID_DELIVERYMETHOD is de identificatie van de gekozen bezorgmethode
- ID_USER is de identificatie van de gebruiker die de verkoop registreert
- Vervolgens is het mogelijk om de identificatie van een klant op te geven of om de informatie te verstrekken voor het aanmaken van een nieuw klantenbestand
- Vervolgens moet u de lijst met items specificeren die aan de bestelling zullen worden toegevoegd
- Optioneel is het mogelijk om een datum op te geven (in Unix timestamp formaat)

Zodra uw verschillende keuzes zijn gemaakt vanaf de Webservices-pagina, geeft deze pagina u de te bellen URL, evenals codevoorbeelden om deze aanroep te maken, geschreven in Java, Php, Node.js, jQuery of met een eenregelige commandocurl.

Télécharger un export des ventes

Il est possible de télécharger les rapports de ventes d'une journée particulière en utilisant notre API.
Les rapports sont dans les mêmes formats que les rapports disponibles en page Rapport : html, PDF, CSV, XML, XLS...

Télécharger la liste des articles, rayons, clients, etc

Il est possible de télécharger le catalogue d'articles, clients, rayons, etc, en utilisant notre API.
Le format de sorite peut être csv, html, ou json.

Obtenir une notification lors d'une vente

Il est possible de configurer un webhook (en page Configuration, options générales, paragraphe "Options interface") qui sera appelé lorsqu'une nouvelle commande est validée, ou est terminée.
Lorsque vous spécifiez une URL pour le paramètre webhook, alors le logiciel appellera l'URL configurée à chaque vente, avec les paramètres suivants :
- type : le type de notification : cela peut être "validated" ou "terminated". Pour chaque commande le webhook sera appelé deux fois, une première fois lorsque la commande est validée, et que la facture est disponible, une deuxième fois lorsque le paiement de la commande est terminé.
- orderID : le numéro de commande dans votre comptabilité
- orderInternalID : le numéro de commande interne
- price : le prix total de la commande
- clientID : l'identifiant du client
- client : les données du client
- cashBoxID : l'identifiant de la caisse
- deliveryMethod : la méthode de livraison
- PDFinvoice : le lien pour télécharger la facture au format PDF
- items : la liste des articles au format json
- VATs : la liste des taux et montants de TVA
- VAT : le montant total de TVA - isRefund : true/false suivant que la commande est un remboursement ou non Register now


A partir de l'aide Caisse tactile avec TPE