Question about API


English version (see below)

Après lecture de la documentation de votre API il me parait nécessaire que vous nous apportiez quelques compléments d'informations techniques et que validiez le process souhaité. 

> Le contexte

La société Paris Seine prévoit de s'équiper du logiciel de gestion commercial TourBiz. 

TourBiz est un logiciel de gestion commerciale en ligne qui offre les fonctionnalités suivantes :


- commercialisation multi-plateforme via différentes API

- la tarification par revendeur

- la facturation et les encaissements clients

- la planification.


Paris Seine propose des diners croisières sur la Seine et dispose pour cela d'une flotte de bateaux.

 

Ces bateaux doivent être équipés de la solution de caisse LightSpeed.


> La connexion souhaitée 


TourBiz et LightSpeed doivent pouvoir échanger des informations sur les ventes et les clients selon le process décrit ci-après :


> Etape 1 - Flux de TourBiz vers LightSpeed


TourBiz enregistre les ventes et les règlements clients jusqu'au départ de la croisière. 

Après le départ plus aucun client ne peut monter à bord du bateau.


TourBiz doit transmettre à LightSpeed les informations suivantes pour chaque dossier client :


- numéro de la vente TourBiz

- Nom du client

- nombre de personnes

- détail des produits vendus (menu + emplacement sur le bateau) 

- prix facturés TTC et répartition de la TVA

- détail des montants dèjà encaissés par type de règlement

- origine de la vente (revendeur)


La transmission de ces informations a lieu au plus tard à l'heure de départ de la croisière.


A partir de ces données, LightSpeed doit ouvrir les tables sur la caisse.


> Etape 2 - Embarquement


Les clients se présentent à l'embarquement avec leur carte d'embarquement obtenue suite à leur achat.

Le document est soit présenté imprimé soit de manière électronique sur smartphone.


Il est souhaité le raccordement d'un terminal de scan (type douchette) afin d'identifier les clients à leur arrivée pour leur affecter leur place et contrôler la validité de leur réservation.


L'embarquement s'effectue dans un délai court. 150 à 200 personnes doivent prendre place en 15 minutes environ.


> Etape 3 - La croisière repas


Durant la croisière c'est la caisse LightSpeed qui enregistre les consommations des clients. En complément de leur achat initial ils consomment sur place des boissons ou des plats complémentaires.


Ces extra viennent compléter la facture initiale transmise par TourBiz.


En fin de repas le client est facturé du solde à régler soit la différence entre ce qu'il a déjà réglé avant la croisière et la facture finale.


> Etape 4 - Flux de données de LightSpeed vers TourBiz


LightSpeed doit retourner à TourBiz le ticket final par client avec notamment les informations suivantes


- référence LightSpeed

- référence TourBiz

- détail des produits consommées à bord

- détail des montants encaissés par type de règlement y compris ceux pré-réglés (voir étape 1)

- détail de la facture avec la répartition de TVA


La TVA appliquée est multiple. En règle générale il s'agit d'une répartition entre TVA à 10 et 20%. 


Il est indispensable que le ticket comporte toutes ces informations car il sera repris tel quel sans modification dans TourBiz qui l'utilisera pour l'export comptable.


----------------------------------------------



After reading your API documentation, it seems necessary to me that you provide us with some additional technical information and that you validate the desired process.


> The context


The Paris Seine company is planning to equip itself with the TourBiz commercial management software.


TourBiz is an online business management software that offers the following features:


- cross-platform marketing via different APIs

- pricing per reseller

- invoicing and customer collections

- Planning.


Paris Seine offers dinner cruises on the Seine and has a fleet of boats for this.

 

These boats must be equipped with the LightSpeed ​​box solution.


> The desired connection


TourBiz and LightSpeed ​​must be able to exchange information on sales and customers according to the process described below:


> Step 1 - Flow from TourBiz to LightSpeed


TourBiz records sales and customer payments until the cruise departs.

After departure, no customer can board the boat.


TourBiz must send LightSpeed ​​the following information for each customer file:


- TourBiz sale number

- Client name

- number of persons

- details of the products sold (menu + location on the boat)

- invoiced prices including VAT and distribution of VAT

- detail of amounts already collected by type of payment

- origin of the sale (reseller)


The transmission of this information takes place at the latest at the time of departure of the cruise.


From this data, LightSpeed ​​should open the tables on the cash register.


> Step 2 - Boarding


Customers show up for boarding with their boarding pass obtained following their purchase.

The document is either presented in print or electronically on a smartphone.


It is desirable to connect a scanning terminal (handshower type) in order to identify customers on their arrival in order to assign them their place and check the validity of their reservation.


Boarding takes place in a short time. 150 to 200 people should be seated in about 15 minutes.


> Stage 3 - The meal cruise


During the cruise, it is the LightSpeed ​​checkout which records the customers' consumption. In addition to their initial purchase, they consume additional drinks or meals on site.


These extras complete the initial invoice sent by TourBiz.


At the end of the meal, the customer is billed for the balance to be paid, ie the difference between what he has already paid before the cruise and the final bill.


> Step 4 - Data flow from LightSpeed ​​to TourBiz


LightSpeed ​​must return the final ticket per customer to TourBiz with the following information in particular


- LightSpeed ​​reference

- TourBiz reference

- detail of products consumed on board

- detail of the amounts collected by type of payment including those pre-settled (see step 1)

- detail of the invoice with the distribution of VAT


The VAT applied is multiple. As a general rule, this is a split between 10% and 20% VAT.


It is essential that the ticket contains all this information because it will be included as is without modification in TourBiz which will use it for the accounting export.

Sign In or Register to comment.