Installer l'extension Toporder permet d'interconnecter votre caisse Toporder (by myPOS) — la caisse enregistreuse des métiers de bouche — avec Melba. Le catalogue produits (déclinaisons par taille, prix à l'unité de mesure) est importé, et les tickets de caisse sont synchronisés automatiquement pour suivre vos ventes, vos consommations matière et vos marges.

Les extensions sont accessibles dans l'onglet Extensions du menu principal (section paramètres, icône engrenage).

Avant de commencer : obtenir votre clé API

La connexion se fait avec une clé d'API Toporder. Une clé correspond à une boutique : si vous exploitez plusieurs points de vente, il vous faut une clé par boutique.

Pour l'obtenir, rapprochez-vous de votre interlocuteur Toporder habituel en précisant l'usage : connexion à Melba, en lecture, pour le catalogue et les tickets de caisse.

Cette clé donne accès à des données commerciales réelles : traitez-la comme un mot de passe et ne la faites pas circuler au-delà des personnes qui en ont besoin.

Comment installer et configurer Toporder ?

Dans Melba, chaque boutique correspond à une organisation. Installez l'extension dans l'organisation de la boutique concernée :

1. Si vous gérez plusieurs boutiques, basculez d'abord sur la bonne organisation (menu du profil, Changer d'organisation)
2. Ouvrir l'onglet Extensions du menu principal
3. Parmi les extensions disponibles, identifier la caisse Toporder
4. Cliquer sur le bouton Installer
5. Dans la modale de configuration, renseigner la Clé API de la boutique
6. Confirmer l'installation au clic sur le bouton Appliquer

Melba vérifie immédiatement la clé auprès de Toporder et mémorise la boutique associée. Répétez l'opération pour chaque boutique, avec la clé qui lui correspond.

Que se passe-t-il après l'installation ?

• Catalogue : les produits Toporder, avec leurs déclinaisons (tailles T1/T2…) et leurs prix à l'unité de mesure (au kg, à la pièce…), peuvent être importés dans Melba pour être rapprochés de vos recettes.
• Ventes : les tickets sont synchronisés automatiquement, environ toutes les 30 minutes, en commençant environ deux mois en arrière lors de la première installation. Les lignes « produit divers » (ventes libres saisies en caisse) sont importées telles quelles, sans lien avec un produit du catalogue.

Suivez les étapes préliminaires à l'import des ventes

Pour ne pas perdre de temps et mélanger vos données, suivez le tutoriel de préparation des imports du POS.

En cas de problème

• Clé refusée à l'installation : vérifiez qu'elle est copiée sans espace et qu'il s'agit bien de la clé d'API fournie pour Melba.
• Extension désactivée (vous recevez un email de Melba) : la clé a probablement été révoquée ou régénérée côté Toporder — demandez une nouvelle clé, puis réinstallez l'extension.
• Besoin d'aide côté caisse : rapprochez-vous de votre interlocuteur Toporder habituel (www.toporder.fr).