Order management
================

1. Order overview
-----------------

To view all orders, navigate to the **"Orders"** page in the sidebar. This page displays orders categorized by their status:

- New
- Paid
- Refunded
- Not Wired
- Completed
- All

Each order includes the following details:

- **Date:** When the order was created.
- **Amount:** The total price of the order.
- **Summary:** A brief description of the order.
- **Copy URL:** Click this button to copy the payment link for the order.

2. Creating a new order
-----------------------

To create a new order, click on the **"+"** button in the top-right corner of the page. A form will appear where you can enter the order details.

There are two order forms: **simple** and **advanced**.

Simple order format
~~~~~~~~~~~~~~~~~~~

In the **Simple order** form, fill in the following fields:

- **Manage products in order** (*optional*): Add products from inventory.

    - **Search product**: Search by product ID or description (case-sensitive).
- **Order price** (*required*): Final price of the order.
- **Summary** (*required*): Title for the order displayed to the customer.

Once completed, click on the **"Confirm"** button to create the order.

Advanced order format
~~~~~~~~~~~~~~~~~~~~~

The **Advanced order** form provides additional customization options. Fill in the following fields:

Managing products
^^^^^^^^^^^^^^^^^

- **Manage products in order**: Manage the list of products in the order.

  - **Search product**: Search by product ID or description (case-sensitive).
  - **Add custom product** button:

    - **Image**: Upload an image of the product.
    - **Description** (*required*): Provide a full product description.
    - **Unit** (*required*): Specify the unit (e.g., kg, items).
    - **Price per unit** (*required*): Define the price in the merchant’s currency.
    - **Quantity**: Set the number of units.
  - **Taxes**: Specify applicable taxes.

    - **Amount**: Taxes may differ from the main currency (e.g., USD:2.3).
    - **Description**: Legal name of the tax.

Order details
^^^^^^^^^^^^^

- **Order price** (*required*): Final order price.
- **Summary** (*required*): Title of the order to be shown to the customer.

Shipping and fees
^^^^^^^^^^^^^^^^^

- **Delivery date**: Deadline for physical delivery assured by the merchant.
- **Fulfilment URL**: URL to which the user will be redirected after successful payment. It can be used for tracking
  the order (unique link) or downloading digital goods. [Repurchase tutorial]()

Taler payment options
^^^^^^^^^^^^^^^^^^^^^

Override default Taler settings for this order.

- **Payment time**: Time for the customer to pay for the order before it expires. Inventory products will be
  reserved until this deadline. The timer starts after the order is created.
- **Refund time**: Time during which the order can be refunded by the merchant. The timer starts after the order
  is created.
- **Wire transfer time**: Time for the exchange to make the wire transfer. The timer starts after the order is
  created.
- **Maximum fee**: Maximum fees the merchant is willing to cover for this order. The customer must cover higher
  deposit fees in full.
- **Create token**: If the order ID is easy to guess, the token will prevent users from stealing orders from others.
- **Minimum age required**: Any value greater than 0 will limit the coins that can be used to pay for this contract.
  If left empty, the products will define the age restriction.


Additional information
^^^^^^^^^^^^^^^^^^^^^^

- **Custom field name**: Add extra details to the contract for this order.

Once completed, click on the **"Confirm"** button to create the order.

3. Payment link generation
--------------------------

After confirming the order:

- A payment link is generated.
- You can copy the link to share with the customer.
- Click on the link to display a QR code for payment.