UPS (OAuth) integration

Modification of parcel stamp via reference fields

Use of the cash on delivery service

Volume weight calculation

Deactivation of address validation

Designation → Freely select a designation for the shipping method. This is displayed in xentral among others in the order for selection in the drop-down menu

Type → Specify the type/field description. You can generally choose this as long as it is not necessary for the store mapping or other mappings. Ideally, you should keep the default setting

Module → Select UPS (Oauth) from the drop-down menu

Project → Optionally select a project, provided that a separate UPS shipping type is created for each project

Active → Check the box to activate the shipping method and make it visible and usable

No postage check → By checking this box, no postage check will be performed in the order

Printer parcel label → Select from the drop-down menu the default printer that prints the parcel labels

Printer Export → Select from the drop-down menu the default printer that prints the export documents

Shipping Mail → From the drop-down menu, select the behavior of the shipping mail. "Default behavior" means that a default tracking mail will be sent, "no shipping mail" means that no tracking mail will be sent for this shipping type, and "custom text template" means that a custom shipping confirmation text template will be used for this shipping type, regardless of project and logistics process

UPS Oauth Connection → The adjacent button has two functions: If it displays Connect, you can click on it to Connect the UPS interface as described above. If it displays Info, you can click on it to get information about your UPS OAuth account and revoke access to the API, if needed.

Account Number → Enter your UPS Account number. You can find it in your UPS account under My profile > Payment options.

Sender Name → Enter the name of the sender. This name must match the name in My Profile → My Information → My Addresses

Sender contact → Enter the name of the contact person on the sender's side

Sender Street → Enter the street of the sender

Sender house number → Enter the house number of the sender

Sender postal code → Enter the postal code of the sender

Sender city → Enter the city of the sender

Sender state → Enter the state of the sender

Sender Country → Enter the country of the sender using the two-digit ISO 3166-1 code, e.g. DE for Germany.

Sender e-mail → Enter the e-mail address of the sender

Sender phone → Enter the phone number of the sender

Sender Internet → Enter the website of the sender

Sender tax ID → Enter the tax ID of the sender

Default weight → Enter the default weight of your shipments. This will appear in the shipping dialog

Length → Enter the length of your standard items in cm

Width → Enter the width of your standard items in cm

Height → Specify the height of your standard items in cm

Standard Service Code → Enter the standard service code from the customer portal, e.g. "11"

Note

If you are using multiple UPS products with different service codes, you need to create a separate shipping method for each code.

Here is a list of the most common service codes:

• Express = 07

• Expedited = 08

• UPS Standard = 11

• Express Plus = 54

• UPS Saver = 65

• UPS Express 12:00 = 74

You can find a list of all service codes in the UPS developer documentation by expanding the Service section.

Standard Service Description → Enter the standard service description from the customer portal, e.g. "UPS Standard"

Standard Package Code → Enter the standard package code from the customer portal, e.g. "02"

Standard Package Description → You can enter the standard package description freely, e.g. "Customer Supplied"

Reference to Label 1 → Enter the text that appears on the package label. Optionally use the variables {Delivery note}, {Order}, {PROJECT}, {YOUR ORDER NUMBER} and {INTERNET}

Reference to Label 2 → Enter the text that appears on the package label. Optionally use the variables {Delivery note}, {Order}, {PROJECT}, {YOUR ORDER NUMBER} and {INTERNET}

Volume weight → By ticking, the volume weight is calculated from the dimensions and transferred

Deactivate address validation → By checking this box you deactivate the address validation by UPS, i.e. the address will not be checked by UPS

Export reason → Enter the export reason. You have to enter this reason only for foreign shipments.

Valid values for this field are: SALE, GIFT, SAMPLE, RETURN, REPAIR, INTERCOMPANYDATA, Any other reason. You can find further information in the UPS developer documentation. If you leave this field empty, SALE is entered automatically as the Export reason when a shipment is exported.

Logging → Check this box to log the output and response in an XML file, the file is located in the userdata/tmp folder

Apply tracking → If checked, the tracking number will be automatically inserted into the field after creating the parcel label and does not need to be scanned from the parcel label anymore

ZPL as output format → If this option is activated, the package label will be requested in ZPL format instead of PDF . ZPL (Zebra Programming Language) is a specific file format for Zebra printers. Important: ZPL files do not have a file ending by default and cannot be opened manually because they are directly processed by the label printer. If you want to check the content of a ZPL file, you can do so with a so-called ZPL Viewer (available online).

UPS Sandbox (test mode) → By checking this box you can test the package label printing with the UPS Sandbox. SAMPLE" will be printed on the package label

UPS Quantum View Notify → By checking this box you can use the UPS arrival notification