> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/fulfillment-services/freightpop-integration.md). # FreightPOP Integration Order Desk can send orders directly to [FreightPOP](https://www.freightpop.com/) then pull shipment details back into your orders here and send them to your shopping carts, if applicable. ### Setup To connect to your FreightPOP account, click on **Manage Integrations** in the left sidebar. Under the **Fulfillment** tab, look for and enable the FreightPOP integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FdxZZEahohviEM8jeNNnN%2Flegacy-ace01249dac2f944e0b2.jpg?alt=media) ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FFIQwWb6zSzwZOP3XC6eY%2Flegacy-0c89f4570090822a8445.png?alt=media) Once enabled, you’ll need to enter the webhook URL into your FreightPOP account to ensure that shipment information can sync back to your orders in Order Desk. Then, use your FreightPOP Username and Password to connect the integration to your Order Desk store. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Ffnua5VD5aGYflaO2Hzgh%2Flegacy-8e84d25260ab8edf3468.png?alt=media) ### Integration Settings Once connected, you’ll have some integration settings to adjust per your preferences. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FL3e7vN4UR3d0aMtuD4oH%2Flegacy-8c6c3cd935b3f1a58be7.png?alt=media) #### Default Mail Class Choose the default shipping class you want FreightPOP to use for your orders. #### After Import, Move To The folder set here is where orders will move after they are successfully sent to FreightPOP. You can choose the default Prepared folder for this, or create your own folders in your Store Settings. Read the [Working with Folders](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information. #### After Shipment, Move To The folder set here is where orders will move after FreightPOP sends back fulfillment and tracking details. #### Automatically Send Imported Orders To FreightPOP Select this setting to import all your FreightPOP orders to Order Desk. #### Shipment Webhook URL This link should be provided to FreightPOP to ensure that your shipments can sync back to Order Desk and is the same link provided when you connect the FreightPOP integration in Order Desk. #### Default Shipper Information Set your default return address for FreightPOP to use on your order shipments. If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and use a rule to set the return address on specific orders. If a return address is not added to the order, the default address set here in the FreightPOP settings will be used. For information on adding additional return addresses and applying them to specific orders with a rule, read the [Store Settings](/guided-walkthroughs/using-order-desk/manage-store-settings.md#return-addresses) guide. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FsUT6xXXGQarEoFVYszUx%2Flegacy-4ea35c643d7b2c7ba609.png?alt=media) For more information on what these product settings are for and how to use them, read the [Fulfillment Integration Product Settings](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md#product-code-match) guide. #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FXc0vtI1sZSz5eYm5RnCa%2Flegacy-2d77f8c8624ca0f72dfa.png?alt=media) To tell FreightPOP what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide. ### Submitting Your Orders To FreightPOP #### Order Level Data The following fields can be set as checkout data or order metadata to specify what gets sent to FreightPOP: | Field Name | Field Description | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | Reference\_x | Up to 6 (e.g. Reference\_1). | | Documents | Use one of the numerical value options found [here](https://api.freightpop.com/Help/ResourceModel?modelName=OrderDocumentTypes) to pass order documents. | | OrderType | Type of order. Default is **Sales Order.** | | ShipDate | Order ship date. | | ITN | International transaction number. | | PaymentTerm | Use a numerical value to pass a payment term to FreightPOP. [Options here](https://api.freightpop.com/Help/ResourceModel?modelName=PaymentTerm). | | ReturnCompanyID | Use to override the shipper company ID upon order submission. | | ThirdPartyAccountNumber | Passes account number only if PaymentTerm field is present with the value of 1 or 3. | If you are unfamiliar with checkout data, please read the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide. #### Preparing Your Items The following fields can be set as variations or item metadata for each order item. Replace the “x” with a value specified in the table, i.e. print\_url\_1 or print\_url\_2. | Field Name | Field Description | | ---------------- | ------------------------------------------------------------------------------------------------------------------ | | Package\_Type\_x | Packing type inside the shipment. Up to x options. | | FreightClass | Freight class for the item. Required for local shipments only. | | PackageType | Defaults to Box. More options can be found here. | | Description | Defaults to Item. Required for some carriers. | | PackageId | Package ID for the item. Defaults to the order’s Source ID. | | Height | Height of the item. Required for rating shipment. | | Length | Length of the item. Required for rating shipment. | | Weight | Weight of the item. Required for rating shipment. | | Width | Width of the item. Required for rating shipment. | | Unit | Unit of measurement for item weight. [Options here](https://api.freightpop.com/Help/ResourceModel?modelName=Unit). | | UPC | Item UPC number. | #### Return Address Fields The following fields can be set as checkout data or order metadata to set the Return Address. If these fields are not present, the Default Shipper Settings will be used. | Field Name | Field Description | | -------------------- | ----------------------------------------------------------- | | return\_name | The name for your return address. | | return\_city | The city for your return address | | return\_company | The company name for your return address. | | return\_company\_id | The company ID for your return address (if applicable). | | return\_state | The state for your return address. | | return\_email | The email you’d like to associate with your returns. | | return\_phone | The phone number you’d like to associate with your returns. | | return\_street1 | The first street address for your returns. | | return\_street2 | The second street address for your returns. | | return\_postal\_code | The postal code associated with your return address. | #### Accessorials Freight accessorials can be set on your orders as checkout data or order metadata. One option is to use the field name **accessorial\_x** with an enum as the value. Enum options can be found [here](https://api.freightpop.com/Help/ResourceModel?modelName=Accessorial). If needed, the field names below can be used instead with a value of **1** to set the accessorial: * freightpop\_DeliveryAppointment * freightpop\_DestinationExhibition * freightpop\_DestinationInsideDelivery * freightpop\_DestinationLiftGate * freightpop\_DestinationSortAndSegregate * freightpop\_Freezable * freightpop\_Hazmat * freightpop\_KeepFromFreezing * freightpop\_LimitedAccessDelivery * freightpop\_LimitedAccessPickup * freightpop\_OriginExhibition * freightpop\_OriginInsidePickup * freightpop\_OriginLiftGate * freightpop\_OriginSortAndSegregate * freightpop\_ResidentialDelivery * freightpop\_ResidentialPickup * freightpop\_PRIORITY\_ALERT --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/fulfillment-services/freightpop-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.