Passerelle Fastmag Joor
  • 07 Dec 2023
  • 7 Minutes à lire
  • Sombre
    Lumière
  • PDF

Passerelle Fastmag Joor

  • Sombre
    Lumière
  • PDF

Article Summary

Cette passerelle a pour but de synchroniser les commandes clients prises sur le site de vente B2B JOOR avec Fastmag Négoce.

1. Descriptif des étapes de la passerelle JOOR

a. Envoi de fichiers depuis Fastmag au site JOOR 

  1. Paramétrage des tarifs envoyés à JOOR
  2. Importation des catégories JOOR
  3. Envoi des Produits à JOOR

b. Récupération des fichiers depuis JOOR 

  1. Importation des commandes depuis JOOR

Au préalable il est nécessaire de mettre en place les paramétrages nécessaires:

2. Paramétrage au niveau de Fastmag

a. Au niveau du dossier

Chemin : Gestion - Paramétrage système - Paramétrage Dossier 

  • Dans l’onglet Export EDI:

Remarque:
Si une langue pour les couleurs est spécifiée seule les couleurs traduites sont exportées.

Concernant la langue de la fiche produit, Fastmag exporte la traduction des fiches traduites et le français des champs non traduits

Nota :
La traduction des familles est importante pour les axes statistiques chez Joor (nous recommandons de propager la traduction de celle-ci).

Envoyer la saison permet de créer un nom de line sheet par saison, si l’envoi de la saison n’est pas coché aucune line sheet ne sera créé et l’affectation des produits devra se faire dans l’application Joor.

L’envoi du thème permet de faire des statistiques sur Joor.

Attention !
Chez Joor les couleurs et les tailles doivent être renseignées, ce logiciel n’acceptant pas les valeurs vides pour ces deux champs. Dans le cas ou vous ne gérez pas les couleurs et/ ou les tailles, renseignez une valeur pour le champ non utilisé dans fastmag.

b. Importer les catégories JOOR

Chemin : Négoce - EDI avec JOOR - Importation des catégories JOOR

c. Au niveau de la fiche produit

Chemin : Négoce - Données de référence - Fiche Produit

  • Dans l’onglet Fiche :

La fiche produits doit être active B2B :

  • Dans l’onglet Négoce :

  • Dans l’onglet Prix - Tarif :

Renseigner le prix de vente des produits.

Remarques
  • Seules les références ayant un gencod, l’indication article actif, la catégorie Joor renseignée et visible sur Ebusiness seront envoyées dans le référentiel Joor.
  • Les photos de plus de 4 Mb ne peuvent être intégrées dans Joor.
  • Si une langue a été programmé pour l’envoi dans Joor, vérifier que la traduction soit réalisée.

  • Dans l’onglet Gencod :

Renseigner les gencod

d. Au niveau de la fiche client

Chemin : Négoce - Fiche client

  • Onglet Paramétrage

L’envoi du client se fait en 2 temps

1. Envoyer à JOOR

Va permettre de créer le client dans JOOR, il faut se connecter pour vérifier que le client bien été créé dans JOOR, avant de faire la modification de la connexion

La version du 20 novembre 2017 permet de faire également la mise à jour avec le bouton envoyer à Joor

Remarques : 
Les modes de règlement et les modes de transports sont à créer chez Joor. En effet, si Fastmag le spécifie ces informations ne seraient pas modifiable dans la saisie de commande chez Joor.

2. Modifier la connexion JOOR (A utiliser pour mettre à jour le client)

Le système va mettre à jour le tarif du client, ainsi que les adresses de facturation et livraison, et toutes les nouvelles informations modifiées dans la fiche du client depuis sa création.

Cette fonction est désactivé depuis la version du 20 novembre 2017

Attention !
  • Vérifier avant l’envoi du client que les pays sélectionnés dans l’adresse de facturation et de livraison sont bien les pays disposant du code ISO (Celui-ci est entre parenthèse dans la liste déroulante du choix pays)
  • Vérifier que le tarif et le code représentant sont renseignés
  • Vérifier que la fiche client possède une adresse mail

e. Téléchargement des pays

Chemin : Gestion - Paramétrage du système - Paramétrage des magasins - Onglet Détaxe - Premier tax Free

  • Cliquer sur le bouton Télécharger la liste des pays ISO.

De cette manière Fastmag enverra à Joor le code ISO du pays de la fiche client négoce.

3. Paramétrage au niveau de JOOR

Se connecter à JOOR:

https://sandbox.jooraccess.com/

S’identifier:

Username: isa@fastmag.fr

Password: @gt3st498

a. Au niveau des modes de règlements 

Chemin : Fastmag - Order Settings - 1.PAYMENT TERMS

Il faut déclarer et activer les codes à l’identique de ceux utilisés dans Fastmag, en respectant la codification.

b. Utilisation de la passerelle JOOR

c. Paramétrage des tarifs envoyés à JOOR

Chemin : Négoce - EDI avec JOOR - Paramétrage des tarifs envoyés à JOOR

Le système va créer les tarifs dans JOOR ainsi que les prix Retail et les associer à une devise.

Il est impératifs de créer tous les tarifs rattachés aux fiches clients, qui vont utiliser JOOR.

Il est obligatoire de renseigner le code ISO de la devise du tarif.

Les tarifs par produits ne seront envoyés que lors de l’Envoi des Produits à JOOR.

Remarque:
Si le prix Retail est le prix de vente de la fiche produit, cocher la case Avec Retail.
Attention !
Les tarifs Wholesales doivent être nommés à l’identique dans l’interface joor.

Menu Order settings

4. Envoyer les produits dans JOOR

Chemin : Négoce - EDI avec JOOR - Envoi des produits à JOOR

Le système propose d’envoyer les produits depuis une saison ou une fiche produit unique

  • Possibilité d’exporter la fiche produit
  • Possibilité d’exporter les photos
  • Possibilité d’exporter le stock (Onglet Négoce: Joor sur commande ne doit pas être coché)
Attention: 

L’envoi ne peut se faire que 

  • Si le produit est actif Ebusiness
  • Si les gencod sont renseignés
  • Si les tailles et couleurs de l’article sont actives
  • Si la traduction de la langue utiliser pour Joor est réalisée

Attention :

Vérifier qu’aucun champs de la fiche produit ne possède le caractère guillemet “ car cela stop le process Json.

Le flux article envoyé par Fastmag est un flux de mise à jour, si un produit ne doit plus être visible chez Joor, il faudra le désactiver chez Joor en plus de l’avoir rendu invisible Ebusiness.


Lors de cet envoi, le système transfère également les tarifs de vente des produits, créés au préalable.

Attention,
Si un client est rattaché, à un tarif non créé sur JOOR,le système ne traitera pas ce tarif, et il faudra refaire la création du tarif et l’envoi des produits.
Remarque:
Il est possible de programmer l’envoi des produits dans le Task, en appelant la page avec l'enseigne en paramètre, le stock sera envoyé automatiquement pour les produits avec JOOR Sur Commande décoché.

1 8 * * * c:\cns\FastMag\bin\httpget.exe "http://localhost:3000/NegoceJOOR_ExportProduits.ips?Enseigne=NOMENSEIGNE&SAISON='SS20'"

Si plusieurs saisons, faire plusieurs lignes.

Au niveau des modes des transporteurs 

Chemin : Fastmag → Order Settings → 2. SHIPPING METHODS

5. Envoyer les clients en masse dans JOOR

Chemin : Négoce - EDI avec JOOR - Envoi en masse des clients à Joor

Sélectionner les filtres de l’export et cliquer sur exporter.

Le client enregistre ses commandes sur JOOR.

Puis la passerelle permet de les rapatrier dans Fastmag

6. Importation des commandes depuis JOOR

Chemin : Négoce  EDI avec JOOR - Importation des commandes depuis JOOR

  • Possibilité de récupérer les commandes approuvées et non synchronisées
  • Possibilité de récupérer les commandes depuis une fourchette de dates
  • Possibilité de voir le fichier des LOGS

Attention: 

La récupération des commandes ne peut se faire que 

  • Si le code client de Joor correspond au code client dans Fastmag
  • Si le code de l’adresse de livraison (code client + code adresse) correspond à couple code client + code adresse de Fastmag

Remarque:
Il est possible de programmer la récupération des commandes dans le Task, en appelant la page avec l'enseigne en paramètre.

Exemple pour l'automatisation de l'intégration à 8h00 tous les jours :

0 8 * * * c:\cns\FastMag\bin\httpget.exe http://localhost:3000/NegoceJoor_ImportCommandes.ips?Enseigne=NOMENSEIGNE

Depuis Fastmag Négoce, dans le fiche client.

Choisir → Vue détaillée

7. Mapping JOOR - Fastmag

STYLES / PRODUITS

JOOR

Champs Fastmag ou valeur

style_name

Designation

style_number

Barcode

style_identifier

Barcode

style_description

Descriptif

style_country_origin

OrigineFab

fabrication

Designation2

silhouette

Famille

categories

Joor_idcategorie

delivery_name

Saison

season_name

Saison

season_code

Saison

materials

Matiere (optionnel selon paramétrage)

color_name

LibelleCouleur (Couleur ou traduction)

color_code

Couleur

size_name

Taille

size_code

Taille (sans les espaces non gérés par JOOR)

sku_color_code

Couleur

sku_size

Taille

upc

Gencod

price_label

Tarif

price_currency

ISODevise (gestion tarifs JOOR)

price_wholesale

Prix

price_currency_retail

ISODeviseRetail (gestion tarifs JOOR)

price_retail

Prix (gestion Tarif JOOR/ prix du tarif retail)

tag_group

Valeur : Thème et/ou Modèle selon paramétrage

tag_name

Valeur : Thème et/ou Modèle selon paramétrage

tag_value

Theme/Modele

IMAGES

Fastmag permet d’affecter 5 photos par couleur et 5 photos pour le produit lui-même.

JOOR permet d’affecter une seule photo par couleur.

Toutes les photos présentes dans Fastmag sont envoyées à JOOR et seule la première photo d’une couleur est affectée à cette dernière dans JOOR. Les autres photos couleurs sont ajoutées au style sans notion de couleur.

INVENTORY / STOCK

JOOR

Champs Fastmag ou valeur

warehouse_name

Warehouse ( Paramètre dossier)

upc

Gencod

made_to_order

Valeur : True (Si cochée dans la fiche produit)

inventory

Valeur du Stock (Si Joor_Made_to_order non cochée dans la fiche produit)

CONNECTIONS / CLIENTS NÉGOCE

JOOR

Champs Fastmag ou valeur

customer_name

Nom

customer_code

Client

customer_alias

Nom

customer_phone

Portable(Téléphone si vide)

customer_contact

Contact (Fiche)

customer_contact_email

email (Fiche)

warehouse_name

Warehouse ( Paramètre dossier)

billing_code

Client

billing_name

Nom (Fiche)

billing_phone

Telephone(Fiche)

billing_address_1

Adresse1 (Fiche)

billing_city

Ville (Fiche)

billing_postal_code

CodePostal (Fiche)

billing_country

Code ISO Pays (Fiche)

payment_method_name

Libellé du mode de règlement de la fiche client

payment_method_code

Code du mode de règlement de la fiche client

shipping_code

Concaténation client-AdrLivraison

shipping_name

Nom

shipping_phone

Télephone (Portable si vide)

shipping_address_1

Adresse1

shipping_address_2

Adresse2

shipping_city

Ville

shipping_postal_code

CodePostal

shipping_country

Code ISO Pays de l’adresse de livraison

shipping_create_doors

Valeur : true

shipping_method_name

Libellé du transporteur de la fiche client

shipping_method_code

Code du transporteur de la fiche client

price_type_label

Tarif

price_type_currency_name

Tarif

price_type_currency_code

ISODevise (gestion tarifs JOOR)

location_address_1

Adresse1 (Fiche)

location_address_2

Adresse2 (Fiche)

location_city

Ville (Fiche)

location_postal_code

codepostal (Fiche)

location_country

Code ISO du Pays (Fiche)

buyer_code

Contact (Table contacts et contact avec envoi facture)

buyer_name

Nom (Contacts)

buyer_email

email

sales_reps .name

Nom (Réprésentant)

sales_reps .code

Representant (Réprésentant)

sales_reps .email

email (Réprésentant)

discounts.amount

Remise (Fiche)

line_item_level

Valeur : true

ORDERS / COMMANDES CLIENTS

JOOR

Champs Fastmag ou valeur

order_id

Référence Commande

customer_code

Client

date_created

Date de commande

order_comments

Observation de l’entête de commande

shipping_code

Permet de retrouver l’adresse de livraison du client. Doit correspondre à la concaténation client-AdrLivraison

payment_method_code

Code du mode de règlement de la commande

shipping_method_code

Code du transporteur de la commande

order_shipping_total

Port

order_type_name

Critère de la commande

date_ship_start

Date de livraison souhaitée

date_ship_end

Date de livraison prévue

order_discount

Remise globale affectée à l’article remise et ajouté aux lignes de la commande

order_currency

Code ISO de la devise de la commande

item_upc

Gencod

item_unit_price

Prix

item_price_adjustment

Taux de remise à la ligne recalculé par rapport à ce montant et au prix de vente

item_quantity

Quantité

item_comment

Commentaire à la ligne



Cet article vous a-t-il été utile ?