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

# Jak připojit Excel k TWICE Commerce

> Načtěte knihy výnosů a plateb do sešitu Excelu pomocí Power Query a obnovujte je při každém otevření sešitu.

![Karta Export u reportu s koncovými body REST API](https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/reports-export.webp?fit=max\&auto=format\&n=Ab7tx7ih94KQsi0k\&q=85\&s=5b8746adc8bb592f174ae9f8130924e2)

Reporty > Přehled prodejů > Export

> **[Otevřít v TWICE Admin](https://admin.twicecommerce.com/reports)**
>
> reports

Načtěte knihy výnosů a plateb do Excelu jako dvě obnovitelné tabulky a nad nimi potom postavte kontingenční tabulky a grafy. Každé obnovení načte z TWICE Commerce nejnovější řádky.

## Předpoklady

> [!WARNING]
>
> **Vyžadovaný přístup:** klíč API pro TWICE Commerce s oblastí **Reporty** na úrovni **Čtení** a bez dalších oblastí. Klíč se ukládá do sešitu, takže sešit sdílejte jen s lidmi, kterým byste dali i samotný klíč. Viz [Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md).

> [!NOTE]
>
> **Než začnete:**
>
> * **Excel pro Microsoft 365 ve Windows.** Tyto kroky používají jeho editor Power Query.
> * **Koncové body knih a formát souboru** z návodu [Přetáhněte svá data do nástroje BI](https://www.twicecommerce.com/docs/cs/guides/reports/pull-report-data.md).
> * **Váš kód měny** a první datum, od kterého chcete historii.
>
> Názvy v Excelu a Power Query jsou v tomto návodu uvedeny tak, jak se zobrazují v anglickém rozhraní.

## Postup

**1. Otevřete prázdný dotaz**

Zvolte **Data → Get Data → From Other Sources → Blank Query**. Otevře se editor Power Query.

**2. Uložte klíč do parametru**

Zvolte **Home → Manage Parameters → New Parameter**, pojmenujte ho `TwiceApiKey`, nastavte **Type** na **Text** a vložte klíč do pole **Current Value**.

**3. Vložte dotaz na knihu výnosů**

Vyberte prázdný dotaz, otevřete **Advanced Editor** a jeho obsah nahraďte dotazem níže. Hodnoty `currency` a `FromDate` změňte na své. Dotaz pojmenujte `Revenue`.

**4. Připojte se anonymně**

Až se Power Query zeptá na způsob připojení, zvolte **Edit Credentials**, vyberte **Anonymous** a zvolte **Connect**. Klíč putuje v hlavičce.

**5. Přidejte dotaz na knihu plateb**

Duplikujte dotaz `Revenue`, kopii pojmenujte `Payments` a hodnotu `RelativePath` změňte na `internal/reporting/payments/export`. Typované sloupce nahraďte tak, aby `Payment_Date` byl `type date` a `Amount_Total` byl `type number`.

**6. Načtěte tabulky**

Zvolte **Home → Close & Load**. Každý dotaz se načte na vlastní list jako tabulka Excelu.

**7. Obnovujte při otevření**

Klikněte pravým tlačítkem na dotaz `Revenue` v panelu **Queries & Connections**, zvolte **Properties** a zaškrtněte **"Refresh data when opening the file"**. Totéž zopakujte u dotazu `Payments`.

Pro knihu výnosů použijte tento dotaz:

```powerquery Revenue theme={null}
let
    FromDate = "2025-01-01",
    ToDate = Date.ToText(Date.From(DateTime.LocalNow()), "yyyy-MM-dd"),
    Source = Web.Contents(
        "https://server.twicecommerce.com",
        [
            RelativePath = "internal/reporting/revenue/export",
            Query = [from = FromDate, to = ToDate, currency = "EUR"],
            Headers = [#"X-API-KEY" = TwiceApiKey]
        ]
    ),
    Csv = Csv.Document(Source, [Delimiter = ";", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]),
    Promoted = Table.PromoteHeaders(Csv, [PromoteAllScalars = true]),
    // A truncated export ends in a notice row with no Row_ID. Drop it.
    DataRows = Table.SelectRows(Promoted, each [Row_ID] <> null and [Row_ID] <> ""),
    Typed = Table.TransformColumnTypes(
        DataRows,
        {
            {"Create_Date", type date}, {"Start_Date", type date}, {"End_Date", type date},
            {"Quantity", type number}, {"Amount_Excl_Tax", type number},
            {"Amount_Total", type number}, {"Amount_Paid", type number},
            {"Amount_Refunded", type number}, {"Amount_Outstanding", type number}
        },
        "en-US"
    )
in
    Typed
```

Kultura `"en-US"` přečte hodnotu `202.42` jako číslo i na počítači, který má v místním nastavení desetinnou čárku, například v češtině. Sloupce s daní zůstávají netypované, protože jejich počet sleduje daňové sazby v období.

Do tabulky Excelu se vejde asi milion řádků. Pro delší historii, než vrátí jedno volání, použijte roční dotaz z návodu [Připojte Power BI](https://www.twicecommerce.com/docs/cs/guides/reports/connect-power-bi.md), z jeho části o načtení více než 100 000 řádků. V Excelu funguje beze změny.

## Jak poznám, že to fungovalo?

* List `Revenue` zobrazuje jeden řádek na řádek objednávky a `Amount_Total` je zarovnaný doprava jako číslo.
* Kontingenční tabulka, která sčítá `Amount_Total` s filtrem `Started_In_Period` = `Yes`, odpovídá reportu **Report výnosů** v administraci za stejné období a ve stejné měně.
* Volba **Data → Refresh All** se dokončí bez chyby.

## Řešení potíží a časté chyby

> **Částky se načtou jako text nebo jako 20242 místo 202.42**
>
> Sloupec byl typován podle místního nastavení vašeho počítače. Ponechte ve funkci `Table.TransformColumnTypes` argument kultury `"en-US"` a smažte každý krok **Changed Type**, který Power Query přidalo samo.

> **Excel se při každém obnovení znovu ptá na přihlašovací údaje**
>
> Přihlašovací údaje byly uloženy k jiné adrese URL. Otevřete **Data → Get Data → Data Source Settings**, vymažte záznam pro `server.twicecommerce.com`, obnovte data a zvolte znovu **Anonymous**.

> **Obnovení selže s chybou "The column 'Tax\_Rate\_2' of the table wasn't found"**
>
> Některý krok odkazuje na sloupec s daní, který nové období nemá. Odeberte sloupce s daní ze všech kroků typování a přejmenování.

> **Obnovení selže s chybou 401, i když předtím fungovalo**
>
> Někdo klíč API smazal nebo vyměnil. Vložte nový klíč do parametru `TwiceApiKey` pod volbou **Manage Parameters**.

Microsoft popisuje editor v článku [Power Query in Excel](https://support.microsoft.com/en-us/office/about-power-query-in-excel-7104fbee-9e62-4cb9-a02e-5bfb1a6c536a) a zdroj v článku [Power Query Web connector](https://learn.microsoft.com/en-us/power-query/connectors/web/web).

## Související články

> **[Přetáhněte svá data do nástroje BI](https://www.twicecommerce.com/docs/cs/guides/reports/pull-report-data.md)**
>
> Koncové body, formát souboru a limity volání.

> **[Připojte Power BI](https://www.twicecommerce.com/docs/cs/guides/reports/connect-power-bi.md)**
>
> Stejné dotazy, obnovované podle plánu.

> **[Finanční reporty](https://www.twicecommerce.com/docs/cs/concepts/reports/finance-reports.md)**
>
> Každý sloupec knihy a jak se každé číslo odvozuje.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.