Buyer info component

Learn how to use the Buyer Info component.

If you use a custom component instead of the drb2b_buyerinfo component, you must:

  • Populate the following fields in the WebCart object:

    • digitalriverv3__Buyer_Name__c

    • digitalriverv3__Buyer_Email__c

    • digitalriverv3__Buyer_Phone__c

    • digitalriverv3__BillingAddress

    • digitalriverv3__DR_Customer_Type__c

    • digitalriverv3__Buyer_OrganizationName__c Note: If you use a custom component, validate that the digitalriverv3__Buyer_Name__c field contains a space. Digital River expects both a First Name and Last Name and does a split on this field by looking for a space, ' ' ,value. Note: If you use the Buyer Info component, you are not required to make changes as the field is automatically displayed. If you are not using the Buyer Info component, use a field in your user interface to collect the Organization Name information if the shopper's purchase type is Business. This UI field updates the digitalriverv3__Buyer_OrganizationName__c field on the WebCart object.

  • Update the DeliverToAddress on the Cart Delivery Group object.

  • (LWR only): After your custom component collects all the data points listed above, update the WebCart synchronously and trigger tax calculation. The WebCart update must be completed before tax is calculated. For options for triggering tax calculation, see the Tax Calculation section.

    • After your component has triggered tax calculation, refresh the page's other Digital River components. Do this by publishing the calculateTaxRefresh event as indicated below.

Note: For guest shoppers, the Buyer Info component restricts the available ship to countries to those available in the store’s Supported Ship To Countries setting.

Publish events

This section provides information on publishing events when using this component.

Use the following steps to publish various event types. The event purpose and payload will vary depending on your use case.

Import theDigitalRiverMessageChannel__c message channel and message service into a custom JavaScript file, as shown below.

Import example
import dr_lms from "@salesforce/messageChannel/digitalriverv3__DigitalRiverMessageChannel__c";

import {publish, MessageContext } from "lightning/messageService";

Declare the message context variable as shown below.

Declare variable example
@wire(MessageContext) messageContext;

Publish the event.

Publish example
  publish(this.messageContext, dr_lms, { 
                    purpose: '<purpose>',           
                    payload: '<payload>'            
                });

The following table provides more information on the component events.

Event Purpose
Event Payload Example
Description

toggleShowBIComponent

{"isShow":true}

Publish this event to show {"isShow":true} or hide {"isShow":false} the Buyer Info component.

saveBuyerInfo

n/a

(Aura only) Publish this event to perform validation of the information entered into the buyer info component and save the data to the cart.

If publishing this event, you must subscribe to the contactPointAddressId event to return the saved Contact Point Address Id.

Use this event if the OOTB Next button is disabled.

calculateTaxRefresh

n/a

(LWR Only) If you are replacing the Buyer Info component with a custom version, publish this event to refresh other components on the page after tax calculation has completed.

Subscribe to an event to get Contact Point Address ID (Aura only)

You can use this event to have the saved Contact Point Address ID returned after the buyer information is saved using the saveBuyerInfo purpose. You use this value to update the Cart Delivery Group as appropriate. Complete the following tasks to subscribe to the event.

Import the DigitalRiverMessageChannel__c message channel and message service into a custom JavaScript file, as shown below.

Import example
import dr_lms from "@salesforce/messageChannel/digitalriverv3__DigitalRiverMessageChannel__c";

import {publish, MessageContext } from "lightning/messageService";

Declare the message context variable as shown below.

Declare variable example
@wire(MessageContext) messageContext;

Declare methods as shown below to get the Contact Point Address Id.

Declare methods example
subscribeToMessageChannel() {
        if (!this.subscription) {
            this.subscription = subscribe(this.messageContext, dr_lms,               (message) => this.handleMessage(message));
        }
    }

   handleMessage(message) {
        switch (message.purpose) {
            case " contactPointAddressId":
               // Call custom logic here 
               // message.payload will give Contact point address Id
                break;
        }
    }

The following is an example of the message format:

Message example:
{"purpose":"contactPointAddressId","payload":"8lW5Y000000Pz69UAC"}

Call a declared method in the connectedCallback method as shown below:

Call declared method
connectedCallback() {
        this.subscribeToMessageChannel();
  

Last updated