EspressoIntégration

BasilBook intégration

Reliez DailyBrew à BasilBook. Associez votre personnel par nom d'utilisateur, créez une clé d'API, et laissez BasilBook récupérer les heures tout seul — heures de pointage, retards, horaires, le tout en un appel.

Pourquoi ça existe

Les heures vivent dans DailyBrew. La compta vit dans BasilBook. Ni l'un ni l'autre ne se parlent.

Sans lien, il faudrait recouper à la main qui était là, qui est arrivé en retard et quel horaire a été fait — puis tout ressaisir dans la compta. Lent, facile à rater, et personne n'en veut.

Le lien BasilBook comble ce trou. BasilBook récupère les heures directement dans DailyBrew, par une connexion sécurisée, en associant les personnes par nom d'utilisateur.

Comment ça marche

Associez votre personnel par nom d'utilisateur

Chaque personne dans DailyBrew peut porter un nom d'utilisateur — le même que celui sous lequel BasilBook la connaît. Quand BasilBook récupère les heures, c'est là-dessus qu'il fait le lien.

Créez une clé d'API

Dans les réglages de l'établissement, créez une clé d'API. La clé complète s'affiche une seule fois — copiez-la et mettez-la dans BasilBook. Nous n'en gardons qu'une empreinte : la clé elle-même ne peut jamais être récupérée.

BasilBook demande les heures

BasilBook envoie un GET avec la clé dans l'en-tête X-Api-Key et une plage de dates, jusqu'à 93 jours. DailyBrew renvoie les journées de toutes les personnes qui ont un nom d'utilisateur — heures d'entrée et de sortie, retards, horaires, le tout dans le fuseau horaire de votre établissement.

Ça se tient à jour tout seul

Une fois en place, BasilBook peut récupérer au rythme qui vous arrange — chaque jour, chaque semaine, ou à la demande. Pas d'export, pas de fichier CSV, pas de copier-coller. Les chiffres sont toujours à jour.

Ce qui revient

Pour chaque personne avec un nom d'utilisateur, vous récupérez ses journées dans la plage demandée :

Nom d'utilisateur— Ce qui relie les deux systèmes
Nom— Nom complet, pour la lecture
Nom de l'horaire— Son horaire, ou rien
Date— Le jour (AAAA-MM-JJ)
Heure de pointage d'entrée— HH:mm dans le fuseau de votre établissement
Heure de pointage de sortie— HH:mm, ou rien s'ils sont encore là
Arrivé en retard— true s'ils sont arrivés après le début de l'horaire
Parti en avance— true s'ils sont partis avant la fin de l'horaire

Les journées vides sont omises — une date absente veut dire que personne n'est venu. Plage maximale par appel : 93 jours.

Ce que ça vous apporte

Rien à ressaisir

Les heures passent de DailyBrew à BasilBook toutes seules. Pas de tableur, pas de copier-coller, aucun chiffre perdu en route.

Toujours à jour

BasilBook lit en direct dans DailyBrew. Chaque jour ou chaque semaine, il reçoit les pointages, les retards et les horaires les plus récents.

Sûr par construction

Nous ne gardons qu'une empreinte de chaque clé — la clé elle-même s'affiche une fois et n'est jamais conservée. Révoquez-la quand vous voulez. Chaque clé ne vaut que pour un établissement.

L'association se fait par nom d'utilisateur

Les personnes sont associées par nom d'utilisateur dans les deux systèmes. Pas d'association par e-mail fragile, pas de correspondance à la main. Réglez-le une fois et le lien tient.

La mise en place

Deux parties : donnez des noms d'utilisateur à votre personnel, puis créez une clé d'API pour BasilBook.

1

Donnez un nom d'utilisateur à chacun

Ouvrez la page de chaque personne et saisissez le nom d'utilisateur sous lequel BasilBook la connaît. Ça doit correspondre exactement.

2

Créez une clé d'API

Dans les réglages de l'établissement, descendez jusqu'à « Clés d'API » et créez-en une. Donnez-lui un nom reconnaissable — « BasilBook ». La clé complète s'affiche une seule fois : copiez-la tout de suite.

3

Réglez BasilBook

Dans BasilBook, collez la clé dans les réglages DailyBrew. BasilBook l'envoie dans l'en-tête X-Api-Key quand il demande les heures.

4

Faites un essai

Lancez une récupération de test depuis BasilBook. Vous devriez voir les journées de toutes les personnes qui ont un nom d'utilisateur. Quelqu'un manque ? Vérifiez son nom d'utilisateur dans DailyBrew.

Questions courantes

Et si je perds la clé d'API ?

La clé complète s'affiche une fois, à la création. Perdue ? Révoquez l'ancienne, créez-en une nouvelle, et mettez BasilBook à jour.

Puis-je avoir plusieurs clés ?

Oui — une pour la production, une pour les tests, autant que vous voulez. Chacune se révoque séparément.

Et si quelqu'un n'a pas de nom d'utilisateur ?

Elle ne remontera pas dans la réponse. Seules les personnes avec un nom d'utilisateur sont incluses — c'est lui qui relie les deux systèmes : sans lui, rien à associer.

Jusqu'où peut remonter un appel ?

93 jours par appel. Pour plus long, faites plusieurs appels avec des plages qui se suivent.

BasilBook renvoie-t-il quelque chose ?

Non. Ça va dans un seul sens : BasilBook lit les heures dans DailyBrew. DailyBrew ne prend rien à BasilBook et n'y modifie rien.

Dans quel fuseau sont les heures ?

Celui de votre établissement — Asia/Phnom_Penh, ou celui que vous avez réglé. Il est inclus dans la réponse pour que BasilBook les lise correctement.

Compris dans Espresso

Le lien BasilBook et les clés d'API sont compris dans Espresso (19,99 $/mois ou 199 $/an). Les noms d'utilisateur pour relier les deux produits sont eux aussi réservés à Espresso.

Prêt à relier les deux ?

Commencez gratuitement. Passez à Espresso quand vous aurez besoin du lien.