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

# Orders

> Export objednávek a jejich položek

<Info>
  Každý řádek CSV odpovídá **jedné položce** objednávky. Údaje o objednávce se u víceřádkových objednávek opakují.
</Info>

## Sloupce odpovědi

Odpověď je CSV (`text/csv`). Sloupce jsou v tomto pořadí:

| Sloupec                           | Popis                                   |
| --------------------------------- | --------------------------------------- |
| `order_id`                        | ID objednávky                           |
| `order_number`                    | Číslo objednávky                        |
| `mutation_id`                     | ID mutace                               |
| `mutation_name`                   | Název mutace                            |
| `create_date_time`                | Datum a čas vytvoření objednávky        |
| `client_first_name`               | Jméno zákazníka                         |
| `client_last_name`                | Příjmení zákazníka                      |
| `is_returning_customer`           | Vracející se zákazník (0 = ne, 1 = ano) |
| `note`                            | Poznámka k objednávce                   |
| `internal_note`                   | Interní poznámka                        |
| `billing_street`                  | Fakturační ulice                        |
| `billing_city`                    | Fakturační město                        |
| `billing_postal_code`             | Fakturační PSČ                          |
| `billing_district`                | Fakturační okres                        |
| `billing_country`                 | Fakturační země                         |
| `delivery_street`                 | Dodací ulice                            |
| `delivery_city`                   | Dodací město                            |
| `delivery_postal_code`            | Dodací PSČ                              |
| `delivery_district`               | Dodací okres                            |
| `delivery_country`                | Dodací země                             |
| `email_anonymized`                | Anonymizovaný e-mail (SHA-256)          |
| `phone_anonymized`                | Anonymizovaný telefon (SHA-256)         |
| `order_status_id`                 | ID stavu objednávky                     |
| `order_status_name`               | Název stavu objednávky                  |
| `is_paid`                         | Zaplaceno (0 = ne, 1 = ano)             |
| `payment_type_id`                 | ID typu platby                          |
| `payment_type`                    | Typ platby                              |
| `shipping_type_id`                | ID typu dopravy                         |
| `shipping_type`                   | Typ dopravy                             |
| `product_quantity`                | Počet produktů celkem                   |
| `total_price_without_vat`         | Celková cena bez DPH                    |
| `total_price_with_vat`            | Celková cena s DPH                      |
| `total_vat`                       | Celkem DPH                              |
| `currency_code`                   | Kód měny                                |
| `is_regular_order`                | Pravidelná objednávka (0/1)             |
| `regular_order_id`                | ID pravidelné objednávky                |
| `regular_order_number`            | Číslo pravidelné objednávky             |
| `tag_name`                        | Označení objednávky                     |
| `client_groups`                   | Výčet zákaznických skupin               |
| `item_product_id`                 | ID položky produktu                     |
| `item_name`                       | Název položky                           |
| `item_unit_price_without_vat`     | Jednotková cena položky bez DPH         |
| `item_unit_price_with_vat`        | Jednotková cena položky s DPH           |
| `item_unit_vat`                   | Jednotkové vyčíslené DPH                |
| `item_vat_rate`                   | Sazba DPH                               |
| `item_quantity`                   | Počet kusů položky                      |
| `item_total_price_without_vat`    | Cena celkem bez DPH za položku          |
| `item_total_price_with_vat`       | Cena celkem s DPH za položku            |
| `item_total_vat`                  | Celkem vyčíslené DPH za položku         |
| `item_purchase_price_without_vat` | Nákupní (výrobní) cena položky          |
| `last_updated_at`                 | Timestamp poslední aktualizace položky  |
| `item_id`                         | ID položky objednávky                   |


## OpenAPI

````yaml api-reference/openapi.json GET /order-items
openapi: 3.1.0
info:
  title: WS API
  version: 1.0.0
  description: >-
    Read-only exportní API skupiny Primulus Group. Všechny endpointy jsou `GET`
    a vracejí data ve formátu CSV (`text/csv`). Autorizace probíhá povinným
    query parametrem `key`.
servers:
  - url: https://zeptej.se.it/api/csv/v1
    description: Produkční WS API v1
security:
  - apiKeyAuth: []
paths:
  /order-items:
    get:
      tags:
        - Orders
      summary: Export objednávek a jejich položek
      description: >-
        Export objednávek a jejich položek. Každý řádek CSV odpovídá jedné
        položce objednávky; údaje o objednávce se u víceřádkových objednávek
        opakují.
      operationId: getOrderItems
      parameters:
        - $ref: '#/components/parameters/create_date_from'
        - $ref: '#/components/parameters/create_date_to'
        - $ref: '#/components/parameters/mutation_id'
        - name: order_state_id
          in: query
          required: false
          description: >-
            Seznam ID [stavů objednávek](/ciselniky/stavy-objednavek) oddělených
            čárkou.
          schema:
            type: string
          example: 1,2
        - $ref: '#/components/parameters/last_updated_at_from'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/from_index'
      responses:
        '200':
          $ref: '#/components/responses/CsvExport'
components:
  parameters:
    create_date_from:
      name: create_date_from
      in: query
      required: false
      description: Datum od (`YYYY-MM-DD`).
      schema:
        type: string
        format: date
      example: '2026-01-01'
    create_date_to:
      name: create_date_to
      in: query
      required: false
      description: Datum do (`YYYY-MM-DD`).
      schema:
        type: string
        format: date
      example: '2026-01-31'
    mutation_id:
      name: mutation_id
      in: query
      required: false
      description: Seznam ID [mutací](/ciselniky/mutace) oddělených čárkou.
      schema:
        type: string
      example: '1'
    last_updated_at_from:
      name: last_updated_at_from
      in: query
      required: false
      description: Filtr na datum poslední změny (Unix timestamp).
      schema:
        type: integer
      example: 1735689600
    limit:
      name: limit
      in: query
      required: false
      description: Vlastní limit počtu záznamů místo výchozí hodnoty.
      schema:
        type: integer
      example: 100
    from_index:
      name: from_index
      in: query
      required: false
      description: >-
        Index prvního výsledku (první výsledek má index `0`). Kombinuje se s
        `limit`.
      schema:
        type: integer
      example: 0
  responses:
    CsvExport:
      description: Úspěšná odpověď. Tělo je export ve formátu CSV (`text/csv`).
      content:
        text/csv:
          schema:
            type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: key
      description: >-
        Autorizační klíč. Povinný ve všech endpointech. Vydá vám ho tým Primulus
        Group.

````