> 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/oia-global-integration.md). # OIA Global Integration Order Desk can import orders from your shopping cart(s), apply custom information and then submit them to [OIA Global](http://www.oiaglobal.com/) for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart(s) if your store is set up for it. ### Setup To connect to OIA Global, click on the **Manage Integrations** link in the left sidebar and under the **Fulfillment** tab find and enable the OIA Global integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FMRTY7mObIjYXIDmznNg1%2Flegacy-086770026968c2c19447.png?alt=media) Once enabled, enter the Client Code and FTP credentials that OIA Global has provided for you then click to connect. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fuw8OgEfYsvUHYIHm7zak%2Flegacy-1d037a1a341b78598915.png?alt=media) ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FrFaB9wsIn2UFPYz0W7OG%2Flegacy-5f20e7520155a366427e.png?alt=media) After you have connected the integration, you can apply any necessary details or preferences to the settings. #### Mode Choose the mode your store is in, either **Test** or **Production** (live) #### Mail Classes Choose the shipping classes you want OIA Global to use for your US, Canadian and international orders. If you need to apply specific methods for certain orders, match your method names to OIA Global’s names in the [Shipping Class Match section](#shipping-class-match) below. #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to OIA Global. You can use one of the default folders already in your store or create your own. 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 Select the folder you want orders to be moved into as OIA Global sends shipment details back to Order Desk. #### Check for Shipments Choose the time interval Order Desk should check for shipments from OIA Global. #### Automatically Send Imported Orders to OIA Global If selected, every order that is added to Order Desk will automatically be sent to OIA Global. Select this setting only if all orders will be sent to OIA Global. If any orders will not be sent, or if you need a delay between when an order is imported into Order Desk and when it is sent to OIA Global do *not* select this. #### Sync Inventory Your inventory imports will be set up by Order Desk support for you. You can enable this setting if you want to pull inventory counts back from OIA Global more often. For more information, see the [How to Work with Inventory Counts](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-quantities.md#send-counts-tofrom-order-desk) guide. #### Inventory Location Name If you want to set a specific inventory location name for the products you have at OIA Global, set that name here. As OIA Global sends back reports your custom name will be added as the location. This will only work if Sync Inventory is enabled. #### Shipper Phone Some shipment services require a phone number for anything they ship. To avoid any delays or problems with orders that may not have a number, add the backup phone number you want to use on any orders where your customer has not provided theirs. #### Warehouse Number Change the Warehouse Number if OIA Global asks you to. #### DC Location Add the DC Location if OIA Global asks you to. #### Use Legacy Connection Method Do not select this unless asked to do so by OIA Global or Order Desk. This is a legacy feature that is only used for certain customers. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F6E4MOOcgdrvlrDmsxDGD%2Flegacy-60ba88591821436263f7.png?alt=media) For more information on what these product settings in the OIA Global integration are for and how to use them, read the [Fulfillment Integration Product Settings](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md) guide. #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FPfGBN2yvpjXczNBUVgTv%2Flegacy-90870df41dea1fdd6f1d.png?alt=media) If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names OIA Global uses, they won’t know what methods you intend for them to use. When this happens, the [default mail classes applied above](#integration-settings) will be used instead for all of your orders. To tell OIA Global 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. #### Getting Tracking Numbers Please contact Order Desk support to configure your account to pull tracking numbers from OIA Global. We will work directly with OIA Global to set this up. ### Sending Orders to OIA Global You can send custom details about an order to OIA Global by entering the following checkout data fields. For more information about these options, please contact OIA Global. | Field Name | Field Description | | ----------------- | ------------------------------------------------------------------------------------------ | | SalesOrderVersion | Default is 1. | | SalesOrderPrepend | Use to add a letter or number to the front of the sales order. | | SalesOrderType | Use to pass sales order type. Accepted values are DTC, W, M, and SAL. Default is SAL. | | PONumber | The PO Number for the order if different from the Source ID. | | BatchID | Default is NA. | | Priority | Default is 15. Other options are 1, 10, 15, 20, 25, 30. Lower numbers are higher priority. | | FreightTerms | Default is P. Other available values are C or T. | | ShippingAccount | Shipping Account #. Default is blank. | | SignatureRequired | Default is N. Enter Y to require a signature. | | FutureShipDate | Use to set the scheduled ship date for your order. Default is current date. | | DeliveryDate | Use to set the scheduled delivery date for your order. Default is current date + 3 days. | | CancelDate | Use to set a cancellation date. Default is current date +5 days. | | IncoTerms | Use to sets incoterms. Default is DDU. | | Lot | Use to set a lot number. | 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. #### Resubmitting or Canceling an Order If you need to cancel an order already sent to OIA Global, or you need to edit and resubmit an order that they already received, you will need to first [contact OIA Global](mailto:distribution.orders@oiaglobal.com) (email link) to let them know to cancel it. After they cancel the original order, an order with updated information can be sent as a second version. To do this, make any necessary edits to the order first. Then click on **Add Checkout Data Fields** in the upper right corner of the order page and add **SalesOrderVersion** with a value of **2** to the order. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F0FiaFIJc904D2yW8rxTz%2Flegacy-9977184a2efa64be6d75.png?alt=media) You can now resubmit the order to OIA Global. #### Custom Settings If you need to skip certain items when sending orders to OIA Global, you have a few options. You can split the items out into their own orders [following these instructions](/guided-walkthroughs/orders-and-folders/how-to-split-orders.md). You can use the [Product Code Skip](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md#product-code-skip) option to tell Order Desk which item SKUs to skip. Or you can apply an item metadata field called **oiaglobal\_skip** with a value of 1 to any item that should not be sent to OIA for fulfillment: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FOo26HT8EEql9UU9sAszd%2Flegacy-fddbb3fd29a3bc7564e7.png?alt=media) This is a good option if you have any items where the SKUs are variable because you can create an Order Item Rule that sets this item metadata based on the item name or some other detail about the item that doesn’t change. For more information about working with rules, [see this guide](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md). --- # 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/oia-global-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.