> ## 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 zmigrovat svá data přes API

> Přesuňte místa, zásoby, katalog, ceny a zákazníky účtu TWICE 1.0 do TWICE 2.0 přes Admin API, v pořadí, ve kterém na sobě data závisejí.

> [card] [Otevřít v administraci TWICE](https://admin.twicecommerce.com/settings/connect/integrations)
>
> settings/connect/integrations

Čtěte účet 1.0 přes jeho API a zapisujte ho do 2.0 přes [Admin API](https://www.twicecommerce.com/docs/cs/concepts/integrations/overview.md), jednu fázi po druhé. Každý krok uvádí, co musí fáze udělat správně a kde výsledek uvidíte v administraci. [Co se mění oproti TWICE 1.0](https://www.twicecommerce.com/docs/cs/guides/migration/what-changes-from-1-0.md) přiřazuje každému objektu z 1.0 jeho protějšek ve 2.0.

Objednávky nechte v 1.0. Importovaná objednávka dostane nové číslo a datum a zarezervuje zásoby napříč vaším kalendářem.

## Předpoklady

> [!WARNING]
>
> **Potřebná oprávnění:** **Integrace a API** pro vytvoření klíče (`account_settings:integrations`). Mají ho Vlastník a Admin. Viz [Uživatelé a role](https://www.twicecommerce.com/docs/cs/settings/users-roles.md).

> [!NOTE]
>
> **Mějte připravené, než začnete:**
>
> * **Nakonfigurované nastavení** z [kroku 1](https://www.twicecommerce.com/docs/cs/guides/migration/configure-settings.md): vaše místa, měna a nastavení daně existují dřív než jakákoli data.
> * **Klíč API k TWICE 1.0** pro daný účet. Pokud ho nemáte, požádejte o něj svůj kontakt v TWICE.
> * **Čtyři rozhodnutí, učiněná s obchodníkem:**
>   * **Místa:** jedno na každý obchod z 1.0, nebo několik obchodů sloučených do jednoho místa.
>   * **Ceny:** každá úroveň doby trvání z 1.0 jako pevný řádek, nebo jeden řádek podle sazby.
>   * **Zákazníci:** zmigrovat je, nebo je nechat v 1.0. Jde o osobní údaje.
>   * **Daň:** zda ceny v 1.0 zahrnují daň, zjištěno ze skutečné objednávky v 1.0.

## Postup

**1. Vytvořte klíč API pro 2.0**

Otevřete **Nastavení → Integrace & API** a na kartě **Klíče API** klikněte na **Vytvořit klíč**. Pojmenujte ho, potom v kroku **Přístup** zvolte **Omezený přístup** a nastavte **Inventář**, **Katalog** a **Lokace** na **Zápis**, plus **Zákazníci** a **Online obchod**, pokud je migrujete. Zkopírujte klíč z **Uložte svůj klíč API**: zobrazí se jen jednou.

![Okno pro vytvoření klíče API v kroku Přístup se zvýrazněným krokem, volbou Omezený přístup a řádky Inventář a Katalog nastavenými na Zápis](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-01.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=7fac6cd8f68d613c596d9f4ea2bef8c5)

**2. Zkontrolujte, že je účet 2.0 prázdný**

V administraci 2.0 otevřete **Katalog → Výpisy** a **Inventář → Skladové položky**. Obě tabulky mají být prázdné. Obsahují-li nabídky nebo skladové položky, účet už někdo migroval nebo sestavil: zastavte se a zjistěte kdo, než cokoli zapíšete. Teď uložte kopii dat obou účtů jako bod, ke kterému se lze vrátit.

![Tabulka Výpisy bez řádků, zvýrazněná](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-02.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=48d5af77169512d52c0bcb471fc8e106)

**3. Přiřaďte každý obchod z 1.0 k místu ve 2.0**

Otevřete **Nastavení → Místa**, poznamenejte si každé místo pod **Všechna umístění** a potom přes API načtěte jejich ID. Každý obchod z 1.0 přiřaďte k místu, kterým se stane, včetně sloučených obchodů. Zásoby, nabídky a ceny zapisujte k těmto ID. Vlastní nastavení míst nechte na kroku 1: místo bez způsobu vyzvednutí nebo vrácení, nebo bez prodejního kanálu, nedovolí objednat nic.

![Nastavení otevřené na stránce Místa se zvýrazněnou kartou Všechna umístění](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-03.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=26759c78d615bb016dfdb3bb7afc9c84)

**4. Vytvořte SKU a skladové položky**

Vytvořte jednu SKU na každou SKU z 1.0, se stejným kódem. Jednotlivé zboží z 1.0 vytvořte jako skladovou položku sledovanou jednotlivě a hromadné zboží jako jednu skladovou položku sledovanou podle množství. Prodané nebo ztracené zboží označte jako neaktivní. Nejdřív vytvořte atributy a přeneste na ně hodnoty vlastních polí.

![Tabulka SKU se zvýrazněnou položkou nabídky SKU a sloupcem Kód SKU](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-04.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=ae3122e988fa4217d9af0d3ee951f9ef)

**5. Vytvořte nabídky**

Vytvořte jednu nabídku na každý produkt z 1.0. Duplikáty, které obchodník vytvořil kvůli obejití omezení 1.0, přeskočte. Zkopírujte prodejní kanály každého produktu, včetně produktů skrytých v online obchodě. Popisy v Markdownu převeďte na formátovaný text, jinak storefront ukáže surové symboly.

![Karta Publikování u nabídky se zvýrazněnou kartou a kartou Prodejní kanály](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-05.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=112bae6b851d9119c47f44024b89759c)

**6. Zapište pravidla inventáře**

Dejte každé nabídce pravidlo, které odpovídá jejím kódům SKU. Balíku dejte jedno pravidlo na každou součást, každé na jeden kus: jedno pravidlo s více podmínkami vyhoví kterékoli z nich, samostatná pravidla musí být splněna všechna. U velikostí a jiných variant vytvořte možnosti a potom na každou možnost jedno pravidlo varianty, které se zúží na její zásoby.

![Karta Vyřízení u balíčkové nabídky se zvýrazněnou kartou a kartou skladových položek s jedním pravidlem pro každou součást](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-06.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=275e8a1268c1917c08cd8c3644dd1028)

**7. Vytvořte cenové tabulky**

Zapište každou úroveň z 1.0 jako pevný řádek, nebo jeden řádek podle sazby, podle rozhodnutí. Den z 1.0 počítaný v rámci otevírací doby se stane denním řádkem omezeným na zavírací dobu. Nejdřív zkontrolujte měřítko cen: některé účty 1.0 ukládají ceny v centech. Řádek platný každý den v týdnu nechává dny v týdnu nenastavené, nikdy ne prázdný seznam.

![Karta Ceny u nabídky se zvýrazněnou kartou a řádky cen](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-07.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=1a67066165d0cdc6a50fae98930a7400)

**8. Vytvořte doplňky**

Z bezplatného příslušenství udělejte nabídky doplňků a každou připojte k nabídkám, ke kterým patří, pokud obchodník nenabízí zdarma všechno. Pojištění nebo krytí škod vytvořte jako doplněk do košíku.

![Karta Doporučení u nabídky se zvýrazněnou kartou a kartou Doplňky](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-08.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=f55bb48fdb78e8c0067c8c51647f6145)

**9. Vytvořte kolekce**

Vytvořte jednu kolekci na každou kategorii z 1.0, kterou obchodník stále používá, a přidejte do ní její nabídky. Na kolekci bez online nabídky vypněte online kanál, jinak se v menu storefrontu zobrazí prázdná.

![Tabulka Kolekce, zvýrazněná](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-09.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=22398f5412958f9259d9a20460c37e45)

**10. Naimportujte zákazníky, pokud jste se tak rozhodli**

Vytvořte jednoho zákazníka na každého zákazníka z 1.0 a párujte podle e-mailu, abyste se vyhnuli duplikátům. Pokud se obchodník rozhodl nechat zákazníky v 1.0, tento krok přeskočte.

![Tabulka Zákazníci s rozmazanými řádky, zvýrazněná](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-10.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=6e12d9061031b849d08f409af5bb58e8)

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

* Každá SKU, skladová položka, produkt a kategorie z 1.0, které si obchodník ponechal, má protějšek ve 2.0, spočítaný proti součtům, které hlásí každé z obou API.
* Každá nabídka, za kterou stojí zásoby, má pravidlo inventáře a její cenové řádky odpovídají 1.0.
* Obchodník provedl [krok 3](https://www.twicecommerce.com/docs/cs/guides/migration/check-what-was-migrated.md) a každou nabídku lze objednat na storefrontu.

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

> [accordion] Každá nabídka se na storefrontu ukazuje jako nedostupná
>
> Místo nemá způsob vyzvednutí ani vrácení nebo má vypnutý online kanál, nebo cenové řádky neplatí v žádný den v týdnu. Viz [Jak zjistit, proč se nabídka neprodává](https://www.twicecommerce.com/docs/cs/guides/catalog/diagnose-an-unsellable-listing.md).

> [accordion] Ceny jsou stokrát vyšší nebo nižší
>
> Tento účet 1.0 ukládá ceny v jiné jednotce, než jste předpokládali. Porovnejte jednu zmigrovanou cenu s tím, co obchodník účtuje dnes, a potom fázi cen spusťte znovu. Viz [Co se mění oproti TWICE 1.0](https://www.twicecommerce.com/docs/cs/guides/migration/what-changes-from-1-0.md#vaše-ceny).

> [accordion] Balík lze objednat, i když jedna součást není skladem
>
> Jeho součásti sdílejí jedno pravidlo, takže ho splní kterákoli z nich. Rozdělte je, každou do vlastního pravidla. Viz [Pravidla inventáře nabídky](https://www.twicecommerce.com/docs/cs/guides/catalog/listing-inventory-rules.md).

## Související články

> [card] [Co se mění oproti TWICE 1.0](https://www.twicecommerce.com/docs/cs/guides/migration/what-changes-from-1-0.md)
>
> Každý objekt z 1.0 a co ho ve 2.0 nahrazuje.

> [card] [Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md)
>
> Rozsahy, platnost a jak klíč posílat.

> [card] [Hromadné vytváření](https://www.twicecommerce.com/docs/cs/concepts/integrations/bulk-creation.md)
>
> Vytvořte mnoho skladových položek, SKU nebo zákazníků jedním voláním.

> [card] [Zkontrolujte svá data proti 1.0](https://www.twicecommerce.com/docs/cs/guides/migration/check-what-was-migrated.md)
>
> Kontrola obchodníka po dokončení importu.


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