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

# Miten yhdistät Excelin TWICE Commerceen

> Lataa liikevaihto- ja maksupääkirjat Excel-työkirjaan Power Queryllä ja päivitä ne aina, kun työkirja avataan.

<Frame caption="Raportit > Myyntinäkymä > Vie">
  <img src="https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/reports-export.webp?fit=max&auto=format&n=Ab7tx7ih94KQsi0k&q=85&s=5b8746adc8bb592f174ae9f8130924e2" alt="Raportin Vie-välilehti, jossa ovat REST API -päätepisteet" width="1920" height="1080" data-path="images/reports-export.webp" />
</Frame>

<Card title="Avaa TWICE Adminissa" icon="external-link" href="https://admin.twicecommerce.com/reports" horizontal>
  reports
</Card>

Lataa liikevaihto- ja maksupääkirjat Exceliin kahtena päivitettävänä taulukkona ja rakenna niiden päälle pivot-taulukot ja kaaviot. Jokainen päivitys hakee TWICE Commercesta uusimmat rivit.

## Edellytykset

<Warning>
  **Vaaditut oikeudet:** TWICE Commercen API-avain. Sillä on omistajatason oikeudet ja se tallentuu työkirjaan, joten jaa työkirja vain henkilöille, joille antaisit myös avaimen. Katso [API-avaimet](/docs/fi/concepts/integrations/api-keys).
</Warning>

<Info>
  **Ennen kuin aloitat:**

  * **Excel for Microsoft 365 Windowsissa.** Nämä vaiheet käyttävät sen Power Query -editoria.
  * **Pääkirjojen päätepisteet ja tiedostomuoto** oppaasta [Tuo datasi BI-työkaluun](/docs/fi/guides/reports/pull-report-data).
  * **Valuuttakoodisi** ja ensimmäinen päivä, josta haluat historiaa.

  Excelin ja Power Queryn nimikkeet on kirjoitettu tässä oppaassa sellaisina kuin ne näkyvät englanninkielisessä käyttöliittymässä.
</Info>

## Vaiheittainen ohje

<Steps>
  <Step title="Avaa tyhjä kysely">
    Valitse **Data → Get Data → From Other Sources → Blank Query**. Power Query -editori avautuu.
  </Step>

  <Step title="Tallenna avain parametriin">
    Valitse **Home → Manage Parameters → New Parameter**, anna nimeksi `TwiceApiKey`, aseta **Type**-arvoksi **Text** ja liitä avain kenttään **Current Value**.
  </Step>

  <Step title="Liitä liikevaihtopääkirjan kysely">
    Valitse tyhjä kysely, avaa **Advanced Editor** ja korvaa sen sisältö alla olevalla kyselyllä. Vaihda `currency` ja `FromDate` omiksesi. Nimeä kysely `Revenue`.
  </Step>

  <Step title="Yhdistä anonyymisti">
    Valitse **Edit Credentials**, kun Power Query kysyy yhteystapaa, valitse **Anonymous** ja valitse **Connect**. Avain kulkee otsakkeessa.
  </Step>

  <Step title="Lisää maksupääkirjan kysely">
    Monista `Revenue`-kysely, nimeä kopio `Payments` ja vaihda `RelativePath`-arvoksi `internal/reporting/payments/export`. Korvaa tyypitetyt sarakkeet niin, että `Payment_Date` on `type date` ja `Amount_Total` on `type number`.
  </Step>

  <Step title="Lataa taulukot">
    Valitse **Home → Close & Load**. Kukin kysely latautuu omalle taulukkosivulleen Excel-taulukkona.
  </Step>

  <Step title="Päivitä avattaessa">
    Napsauta hiiren kakkospainikkeella `Revenue`-kyselyä kohdassa **Queries & Connections**, valitse **Properties** ja rastita **"Refresh data when opening the file"**. Toista sama `Payments`-kyselylle.
  </Step>
</Steps>

Käytä tätä kyselyä liikevaihtopääkirjalle:

<CodeGroup>
  ```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
  ```
</CodeGroup>

`"en-US"`-kulttuuri lukee arvon `202.42` numerona myös tietokoneella, jonka alueasetuksissa desimaalierotin on pilkku, kuten suomalaisissa. Verosarakkeet jätetään tyypittämättä, koska niiden määrä seuraa jakson verokantoja.

Excel-taulukkoon mahtuu noin miljoona riviä. Jos tarvitset pidemmän historian kuin yksi kutsu palauttaa, käytä vuosikohtaista kyselyä oppaasta [Yhdistä Power BI](/docs/fi/guides/reports/connect-power-bi#lataa-yli-100-000-riviä). Se toimii Excelissä sellaisenaan.

## Mistä tiedän, että se onnistui?

* `Revenue`-taulukkosivu näyttää yhden rivin tilausriviä kohden, ja `Amount_Total` on tasattu oikealle numerona.
* Pivot-taulukko, joka laskee `Amount_Total`-summan suodatettuna ehdolla `Started_In_Period` = `Yes`, vastaa hallintapaneelin **Liikevaihtoraporttia** samalla jaksolla ja valuutalla.
* **Data → Refresh All** valmistuu ilman virhettä.

## Vianetsintä ja yleiset sudenkuopat

<AccordionGroup>
  <Accordion title="Summat latautuvat tekstinä tai muodossa 20242 eikä 202.42">
    Sarake tyypitettiin tietokoneesi alueasetuksilla. Säilytä `"en-US"`-kulttuuriargumentti funktiossa `Table.TransformColumnTypes`, ja poista jokainen **Changed Type** -vaihe, jonka Power Query lisäsi itse.
  </Accordion>

  <Accordion title="Excel kysyy tunnistetietoja uudelleen jokaisella päivityksellä">
    Tunnistetiedot tallennettiin eri URL-osoitteelle. Avaa **Data → Get Data → Data Source Settings**, tyhjennä kohteen `server.twicecommerce.com` merkintä, päivitä ja valitse **Anonymous** uudelleen.
  </Accordion>

  <Accordion title="Päivitys epäonnistuu virheellä &#x22;The column 'Tax_Rate_2' of the table wasn't found&#x22;">
    Jokin vaihe viittaa verosarakkeeseen, jota uudella jaksolla ei ole. Poista verosarakkeet kaikista tyypitys- ja uudelleennimeämisvaiheista.
  </Accordion>

  <Accordion title="Päivitys epäonnistuu virheellä 401, vaikka se toimi aiemmin">
    Joku poisti tai vaihtoi API-avaimen. Aseta uusi avain `TwiceApiKey`-parametriin kohdassa **Manage Parameters**.
  </Accordion>
</AccordionGroup>

Microsoft kuvaa editorin artikkelissa [Power Query in Excel](https://support.microsoft.com/en-us/office/about-power-query-in-excel-7104fbee-9e62-4cb9-a02e-5bfb1a6c536a) ja lähteen artikkelissa [Power Query Web connector](https://learn.microsoft.com/en-us/power-query/connectors/web/web).

## Aiheeseen liittyvät artikkelit

<CardGroup cols={2} className="doc-rows-condensed">
  <Card title="Tuo datasi BI-työkaluun" href="/docs/fi/guides/reports/pull-report-data">
    Päätepisteet, tiedostomuoto ja kutsurajat.
  </Card>

  <Card title="Yhdistä Power BI" href="/docs/fi/guides/reports/connect-power-bi">
    Samat kyselyt ajastetusti päivitettynä.
  </Card>

  <Card title="Talousraportit" href="/docs/fi/concepts/reports/finance-reports">
    Jokainen pääkirjan sarake, ja miten kukin luku muodostuu.
  </Card>
</CardGroup>