# Introduction

<div align="left"><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FudOVN8snasyAWc90MYpp%2FCreate%20and%20void%20shipments%20Display%20live%20rates%20Add%20unlimited%20UPS%20accounts%20Pickup%20and%20tracking%20Bulk%20prints%20International%20forms%20Free%20updates%20No%20annual%20fees%20(2).png?alt=media&amp;token=bffb0b0c-dd44-4d06-a702-5f20330967ca" alt=""></div>

iBen UPS Labels and Live Rates is an all-in-one WordPress/WooCommerce plugin that automates your UPS shipping and tracking. If you are looking for the easiest and most proficient way to incorporate UPS (United Parcel Service) shipping with your WooCommerce Store, **iBen UPS Labels and Live Rates for WooCommerce** is your one-stop solution.

### BUY HERE

{% embed url="<https://codecanyon.net/item/woocommerce-ups-label-live-rates/35906546>" %}


# Description

* Generate forward or return shipments, and print labels through your WooCommerce dashboard with a single click.
* Fetch live UPS public or negotiated rates, and display on cart and checkout according to user’s cart content.
* Have full control of complete shipping data for each order before it is sent to UPS servers.
* Speed up your online store’s ordering process and optimize your procedures to grow your business.

**iBen UPS Labels and Live Rates for WooCommerce** is designed to meet the needs of growing businesses as well as large online stores with a heavy inflow of orders.

* It’s fast
* Ergonomic
* Does not burden the loading speed

Completely automate your UPS shipping and tracking with iBen UPS Labels and Live Rates plugin for WooCommerce, and have peace of mind.

* No Annual Fees
* Free Updates Forever

### **Key Features** <a href="#item-description__key-features" id="item-description__key-features"></a>

* Display live and Negotiated UPS rates on checkout
* Create pickup and void a shipment
* Create and print Label of an individual shipment
* Create bulk shipments of selected orders and combine labels into 1 file
* Create return shipment and print label with a single click
* Re-download UPS labels
* Utility to print single labels in custom sizes etc A4, A5, A6
* Utility to print bulk selected orders in up to 4 in A4, up to 2 in A5, and up to 1 for A6
* Automatically send emails with tracking numbers
* Print commercial invoice, Packing, list, NAFTA
* Review shipping and get rates before finalizing shipment
* Get available UPS access points. Send the shipment to an available access point near to you
* Check the delivery status of all shipments manually or automatically

### **Tech Advantage** <a href="#item-description__tech-advantage" id="item-description__tech-advantage"></a>

* Easiest to use
* Simple and clear interface
* Shortcodes supported for customization
* Ajax-based
* Quick response time
* Very light, doesn’t impact the backend performance
* Debug system and tool integrated to send diagnostic report to iBen support
* Accessible, desirable, and friendly UX
* Unlimited UPS accounts
* Different settings for each account
* Address classification for US/PR only
* Easy to switch from one account to another
* International forms supported
* Reduce to a minimum of any mistakes
* Helps you upgrade the ordering process of your WooCommerce store
* Bird’s eye view of shipments history in the dashboard for better management
* Six months support included in the price
* Extended support is available for an additional cost.

&#x20;


# Screenshots

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FNHme0i7Ye4bvJwad1Xz3%2Fiben%20UPS%20Woo%20Settings2.png?alt=media\&token=f4f7d275-e286-4a3a-84fb-52997c6bec7f) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FJylIRWpFYuMTXnb39t91%2Fiben%20UPS%20Woo%20Settings5.png?alt=media\&token=1950ff5b-ad2b-4037-85f6-ef5a234d88bd) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FOCxP4SdDLhEPAkXuqJX7%2Fiben%20UPS%20Woo%20Settings3.png?alt=media\&token=9e38828f-734e-4cd4-9b51-24dcf193d7f4) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FtZUypzKLwnEq0rwYbf4X%2Fiben%20UPS%20Woo%20Settings9.png?alt=media\&token=81fa664a-8ce2-400b-8c6b-8f16b24c4745) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F5TFps4sVLauSDBFgwkmA%2Fiben%20UPS%20Woo%20Settings4.png?alt=media\&token=e98a63e4-69d3-4134-a24b-a11cb2f9783c) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FEBNUMmbylSNOJhkm418p%2Fiben%20UPS%20Woo%20Settings6.png?alt=media\&token=486ed1ec-8853-413d-93c8-8a2823164901) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FJospkjOLqAlUg8rQxoUD%2Fiben%20UPS%20Woo%20Settings10.png?alt=media\&token=85c84566-3a8f-4234-a730-43bdec5df87f) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FXPsoNPZzNZ0TRPnXS4si%2Fiben%20UPS%20Woo%20Settings11.png?alt=media\&token=88bc3d19-0a8b-4226-98c7-4930ed035da8) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FjEZ2TjNbxJurlUILl9uJ%2Fiben%20UPS%20Woo%20Settings13.png?alt=media\&token=b6801b68-c7ba-42ee-b484-8af404c1ec82) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F95UFE6PFoWlbYz52ibq2%2Fiben%20UPS%20Woo%20Settings12.png?alt=media\&token=34e80ef2-0195-4d2d-843a-c0f52a367467) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FcpiXVvs1Tss515OLUCMU%2Fiben%20UPS%20Woo%20Settings14.png?alt=media\&token=1a527de5-51a5-4a9a-9d6d-dde8ed77cc49) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FJ7ctwqX7skJzk0w4rMHl%2Fiben%20UPS%20Woo%20Settings15.png?alt=media\&token=c3f411e1-42a7-4f75-82c4-4baa801840d1) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F4GL8QZyFHgoIc56SMuX9%2Fiben%20UPS%20Woo%20Settings16.png?alt=media\&token=03531ddd-837e-4199-976c-3d9b9b8da7a1) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FutFx5posTVx6NlYPC2yH%2Fiben%20UPS%20Woo%20Settings1.png?alt=media\&token=0a4a342c-1161-43e3-8167-fa2f2236cc18) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FJ3BUw9t63E7ebB5jib8e%2Fiben%20UPS%20Woo%20Settings8.png?alt=media\&token=94bb221c-6921-477b-a2ac-e0de1b5449de) ![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FAkxJNxRYehxnfERbQqGR%2Fiben%20UPS%20Woo%20Settings7.png?alt=media\&token=f62bea25-3c44-4677-9d29-60e264d60b3e)


# Download and Installation


# Requirements

**WooCommerce** plugin installed and activated.

**Woo Products side:** Adding weight attributes to all the products is a prerequisite for the UPS plugin to work.

**Server-side:** Soap PHP extension must be enabled


# Download Plugin

In order to download the iBen UPS plugin, log into your CodeCanyon account and go to your downloads page.&#x20;

Here is where you will find all of your Codecanyon purchases. Find the iBen <mark style="color:red;">**UPS**</mark> plugin, click on the download button and select Installable WordPress file only.

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FrtvtLpIOe7whL47t0l8B%2Fdownload_plugin.png?alt=media\&token=13c15ec0-e8c3-48d9-a34d-56ac2a3bdf3f)


# Installation

#### Upload the downloaded file

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FqHeFWFsLrj9DiUxVgqP4%2FScreenshot%202022-01-23%20at%203.38.04%20PM.png?alt=media\&token=004eceda-092c-4b15-81be-4e300b64c6df)

#### Click the button "Install now"

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F2bK1IEo9JhgBh0aOibBj%2FScreenshot%202022-01-23%20at%203.38.37%20PM.png?alt=media\&token=9b25d4bf-7e5d-49d9-90f1-1eb81286739f)

#### Click the button "Activate plugin"

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FMVWDs6butAvjaigjf0No%2FScreenshot%202022-01-23%20at%203.39.06%20PM.png?alt=media\&token=70047f40-12b2-4485-9f5c-9d434c6676e6)

At this moment, you see two (2) notifications

The first notification is about License registration

The second notification is about zero UPS accounts.&#x20;

Let's register our license first. Follow "**Click here**" from the first notification

or go to Settings->Settings UPS-> License & Support (Tab)


# Register your license

**Go to your CodeCanyon downloads page again and download your purchase code**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FMNN7YBAoBtyF4jjWPMN2%2Flicense.png?alt=media\&token=730f3812-f3fa-4939-ae0a-93735107bc72)

#### Click "License certificate & purchase code (text)"

Open the txt file and copy the big number under the '**Item Purchase Code'** title

**Then paste it to the "License Code" field**

**Fill your codecayon email too**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FHdmofsC3IFGV3hGsrYoJ%2Flicense1.png?alt=media\&token=842820f8-440b-4c12-a707-53badcb0c6f5)

#### Click the button 'Activate'

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FnMJkf8gKuAXuxNfyDrBq%2Flicense2.png?alt=media\&token=755a936c-f8ef-4035-9fa7-c1e1dd23b388)

You probably see the license status as Valid and a vital tool if you need support "**Send diagnostic report**" form.


# Update UPS plugin

Available updates will be displayed below

**License registration is required** to install updates

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FZOlBzHHGpWRNErqdkVR8%2Fplugin-update.png?alt=media\&token=be59b2a5-ef3b-494c-bea7-a046434a2b90)


# Set your UPS account

#### **Click the link** "UPS accounts" from the plugin list

or click the link "Go to accounts list" from the 2nd notification

#### <mark style="color:red;">Functional buttons and features are hidden or disabled while at least 1 UPS account is not set.</mark>

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FMVWDs6butAvjaigjf0No%2FScreenshot%202022-01-23%20at%203.39.06%20PM.png?alt=media\&token=70047f40-12b2-4485-9f5c-9d434c6676e6)


# Receive UPS Client & Secret ID

**Step 1:** First we need to access the UPS Developer Portal: <https://developer.ups.com/>

Then we need to select '**Apps**' in the profile menu and click '**Add Apps'** once the Apps menu has opened.

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FmoxW4imkgJpU8EWUMzIH%2Fimage.png?alt=media&amp;token=08930717-2bf7-4f72-94dc-34f6c9e12010" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FMWchnY6nIAER7YqTr8Sh%2Fimage.png?alt=media&amp;token=f4548bb5-3168-465e-9ac6-8b2002ec066f" alt=""><figcaption></figcaption></figure>

**Step 2:** When adding a new App, select '**I want to integrate UPS technology into my business**' in the first dropdown menu and then select an **appropriate UPS Account** to associate with the new credentials.

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FF44zJ76VyaTlycHTAwMe%2Fimage.png?alt=media&amp;token=be84f381-8d35-44ff-8b56-357ee30fa239" alt=""><figcaption></figcaption></figure>

**Step 3:** Afterwards you can fill out your contact details as you see fit.

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FETkbzR3tleyt4lB9UFdq%2Fimage.png?alt=media&amp;token=4a0df08a-c0ef-4ff9-b746-2cfc8d3499b1" alt=""><figcaption></figcaption></figure>

**Step 4:** On the following page you can select which UPS Products to associate with the new API connection.

Select the following:

* **Shipping**
* **Tracking**
* **Paperless Documents**
* **Time in Transit**
* **Locator**
* **Pickup**
* **Rating**
* **Address Validation**

**OAuth should automatically be selected and be non-removeable, but if not automatically selected please do so.**

**If callback URL is required put this**\
[**https://yourdomain.com/wp-json/iben\_ups/v1/ups\_auth\_callback**](https://ups.ibenetos.com/wp-json/iben_ups/v1/ups_auth_callback)

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FdF524alzAzGFwiqWdNGZ%2Fimage.png?alt=media&amp;token=4dec6e19-54c0-4d98-a955-f7d61bd3c535" alt=""><figcaption></figcaption></figure>

**Step 5:** Once the Products are saved, you will be presented with the new App details.

Here we need to get the **Client ID** and **Client Secret**.


# Set UPS API key, shipper info, shipform info

#### Click Add new account

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FAZ0ywegOFiqTJDOXxVQI%2Fset_account1.png?alt=media\&token=f3a618d7-21c5-4738-bfcd-5634e05ea666)

#### Fill in your UPS account credentials

In this screenshot, you see Europe's relative UPS services. In case you choose the USA you will see different UPS services like the next screenshot

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F13uIyT3rObf3bnXiLDbx%2Fimage.png?alt=media&amp;token=f5f7311a-05d2-47d4-81b5-fe341836cf46" alt=""><figcaption></figcaption></figure>

#### Fill your Shipper info, Ship from Info, and pickup info

You can easily copy info if all the same

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FGvzBayEHqyKhrcybuRcH%2Fset_account.png?alt=media\&token=9e5d4c67-e134-43ee-8c2f-a6fd5aec0097)

#### Choose your metrics system

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FFU0SD1fXEPJ1IIdpm2s6%2Fset_account5.png?alt=media\&token=814dfd6f-b61d-4d12-8293-726b44bd9d69)

#### Choose your preferred packaging method

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FkVPYkN1hf3dIkF1L1TIx%2Fsettings_packaging.png?alt=media\&token=0fd845f6-65cf-4e57-9439-8ead1900c803)

for now, don't edit anything else

#### Click save account and you are almost ready!


# Ready to create shipments

At this point, you can create shipments and print labels.

First, let jump in the iBen UPS global settings

**Go to Settings-> Settings UPS**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FiiHeoWTtanZ6tzMBDWLd%2Fmain_settings.png?alt=media\&token=ba9d4924-344b-4232-a4f2-da432e85da04)

Make sure API mode is **Test** selected. All other settings leave them as they are for now.

Click the button at the bottom "**Save Changes"**

**Go to the orders list**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2Fn797iw8YXIizS4T0JMye%2Forders_list.png?alt=media\&token=2bf6dc54-626a-4414-89e9-aefd5389efc3)

**Find an order and click the button "Create a UPS shipment"**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FypIX7BPNM41fFITj7NPf%2Forders_list-create%20shipment.png?alt=media\&token=865f46f1-2b3d-4c62-9c10-97bdd0009ffe)

**If you want to Review it before creating the shipment, check the "Save edits & Review Shipping"**

**You will be able to see possible errors or Alerts.**&#x20;

**Our example**

**Has an alert:** A Delivery Area surcharge has been added to the service cos&#x74;**.**

&#x20;and

**Public rates:**  Rates are displayed as you see them on your UPS account at their official website.

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FDEIl3HFxLShErwAumAT4%2Freview_shipment.png?alt=media\&token=baf2ebae-c8a7-4119-8972-d3751e6a854c)

&#x20;**Click the blue button "Create UPS Label" to create and print the shipment.**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FDn5e5Ph2plKXmWaUslGb%2Fgenerated-shipement.png?alt=media\&token=7b13f3d4-7e6a-4913-9a33-5449f5a11511)

**iBen UPS plugin** has an excellent built-in feature to automatically resize/rotate and transform the original UPS label and export them to a PDF single file. More labels options can find in global settings.

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FlD1jJ9GWRfsa7vvDohgn%2FScreenshot%202022-01-23%20at%208.11.47%20PM.png?alt=media\&token=2e297794-505e-479b-b9ff-f05ff465a8dd)

**In our example, the first is what we received from UPS and Customised PDF is the feature we are talking about.**

**Here are our results**

![Original unformatted](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FxHczpDNHUOO8kvtJp64s%2Foriginal-label.png?alt=media\&token=91ea3e3c-c692-4847-a329-0e2b20921f92) ![A6 PDF - Portrait](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FkgN8ZIRFPC4hBhHw4gME%2Fcustommized-label.png?alt=media\&token=8922d47d-8ede-4328-aba5-d00b7aa40298)

### **All shipments can be found here.**

**WooCommerce->UPS Shipments**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FNhG35QNPrapnLeWrcmHW%2FScreenshot%202022-01-23%20at%208.15.30%20PM.png?alt=media\&token=243854e6-44c2-4abb-a738-19e8842f80d3)


# Set Live rates & UPS services


# Edit UPS services

#### Let's go to the UPS accounts list

Settings-> Settings UPS-> UPS accounts & Services (TAB) and click Edit account in Friendly name column

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FxbwpqhCGsN7YOV6e2peF%2Fedit-account.png?alt=media\&token=0fa241a3-1df6-4d52-88c5-061567dcc1cd)

So we will focus on the right sidebar as you see below

At the **UPS services & Live rates** section feel free to enable the UPS services that you desire to work within cart/checkout also in the backend too.

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FSg36j7Qq554OfFNQG323%2Fups-services.png?alt=media\&token=7214b818-b289-4537-bd5e-662563f814e0)

**Name:** Give a custom name&#x20;

**Price Adjustment %:** For percentage discounts. Use the minus(-) for negative adjustment.&#x20;

Example -70 = (**BASE -70%)**

**Price Adjustment +-:** For fixed amount discount. Use the minus(-) for negative adjustment.&#x20;

Example: -14 = **(BASE - 14)**

**Include/exclude selected countries:** You can disable or enable a specific UPS service for selected&#x20;

Countries

#### Continue to the next section

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F4ISdyRX0xbAJZtiP1G7Y%2Fshipping-zones-rates.png?alt=media\&token=3ba3fd69-dcf3-4e31-9b69-ba0df9691576)

**UPS rates adjustments by shipping zones** section is one of the most powerful tools relative to live rates. You have the ability to Adjust percent or fixed discounts for a specific Shipping zone and UPS service.

#### Continue to the next section

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FvD61nizEZaNzK83u7l6L%2Flive-rates-settings.png?alt=media\&token=9a318cce-71c1-4282-84f1-6ab6369ca769)

**Rates country availability:** Disable or enable live rates **feature** for specific countries

**Round UPS rates:** This will transform up or down UPS prices with 0 or 1 decimal&#x20;

**Ship to Residential. 3 available options**

1. **Indicate always as residential:** Will indicate the address as residential when it requests real rates. UPS charges a bit more for residential destinations.
2. **All as Non-residential and only validate (US/PR) destinations**. All destinations won't be set as residentials, but only for US/PR addresses after a validation request.
3. **All as Residential and then Partial validate (US/PR) ONLY:** All destinations will indicate as residentials but they will revalidate if is a US/PR address.

**Option 2 and Option 3.** An extra request is being executed to UPS API to get real-time results if an address is classified as residential or commercial. Only US/PR accounts can perform this validation. Please, if you don't have a US/PR account, use option 1 or 2; otherwise, it will make an additional request for no reason.

### Estimated Settings

**Enable UPS estimated time**

**Estimated time prefix:** Change prefix text

**Estimated time format:** Select date format

**\*\*Until what time do you deliver the same day?:** Until what time you will deliver the package if you receive it.

**\*\*Which days are you shipping? \*\*Specific days?**

\*\* Values are necessary for our algorithm to pass to UPS API when they pick up your package, so the estimated time is more accurate.

Probably you have noticed the red notice  <mark style="color:red;">**(UPS rates is disabled)**</mark>

#### Let's jump on our global settings

Go to Settings-> UPS Settings

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2Fu8gzQtDGN2xsVu7B2muy%2Fmain-settings-live-rates.png?alt=media\&token=956f0dd3-5623-46ad-8400-d4f15a3458a3)

#### Check the checkbox "**Enable live rates"**

Notification is disappeared <mark style="color:red;">**(UPS rates is disabled)**</mark>

Let's go to the front shop, add a product and go to checkout.

### <mark style="color:red;">IMPORTANT!</mark>

{% hint style="warning" %}
After these steps, **if live rates are not displayed, do the following:**

Go to Woocommerce->Shipping->(iBen) UPS live rates

Confirm that **Enable** is checked and **CLICK "Save Changes"** in any way.

Even if was checked, please **click "Save Changes"**
{% endhint %}

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FxwD2VSqft07OB7TQjFO1%2Ffront-rates.png?alt=media\&token=522c4273-d73b-4123-b4f0-8330181da419)


# UPS Global Settings


# General settings

**API mode:** Test or Live.

**Debug mode:** By enabling this option, it will show **Debug categories** field. You can select specific parts of functions to log.

This option is a powerful tool for iBen support if you meet issues. The plugin will log various queries and valuable data in the WooCommerce log data section.

WooCommerce->Status->Logs (Tab)

Those logs can be sent automatically to iBen support if you go to the support section.

Settings->UPS Settings->License & Support->Send diagnostic report.

**Select default active section:** Select which section is active when going to create a shipment

**Enable creation in order list:** Enabled, you can create a shipment from the orders list. An extra column is displayed.

**Hide UPS account admin bar:** If you want to hide the widget from the admin bar. If you use multiple accounts, hiding the top bar widget is not recommended.

**Hide bulk actions from the order list**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F6PiYjorvnhYfy7jFXj50%2FScreenshot%202022-01-23%20at%208.29.16%20PM.png?alt=media\&token=12b6d6f5-40fa-40ce-8b2e-39f9c43d7839)

**Hide bulk print & combine**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FhHEEmTYZ4C0gHd4k2OZe%2FScreenshot%202022-01-23%20at%208.29.26%20PM.png?alt=media\&token=761906c1-2350-4659-a9f1-bffd13d9abac)


# Example - How to get debug logs for frontend UPS rates

Enable Debug mode and select front rates from the debug categories

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FqmDhLDBCh6irX9yl2KaG%2FScreenshot%202022-11-11%20at%208.30.45%20AM.png?alt=media&amp;token=ba0b7d45-5670-43c7-8a8d-41615d36f63a" alt=""><figcaption></figcaption></figure>

Go to frontend checkout and do a minor change in your address so woocommerce will provide none cached results

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F1c0AWsFMy5ySk6oemYLJ%2FScreenshot%202022-11-11%20at%208.35.35%20AM.png?alt=media&amp;token=018ed054-f5d3-4445-b330-b235e5a52f27" alt=""><figcaption></figcaption></figure>

after that go to WooCommerce->Status->Tool

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FgHPId73EcOlUHrybxEUR%2FScreenshot%202022-11-11%20at%208.37.35%20AM.png?alt=media&amp;token=40e7f0da-cc68-4fae-bbb3-2b7ed1ebc7e2" alt=""><figcaption></figcaption></figure>

you may see a newly generated log file iBen\_UPS\_Rate\_Front\_Calculate\_shipping\_

you can take a look at the log if you are familiar with it

#### How to send logs to our support system

Go to Settings-> UPS settings -> License & Support

<figure><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2Fkv7ZptD1K6nI9Rc5GSxg%2FScreenshot%202022-11-11%20at%208.39.56%20AM.png?alt=media&amp;token=c0b1acd6-9793-4eab-9c27-081deea3e46e" alt=""><figcaption></figcaption></figure>


# UPS Live rates

**Enable live rates:** This is the global option to enable live rates in your shop.

**Cache live rates:** For best performance is a good idea to cache very similar live rates queries


# Label size settings (Single Order)

**Label type:** PNG or GIF & ZPL or EPL

**Option PNG or GIF**

Export as PDF option

A6 - Portrait. Up to 1 voucher

A6 - Landscape. Up to 1 voucher

A5 - Portrait. Up to 2 Vouchers

A5 - Landscape. Up to 2 Vouchers

A4 - Portrait. Up to 4 Vouchers

A4 - Landscape. Up to 4 Vouchers

**Option ZPL or EPL**

Label Stock Size option

Height 6 - Width 4

Height 4 - Width 6


# Other features

### Enable loading UPS services dynamically

This option displays all available UPS services for a specific order.&#x20;

**For example.** The below image displays, all enabled UPS services from our UPS account.

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FXgRCkbqpl3foZXqyXjS5%2Fauto-load-ups-services-disabled.png?alt=media\&token=bb706fd9-b404-4688-87da-17fcef5c648d)

Although, some UPS services are not available depending on the origin and destination of an order.

Let's choose: Worldwide Economy DDP service.

**We get the following UPS error**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FgwEgwmnMO3xq8IyW6oPU%2Fups-unavailable-service.png?alt=media\&token=4275afc0-7508-46c7-bbd4-e57707e7c219)

To prevent this, lets **check "**&#x45;nable loading UPS services dynamically".

Now we see only available UPS services AND estimated time

<div align="left"><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FihwFZ8Z33Tn9AyqIjnBS%2Fauto-load-ups-services%20text.png?alt=media&amp;token=50b2dd53-b462-4c83-9eee-eee1ed589a73" alt=""></div>

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FNqPYjegK4vV3QeiAm197%2Fauto-load-ups-services.png?alt=media\&token=39b23e23-f3c7-4287-aa21-fcc5331d311e)

### Enable creation of an independent voucher/label

With this option enabled an extra button will be displayed on top of the orders list next to bulk actions.

**The creation of an indepedent** shipment is an extra build-in feature that allows you to create a forward or return shipment unrelative of an existing order.

<div align="left"><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2Fcl4LQUDuhrySElSNpmSj%2Fsingle-button.png?alt=media&amp;token=3dc98bb5-ac72-444e-aea1-73197d697380" alt=""></div>

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FJ1WFpwRD3mv6xhWSS8fP%2Fsingle-modal.png?alt=media\&token=ba413381-53b6-4837-8c6d-52074103cdc6)

### Enable Return Label

Enabling this option will display an extra section in the shipment creation called as "Return label"

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FAGdI1ILjimDsremHgFbs%2Freturn-feature.png?alt=media\&token=ef7d8867-daa0-4408-bee5-b8dd3da3586a)

### Enable Pickup feature

You can enable this option if you want to call UPS for your Pickup packages

Enabling this option an extra button called "**Create a PICKUP**" will be displayed in the top list of UPS shipments

Go to WooCommerce->UPS Shipments

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FunbpBV9OY1otjThRwwSl%2Fpickup-button.png?alt=media\&token=d44c78fa-fb40-470a-8881-f410e6ce62b0)

Select an order and click the button **"Create a PICKUP"**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FAe2G8UvWKtihHrDVmQjA%2Fpickup-modal.png?alt=media\&token=b9f9031b-52da-4906-9bea-9eac789afd29)

By clicking the PICKUP button, a modal window is showing

There are some useful details about the pickup you are going to sumbit.

Total of packages, weight and pickup address

#### Your pickup address is on your account page

Go to Settings->Settings UPS->UPS accounts & services (Tab)

Click accordion section ->Shipper info & Ship from

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FTzIb7yrTvNdDvllb9Dc5%2Fpickup-account.png?alt=media\&token=10c8b02d-8ed3-46a4-8885-b8ac2f8e32de)


# International forms

### Enable International forms

This is a global option to enable international forms when creating shipments manually or automatically

Enabling this you will see an extra section for international shipments as follows:

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FTTyXjRTXJjA1IFfWDCRo%2Finternational-order.png?alt=media\&token=33f01477-8513-4c23-93f5-0d7a56b676be)

On the current shipment, I Created the Shipment with Commercial invoice and NAFTA checked as the origin is US and Destination Canada

<div align="left"><img src="https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FcfXvd7UYBT5GNfIRMT4b%2Ftracking-invoice.png?alt=media&amp;token=ff5b926e-313c-449d-a462-c790278c2f7f" alt=""></div>

With 1 click I got the label and all commercial forms in 1 PDF

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FHSbtkB7Sa2qGjjjt83tq%2Fcommercial-pdf.png?alt=media\&token=1276c598-dbc7-4297-b9e3-a40470d7d4b4)

### International account settings

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FLScWlK0n1GbNqon4mWEW%2Finternational-accounts.png?alt=media\&token=a41c115c-5ca6-4731-983b-83dda6e2b25d)

### Enable product UPS fields

This field is recommended enabled if you want to use international forms as it will display extra fields in each product. Currently supports only simple and variable products

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FDp8rcYHidvkEueQaeb6R%2Finternational-product-fields.png?alt=media\&token=1652d971-9e99-43ca-8ded-93057975fc03)

You can set for each product

**H.S Tarrif**

**Product description**, if you want to use a different description than the product name

**Country of Manufacture**

**(NAFTA only) Net Cost Code**

**(NAFTA only) Net Cost Begin Date:**

**(NAFTA only) Net Cost End Date:**

**(NAFTA only) Preference Criteria**

**(NAFTA only) Producer Info**

### Enable restricted Articles fields

Enable this option if you want to display restricted products in your packages and need to inform UPS

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2Fhy6uGFzFixll5ZX5NnG3%2Frestricted-articles.png?alt=media\&token=605e9eef-1c96-4bf8-9f1b-357495e3c908)


# Tracking email settings


# Email settings

### Enable email tracking

Check to enable the feature to send tracking numbers to customer

Ensure that iBen email is enabled here too: **WooCommerce->Settings->Emails -> (iBen) UPS Order Tracking email**<br>

### Display checkbox of sending - Available Options

Hide checkbox and ALWAYS send tracking code email

Display checkbox as unchecked.

Display checkbox as checked - Recommended

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F7rDwjzQcB1NTOYJ9enYz%2Fsend%20email-checkbox.png?alt=media\&token=8d6f3b8a-a59e-4664-ac3f-3421960c16fa)

### Message in email:&#x20;

Write the text you want to displayed in iBen email

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FYsZRl0iGMqv3hqulB2xb%2Ftracking-code-message.png?alt=media\&token=de9a2328-e9f4-4b44-8457-5258e4c070dc)

#### **Preview inside email**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FR0KPowsbeC9ekvJwLLA8%2Ftracking-code-email-preview.png?alt=media\&token=9a4d051a-9021-48a8-a50b-9d0a4bdc6a81)

#### **Available Shortcodes: (Only for internal use on above message)**

\[iben\_ups\_tracking\_shipping\_first\_name] = First name of customer

\[iben\_ups\_tracking\_shipping\_last\_name] = Last name of customer

\[iben\_ups\_tracking\_code] = ZL4556544126

\[iben\_ups\_tracking\_service\_name] = UPS Sandard


# Global shortcodes for emails templates

**UPS tracking links**

This shortcode will return all UPS vouchers links for the specific order ID

```
[iben_ups_shortcode_tracking_number_link order_id = "xxx" prefix_text="TEXT BEFORE LINKS" suffix_text="TEXT AFTER LINKS"]
```

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FD1nAd6YsHgEao4QgP86q%2Fglobal-shortcode-email.png?alt=media\&token=4d7ca8c2-55b1-4c1d-b7a3-5a6f67a81efe)

**Preview in completed email**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2FseZXoXQ2p3zc9EIJ1CXz%2Fglobal-shortcode-preview.png?alt=media\&token=cc11020a-be3a-443a-b8b1-c94c4d886431)

**UPS tracing**

This shortcode will return the UPS tracing history for the specific order ID if shipments exist.

You need to pass **order\_id** argument. Optional is **locale**&#x20;

```
[iben_ups_shortcode_tracing_by_order_id order_id = "xxx" locale = "en_US" style="false"]
```

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F2CPvLDkiBa7nRzQIBBRy%2Ftracing-shotcode.png?alt=media\&token=2cc33a2f-279a-4a53-8e9a-642820fadce3)

**Preview**

![](https://2397728296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszXzUFVI6AemSIfbvaXs%2Fuploads%2F1G0Bvw7iNREAMrbLESLh%2Ftracing-shotcode-preview.png?alt=media\&token=0c3a046d-7e3a-40cb-bbe7-bc332fb97c37)


# Various actions

### Automatic actions after label created

**Change order status:** You can select the order status you want to be changed immediately after the shipment and label are created. It supports custom orders states

**Copy UPS tracking code:** After voucher  creation, the tracking number will be copied to the target fields.&#x20;

Enabling this option a new text field is displayed. In this fi

Fill class or ID name. For multiple targets separated by **|**  Include # for ID and . for css class in the prefix. Example for valid targets: #iben\_field\_name\_id | .iben\_field\_name\_class

**Example.** Probably you may have an extra plugin that you add the tracking number to a specific field, you click a button and your customer will receive an email about UPS shipping details, etc. For this case, this feature (**Copy UPS tracking code**) is good because it will automatically copy the newly generated number to this extra plugin.

### Check automatically shipments delivery

iBen ups have a built-in feature to track all your shipments packages and check if have been delivered.

**Choose running frequency:** Select the frequent time that this tool will run

**Select limit of query:** Select how many shipments will be checked each time

**Enable email notification:** Check if you want to be notified in your email for new delivered shipments

**Change order status:** You can select the order status you want to be changed immediately after the shipment has been delivered. It supports custom orders states

### Delete old generated PDF

By using the iBen UPS plugin various files are temporarily saved in your WP uploads folder to maximize the user experience.

These files are shipment labels, bulk combined PDFs, commercial invoices, etc.

It is very safe and preferred to delete those especially after a shipment has been delivered because you won't use them anymore.

This tool will keep your server files clean and prevent exceeding your quota space.

**Enable PDF deletions:** Check to enable this tool

**Enable for Combined too:** Check to enable this tool for combined PDFs too. (Recommended checked)

**Choose running frequency:** Choose how often to check for if there are available assets to delete

**Choose shipment statement:**

* All delivered shipments
* All delivered shipments except for last 1 week - Recommended
* All delivered shipments except for the last 2 weeks
* All delivered shipments except for last 1 month


# Custom functions

### Hide checkout live rates if country =  "Bulgaria"

```
if ( ! function_exists( 'iben_ups_skip_country_front_rates' ) ) {
    
    function iben_ups_skip_country_front_rates($default, $args){
        
        if (isset($args['destination']['country']) && $args['destination']['country'] == 'BG') return true;

        return $default;
    }

add_filter('iben_ups_filter_liverate_checkout_disable_request_rate', 'iben_ups_skip_country_front_rates', 10, 2);
}
```

### Change default account id for frontend live rates

```
if ( ! function_exists( 'iben_ups_change_default_account_id_front_rates' ) ) {
    function iben_ups_change_default_account_id_front_rates($account_id){
        // account ID
    	return 20;
    }
    
add_filter('iben_ups_filter_live_rates_default_account', 'iben_ups_change_default_account_id_front_rates');
}
```

### Change default weight to 0.5 for all products if didn't set or equal to zero

```
if ( ! function_exists( 'iben_ups_change_default_weight' ) ) {
    function iben_ups_change_default_weight($default, $args){

        return 0.5;
    }
    
add_filter('iben_ups_filter_get_package_default_weight', 'iben_ups_change_default_weight', 10, 2);
}
```

### Hide UPS Standard ( ID:11 ) if country is France and total weight > 10kg

```
if ( ! function_exists( 'iben_ups_disable_service_conditions' ) ) {
	function iben_ups_disable_service_conditions($boolean, $ups_id, $args){

		if (!isset($args['destination']['country']) || !isset($args['total_weight']) ) return true;

		if ($ups_id == '11' && $args['destination']['country'] == 'FR' && $args['total_weight'] > 10){
			return false;
		}

		return true;
	}

add_filter('iben_ups_filter_liverate_checkout_disable_service', 'iben_ups_disable_service_conditions', 10, 3);
}
```

### Hide shipment creation box for specific countries

```
if ( ! function_exists( 'iben_ups_except_display_countries' ) ) {
	function iben_ups_except_display_countries(){
		return array('US', 'GR');
	}
add_filter('iben_ups_filter_order_except_display_countries', 'iben_ups_except_display_countries');
}
```

### Override final UPS rate price. Add 24% percent

```
if ( ! function_exists( 'iben_ups_override_final_price' ) ) {
	function iben_ups_override_final_price($ups_price, $args){
		
		return $ups_price * 1.24;
	}
add_filter('iben_ups_filter_liverate_checkout_price', 'iben_ups_override_final_price', 10, 2);
}
```

### Override Fallback price

#### If country is Bulgaria and total weight <= 1 price = 15 else price = 50 else if other country return default fallback price

```
if ( ! function_exists( 'iben_ups_override_fallback_price' ) ) {
	function iben_ups_override_fallback_price($default_fallback_price, $args){
		
		$total_weight = 0;

		if ( isset( $args['destination']['country'] ) && $args['destination']['country'] == 'BG'){
			
			if ( isset( $args['packages'] ) && !empty($args['packages']) ){
				
				foreach($args['packages'] as $package){
					$total_weight = $total_weight + floatval($package['weight']);
				}
			}

			if ($total_weight <= 1 ){
				return 15;
			}else{
				return 50;
			}

		}

		return $default_fallback_price;
	}
add_filter('iben_ups_filter_live_rates_callback_price', 'iben_ups_override_fallback_price', 10, 2);
}
```

### Change UPS description with order customer notes

```
add_filter('iben_ups_filter_order_metabox_description', 'iben_custom_filter_order_description', 20, 2);
function iben_custom_filter_order_description($default, $filter_args){

    $order_id = $filter_args['order_id'];
    // Order Object
    $order = wc_get_order($order_id);
    if (!is_object($order)) return $default;

    $order_notes = $order->get_customer_note();

    return $order_notes;
}
```

### Add Order ID in the description field

This may not work for USA domestic shipments. Alternatively, you can use the next function

```
add_filter('iben_ups_filter_order_metabox_description', 'iben_custom_filter_order_id_description', 20, 2);
function iben_custom_filter_order_id_description($default, $filter_args){
	$order_id = $filter_args['order_id'];
	// Order Object
	$order = wc_get_order($order_id);
	if (!is_object($order)) return $default;
	
	$get_order_number = 'Order ID '.$order->get_order_number();
	return $get_order_number;
}
```

### Change the default reference1 of the label with the order ID

```
// CHANGE CHECKBOX TO TRUE AS DEFAULT VALUE
// Enabled checkbox by default for USA domestics
add_filter( 'iben_ups_filter_order_metabox_package_enable_reference1', '__return_true' ); 
// Enabled checkbox by default for international
add_filter( 'iben_ups_filter_order_metabox_enable_reference1', '__return_true' ); 

// CHANGE THE DEFAULT DROPDOWN VALUE
function iben_change_default_reference_value_with_po($default, $args){
	return 'PO';
}
// for USA domestics
add_filter('iben_ups_filter_order_metabox_package_reference_type1', 'iben_change_default_reference_value_with_po', 10, 2);
// for international
add_filter('iben_ups_filter_order_metabox_reference_type1', 'iben_change_default_reference_value_with_po', 10, 2);

// ADD ORDER ID AS DEFAULT VALUE IN THE TEXT FIELD
function iben_change_default_reference_value_with_orderid($default, $args){
	$order_id = $args['order_id'];
	// Order Object
	$order = wc_get_order($order_id);
	if (!is_object($order)) return $default;
	
	$get_order_number = 'Order ID '.$order->get_order_number();
	return $get_order_number;

}


// Fire filter for USA domestics
add_filter('iben_ups_filter_order_metabox_package_reference_value1', 'iben_change_default_reference_value_with_orderid', 10, 2);
// Fire filter  for international
add_filter('iben_ups_filter_order_metabox_reference_value1', 'iben_change_default_reference_value_with_orderid', 10, 2);
```

### Change the default reference1 of the label with product names&#x20;

```
// CHANGE CHECKBOX TO TRUE AS DEFAULT VALUE
// Enabled checkbox by default for USA domestics
add_filter( 'iben_ups_filter_order_metabox_package_enable_reference1', '__return_true' ); 
// Enabled checkbox by default for international
add_filter( 'iben_ups_filter_order_metabox_enable_reference1', '__return_true' ); 

// CHANGE THE DEFAULT DROPDOWN VALUE
function iben_change_default_reference_type1($default, $args){
	return 'AJ';
}
// for USA domestics
add_filter('iben_ups_filter_order_metabox_package_reference_type1', 'iben_change_default_reference_type1', 10, 2);
// for international
add_filter('iben_ups_filter_order_metabox_reference_type1', 'iben_change_default_reference_type1', 10, 2);

// ADD PRODUCT NAME AS DEFAULT VALUE IN THE TEXT FIELD
function iben_change_default_reference_value1($default, $args){
	$default_text_description = '';
	if ( function_exists( 'iben_ups_get_product_names_from_order_id' ) ) {
		$default_text_description = iben_ups_get_product_names_from_order_id($args['order_id']);
	}
	
	return $default_text_description;

}
// Fire filter for USA domestics
add_filter('iben_ups_filter_order_metabox_package_reference_value1', 'iben_change_default_reference_value1', 10, 2);
// Fire filter  for international
add_filter('iben_ups_filter_order_metabox_reference_value1', 'iben_change_default_reference_value1', 10, 2);
```

### Change order First name & Last name

By default, plugins fill first the Last name and then the First name

With the following function, you can revert the sorting

```
add_filter('iben_ups_filter_order_metabox_attention_name', 'iben_custom_change_order_name_lastname', 10, 3);
function iben_custom_change_order_name_lastname($attentionname, $filter_args2, $filter_args){
	
	return $filter_args2['first_name']. ' '.$filter_args2['last_name'];
}
```


