Introduction

This guide walks you through how to install and configure the 3PL app in TRAEDE. The 3PL app allows you to set up your own 3PL (third-party logistics) integration using webhooks or polling. It covers initial installation, data mapping, webhook setup, and shipment settings.

Video guide

How to install and configure the 3PL app

Step 1: Install the 3PL app

1. Navigate to App Store from your TRAEDE home screen.

2. Scroll down and locate the 3PL app.

3. Click the app, then click Install.

4. You’ll be redirected to the Settings page for the app.

Step 2: Set up data mapping (optional)

You can skip this section if you don’t use composition, origin, or tariff code fields. If you do, fill in the relevant custom fields:

• Composition field → e.g., Material

• Country of origin field → e.g., Country of origin

• HS Tariff code field → e.g., Tariff code

• Order reference field → e.g., PO number (used if you store the customer’s own reference on orders)

Step 3: Configure shipment synchronization

You can configure how your system receives shipment data using either webhooks or polling.

Option A: Webhooks (recommended)

1. Toggle Push shipment to enable webhook sending.

2. Click Send webhook to URL.

3. Enter your webhook URL, e.g., https://brandapi.com/new-shipment.

4. (Optional) Add a webhook secret to validate requests.

Option B: Polling

If you prefer to fetch shipment data periodically:

• Use the Polling method to call TRAEDE’s API at regular intervals.

• Shipments created since the last API call will be retrieved.

Step 4: Configure production order sync

If you also want to sync production orders, repeat the webhook setup:

1. Enable Push production orders.

2. Enter a separate webhook URL, or reuse the same as for shipments.

3. Add a separate webhook secret if needed.

Step 5: Select warehouse location

1. Choose the warehouse location (e.g., In Stock) that this integration applies to.

2. Click Save.

You can always return to this page to update the webhook URLs or secrets.

Summary

You’ve now installed and configured the 3PL app for TRAEDE, allowing automated syncing of shipments and production orders via webhooks or API polling. Make sure to test your integration to ensure data flows correctly between systems.