Upgrading to 2024-08-29

We are improving our exports process for SFCC, this will require SLAS credentials for our integration and a cartridge update.

You can create the required client credentials for us by following the SFCC documentation hereSpecially we need a private client which has sufficient scopes to use the createOrders API. This should be just be sfcc.ts_ext_on_behalf_of and sfcc.orders.rw

Once the client has been created you can add the new credentials in the Purple Dot integration settings page.

To fully benefit from this upgrade you will also need to upgrade your client to install some additional hooks which will ensure that the shoppers email address is set correctly on the order and also automatically set the confirmed flag and export status.

We will share both an updated copy of the cartridge code and also a Git repository so you can easily identify the changes between versions.

Changes

• SLAS client credentials are now required to export orders from Purple Dot to SFCC

  • This makes exporting easier and more reliable by decoupling it from the Basket in SFCC which means you can export orders even if the waitlist is closed, and will improve the accuracy of prices on the exported order.

• Order attributes

  • purpleDot_isRefunded has been removed, it was never set.

• Product Line Item attributes

  • purpleDot_waitlistId has been added.

  • purpleDot_shipDates has been removed.

• Orders will be automatically created with the following attributes

  • purpleDot_isPreOrdered: true

  • Confirmation Status: Confirmed

  • Export Status: Ready to Export

• Preorder line items will automatically have:

  • purpleDot_waitlistId: {The ID of the waitlist the item was assigned to in Purple Dot}

  • purpleDot_lineItemId: {The ID of the line item in Purple Dot}

• The default checkout mode is now express instead of separate bag.

Upgrade process

To upgrade to the new release you will need to follow this process

• Create a private SLAS client with the scopessfcc.ts_ext_on_behalf_of and sfcc.orders.rw for Purple Dot and save the client id and secret in your Purple Dot integration settings page.

• Upgrade the cartridge to the latest release. If you have modified the cartridge you can follow the diff in git to apply the required changes.

• In System Object Attribute settings find Product Line Items and remove the purpleDot_shipDates attribute. It was never used.

• In System Object Attribute settings find Orders and remove the purpleDot_isRefunded attribute. It was never used.