> ## Documentation Index
> Fetch the complete documentation index at: https://docs-pos.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Procurement

> Manage suppliers, raise purchase orders and handle returns-to-vendor in the Solya POS Centrale.

**Procurement** covers how stock enters the network from suppliers: maintaining
supplier records, raising **purchase orders (POs)** and receiving them, and
sending stock back with **returns-to-vendor (RTV)**.

## What it is for

* Keep a directory of **suppliers**.
* Raise **purchase orders** and receive them line by line into stock.
* Return defective or unwanted stock to a supplier and track the **credit**.

## Key screens and actions

<Steps>
  <Step title="Manage suppliers">
    Maintain supplier records; a supplier can be created, edited and deactivated.
    Each supplier's related purchase orders are visible from its detail.
  </Step>

  <Step title="Raise a purchase order">
    Create a PO for a supplier with the units and quantities to order. The
    purchase-order list tracks each PO's status.
  </Step>

  <Step title="Receive a purchase order">
    Record receipt of a PO's lines; the variance view highlights differences
    between ordered and received quantities, and receiving updates stock.
  </Step>

  <Step title="Return to vendor">
    Raise an RTV, ship it back to the supplier, and record the credit once
    settled.
  </Step>
</Steps>

## In the API

| Capability        | Endpoints                                                                                                                                                     |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Suppliers         | `GET/POST /v1/suppliers`, `GET/PUT /v1/suppliers/{supplierId}`, `POST /v1/suppliers/{supplierId}/deactivate`                                                  |
| Purchase orders   | `GET/POST /v1/purchase-orders`, `GET /v1/purchase-orders/{orderId}`, `POST /v1/purchase-orders/{orderId}/receive`                                             |
| Returns-to-vendor | `GET/POST /v1/return-to-vendors`, `GET /v1/return-to-vendors/{rtvId}`, `POST /v1/return-to-vendors/{rtvId}/ship`, `POST /v1/return-to-vendors/{rtvId}/credit` |

Procurement writes require the procurement **manage** scope — see
[roles and permissions](/en/getting-started/roles-and-permissions). Full request
shapes are in the [API Reference](/en/developers/overview).