UPS OAuth 2.0 Authentication

On, or before August 2, 2024, UPS will terminate their existing authentication mechanism to OAuth authentication. Consequently, the following change is required within NetSuite to use the Shipping feature. All NetSuite customers using the UPS direct integration (not through Ship Central) will need to enable the OAuth mechanism.

Watch the following video for an overview of the UPS OAuth 2.0 authentication process:

To enable OAuth 2.0:

  1. Go to Setup > Accounting > Shipping.

  2. Set your shipping preferences.

    To learn more, see Setting Up Shipping.

  3. To use OAuth, check the Use OAuth for UPS Accounts.

  4. Click Submit.

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.

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

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

    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 on invalid shipper number” error will be displayed when you try to generate a label.

  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