Introduction

Aurora's True Fit data feeds permit you to export your orders and returns to the True Fit system using full and incremental delta feeds. These are provided in XML format and are automatically uploaded to the True Fit SFTP location.

In order for you to start using the Aurora True Fit integration, you will need to coordinate with True Fit to setup your account and request your Brand ID and SFTP credentials that must then be entered into the Aurora True Fit integration settings.

Integration Settings

The Aurora True Fit integration settings can be found here: Store > Settings > Feeds > True Fit

This section will explain some of the options when configuring True Fit.

Export Full Purchase History and Returns Feeds

Once configured, you can begin by initiating full purchase history and returns exports from within the Aurora backend UI using the following export buttons:

When initiated, the export process will be scheduled and the button will be updated to reflect the current process status.

📘

A full export will limit the dataset to the last 2 years; this is calculated based on the previous full day minus two years inclusively.

For example, were the process to be run on the 14th November 2019, all transactions between the 14th of November 2017 and 13th of November 2019 inclusively will be exported.

👍

After initiating a full export, you should also set the incremental start date for the respective export to be the date that you initiated the full export. This will ensure that all subsequent purchases and returns are automatically exported by Aurora using incremental (delta) datasets.

Purchase History Hierarchy ID

The purchase history feed contains a hierarchy ID value that is determined based on the following purchased product information: 

• Product Gender Additional Field value
• Product Main Subcategory

A Main Subcategory can be explicitly set for each product using one of the following:

• Backend UI:
  • Edit Product > Categories > Main Subcategory
• Product Export/Import CSV tools:
  • Please see CSV Import Format
• Product Add/Update/Get APIs
  • Please see Aurora API: Product

📘

In the absence of an explicitly set value, Aurora will automatically attempt to identify a primary subcategory based on the deepest assigned subcategory within the products Main Category.

Data Feeds

The following feed specifications detail the source of each field and demonstrate the XML format of the both purchase history and returns feeds uploaded to the True Fit SFTP location.

Purchase History

Specification:

Sample

<?xml version="1.0"?>
<PurchaseHistory>
	<Purchase>
    	<Date>2017-02-05</Date>
    	<OrderId>889507</OrderId>
    	<CustomerId>67386</CustomerId>
    	<ProductId>47317</ProductId>
    	<ProductTitle>My First Product</ProductTitle>
    	<HierarchyId>Women/First Category/Second Category</HierarchyId>
    	<SKU>EAN221855</SKU>
    	<BrandId>TESTBRAND</BrandId>
    	<BrandProductId>REF47317</BrandProductId>
    	<Quantity>1</Quantity>
    	<Price>7.99</Price>
    	<Size>7</Size>
	</Purchase>
	<Purchase>
    	<Date>2017-02-05</Date>
    	<OrderId>889507</OrderId>
    	<CustomerId>67386</CustomerId>
    	<ProductId>44574</ProductId>
    	<ProductTitle>My Second Product</ProductTitle>
    	<HierarchyId>Women/Second Category/Third Category/Forth Category</HierarchyId>
    	<SKU>EAN207403</SKU>
    	<BrandId>TESTBRAND</BrandId>
    	<BrandProductId>REF44574</BrandProductId>
    	<Quantity>1</Quantity>
    	<Price>7</Price>
    	<Size>5</Size>
	</Purchase>
</PurchaseHistory>

Returns

Specification

Sample

<?xml version="1.0"?>
<Returns>
	<Return>
    	<Date>2018-05-16</Date>
    	<OrderId>889503</OrderId>
    	<CustomerId>2000</CustomerId>
    	<ProductId>56499</ProductId>
    	<BrandProductId>REF56499</BrandProductId>
    	<UPC>EAN277457</UPC>
    	<Quantity>1</Quantity>
    	<Price>9.99</Price>
    	<Size>13</Size>
    	<ReturnReason>Faulty</ReturnReason>
	</Return>
	<Return>
    	<Date>2017-02-05</Date>
    	<OrderId>889508</OrderId>
    	<CustomerId>3000</CustomerId>
    	<ProductId>53530</ProductId>
    	<BrandProductId>REF53530</BrandProductId>
    	<UPC>EAN259198</UPC>
    	<Quantity>1</Quantity>
    	<Price>9.99</Price>
    	<Size>8</Size>
    	<ReturnReason>To small</ReturnReason>
	</Return>
</Returns>