This guide will assist you in preparing your Squarespace shop so that ReturnPilot can connect to it and import your orders and products.

Do not connect your shop before reading this guide in full.

Introduction

Before you begin, it is important to note that Squarespace and ReturnPilot are distinct platforms that operate and manage data differently. As such, you will need to ensure that your shop meets the integration requirements contained in this guide. Failure to do so will lead to import errors.

Please also note that no import process is guaranteed to be perfect as we do not set the requirements on the data that you provide to Squarespace.

ReturnPilot may encounter data that is missing, invalid or incompatible. In these situations, ReturnPilot may make some changes in order to attempt a successful import. To learn more this, see the import disclaimer below.

Availability

The Squarespace integration is now in public beta. You may occasionally encounter issues that prevent ReturnPilot from importing your orders and products. If you encounter any issues, then please contact us.

How it works (data synchronization)

In order for ReturnPilot to provide return support to your customers, it will import the following data from your Squarespace shop:

• Order information (including line items and addresses).
• Product information (including variants, dimensions and weight).

No other data is imported.

In addition, ReturnPilot does not synchronize any new data it creates back to Squarespace, this is because such an action is not necessary in order for ReturnPilot to provide its required functionality.

In other words, data transfer is only one-way (from Squarespace to ReturnPilot).

Products

This section is divided into two sub-sections:

• Requirements (the fields and data your products must have).
• Information (additional product details to be mindful of).

Requirements

All physical (non-digital) products must have the following:

• A unique SKU (less than 30 characters long).
• A name.
• A price.
• At least one tag.
• A length (between 4 and 50 inches).
• A width (between 4 and 50 inches).
• A height (between 1 and 50 inches).
• A weight (between 1 and 50 pounds).

ReturnPilot will automatically interpret your shop's measurement system (imperial or metric), so you don't need to specify this for dimensions and weight. Simply provide the numbers for these fields.

Information

• Returns are not supported for digital products.
• Dimensions or weights that exceed the above limits will be changed to the max limits in order to be imported. Since this data is only used to make package size recommendations to the customer, this should not be a problem. The customer still retains the right to make an informed decision about the number and size of packages.
• Despite including categories for page organization, these categories are not made available to ReturnPilot. Therefore, ReturnPilot will use the product's first tag as its category.
• Squarespace doesn't allow you to indicate whether a product can be returned. Therefore, ReturnPilot assumes that all physical products can be returned. If you have products that cannot be returned, add them to ReturnPilot via the website (either one at a item or via CSV import). You are strongly advised to do this before publishing the products on your Squarespace shop.

Orders

This section is divided into two sub-sections:

• Requirements (the fields and data your orders must have).
• Information (additional order details to be mindful of).

Requirements

Note these requirements only apply if you import third-party sales channel orders into Squarespace. If customers only order through the Squarespace shop and checkout, then all required information should be present.

All orders must have the following:

• A unique order number / reference.
• A customer email address.
• A shipping address first and last name.
• A shipping address first line.
• A shipping address town or city.
• A shipping address region (state or province).
• A shipping address post or zip code.
• A shipping address country.
• One or more line items, each of which must have a product SKU.

Information

• Order numbers are prefixed with "SQ-" in order to differentiate them from other channels e.g. website, API, or another integration.
• Orders containing only non-physical products will be ignored.
• Orders containing a mix of physical and non-physical products will be processed, however only physical products will be imported.
• ReturnPilot will only import the first 100 line items (that correspond to physical products) within an order.

Import disclaimer

Sometimes, imported data may exceed the maximum size that a certain field permits. In these situations, ReturnPilot will trim the excess to ensure that it fits. This will usually not impact how ReturnPilot operates.