Création et importation d'offres gérées en externe

Remarques préliminaires

Les offres gérées par des tiers ne peuvent pas être achetées via le checkout de Frisbii Media. Une importation via API peut être utilisée pour passer une commande pour une offre gérée en externe.

Note

Une importation crée à la fois une commande et un abonnement géré en externe. Les abonnements gérés en externe diffèrent des abonnements ordinaires. Une description peut être trouvée ici.

Création de l'offre

Toutes les offres qui peuvent être gérées en externe ont une option correspondante dans la création de l'offre.

Les étapes suivantes sont nécessaires pour définir une offre comme étant gérée en externe :

• Ouvrez le menu Produits/Offres.

• Cliquez sur le bouton « Créer une offre ».

• Sélectionnez le type d'offre souhaité et cliquez sur le bouton « Créer ».

• Sélectionnez l'option souhaitée dans la section « Gestion externe » du formulaire.
  Selon le type d'offre, la zone se trouve soit à la fin du formulaire, soit dans l'onglet « Données de base »

• Enregistrement de la création de l'offre

Importation d'une commande

Pour passer une commande pour une offre gérée en externe, il est nécessaire d'importer la commande via l'API. Le point final ou la requête correspondante est décrit dans la documentation de l'API.  

Données du client Pour effectuer une importation, le client pour lequel la commande est créée doit déjà exister dans Frisbii Media.

Si ce n'est pas le cas, le client doit être créé par le biais d'une demande supplémentaire avant l'importation. Pour ce faire, les étapes suivantes sont nécessaires :

• Demande POST pour créer un enregistrement de données client

• Les données nécessaires à la demande sont les suivantes :

  • email
    l'adresse e-mail du client comme identifiant unique de l'enregistrement de données

  • langue
    la langue du client

• Les autres champs peuvent être remplis de manière facultative

Données d'importation
Données nécessaires dans la demande de réalisation d'une importation :  

• externalSystemId
  ID unique du système tiers principal. Il est indiqué à Frisbii Media sur la commande et l'abonnement.

• Frisbii MediaOfferId
  Numéro de commande Frisbii Media à utiliser.

• invoiceCustomerId
  Numéro de client de Frisbii Media

• quantity
  Quantité souhaitée pour l'offre

• startDate
  Date de début des abonnements. Détermine également la date de début des droits d'accès dans Frisbii Media.

• paymentMethod
  Mode de paiement utilisé pour la commande.

D'autres champs de données sont également disponibles. Une liste complète est disponible dans la documentation de l'API.  

Toutes les importations effectuées sont enregistrées dans le journal.  

Note

L'importation d'une commande est exécutée de manière asynchrone. Dans la réponse à une importation, un promiseId peut être émis, qui peut être utilisé pour l'identification.

Mise à jour d'une commande

Les offres gérées en externe ne peuvent pas être mises à jour directement dans le backend de Frisbii Media. Une nouvelle importation avec des données ajustées est nécessaire pour chaque mise à jour.  

Mise en œuvre d'une mise à jour :  

• Le même point de terminaison est utilisé pour la mise à jour que pour l'importation.

  • Personnalisation des données souhaitées dans le requestbody

  • La définition du champ « EndDate » entraîne la fin d'un abonnement

  • Mettez à jour le mode de paiement en mettant à jour le champ « paymentMethod »