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

# Regular Orders

> Export pravidelných objednávek a jejich položek

<Info>
  Každý řádek CSV odpovídá **jedné položce** pravidelné objednávky.
</Info>

## Sloupce odpovědi

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

| Sloupec                        | Popis                                   |
| ------------------------------ | --------------------------------------- |
| `regular_order_id`             | ID pravidelné objednávky                |
| `regular_order_number`         | Číslo pravidelné objednávky             |
| `mutation_id`                  | ID mutace                               |
| `mutation_name`                | Název mutace                            |
| `create_date_time`             | Datum a čas vytvoření objednávky        |
| `client_id`                    | ID zákazníka                            |
| `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                  |
| `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                                |
| `tag_name`                     | Označení objednávky                     |
| `frequency`                    | Číslo frekvence                         |
| `frequency_type`               | Typ frekvence (den, měsíc…)             |
| `variable_symbol`              | Variabilní symbol                       |
| `last_expedition_date`         | Poslední datum expedice                 |
| `next_expedition_date`         | Datum příští expedice                   |
| `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         |
| `last_updated_at`              | Timestamp poslední aktualizace položky  |
| `item_id`                      | ID položky pravidelné objednávky        |


## OpenAPI

````yaml api-reference/openapi.json GET /regular-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:
  /regular-order-items:
    get:
      tags:
        - Regular Orders
      summary: Export pravidelných objednávek a jejich položek
      description: >-
        Export pravidelných objednávek a jejich položek. Každý řádek CSV
        odpovídá jedné položce pravidelné objednávky.
      operationId: getRegularOrderItems
      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ů pravidelných
            objednávek](/ciselniky/stavy-pravidelnych-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.

````