Připojte Excel k TWICE Commerce

Karta Export u reportu s koncovými body REST API — Reporty > Přehled prodejů > Export

Otevřít v TWICE Admin

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

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.

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

Otevřete prázdný dotaz

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

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.

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.

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.

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.

Načtěte tabulky

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

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:

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, 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 a zdroj v článku Power Query Web connector.

Související články

Přetáhněte svá data do nástroje BI

Koncové body, formát souboru a limity volání.

Připojte Power BI

Stejné dotazy, obnovované podle plánu.

Finanční reporty

Každý sloupec knihy a jak se každé číslo odvozuje.

Spusťte TWICE

Práce v TWICE

Jak připojit Excel k TWICE Commerce

Otevřít v TWICE Admin

Předpoklady

Postup

Jak poznám, že to fungovalo?

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

Související články

Přetáhněte svá data do nástroje BI

Připojte Power BI

Finanční reporty

Otevřít v TWICE Admin

​Předpoklady

​Postup

​Jak poznám, že to fungovalo?

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

​Související články

Přetáhněte svá data do nástroje BI

Připojte Power BI

Finanční reporty

Předpoklady

Postup

Jak poznám, že to fungovalo?

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

Související články