Import of purchases

Prev Next

Preliminary Remarks

WBZ dealers do not act directly as buyers via the Frisbii Media Checkout. Purchases are mapped in third-party systems and can also be transmitted to Frisbii Media as an externally-managed offer. No individual purchases are mapped in the WBZ dealer account.   


Import of purchases from WBZ dealers

To place an order for an offer for WBZ dealers, it is necessary to import the order via the API. The corresponding endpoint or request is described in the API documentation .

Note:

Although an order is technically imported, no order data is displayed in a WBZ dealers account. 

Only the subscriptions resulting from an order are shown. 

Customer data

To perform an import, the WBZ dealer for whom the order is being created must already exist in Frisbii Media.

If this is not the case, the WBZ dealer must be created via an additional request before the import. The following steps are necessary for this:

  • POST request to create a customer data record

  • Necessary data in the request are:

    • email
      the customer's email address as a unique identifier of the data record 

    • language
      the language of the customer

  • The other fields can be filled in optionally. 

Import data

The data required in the request to carry out an import are:  

  • externalSystemId
    Unique ID from the leading third-party system. Is noted in Frisbii Media on the order and subscription.

  • plenigoOfferId
    The plenigo offer ID to be used

  • invoiceCustomerId
    The customer ID

  • quantity
    The desired quantity of the offer

  • startDate
    The start date for subscriptions. Also determines the start date for the access rights in Frisbii Media. 

  • paymentMethod
    The payment method used for the order. 

Other data fields are also available. A complete list can be found at in the API documentation.  

All imports carried out are logged in a Log.

Note: An order import is executed asynchronously. In the response for an import, a promiseId may be issued, which can be used for identification.