> ## 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řetáhnout svá data do nástroje BI > Dostaňte z TWICE Commerce přes API data o prodejích, platbách a reportech na úrovni řádků, aby si nad nimi Power BI, Excel, Tabulky Google, Tableau nebo Looker Studio postavily vlastní zobrazení. ![Karta Export u reportu s tlačítky ke stažení a 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 Přetáhněte knihy výnosů a plateb přes API a postavte nad nimi vlastní zobrazení. Obě knihy jsou data na úrovni řádků, která stojí za každým prodejním a finančním číslem v TWICE Commerce: jeden řádek na řádek objednávky a jeden řádek na řádek platby, s daty, místem, částkami a stavem platby. ## Předpoklady > [!WARNING] > > **Vyžadovaný přístup:** klíč API s volbou **Omezený přístup** a s oblastí **Reporty** na úrovni **Čtení**. Připojení pro reportování nic dalšího nepotřebuje a klíč na vašem účtu nic nezmění. Klíč dejte tomu, kdo dashboardy staví, nikdy ho nevkládejte do sdíleného souboru a po dokončení práce ho smažte. Viz [Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md). > [!NOTE] > > **Rozhodněte se, než začnete:** > > * **Měna.** Každé volání knihy vrátí jednu měnu. Volejte jednou za každou měnu, ve které prodáváte. > * **Potřebná historie.** Jedno volání vrátí až 100 000 řádků. Delší historii rozdělte na jedno volání za rok. > [!NOTE] > > **Pokročilé vykazování** je dostupné v plánech **Standard** a **Enterprise**. Viz [plány](https://www.twicecommerce.com/docs/cs/twice-commerce-overview) (sekce Ceny). ## Vyberte koncový bod pro data, která potřebujete Obě knihy použijte jako tabulky, na kterých váš model stojí. Vestavěný report vrátí čísla, která zobrazuje jedno zobrazení administrace, s limitem 1 000 řádků, takže se hodí pro jeden graf, ne pro datový model. | Data | Koncový bod | Řádků na volání | | - | - | - | | Každý řádek objednávky s daty, místem, částkami a stavem platby | `GET /internal/reporting/revenue/export` | 100 000 | | Každá platba, vrácení peněz a poplatek platformy | `GET /internal/reporting/payments/export` | 100 000 | | Jeden vestavěný report tak, jak ho zobrazuje administrace | `GET /internal/reporting/reports/{reportId}/data` | 1 000 | | Zákazníci, skladové položky, nabídky | Koncové body výpisů v [Admin API](https://www.twicecommerce.com/docs/cs/api-reference) | Po stránkách | Všechny cesty vedou na `https://server.twicecommerce.com`. Data reportů stojí mimo verzované Admin API, takže tyto cesty nemají stránku na kartě **API** a mohou se změnit. Pokud připojení přestane vracet data, podívejte se na tuto stránku. ## Postup **1. Vytvořte klíč API** Klíč vytvořte pod **Nastavení → Integrace & API** v sekci **Klíče API**. Pod volbou **Přístup** vyberte **Omezený přístup** a oblast **Reporty** nastavte na **Čtení**. Klíč si zkopírujte, protože celý se zobrazí jen jednou. **2. Sestavte adresu URL knihy** K cestě knihy přidejte období a měnu: | Parametr | Hodnota | Povinný | | - | - | - | | `from` | První den období, `YYYY-MM-DD` | Ano | | `to` | Poslední den období, `YYYY-MM-DD`, včetně | Ano | | `currency` | Kód podle ISO 4217, například `EUR` | Ano | Data se čtou v časovém pásmu vašeho účtu, nastaveném v [Detaily účtu](https://www.twicecommerce.com/docs/cs/settings/account.md). Kniha nese všechna místa, takže ve svém nástroji filtrujte podle jejího sloupce `Location`. ```text theme={null} https://server.twicecommerce.com/internal/reporting/revenue/export?from=2026-01-01&to=2026-09-30¤cy=EUR ``` **3. Otestujte adresu URL s klíčem** Klíč posílejte v hlavičce `X-API-KEY`. Funkční volání vrátí knihu jako CSV. ```bash cURL theme={null} curl "https://server.twicecommerce.com/internal/reporting/revenue/export?from=2026-01-01&to=2026-09-30¤cy=EUR" \ -H "X-API-KEY: {key}" \ -o revenue-2026.csv ``` **4. Připojte svůj nástroj** Nasměrujte nástroj na tuto adresu URL s klíčem v hlavičce. Postupujte podle návodu pro svůj nástroj: [Power BI](https://www.twicecommerce.com/docs/cs/guides/reports/connect-power-bi.md), [Excel](https://www.twicecommerce.com/docs/cs/guides/reports/connect-excel.md), [Tabulky Google](https://www.twicecommerce.com/docs/cs/guides/reports/connect-google-sheets.md), [Tableau](https://www.twicecommerce.com/docs/cs/guides/reports/connect-tableau.md) nebo [Looker Studio](https://www.twicecommerce.com/docs/cs/guides/reports/connect-looker-studio.md). ## Přečtěte si soubory knih Otevřete soubor, který jste uložili při testu, a zkontrolujte, že začíná takto: ```text Kniha výnosů, první řádky theme={null} Create_Date;Start_Date;End_Date;Created_In_Period;Started_In_Period;Ended_In_Period;Document_Type;Revenue_Category;Order_Number;Item_Name;Quantity;Account;Location;Cost_Center;Timezone;Currency;Amount_Excl_Tax;Tax_Rate_1;Tax_Amount_1;Amount_Total;Payment_Status;Amount_Paid;Amount_Refunded;Amount_Outstanding;First_Payment_Date;Order_ID;Order_Line_Item_ID;Row_ID 2026-03-02;2026-03-14;2026-03-15;Yes;Yes;Yes;sale;booking;#1042;Meeting room A;1;Northwind Spaces;Helsinki;HEL-01;Europe/Helsinki;EUR;161.29;25.5;41.13;202.42;paid;202.42;0.00;0.00;2026-03-02;7d1c9e4a-3b2f-4c8e-9a61-5f0e2b7c4d13;a3e8f0b2-6c41-4d9a-8e27-1b5c9f3d2e60;a3e8f0b2-6c41-4d9a-8e27-1b5c9f3d2e60 2026-03-05;2026-03-05;2026-03-05;Yes;Yes;Yes;sale;sale;#1043;Used road bike, size M;1;Northwind Spaces;Helsinki;HEL-01;Europe/Helsinki;EUR;318.73;25.5;81.27;400.00;paid;400.00;0.00;0.00;2026-03-05;2f6b8d10-9e3c-4a57-b1d4-6c8e0a2f7b95;c9d2a7e4-1f38-4b6c-a5e0-3d7b9c1f8a42;c9d2a7e4-1f38-4b6c-a5e0-3d7b9c1f8a42 ``` V každém nástroji, který soubory čte, nastavte tyto čtyři volby: | Nastavení | Hodnota | | - | - | | Oddělovač | Středník (`;`) | | Kódování | UTF-8, se značkou pořadí bajtů | | Oddělovač desetin | Tečka, se dvěma desetinnými místy (`202.42`) | | Data | `YYYY-MM-DD`, v časovém pásmu vašeho účtu | Částky čtěte v hlavní jednotce měny. Vrácení peněz a poplatky platformy jsou negativní, takže pro čistý výnos nebo čistý výtěžek sčítejte `Amount_Total`. Počet sloupců s daní sleduje daňové sazby použité v období: `Tax_Rate_1` a `Tax_Amount_1`, potom `_2` a tak dál. Období s novou sazbou přidá sloupec. Na sloupce odkazujte jménem, nikdy pozicí. Stránka [Finanční reporty](https://www.twicecommerce.com/docs/cs/concepts/reports/finance-reports.md) v části o exportu do CSV popisuje každý sloupec a to, který sloupec s datem sčítat pro prodaný, vydaný a vrácený výnos. ## Postavte datový model nad knihami Načtěte obě knihy jako tabulky faktů a spojte je na klíči výnosů: | Tabulka | Klíč | Spojuje se na | | - | - | - | | Kniha výnosů | `Row_ID` | | | Kniha plateb | `Row_ID` | `Revenue_Row_ID` → `Row_ID` výnosů | Objednávky seskupujte na `Order_ID` a místa na `Location` a `Cost_Center`. Poplatky platformy a platby bez řádku objednávky mají `Revenue_Row_ID` prázdný, takže ponechte spojení jako left join od plateb. Hodnota `Row_ID` je stabilní napříč voláními. Použijte ji k odstranění duplicit, když se období dvou volání překrývají. ## Přečtěte místo toho vestavěný report Z karty **Export** kteréhokoli reportu zkopírujte **koncový bod JSON** s filtry, které chcete použít. Odpověď nese sloupce `columns` a řádky `rows` daného reportu: ```bash cURL theme={null} curl "https://server.twicecommerce.com/internal/reporting/reports/sales-overview/data?from=2026-08-28T21%3A00%3A00.000Z&to=2026-09-28T20%3A59%3A59.999Z" \ -H "X-API-KEY: {key}" ``` ```json Odpověď (zkrácená) theme={null} { "reportId": "sales-overview", "columns": [ { "field": "id", "headerName": "Order ID" }, { "field": "date", "headerName": "Date", "type": "date" }, { "field": "customer", "headerName": "Customer" }, { "field": "location", "headerName": "Location" }, { "field": "total", "headerName": "Total", "type": "currency", "currency": "EUR" }, { "field": "status", "headerName": "Status" } ], "rows": [ { "id": "7d1c9e4a-3b2f-4c8e-9a61-5f0e2b7c4d13", "date": "2026-09-01", "customer": "Aino Virtanen", "location": "Helsinki", "total": 20242, "status": "open" }, { "id": "2f6b8d10-9e3c-4a57-b1d4-6c8e0a2f7b95", "date": "2026-09-02", "customer": "Lumo Events Oy", "location": "Tampere", "total": 40000, "status": "closed" } ], "totalCount": 212, "truncated": false } ``` Sloupce typu `currency` drží menší jednotky (centy): pro eura dělte stem. Hodnota `truncated: true` znamená, že report narazil na limit 1 000 řádků, takže zužte data nebo použijte knihu. Pro vestavěný report jako CSV volejte `/internal/reporting/reports/{reportId}/export` s parametry `from` a `to`. Vrátí stejné řádky ve formátu souboru knihy. ## Dodržte limity volání Obnovení naplánujte podle limitů. Obnovení, které odpálí mnoho volání naráz, narazí na ně dřív než na data. | Volání | Limit na adresu IP | Limit na účet | | - | - | - | | Exporty knih a reportů do CSV | 5 za minutu | 10 za minutu | | Data reportu v JSON | 30 za minutu | 60 za minutu | Jedno obnovení držte na pěti voláních exportu nebo méně. Každé volání se také započítává do kvóty vašeho klíče API, popsané na stránce [Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md) v části o limitech volání. ## Jak poznám, že to fungovalo? * Testovací volání uloží soubor CSV, jehož první řádek začíná `Create_Date;Start_Date;End_Date`. * Součet `Amount_Total` tam, kde `Started_In_Period` je `Yes`, odpovídá reportu **Report výnosů** v administraci za stejné období, ve stejné měně a s uznáním výnosu **Zahájeno v období**. * Poslední řádek souboru je řádek s daty, ne zpráva. ## Řešení potíží a časté chyby > **Volání vrátí 401 Unauthorized** > > Klíč chybí, je přepsaný s chybou, nebo byl smazán. Posílejte ho v hlavičce s názvem `X-API-KEY`, ne v adrese URL, a zkontrolujte, že klíč stále existuje pod **Nastavení → Integrace & API**. > **Volání vrátí 400 Bad Request** > > Povinný parametr chybí nebo má špatný formát. Knihy potřebují `from`, `to` a `currency` a data musí být v čistém formátu `YYYY-MM-DD` bez času. > **Poslední řádek zní "Export truncated at 100,000 rows"** > > Období drží více řádků, než vrátí jedno volání. Rozdělte období, například na jedno volání za rok, a výsledky spojte. Hodnota `Row_ID` udrží spojenou tabulku bez duplicit. > **Volání vrátí 429 Too Many Requests** > > Obnovení provedlo za minutu příliš mnoho volání. Vyčkejte počet sekund uvedený v hlavičce `Retry-After` a potom snižte počet volání exportu na jedno obnovení na pět nebo méně. > **Koncový bod CSV na kartě Export vrací JSON** > > **Koncový bod CSV** zobrazený na kartě **Export** u reportu vrací stejný JSON jako **koncový bod JSON**. Pro CSV nahraďte v cestě `/data` za `/export` a vynechte parametr `compareTo`. > **Součty jsou stokrát větší** > > Data pocházejí z koncového bodu JSON u vestavěného reportu, který vrací peníze v centech. Sloupce typu `currency` dělte stem. Soubory knih jsou už v eurech. > **Sloupec zmizel nebo se objevil nový** > > Sloupce s daní sledují daňové sazby použité v období. Na sloupce odkazujte jménem a `Tax_Rate_n` i `Tax_Amount_n` berte jako volitelné. ## Související články > **[Připojte Power BI](https://www.twicecommerce.com/docs/cs/guides/reports/connect-power-bi.md)** > > Načtěte knihy do Power BI a obnovujte je podle plánu. > **[Připojte Tabulky Google](https://www.twicecommerce.com/docs/cs/guides/reports/connect-google-sheets.md)** > > Načtěte knihy do tabulky pomocí Apps Scriptu. > **[Finanční reporty](https://www.twicecommerce.com/docs/cs/concepts/reports/finance-reports.md)** > > Každý sloupec obou knih a jak se každé číslo odvozuje. > **[Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md)** > > Vytváření klíčů a limity volání, které každý klíč sdílí. > **[Reporty](https://www.twicecommerce.com/docs/cs/reports.md)** > > Každý vestavěný report a jeho karta Export. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.