Consignor

Sana Commerce 9.3
Your connector

Create Consignor Shipping Methods

When Consignor is installed and configured, the list of the Consignor service types is automatically available to create Consignor shipping methods.

Create Consignor shipping methods

Step 1: In Sana Admin click: Setup > Ordering & checkout > Shipping methods.

Step 2: Click New item to create a shipping method.

The table below provides the description of the fields and settings that should be configured when you create Consignor shipping methods:

Fields and settings Description
Name Enter the name of the shipping method.
Enabled Enable / disable the shipping method.

You can also enable / disable shipping methods on the shipping methods list page.

External shipping method Map the shipping method to the one configured in your ERP system.

If the shipping method in Sana Admin is mapped to the shipping method in your ERP system, then when a customer places an order in the web store, the selected shipping method will be stored in the sales order in the ERP system.

See also:
Microsoft Dynamics NAV: Shipping Agents and Services
Microsoft Dynamics AX: Shipping Providers and Methods
Microsoft Dynamics 365 Business Central: Shipping Agents and Services
Microsoft Dynamics 365 for Finance and Operations: Modes of Delivery
Microsoft Dynamics GP: Shipping Methods
SAP Business One: Shipping Methods
SAP ERP: Shipping Methods

Image Add an image icon of the shipping method.

If you add an icon, it will be shown in the web store in the list of delivery methods.

Description You can add a description to the shipping method. Shipping method description is shown in the Sana web store on the "Delivery method" checkout step, where a customer can select the shipping method he or she wants his or her order to be delivered.
Link You can add a link to the external website or internal page that contains some additional information.
Calculation method Select Consignor.

The shipping costs are calculated by Consignor real-time depending on the Consignor service and product type, customer's shipping address / pickup location address, actual weight and dimensions of the package. 

    The Consignor calculation method is available only when the Consignor add-on is installed.

 

Set up the Consignor specific settings

The table below provides the description of the Consignor specific fields and settings that should be configured when you create a shipping method:

Fields and settings  Description 
Consignor good type  Enter a Consignor good type, for example Business-Parcel, Business-Pallet-Solution.

   In the Consignor admin panel, users can assign their own value as a label for referring to each good type, for example Business-Parcel: A, Business-Pallet-Solution: P.

   Currently, the value of this field is not validated. Therefore, make sure to enter the correct Consignor good type. 

Sana UOM  Select the unit of measure from the list available in Sana. The list of units of measure is retrieved from your ERP system. The selected unit of measure is mapped to the Consignor good type. 
Max height in millimeters  Use these fields to specify the maximum dimensions (in millimeters) and weight (in grams) of the Consignor good type. A user can also enter the maximum dimensions and weight in the Consignor admin panel.  

    You can use the maximum dimensions and weight only if Sana UOM is set to "None".  

Max width in millimeters 
Max length in millimeters 
Max weight in grams 
Actor id  Enter the actor ID. The actor ID identifies you, when you make requests to the web service. The actor id is created by Consignor, and contains all the information set up by Consignor. You can get the actor ID, when you become a Consignor Integrator.

The actor ID for the test environment is 63.

     Test actor ID does not work for the production environment.

See also:
Introduction to Consignor Shipment Server API
Getting Started with Shipment Server Integration 

Product  Enter the product ID of the shipping provider, which is configured in Consignor. This field is mandatory. For more information, see "Get the Consignor Product ID and Service ID". 
Service  Enter the service ID of the selected shipping provider, which is configured in Consignor. This field is optional. For more information, see "Get the Consignor Product ID and Service ID". 
Reference field id  Enter the reference field ID and its value which can be used to set up an additional field that can be sent to Consignor.  For more information about shipment object and fields, see the Consignor portal
Reference field value 
Extra charge percentage (%) 

You can set up an extra charge percentage for a shipment. The default value is 100%. For example, Consignor returned the shipping cost 10$:

  • If the extra charge is 100%, then it means that there is no extra charge and the shipping cost is 10$.
  • If the extra charge is 110%, then it means 10$ + 10% of extra charge = 11$.
  • If the extra charge is 90%, then it means 10$ − 10% of extra charge = 9$.
Get price from the field  Select which price to take from the Consignor response:
  • ListPrice
  • Price1
  • Price2 
Supports pickup locations 

     If you have multiple blocks of the Consignor specific settings, you can enable the option Supports pickup locations only in one block.

Select this checkbox, if the selected service of the shipping provider supports the drop point facility.

If a customer places an order in the Sana web store and selects a shipping carrier which supports pickup locations, he or she can select a pickup location instead of the shipping address.

The selected pick-up location is stored in the sales order in the ERP system.

For more information about where to find pick-up location in ERP, see:
Microsoft Dynamics NAV: Sales Order Data
Microsoft Dynamics AX: Sales Order Data
Microsoft Dynamics 365 for Finance and Operations: Sales Order Data
Microsoft Dynamics 365 Business Central: Sales Order Data
Microsoft Dynamics GP: Sales Order Data
SAP Business One: Sales Order Data
SAP ERP: Sales Order Data

Number of pickup points to show Enter the number of pickup points to show on the Delivery method checkout step in the Sana web store for the selected shipping method.

If you enter "0", then all available pickup points will be shown. 

Default email address for customer  This email is used only to get the shipping price from the shipping providers which require the customer e-mail address. 

 

Set up shipping origin

The table below provides the description of the fields and settings that should be configured when you set up shipping origin:

Fields and settings Description
Use custom shipping origin Configure the web store shipping origin:
  • If the option Use custom shipping origin is disabled, then the shipping origin will be retrieved from the ERP system. For the shipping cost calculation, the address of the warehouse that you ship from when delivering goods to the customer will be used. In case of anonymous web store visitor, the warehouse address of the template customer will be used.
  • If the option Use custom shipping origin is enabled, then the shop administrator should manually enter the web store shipping origin address. All shipping costs will be calculated based on this address.
Availability per country Select countries for which the shipping method should be available. If some country is not selected, the shipping method will not be available for delivery addresses in that country.
Customer segments

     Applies to: Sana 9.3.1 and higher

Assign customer segments. Using customer segments you can filter shipping methods. If you add a customer segment to the shipping method, then this shipping method will be available only to the customers that meet the criteria set in the customer segment. Other customers will not see this shipping method.

  • When you configure Consignor shipping methods, you should also take into consideration the requirements below. On the screenshot below you can see a block of Consignor specific fields and settings.

At least one block of the Consignor specific fields and settings must be configured for a shipping method.

  • One shipping method can have multiple blocks of the Consignor specific fields and settings. If you need to add more blocks, click on the Add button. If you want to delete a block, click on the Delete button .
  • You cannot enter the same Consignor good type in different blocks of one shipping method.
  • You cannot select the same Sana UOM for different products in one shipping method.
  • If in the Sana UOM field you select None, then it is required to enter maximum dimensions and weight.
  • You can enable pickup locations only for a single block of Consignor specific fields and settings.

The diagram below describes sample scenarios how you can select a product unit of measure and what possible shipping methods can be configured in Sana Admin.

The diagram below describes possible scenarios how shipping rates can be calculated when the option Supports pickup locations is enabled.