https://caisse.enregistreuse.fr

Hulp bij het gebruik van de kassa

Webservices

Recording of sales made on an external tool in this software

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.

Download a sales export

It is possible to download sales reports of a particular day using our API.
The reports are in the same formats as the reports available on the Report page: html, PDF, CSV, XML, XLS...

Download list of items, departments, clients, etc

It is possible to download the catalog of articles, customers, departments, etc., using our API.
The output format can be csv, html, or json.

Get notified during a sale

It is possible to configure a webhook (on the Configuration page, general options, "Interface options" paragraph) which will be called when a new order is validated, or is completed.
When you specify a URL for the webhook parameter, then the software will call the configured URL on each sale, with the following parameters:
- type: the type of notification: this can be "validated" or "terminated". For each order the webhook will be called twice, a first time when the order is validated, and the invoice is available, a second time when payment for the order is completed.
- orderID: the order number in your accounting
- orderInternalID: the internal order number
- price: the total price of the order
- clientID: the client identifier
- customer: customer data
- cashBoxID: the cash box identifier
- deliveryMethod: the delivery method
- PDFinvoice: the link to download the invoice in PDF format
- items: the list of articles in json format
- VATs: the list of VAT rates and amounts
- VAT: the total amount of VAT - isRefund: true/false depending on whether the order is a refund or not

From help Cashier app mobile