Connecter Recipok au TPV Ágora
Activée sur demande
Envoyez le stock de l’atelier aux boutiques équipées d’Ágora sous forme de bons de réception, avec les produits déjà associés.
À quoi ça sert
Si vos boutiques utilisent le TPV Ágora, vous pouvez leur envoyer depuis Recipok ce qui sort de l’atelier : chaque sortie vers une boutique Ágora arrive à son TPV sous forme de bon de réception, avec les produits déjà associés. Ainsi, personne n’a besoin de créer deux fois le même produit, dans la boutique et dans l’atelier.
Il s’agit d’une intégration sur mesure : nous l’activons pour votre entreprise lorsque vous acceptez le devis. Nous expliquons ici comment elle est configurée et comment l’utiliser.
Cette connexion est en préparation pour les premières boutiques. Ce que nous expliquons ici est ce qu’elle fait. L’import des ventes du TPV, qui déduit le stock de Recipok, est encore en cours de développement et nous ne le décrivons pas.
Avant de commencer
- Chaque boutique a besoin de son Ágora avec l’API HTTP activée et l’ordinateur allumé, avec le port accessible depuis l’emplacement de Recipok.
- Créez dans Ágora une série dédiée aux bons de réception (par exemple RCP), pour qu’elle ne se mélange pas avec vos bons d’achat.
- Vérifiez le nom de vos produits dans Recipok : l’association est suggérée surtout d’après le nom.
Connecter une boutique
Dans Ventes › Boutiques, ouvrez la fiche de la boutique et repérez le panneau Connexion avec Ágora.
- 1Adresse et clé : celles de l’administration d’Ágora. La clé est enregistrée chiffrée.
- 2Tester la connexion vérifie qu’Ágora répond avant l’enregistrement.
Saisissez l’adresse et la clé
Adresse d'Ágora : celle de son administration, avec le port (en général 8984). Clé d'API (Api-Token) : elle est enregistrée chiffrée. Si elle est déjà enregistrée, laissez-la telle quelle ; si vous la changez, saisissez la nouvelle.
Testez la connexion
Cliquez sur Tester la connexion. Si Ágora répond, Connexion réussie apparaît avec sa version. Sinon, Recipok vous indique la cause : Ágora ne répond pas à cette adresse ou refuse la clé.
Choisissez l’entrepôt et la série
Entrepôt qui reçoit le stock : l’entrepôt de la boutique dans Ágora où arrive la marchandise. Série des bons de réception : la série dédiée que vous avez créée. Si vous choisissez la série de vos achats, Recipok vous en avertit.
Enregistrez et vérifiez l’état
Cochez Connexion active puis cliquez sur Enregistrer la connexion. Quand Prête à recevoir du stock apparaît, la boutique peut déjà recevoir des bons de réception.
Associer les produits
Chaque produit de Recipok doit correspondre à un produit d’Ágora dans cette boutique. Dans le même panneau, cliquez sur Associer les produits :
- Recipok propose des correspondances d’après le nom : Même nom ou Nom proche. Vérifiez chacune puis cliquez sur Utiliser la suggestion, ou choisissez à la main le produit d’Ágora.
- Avec Seulement non associés, vous voyez ce qui manque. Le compteur (« X sur Y associés ») indique ce qu’il reste à faire.
- Si un produit n’existe plus dans Ágora, il apparaît avec la mention N'existe plus dans Ágora. Vérifiez si vous l’avez désactivé ou renommé là-bas.
Envoyer le stock à la boutique
Dans une sortie Recipok, choisissez comme destination Boutique (Ágora), puis la Boutique de destination. À la confirmation, Recipok vous demande si vous voulez envoyer le stock maintenant :
- Confirmer et envoyer maintenant : crée le bon de réception dans l’Ágora de la boutique.
- Confirmer sans envoyer : vous l’envoyez plus tard depuis le document, avec Envoyer à Ágora.
Si un produit de la sortie n’est pas associé dans cette boutique, Recipok n’envoie pas le document tant que tous les produits de la sortie ne sont pas associés.
Chaque document affiche son état : En attente d'envoi à Ágora, Envoyé à Ágora ou Erreur lors de l'envoi à Ágora. Si vous modifiez quelque chose et voulez le renvoyer, cliquez sur Renvoyer à Ágora : si le bon était déjà là, Ágora le met à jour et le stock n’est pas dupliqué.
En cas de problème
Recipok vous indique la cause exacte lorsqu’un envoi échoue. Les plus fréquentes sont les suivantes :
- Ágora ne répond pas : l’ordinateur de la boutique est éteint ou le port est fermé.
- Ágora refuse la clé d’API : la clé n’est pas valide ou l’API HTTP est désactivée dans Ágora.
- Un produit de la sortie n’est pas associé.
Corrigez la cause, puis renvoyez le document avec Renvoyer à Ágora.
Conseils
- Commencez par une seule boutique et vérifiez un bon de bout en bout avant de connecter les autres.
- Utilisez des séries distinctes dans Ágora pour Recipok et pour vos achats, afin qu’elles ne se mélangent jamais.
- Avant d’associer, vérifiez les noms de vos produits : les suggestions seront ainsi presque toutes justes.
- Si votre logiciel de facturation reçoit aussi les sorties, nous l’expliquons dans Sorties et bons de livraison avec lot.