NF17502 — API WebConnect

De Documentation Polaris
Aller à : navigation, rechercher

Voir la carte de la fonctionnalité : A classer



API Webconnect :

Limiter les accès concurrents aux API

Mise en place de garde fou empêchant un client d'appeler en boucle des API avec pour conséquence de consommer toutes les ressources d'un service de réplication, notamment le nombre de connexions SQL disponibles, en entraînant sa paralysie.

Mise en place un nombre maximal d'appels simultanés de :

- 3 appels par jeton utilisé ;

- 1 appel simultané de la même API pour un même jeton ;

- Les appels sans connexion sont librement autorisés (car ils ne nécessitent que peu de ressource et sont optimisés).

Gestion des appareils

  • <Système / gestion des appareils
  • Nouvel appareil ou Nouveau prestataire / WebConnect
Disponible depuis la version 11.02

Appareil "Webconnect"

Paramétrer :

  • Magasin de réference
  • Utiliser les descriptions du site internet : saisir le site internet
  • Exposer uniquement les produits publiés sur ce site :
    • si coché : exporte uniquement les articles publiés sur le site internet renseigné
    • si décoché :
Disponible depuis la version 13.03
      • OU Sinon, utiliser le filtrage suivant : décoché par défaut.
        • Si coché : permet de définir les articles exportés via des filtres.
  • Préfixe des références externes


  • Autoriser :
    • Imports clients
    • Modif. clients existants
    • Import bons
    • Imports transferts
    • Imports réservations
    • Imports vente en gros
    • Exports clients
Disponible depuis la version 11.02
      • Que les clients avec e-mail :
        • Décoché : (par défaut). Tous les clients
        • Coché : QUE les clients avec e-mail
    • Imports ventes
    • Exports bons
    • Exports des PA
    • Export réservations
    • Export ventes

Lors de l'importation des ventes :

  • Code caisse par défaut
  • Code vendeur par défaut
  • Magasins exposés : permet de filtrer les clients sur le "Magasin lié" de la fiche client.
    • Sélectionner les magasins ou cocher Exposer tous les magasins
Disponible depuis la version 11.02
  • Magasins autorisés pour les clients : "Magasin lié" de la fiche client
    • Sélectionner les magasins ou cocher Tous les magasins

API WebConnect "Catalog"

Les API suivantes intégrent les libellés renseignés dans le site internet :

  • Catalog/Categories1 à 4
  • Catalog/CategoriesEXT1 à 4
  • Catalog/Niveaux1 à 4
  • Catalog/NiveauxEXT1 à 4
  • Catalog/Classifications
  • Catalog/ClassificationsEXT

API Webconnect CATALOG/Magasin (GET) CatalogGetMagasin

Disponible depuis la version 12.2
  • Ajout de la rubrique "Horaires" qui renseigne les jours et horaires du magasin. par exemple :
    • "Horaires": "Dimanche : Fermé, Lundi : Fermé, Mardi : 10-19, Mercredi : 10-19, Jeudi : 10-19, Vendredi : 10-19, Samedi : 9-20"

API Webconnect CATALOG/Produits (GET)

Rubriques

Rubrique "GrilleTaille"

Disponible depuis la version 12.2

GrilleTaille : libellé de la grille taille :

  • "GrilleTaille": "chaussures 36 au 41",

Rubrique "TauxTVA"

Disponible depuis la version 12.2

TauxTVA

  • "TauxTVA": 0.2 pour une TVA à 20 %
  • "TauxTVA": 0.055 pour une TVA à 5.5 %

Rubrique "Zonage" taille

Disponible depuis la version 12.2
  • Dans Polaris pour paramétrer le zonage taille :
  • Système / paramétrages / applications / rayonnage / "Niveau du zonage dépôt" = tailles
  • Ajout du zonage à la taille : Zonage dans la rubrique Tailles.
    • Exemple de zonage à la taille renseigné
"Tailles": [
{
"Taille": "s",
"TailleFour": null,
"Zonage": "a01p01e01",
"Refs": [
"11686484"
],
...
    • Exemple de zonage taille non renseigné
"Tailles": [
{
"Taille": "s",
"TailleFour": null,
"Zonage": "",
"Refs": [
"11686460"
],
...


A savoir :
ATTENTION : si on repasse au paramétrage zonage au critère, Polaris n'efface pas le zonage saisi à la taille et l'API ressortira le zonage à la taille renseigné précédemment.

API Webconnect CATALOG/ProduitsInvalides (GET)

Disponible depuis la version 12.2
  • Lorsque les produits sont supprimés/dépubliés, ils ne sortent plus dans le endpoint Produits et donc l'utilisateur de l'API n'est pas mis au courant que tel ou tel produit doit être supprimé du site.
  • L'API ProduitsInvalides Création d'un EndPoint permettant de lister tous les produits qui ne DOIVENT PAS/PLUS être sur le site.

Cela permet de boucler sur les références tailles (code barres Polaris) et de les supprimer du site s'ils existent.

API WebConnect "Clients"

API WebConnect ClientsPostBon

  • Si le client ne fait pas partie des magasins autorisés pour les clients : "Message": "Le client n'est associé à aucun magasin autorisé"

API WebConnect ClientsGetBon

  • Filtre sur le CB du bon : Le programme affiche le bon même si le client ne fait pas partie des "magasins autorisés pour les clients".

API WebConnect ClientsGetBons

  • Le programme affiche uniquement les bons des clients dont le magasin fait partie des "magasins autorisés pour les clients".

API WebConnect ClientsGetCartePrePaye

  • Filtre sur le CB de la carte pré-payée : Le programme n'affiche pas la CPP si le client ne fait pas partie des "magasins autorisés pour les clients" : "Message": "Not Found".

API WebConnect ClientsGetCartePrePayes

  • Le programme affiche uniquement les cartes pré-payées des clients dont le magasin fait partie des "magasins autorisés pour les clients".

API WebConnect ClientsGetClient

  • Si le magasin du client ne fait pas partie des magasins autorisés pour les clients : "Message": "Not Found".
Disponible depuis la version 13.1.1.44971
    • Ajout des critères N°1 à 3 :
"Crit1": "string",
"Crit2": "string",
"Crit3": "string",

API WebConnect ClientsPostClient

  • Si le magasin du client ne fait pas partie des magasins autorisés pour les clients : "Message": "Not Found".

API WebConnect ClientsDeleteClient

  • ne supprime pas le client si le magasin du client ne fait pas partie des magasins autorisés pour les clients : "Message": "Le client n'est associé à aucun magasin autorisé".

API WebConnect ClientsPutClientCarte

  • Si le magasin du client ne fait pas partie des magasins autorisés pour les clients : "Message": "Le client n'est associé à aucun magasin autorisé".

API WebConnect ClientsGetClients

  • Le programme affiche uniquement les clients dont le magasin fait partie des "magasins autorisés pour les clients".
Disponible depuis la version 13.1.1.44971
    • Ajout des critères N°1 à 3 :
"Crit1": "string",
"Crit2": "string",
"Crit3": "string",

API WebConnect ClientsGetDiffusion

API WebConnect "Stocks"

API Webconnect Stocks / Stocks (GET)

Filtres

Disponible depuis la version 10.0.8
  • Nouveau filtre IsInternet (boolean) : Le plan de solde est valable sur internet
NF17502 APiWebconnect 1.png

Rubriques

Disponible depuis la version 10.0.8
  • La nouvelle rubrique DatesLivrPrev liste les dates de réception prévisionnelles des commandes fournisseur en cours (Commandes validées non ou partiellement reçues).

Par exemple : 

"DatesLivrPrev": [
               "2022-03-01T00:00:00",
               "2022-02-11T00:00:00"
             ]

API WebConnect "Ventes"

API Webconnect Ventes / Ventes (PUT)

Disponible depuis la version 13.1.1
  • Ajout de la notion de vente défectueuse :
"Defectueux": false
"Defectueux": true
Récupérée de « https://extranet.vega-info.fr/doc-polaris/index.php?title=NF17502_—_API_WebConnect&oldid=35317 »