UPS shipping Oauth method

 

Description

This screen enables you to edit the UPS OAuth shipping method options. Shipping methods will be filtered on checkout based on the zone you set for them, if any. Then, they will be displayed to the user for him to choose which shipping method he prefers for his order.

Note that before you configure the UPS OAuth plugin, you first need to register on UPS's website, create a shipper account in your UPS account, and then create an App with access to the Authentication API, the Rating API and the TimeInTransit API.

 

Toolbar

ship method Toolbar

 

  • Save & Close : Save the shipping method options and return to the shipping methods Management screen.
  • Save : Apply the modifications to the shipping method and stay on the same screen.
  • Cancel : Return to the previous screen without saving the modifications.

 

Main Information

If you use one of our commercial versions, you will be able to enter the name and description in different languages. This feature can be activated in the configuration page. If you don't enter something for a translation, it will just use the default information in the Main information tab instead. After you click on save or apply an additional publish icon will appear next to the fields where you entered something in the languages tabs so that you can easily enable or disable them. The default publish status can also be changed in the configuration page of HikaShop.

 

Specific Configuration

  • ENVIRONMENT : Select among Product or Customer Integration Environment in order to process tests.
  • Client ID: The Client ID of the app you created in your UPS account (learn more here)
  • Client secret : The Client secret of the app you created in your UPS account (learn more here)
  • UPS account number : Unique UPS shipper account number provided by UPS once you create a shipper account with them (learn more here).
  • Name : The name associated with the address below
  • Address line: the address line of the place from where you'll ship your products, meaning number, and street line.
  • City: The city name of the place from where you'll ship your products
  • Post code : The post code of the place from where you'll ship your products.
  • State code : The 2 letters code of the state of the place from where you'll ship your products.( For example CA if you're based in California, USA )
  • Country code: The 2 letters code of the country of the place from where you'll ship your products ( For example FR if you're based in France )
  • Pickup type: Choose here your pickup type in the list. (Prices will vary based on the pickup type)

 

    Shipping services :

    UPS offers many Shipping services in order to best match your constraints and needs!
    In order to learn which services you have to use learn more with this UPS Documentation.

 

  • Weight unit : Select among KG (Kilogramm) or LB (Pounds).
  • Negotiated rate : If you have negotiated rates with UPS, you can share or not theses rates with your customer.
  • Saturday shipping : Your UPS user ID on the UPS website (This is the ID you are logged with).
  • Group packages : If this option is activated, products will be grouped together. Otherwise, every product will have its own package (more expensive).
  • Show ETA ? : Select if you want to display the estimated time when a package or delivery should arrive at its destination (Estimated Time of Arrival).
  • Include prices :: If this option is activated the price of goods is given to UPS so that it can add the shipping insurance in the prices (more expensive).
  • Exclude dimensions : If this option is activated your packages will be sent without any dimension but with a weight.
  • Weight approximation : You can add here a percentage to the weight of your products.
  • Dimension approximation : You can add here a percentage to the dimensions of your products.
  • Debug : If you have troubles with the shipping method, activate this option, reproduce the issue, and then check the "payment log file" of the HikaShop configuration. It should contain debug information to better understand what's going on.

 

Restrictions

You can set restrictions on shipping methods. Based on the products in the cart of the user, the system will calculate which shipping methods the customer can choose from.

  • Zone: You can restrict a shipping method to a zone. By clicking on the edit icon, a popup will open enabling you to select a zone. Only customers with a shipping address in the selected zone (or its sub-zones) will see this shipping method. You can remove this limitation by clicking on the delete icon.
  • Warehouse: You can restrict the shipping method to one or more warehouses. You can also choose whether the filter is inclusive ("Only these warehouses") or exclusive ("All except these warehouses") using the radio buttons next to the selector.
  • Minimum price: The shipping method will only be available for orders with a product total above this minimum price.
  • Maximum price: The shipping method will only be available for orders with a product total below this maximum price.
  • Include virtual products price: If you activate this option, the price of virtual goods (products without weight) is taken into account for the maximum and minimum price restrictions above as well as the percentage price calculation. Otherwise, only physical goods (with a weight) are taken into account.
  • With tax: When enabled, the minimum and maximum price restrictions use the product prices including taxes. When disabled, they use the prices excluding taxes. Enabled by default.
  • Minimum quantity: The minimum number of items in the cart for this shipping method to be available. The quantity is calculated as the sum of the quantity of each product in the cart.
  • Maximum quantity: The maximum number of items in the cart for this shipping method to be available.
  • Minimum weight: The minimum total weight of the cart for this shipping method to be available. The weight is calculated as the sum of each product's weight multiplied by its quantity. You can select the weight unit next to this field.
  • Maximum weight: The maximum total weight of the cart for this shipping method to be available.
  • Minimum volume: The minimum total volume of the cart for this shipping method to be available. The volume is calculated from the width, height and length of each product multiplied by its quantity. You can select the volume unit next to this field.
  • Maximum volume: The maximum total volume of the cart for this shipping method to be available.
  • Post code RegEx: A regular expression to match against the customer's postal code. Only customers whose postal code matches the expression will see this shipping method. For example, ^(75|92|93|94) to match postal codes starting with 75, 92, 93, or 94.
  • Prefix: You can restrict the shipping method to only postal codes starting with this prefix.
  • Min. postal code: You can restrict the shipping method to only postal codes within a numeric range, whereby this is the minimum value.
  • Max. postal code: The maximum value of the postal code numeric range.
  • Suffix: You can restrict the shipping method to only postal codes ending with this suffix.

Access Level

You can restrict which Joomla user groups can see and use this shipping method. By default, the shipping method is available to all user groups. Select specific groups to limit access. This is useful if you want to offer specific shipping options only to certain customer groups (e.g. wholesale customers, VIP members).