> For the complete documentation index, see [llms.txt](https://docs.neox.vn/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neox.vn/docs/global/global-collections/integration/trade-orders.md).

# Trade Order APIs

**Trade Order APIs** provide the mechanism to register, manage, and match PI/CI (Proforma Invoice / Commercial Invoice) trade-contract orders that establish the commercial background required for cross-border collection funds to be recognized and settled.

By integrating with these APIs, organizations can:

* **Register trade contracts:** Submit goods or services trade orders backed by contracts, logistics records, and product details so that incoming collection funds can be matched to verified commercial activity.
* **Match collections to trade orders:** Directly associate incoming collection transactions with one or more trade orders — or vice versa — ensuring that each received payment is anchored to its corresponding commercial transaction.

In essence, **Trade Order APIs** empower you to build a complete, auditable link between your commercial contracts and the cross-border funds flowing through the Global Collections platform.

{% hint style="warning" %}
This endpoint has no schema-level (Zod) validation on the backend — see the hint on [Create Trade Order](/docs/global/global-collections/integration/trade-orders/api-create-trade-order.md). There is also no GET endpoint for trade-order status — see the notice on [Get Detail Trade Order](https://github.com/neopayvn/neox-gitbook-documents-v2/tree/main/global-collections/integration/trade-orders/get-detail-trade-order.md).
{% endhint %}

### Endpoints

| Method | Endpoint                                                                                                                         | Description                                                      |
| ------ | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| POST   | [Create Trade Order](/docs/global/global-collections/integration/trade-orders/api-create-trade-order.md)                         | Create a PI/CI trade-contract order.                             |
| PUT    | [Update Trade Order](/docs/global/global-collections/integration/trade-orders/api-create-trade-order.md#update-trade-order)      | Update an existing trade order.                                  |
| POST   | [Match Collection and Trade Order](/docs/global/global-collections/integration/trade-orders/api-match-collection-trade-order.md) | Match a collection transaction to trade order(s), or vice versa. |