> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/apps-and-integrations/3pl-connections/api-integration-3pl.md).

# API Integration – 3PL

Xorosoft can integrate with third-party logistics providers (3PLs) via FTP using CSV files and through APIs. This integration capability allows businesses to choose the method that best suits their operational needs and technical infrastructure.

**API Integration**

For detailed documentation on our Xoro API, please visit: [Xoro API Documentation](https://xorosoft.docs.apiary.io/).

**API Workflow for Sales Orders and Shipping Confirmation**

The API workflow for sales order and ship confirmation simplifies the process of order fulfillment and shipment tracking. Here's how it works:

1. Orders are synchronized into Xoro from various sales channels.
2. Xoro creates a wave to allocate the order.
3. The 3PL fetches the wave periodically using the `getWave` API or receives it in real-time via a webhook.
4. The 3PL marks the wave as fulfilled using the `fulfill` API.
5. The 3PL calls the `ship` API with tracking information to mark the order as shipped and automatically generate an invoice in Xoro.

**API Workflow for Receiving**

Managing incoming inventory efficiently is critical for businesses. Xorosoft simplifies the receiving process with the following API workflow:

1. A purchase order is created in Xoro by the client.
2. Xoro generates an ASN (Advance Shipping Notice) based on the packing slip confirmation.
3. The 3PL fetches the ASNs periodically using the `getasn` API or receives them in real-time via a webhook.
4. The 3PL closes the ASN using the `Close/Receive ASN` API.
5. The purchase order is marked as received, and an Item Receipt is generated in Xoro.

**API Workflow for Returns**

Efficiently processing returns is essential for customer satisfaction and inventory management. Xorosoft streamlines the returns process with the following API workflow:

1. An RMA (Return Merchandise Authorization) is created in Xoro by the client.
2. Xoro generates an ASN from the RMA for return processing.
3. The 3PL fetches the ASNs periodically using the `getasn` API or receives them in real-time via a webhook.
4. The 3PL closes the ASN using the `Close/Receive ASN` API upon completing the return process.
5. The RMA is marked as closed, and a Credit Memo is generated in Xoro for accurate financial tracking.

By integrating Xorosoft with 3PLs through API, you can achieve better operational efficiency, improved inventory management, and enhanced customer satisfaction. The seamless data exchange and automated workflows offered by Xorosoft's API integration capabilities pave the way for streamlined logistics operations and optimized supply chain management.

<br>


---

# 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://docs.xorosoft.com/xoroerp-1/apps-and-integrations/3pl-connections/api-integration-3pl.md?ask=<question>&goal=<endgoal>
```

`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.