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

Karta Export u reportu s tlačítky ke stažení a koncovými body REST API — Reporty > Přehled prodejů > Export

Otevřít v TWICE Admin

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

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.

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.

Pokročilé vykazování je dostupné v plánech Standard a Enterprise. Viz plány (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	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

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.

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. Kniha nese všechna místa, takže ve svém nástroji filtrujte podle jejího sloupce Location.

https://server.twicecommerce.com/internal/reporting/revenue/export?from=2026-01-01&to=2026-09-30&currency=EUR

Otestujte adresu URL s klíčem

Klíč posílejte v hlavičce X-API-KEY. Funkční volání vrátí knihu jako CSV.

curl "https://server.twicecommerce.com/internal/reporting/revenue/export?from=2026-01-01&to=2026-09-30&currency=EUR" \
  -H "X-API-KEY: {key}" \
  -o revenue-2026.csv

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, Excel, Tabulky Google, Tableau nebo Looker Studio.

Přečtěte si soubory knih

Otevřete soubor, který jste uložili při testu, a zkontrolujte, že začíná takto:

Kniha výnosů, první řádky

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

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}"

{
  "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 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

Načtěte knihy do Power BI a obnovujte je podle plánu.

Připojte Tabulky Google

Načtěte knihy do tabulky pomocí Apps Scriptu.

Finanční reporty

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

Klíče API

Vytváření klíčů a limity volání, které každý klíč sdílí.

Reporty

Každý vestavěný report a jeho karta Export.

Spusťte TWICE

Práce v TWICE

Jak přetáhnout svá data do nástroje BI

Otevřít v TWICE Admin

Předpoklady

Vyberte koncový bod pro data, která potřebujete

Postup

Přečtěte si soubory knih

Postavte datový model nad knihami

Přečtěte místo toho vestavěný report

Dodržte limity volání

Jak poznám, že to fungovalo?

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

Související články

Připojte Power BI

Připojte Tabulky Google

Finanční reporty

Klíče API

Reporty

Otevřít v TWICE Admin

​Předpoklady

​Vyberte koncový bod pro data, která potřebujete

​Postup

​Přečtěte si soubory knih

​Postavte datový model nad knihami

​Přečtěte místo toho vestavěný report

​Dodržte limity volání

​Jak poznám, že to fungovalo?

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

​Související články

Připojte Power BI

Připojte Tabulky Google

Finanční reporty

Klíče API

Reporty

Předpoklady

Vyberte koncový bod pro data, která potřebujete

Postup

Přečtěte si soubory knih

Postavte datový model nad knihami

Přečtěte místo toho vestavěný report

Dodržte limity volání

Jak poznám, že to fungovalo?

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

Související články