NF19603 — Spécifique service tiers "Freepry" avec API ⇒ revente de vêtements d'occasion

De Documentation Polaris
Aller à : navigation, rechercher
Disponible depuis la version 10.01.0.39440

Voir la carte de la fonctionnalité : A classer



Fonctionnalités :

FreePry est un spécifique client fonctionnant via les API, permettant de gérer la vente d'article d'occasion déposé en boutique qui générera un chèque cadeau utilisable par le client pour un prochain achat dans la boutique.

  • FreePry :
    • récupère la liste des RFS, des clients (clé U = email)
    • crée les produits Freepry (référence, RFS, CB, PVTTC, email du client, montant du chèque cadeau)
  • Polaris :
    • récupère les produits FreePry qui ne sont pas crées en tant qu'article dans polaris afin de ne pas alourdir la base.
    • En caisse, création de la vente du produit qui génère un chèque cadeau pour le client vendeur.
  • Freepry : peut récupérer la liste des bons générés et éventuellement avertir le client.
  • Polaris : Le client peut bénéficier de son "chèque cadeau" lors du prochain achat dans la boutique.

Polaris : Paramétrages

  • Créer la/les sous-famille(s) spécifique(s) Freepry en affectant la TVA correspondante :
    • (Base de travail > Classifications rayons/familles/Sous-familles).
    • Il est conseillé de créer un rayon ou famille et des sous-familles spécifiques pour Freepry pour faciliter le filtrage des ventes et définir les taux de TVA des produits vendus.
  • Activer Freepry :
    • Système / paramétrages / Services tiers / Freepry
    • NF19603 Freepry 7.png
    • NB : ces paramètres sont généraux.
    • Cocher Utiliser Freepry
    • Renseigner Sous famille par défaut de produit Freepry : RFS qui sera appliquée si la RFS du produit n'est pas renseignée dans Freepry.
    • Nombre de jours de validité du chèque cadeau émis : 60 par défaut.
  • Paramètre pour afficher la sous-famille en caisse :
    • Système / paramétrages / Gestion des ventes / Option de ventes
    • Cocher Forcer la saisie de la RFS en cas de code barre inconnu
    • En caisse, la colonne "Sous-familles" sera affichée et pourra être saisie en cas de saisie code barre inexistant afin d'affecter la TVA de la RFS au produit vendu.

Polaris : Création d'un appareil "Freepry"

  • Système / Gestion des appareils / Nouvel appareil
  • Sélectionner "Freepry"
  • Clic sur le lien
  • Renseigner le code PIN
  • NF19603 Freepry 4.png

Identifiants

  • Cliquer sur Communiquer les identifiants
  • NF19603 Freepry 1.png
  • cliquer sur Commencer
  • NF19603 Freepry 2.png
  • Cliquer sur Continuer
  • NF19603 Freepry 3.png
  • Saisir le code PIN et Valider
  • NF19603 Freepry 5.png

FREEPRY : Autorisations

  • Clic sur Authorize
  • NF19603 Freepry 6.png
  • Value : Renseigner la X-API-Key (uid+secret) puis clic sur Authorize
  • Close

FREEPRY : Créer le client et l'article

Freepry devra utiliser les API "FreePry", ce sont eux qui viennent chercher l'information :

  1. Créer/modification/sélection du client (l'e-mail est la clé unique.)
    1. Freepry vient chercher le client dans la base de Polaris (Avec nom, prénom, e-mail, téléphone portable ... )
    2. S'il existe déjà, il peut le sélectionner et éventuellement le modifier en renvoyant les modifications dans polaris
    3. sinon il le crée dans polaris (attention, l'e-mail est la clé)
  2. il effectuent leur traitement puis nous renvoient un code barre unique (un EAN13 dans la plage NUR 9900) avec les prix (pa et pv) et la classification.


Les API "Freepry" permettent de :

  • Récupérer la liste des RFS Polaris : API GET ​/Freepry​/Classifications
  • Récupérer la liste des clients Polaris : API GET ​/Freepry​/Clients (Avec nom, prénom, e-mail, téléphone portable ... )
  • Créer la référence de l'article d'occasion à vendre : POST "/Freepry/Reference"
    • Description, PVTTC, Montant chèque cadeau, Code RFS, CB, email du client, (Réf extérieure), code magasin.


A savoir :
Attention, ne pas passer en mode isolé sur le TLR car les API fonctionnent lorsque Polaris est en mode isolé et vous pourriez perdre des informations en cas de sortie sans conserver les modifications.

POLARIS : vente du produit Freepry et génération du chèque cadeau

Récupération des articles freePry

  • Polaris récupère automatiquement l'article (et le client) crées dans freepry.
A savoir :
L'article Freepry n'est pas crée en tant qu'article dans Polaris. Il ne figure pas dans la fiche stock de Polaris, il ne peut être beepé qu'en caisse.
  • Il est enregistré dans une table spécifique ("Freepry").
  • Polaris ne permet pas de générer les étiquettes du produit Freepry.

Vente du produit Freepry

Dans Polaris, lors de la vente, au beepage du code-barres, Polaris créé une vente RFS dans la classification du produit avec le code barre et le bon prix (Attention : le code barre est dans la vente et dans le ticket.).

  • En caisse, dans le magasin concerné :
  • Beeper le CB du produit freepry. Polaris affiche :
    • Désignation : CB et description freepry
    • Quantité=1 (non modifiable)
    • Prix de vente unitaire : PVTTC de Freepry (non modifiable)
    • Sous-familles : RFS renseignée dans Freepry sinon paramètre RFS par défaut, qui définit la TVA du produit (non modifiable)
  • NB : La ligne de vente est verrouillée : impossible de changer la quantité et le prix.
  • Le vendeur peut quand même supprimer l'article de la saisie.
  • Terminer puis valider le débit
  • La TVA du produit correspond à la TVA de la RFS correspondante.
  • Le PAMP de la vente est égal au montant du chèque cadeau émis pour la cliente (TTC)
  • Le ticket de caisse et la facture comporte le CB et la référence de freepry :
    • Ticket caisse :
(1) 1 × [3 564 706 624 795] sac cuir noir 29,90 €
    • Facture :
DÉSIGNATION TVA TAUX QTÉ. PUHT T.Rem Rem. HT TOTAL HT TOTAL TTC
[3 564 706 624 795] sac cuir noir 1 20,00 1 24,92 € 0,00 % 0,00 € 24,92 € 29,90 €



  • Le CB est enregistré dans Polaris comme étant vendu.


A savoir :
Si le CB est re-beepé par erreur en caisse, il passera en "Article inexistant" à 0 €.

Pourquoi l'article passe en "Article inexistant" ?

  • L'article a déjà été vendu.
  • L'article n'a pas été enregistré dans Freepry ou ne figure pas dans la table des articles "freepry" de polaris.
  • L'utilisateur connecté a un filtre "magasin" et l'article a été affecté dans freepry à un autre magasin.

Génération du bon de type "chèque cadeau" :

Polaris génère un bon de type "Chèque cadeau" de la valeur définie dans Freepry pour le client vendeur de l'article avec pour libellé le descriptif de l'article.

  • Ventes / Bons
  • Vous pouvez filtrer les bons Freepry générés par polaris
    • Filtre / Filtre personnalisé / Autres filtres / Tous les bons
    • Ne cocher que Bons de freepry


  • Polaris auto purge les codes au bout de 1 à 6 ans.
  • Polaris auto purge les bons comme les autres bons.

Annulation d'un débit de vente d'un produit Freepry :

Lors de l'annulation d'un débit contenant un produit Freepry, le programme :

  • annule le débit
  • annule le chèque cadeau généré
  • remet en vente le produit Freepry qui pourra être revendu.

Retour d'articles Freepry non supportés :

Les retours d'article Freepry ne sont pas supportés. Il faut :

  • Supprimer le bon lié au vendeur vendeur (Ventes / Bons / Supprimer)
  • Réimporter le produit dans Freepry

Fonctionnement

  1. Dans Polaris, lors de la vente, au beepage du code-barres, Polaris créé une vente RFS dans la classification du produit avec le code barre et le bon prix (Attention : le code barre est dans la vente et dans le ticket.).
    1. La vente est verrouillée : impossible de changer la quantité et le prix ...
    2. Le vendeur peut quand même supprimer l'article de la saisie.
  2. Polaris retourne tous les codes vendus depuis une date.
  3. Freepry peut alors pousser les bons.
  4. Freepry peut interroger les bons utilisés qu'il a créé.
  5. Polaris auto purge les codes au bout de 1 à 6 ans
  6. Polaris auto purge les bons comme les autres bons.
  7. Je conseille la création d'une classification Freepry séparée du reste.


Avantages :

  • La cliente n'a pas de modèle Freepry
  • La cliente peut analyser ses ventes sous Polaris
  • L'activité de Freepry ne perturbe pas Polaris, ni dans sa structure, ni dans son utilisation.

FREEPRY : récupérer les bons générés

Une fois l'article vendu dans Polaris et le bon généré, les API Freepry permettent de :

  • Récupérer la liste des bons Freepry générés dans polaris : GET ​/Freepry​/Bons
  • Récupérer la liste des articles vendus

Polaris : bons

Envoi SMS pour informer le client du bon

Il est éventuellement possible d'éxécuter une tâche automatisée pour envoyer un SMS pour informer le client de la génération de bons entre deux dates mais il n'est pas possible d'utiliser les balises de type bon pour préciser le montant et N° du bon.

  • Système / mes tâches automatisées / créer

Utilisation du bon freepry

  • En caisse, lors du prochain achat le client vendeur peut utiliser de type "chèque cadeau" généré par sa vente.
  • Le bon de type "chèque cadeau" passe alors en quarantaine.