3B2C
Overview
Comment - I'll write the overview at the end.
Inter-Company Price
The following table shows information about the inter-company price. Each link refers you to the procedure describing how to set the product price for duties for each of supported platforms: Comment: Are all of these platforms below supported? If so, we need the internal documentation for each one.
Platform | Field | MAS to Configure |
---|---|---|
Comment: Need field for each one. | Comment: Need MAS for each one. | |
Full GEM | ||
Hybris | ||
M2L - GEM | ||
Magento Full | ||
| ||
Shopline | ||
Shopware | ||
Wix | ||
Configuring Product Price for Duties
Global-e supports the following platforms: Comment - I'll add the rest after the following two have been reviewed and approved.
Comment: SFCC has a requirements section, but the other platforms do not. Is this correct?
Comment: Is this the full list of supported platforms?
Comment: I don't think we need this page as long as we have the Inter-Company Price page.
BigCommerce
This page describes how to configure BigCommerce to enable receiving prices for duties. The value is PriceForDuties
.
Navigate to Products > All products in the Admin panel.
Select a relevant product and click Custom Fields. Comment: It isn't clear from this screenshot where the user selects a product. Can you please provide a screenshot (with no callouts) that shows where the user selects a product?
Click Add Custom Fields.
Set the Custom Field Name as PriceForDuties.
Caution
Verify that you have mapped the Global-e admin the MAS
BigComm_OriginalMerchantPriceForDuties
with the value of the custom field you added (PriceForDuties).Set the Custom Field Value as the price value in the merchant's currency (such as 10).
Click Save.
Centra
Need procedure.
Configuring the Magento 2.x. Lite Platform
This page describes how to configure the Magento 2.x. Lite platform to enable receiving PriceForDuties in Products.MetaData.Attributes in GetCart.
Comment: Please provide image of the platform's main screen.
In the Attribute Information menu on the left, click Properties.
In the Attribute Properties section, define the following:
Default label (mandatory)
Catalog input type for store owner
Values required
In the Advanced Attribute Properties section, define the following if needed: Comment: are these mandatory?
Attribute Code
Scope
Default value
In the Name field, define the attribute set name.
Assign the new attribute to an attribute set. Comment: the user should select here only PriceForDuties?
Assign the attribute value to a product. Comment: In other words, fill out all the fields?
In the Configuration menu, define the following: Comment: How does the user get to Configuration? I.e., where is it on the GUI?
Extra Product Attributes - PriceForDuties
Extra Product Attributes From Simple - name,PriceForDuties
Flush the Magento cache. Comment: How is this done?
PriceForDuties is displayed in Products.MetaData.Attributes in GetCart.
PrestaShop
This page describes how to configure PrestaShop to enable receiving priceforduties in Products.MetaData.Attributes when you use GetCart.
Comment - General comment: I generally include screenshots only when an action is not intuitive. I generally don't include screenshots for two reasons: 1) They require regular maintenance whenever a GUI is modified, and 2) they break the flow of a procedure and take up a lot of space. Users typically are following the documentation side-by-side with the GUI so they don't need to see a screenshot in the procedure. Please confirm.
In the left menu, navigate to Attributes & Features and click Features.
Define the following: Comment - Are Meta title and Indexable mandatory?
Name
URL
Meta title
Indexable
In the left menu, click Products.
In the Features menu, select a feature for all products. Comment - Do they have to set anything else, such as Pre-defined value, etc?
In the left menu, in the IMPROVE section, expand Modules. Comment - Do they select Marketplace or Module Manager to get to this screen?
Configure the module with the following values:
Secondary Product Code - EAN13 or JAN barcode
Product extra meta data - PriceForDuties
Clear the cache.
In GetCart, the
Products.MetaData.Attributes
parameter is set topriceforduties
. Comment - The figure below shows that the AttributeKey, not Products.MetaData.Attributes, is set to priceforduties.
Salesforce Commerce Cloud
This page describes how to configure SalesForce Commerce Cloud (SFCC) to enable passing product wholesale prices when you use the SendCartV2 payload object.
Requirements
Wholesale product prices available on the platform side (in the merchant's base currency).
The SendCartV2 Dynamic Attribute Mapping feature (cartridge version 24.1.0 and higher).
Additional configurations to the merchant account. Comment - Are these additional configurations described somewhere?
Configuring the Product Wholesale Prices
You can use either of the following attributes for configuring their product wholesale prices:
Note that if you define a product wholesale price in both the Product Custom and the Price Book attributes, SFCC assigns priority to and uses the Product Custom attribute.
For more information on the attribute preference logic, see Attribute Preference Logic.
For more information about the globale.getSendCartProductOriginalMerchantPriceForDuties
attribute, see globale.getSendCartProductOriginalMerchantPriceForDuties.
Configuring the Product Custom Attribute
Merchants may use the Product Custom attribute for storing product wholesale prices. Such merchants must configure it using the site's custom preference geProductWholesalePricePropName.
Navigate to Merchant Tools > Site Preferences > Custom Site Preference Groups > Global-e Product Settings.
In the Value column type wholesaleBasePrice.
Configuring the Price Book Attribute
Merchants may use the Price Book attribute for storing product wholesale prices. Such merchants must configure it using the site's custom preference geProductWholesalePricePriceBookID.
Navigate to Merchant Tools > Site Preferences > Custom Site Preference Groups > Global-e Settings.
In the Value column type base-wholesale-prices.
Attribute Preference Logic
If you define a product wholesale price in both the Product Custom and the Price Book attributes, SFCC assigns priority to and uses the Product Custom attribute.
The code snippet below shows the productWholesalePrice
set in both the Product Custom and Price Book attributes:
/** * Retrieves the original merchant price for duties of a product line item. * This function attempts to determine the wholesale price of a product * either through a custom attribute or a specific price book entry. * If neither is available or an error occurs, it defaults to null. * * @param {Object} target - The target object, currently not used. * @param {Object} source - The source object containing a productLineItem. * @returns {number|null} - The product's wholesale price or null if unavailable. */ function getSendCartProductOriginalMerchantPriceForDutiesFb(target, source) { var globaleHelpers = require('*/cartridge/scripts/helpers/globaleHelpers'); var logger = globaleHelpers.getLogger(); var pli = source.productLineItem; var productWholesalePrice = null; try { var wholesalePriceProductCustomAttributeID = globaleHelpers.getPreference(globaleHelpers.preferenceKeys.geProductWholesalePricePropName) || null; if (wholesalePriceProductCustomAttributeID && pli.product && pli.product.custom[wholesalePriceProductCustomAttributeID]) { productWholesalePrice = Number(pli.product.custom[wholesalePriceProductCustomAttributeID]); } var wholesalePricePricebookID = globaleHelpers.getPreference(globaleHelpers.preferenceKeys.geProductWholesalePricePriceBookID) || null; if (productWholesalePrice === null && wholesalePricePricebookID && pli.product && pli.product.priceModel) { var wholesalePricePricebookPrice = pli.product.priceModel.getPriceBookPrice(wholesalePricePricebookID); productWholesalePrice = wholesalePricePricebookPrice.isAvailable() ? wholesalePricePricebookPrice.getValue() : null; } } catch (e) { logger.error('getSendCartProductOriginalMerchantPriceForDutiesFb: {0}', logger.message(e)); productWholesalePrice = null; } return productWholesalePrice; }
Shopify
This page describes how to configure the Shopify platform to enable receiving PriceForDuties. To do this you must configure the MAS (MerchantAppSettings) as described in this section. In addition, merchants must add the Cost Per Item value in their own back offices.
Activate the
Shopify_DeclareLowerPriceForCustoms
parameter by setting it totrue
.Shopify_DeclareLowerPriceForCustoms = true
Verify that the merchant has added the price (Cost Per Item) per variant:
In the Shopify admin panel click Products.
Select a product and a product variant:
In each variant set the Cost per Item:
Configuring the WooCommerce Platform
This page describes how to configure the Magento 2.x. Lite platform to enable receiving Priceforduties in Products.MetaData.Attributes in GetCart.
In the x menu, click Products.
In the Attribute section, define the following:
Name
Slug
Enable archives
Default sort order
Assign the attribute value for a product. Comment - Does the merchant need to select a product and then assign the attribute value for it?
Click WooCommerce and define the following Global-e module configurations:
API Base URL - https://connect.bglobale.com/
Include mode - GEM
Global data cookie name - GlobalE_Data
Meta data product attributes - priceforduties
In GetCart, the
Products.MetaData.Attributes
parameter is set topriceforduties
. Comment - Please provide a larger picture.