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

# Invoices

> Export faktur a jejich položek

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

## Sloupce odpovědi

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

| Sloupec                           | Popis                                                |
| --------------------------------- | ---------------------------------------------------- |
| `document_id`                     | ID dokladu                                           |
| `document_number`                 | Číslo dokladu                                        |
| `document_status`                 | Stav dokladu                                         |
| `order_id`                        | ID objednávky                                        |
| `order_number`                    | Kód objednávky                                       |
| `variable_symbol`                 | Variabilní symbol                                    |
| `mutation_id`                     | ID mutace                                            |
| `mutation_name`                   | Mutace                                               |
| `document_type_id`                | ID [typu dokladu](/ciselniky/typy-dokladu)           |
| `document_type`                   | Typ dokladu                                          |
| `client_id`                       | ID klienta                                           |
| `billing_company`                 | Firma                                                |
| `billing_first_name`              | Jméno klienta                                        |
| `billing_last_name`               | Příjmení klienta                                     |
| `billing_street`                  | Ulice                                                |
| `billing_city`                    | Město                                                |
| `billing_postal_code`             | PSČ                                                  |
| `billing_district`                | Okres                                                |
| `billing_country`                 | Země                                                 |
| `company_id_number`               | IČO                                                  |
| `issue_date`                      | Datum vystavení                                      |
| `taxable_supply_date`             | Datum zdanitelného plnění                            |
| `due_date`                        | Datum splatnosti                                     |
| `payment_date`                    | Datum zaplacení                                      |
| `payment_method`                  | Způsob zaplacení                                     |
| `description`                     | Popis                                                |
| `payment_type_id`                 | ID platby                                            |
| `payment_type`                    | Platba typ                                           |
| `payment_price_with_vat`          | Platba cena s DPH                                    |
| `shipping_type_id`                | ID dopravy                                           |
| `shipping_type`                   | Doprava typ                                          |
| `shipping_price_with_vat`         | Doprava cena s DPH                                   |
| `total_price_without_vat`         | Cena celkem bez DPH                                  |
| `total_price_with_vat`            | Cena celkem s DPH                                    |
| `currency_code`                   | Kód měny                                             |
| `is_exported_to_erp`              | Je doklad exportován do ERP (0/1)                    |
| `client_groups`                   | Výčet skupin zákazníka                               |
| `item_product_id`                 | ID produktu                                          |
| `item_name`                       | Položka                                              |
| `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 za položku                  |
| `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í cena položky                                 |
| `item_id`                         | ID položky faktury                                   |
| `item_reference_id`               | Reference na ID položky, ke které se váže            |
| `item_type_id`                    | ID [typu položky](/ciselniky/typy-polozek) dokumentu |
| `last_updated_at`                 | Timestamp poslední aktualizace položky               |


## OpenAPI

````yaml api-reference/openapi.json GET /invoice-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:
  /invoice-items:
    get:
      tags:
        - Invoices
      summary: Export faktur a jejich položek
      description: >-
        Export faktur a jejich položek. Každý řádek CSV odpovídá jedné položce
        dokladu.
      operationId: getInvoiceItems
      parameters:
        - $ref: '#/components/parameters/taxable_supply_date_from'
        - $ref: '#/components/parameters/taxable_supply_date_to'
        - $ref: '#/components/parameters/mutation_id'
        - name: document_type_id
          in: query
          required: false
          description: >-
            Výčet ID [typů dokladu](/ciselniky/typy-dokladu) (faktura, dobropis,
            proforma) oddělených čárkou.
          schema:
            type: string
          example: '1'
        - $ref: '#/components/parameters/last_updated_at_from'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/from_index'
      responses:
        '200':
          $ref: '#/components/responses/CsvExport'
components:
  parameters:
    taxable_supply_date_from:
      name: taxable_supply_date_from
      in: query
      required: false
      description: Datum zdanitelného plnění od (`YYYY-MM-DD`).
      schema:
        type: string
        format: date
      example: '2025-05-20'
    taxable_supply_date_to:
      name: taxable_supply_date_to
      in: query
      required: false
      description: Datum zdanitelného plnění do (`YYYY-MM-DD`).
      schema:
        type: string
        format: date
      example: '2025-05-25'
    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.

````