1. Order Management
  2. Order Fulfillment and Shipping
  3. Shipping
  4. UPS
  5. UPS OAuth 2.0 Authentication

UPS OAuth 2.0 Authentication

Important:

NetSuite Ship Central is NetSuite's standard shipping solution. For more information, see NetSuite Ship Central.

The Shipping Integration with FedEx, UPS, and USPS/Endicia is not available to new customers. It is available with limited support only for existing customers before they transition to NetSuite Ship Central.

For more information about transitioning to NetSuite Ship Central, including the self-service procedure, see Upgrading from Integrated Shipping to NetSuite Ship Central (SuiteAnswers article 1015202).

UPS requires OAuth 2.0 as the only supported authentication method. All NetSuite customers using the UPS direct integration (not through Ship Central) must authenticate with UPS using OAuth 2.0 to continue rating, creating shipments, printing labels, and tracking packages.

OAuth 2.0 authorizes NetSuite to call UPS APIs on your behalf for activities such as rate quotes, shipment creation, label generation, and tracking updates tied to your UPS account.

During setup, you sign in to UPS.com and consent to connect your UPS account. UPS issues tokens (access/refresh) to NetSuite. NetSuite securely stores and uses these tokens for UPS API requests. Tokens can expire after periods of inactivity per UPS policy and may need regeneration.

To verify your account's OAuth 2.0 status:

  1. Go to Setup > Accounting > Shipping.

  2. On the Carrier Registration tab, verify that the OAuth column for your UPS account shows Yes.

To add a UPS account:

  1. Go to Setup > Accounting > Shipping.

  2. In the Carrier Registration subtab, click Add UPS Account.

  3. On the message box directing you to an external website (UPS) for authentication, click OK.

  4. On the UPS Log In page enter your UPS username for the email associated with your UPS account.

  5. Check the UPS Technology Agreement box and then click Continue.

  6. Enter your UPS Password and then click Log In.

    You will be redirected to the NetSuite UPS Developer Kit Registration page.

  7. Complete and then Submit the UPS Developer Kit Registration page.

    To learn more, see Registering a UPS Account.

    Important:

    The UPS account number you add here should also be present in the UPS.com account used for authentication. You can find this number in Account and Payments section of your ups.com account.

    If the account number added in NetSuite does not match with the account number in the ups.com account, a 'Missing or invalid shipper number' error will be displayed when you try to generate a label.

    If successful, the UPS Developer Kit Registration page Registration Successful page opens.

    The UPS Tokens are generated as part of the OAuth workflow.

  8. The new account is displayed in the Set Up Shipping page, Carrier Registration subtab.

  9. If the Carrier Account is using OAuth, the new OAuth column displays Yes.

To edit an account:

Editing is not permitted in the UPS Developer Kit Registration page editing.

To delete an account:

  1. In the Carrier Registration subtab, select the account you want to delete.

  2. Click Actions > Delete.

Regenerate Tokens

The Regenerate Tokens feature enables you to regenerate UPS tokens for an existing account and avoid having to delete and re-register your account.

You will need to regenerate tokens when they expire after 60 days of inactivity.

To regenerate a token:

  1. In the Carrier Registration subtab, select the account you want to regenerate tokens for.

  2. In the UPS Developer Kit Registration page, click Regenerate Tokens.

    You will be redirected to an external website (UPS) to authenticate and then redirected back to the UPS Developer Kit Registration page.

  3. Tokens are then regenerated as part of this work flow.

Related Topics:

General Notices