Metadata

Les Metadata sont des données structurées JSON. Dans le cadre du e-commerce, les métadata vont permettre à Vijay de faire communiquer toutes autres informations, non présentes dans la plateforme Frisbii Pay, entre le site et Frisbii, comme par exemple, le SIRET.
Le SIRET n'est pas un champs existant sur la plateforme Frisbii Pay. La métadata permet de faire transférer cette valeur du site e-commerce, vers de la plateforme Frisbii Pay, puis vers Frisbii.

La métadata contient le modèle de données suivant :

public with sharing class ReepayEcommerceMetadataDTO { 
    public Account account; 
    public Contact contact; 
    public sofactoapp__Factures_Client__c invoice; 
  public List<sofactoapp__Ligne_de_Facture__c> invoiceLineItems = new List<sofactoapp__Ligne_de_Facture__c>(); // Must have as many lines and in the same order as the invoice line items requested from reepay. Create an empty line if necessary 
    public List<Product2> products = new List<Product2>(); // Must be in the same order as invoiceLineItems. Create empty lines if necessary 
    public sofactoapp__R_glement__c payment; 
}

Fonctionnement des Metadata

Dans l'API de la plateforme Frisbii Pay, un champ "Metadata" permet de stocker de la donnée au format JSON. Ce champs va vous permettre de transférer de la donnée entre le site e-commerce et Salesforce, comme par exemple, le SIRET d'une entreprise.

L'information doit être présente sur le site e-commerce, qui sera envoyée et stockée par dans les Metadata.
La métadata est ensuite envoyée à Frisbii.
Frisbii attend un format bien particulier de la Métadata, pour pouvoir l'interpréter.

Dans la plateforme Frisbii Pay, la métadata est affichée de cette façon :

Attention : Les champs venant de la plateforme Frisbii Pay sont prioritaires. Les informations de la métadata seront écrasées par les données de la plateforme Frisbii Pay.
Exemple : sur le site e-commerce, la désignation du produit est "Basket Margo", mais dans les metadata, la désignation de ce produit est "Basket Code MGT". Cette donnée sera écrasée par la désignation "Basket Margo", et dans Frisbii, vous retrouverez uniquement cette désignation.

Voici quelques usages, les métadata peuvent couvrir les fonctionnalités suivantes :

• renseigner un champs Frisbii, autres que les champs cités précédemment dans les articles

• renseigner un champs custom

• créer un enregistrement selon le record type que vous souhaitez

• associer le Produit vendu en ligne à votre catalogue Produit

Cas d'usage : connecter les record type

Depuis une commande en ligne, vous souhaitez que l'acheteur soit créé dans le record type Compte que vous voulez ?
Avec les métadata, vous pouvez renseigner l'ID du record type sur le site et envoyer cette information à Frisbii pour créer le Customer dans le record type Compte de votre choix.

Cette procédure s'applique également si vous avez des record type sur le Contact ou la Facture.

Cas d'usage : connecter le catalogue Produit Salesforce au Produit vendu en ligne

Depuis votre site e-commerce, vous souhaitez associer les produits vendus avec votre catalogue Produit Salesforce ?
Avec les métadata, vous pouvez renseigner un ID Produit sur le site et envoyer cette information à Frisbii. A réception, si l'ID correspond à l'ID externe présent sur Produit sofactoapp__External_ID__c, les Lignes de factures vont être créées avec le look up vers le Produit en question.