V určitých případech může být užitečné automaticky předvyplnit vybraná pole prodejního formuláře FAPI na webové stránce konkrétními údaji klienta.

Jednou z možností jsou parametry v URL adrese stránky s prodejním formulářem. Vkládejte je do adresy stránky, ne do URL vkládaného skriptu. Pro vlastní JavaScript můžete použít také programové předvyplnění.

Celý videonávod máte k dispozici zde:

Jaké údaje lze předvyplnit?

Pro předvyplnění prodejního formuláře je možné použít následující parametry:

  • fapi-form-name= (Jméno)
  • fapi-form-surname= (Příjmení)
  • fapi-form-email= (E-mailová adresa)
  • fapi-form-mobil= (Mobil)
  • fapi-form-street= (Ulice)
  • fapi-form-city= (Město)
  • fapi-form-postcode= (PSČ)
  • fapi-form-state= (Stát)
  • fapi-form-company= (Firma)
  • fapi-form-ic= (IČ)
  • fapi-form-dic= (DIČ)
  • fapi-form-notes= (Poznámka)
  • fapi-form-discountCode= (Slevový kód)
  • fapi-form-customField-{id} (Vlastní pole)
  • fapi-form-item-{product_code}=1 (předvybrání /=1/ nebo vypnutí /=0/ označení produktu) 
  • fapi-form-item-count-{product_code}=10 (Nastavení počet produktů k zakoupení, pouze v případě že se ve formuláři dá počet zakoupených produktů měnit) 
  • fapi-form-repayment=1 (předvybrání /=1/ nebo vypnutí /=0/ splátek)

Formát zápisu

Parametry se do URL adresy stránky vkládají spolu s hodnotou, která se má předvyplnit do příslušného pole prodejního formuláře.

Obecný formát zápisu je následující:

?název_parametru_1=hodnota_parametru_1&název_parametru_2=hodnota_parametru_2&...

Příklady použití

Předvyplnění e-mailové adresy, jména a příjmení klienta a poznámky (Jan Malý, jan.maly@seznam.cz, VIP):

?fapi-form-email=jan.maly@seznam.cz&fapi-form-name=Jan&fapi-form-surname=Malý&fapi-form-notes=VIP

Předvyplnění státu (Dánsko):

?fapi-form-state=DK

Předvyplnění vlastního pole (sobota):

?fapi-form-customField-20=sobota

Programové vyplnění prodejního formuláře

Pokud máte zákaznické údaje k dispozici ve svém webu, můžete je předat formuláři metodou prefillCustomer. Není potřeba měnit jednotlivá HTML pole ani ručně vyvolávat jejich události. S úpravou JavaScriptu vám může pomoci správce webu.

  1. Na stránku vložte následující kód před kód prodejního formuláře. Ukázkové údaje nahraďte údaji, které chcete předvyplnit.
  2. Za něj vložte běžný HTML kód prodejního formuláře.
  3. Stránku uložte, otevřete ji mimo editor a zkontrolujte vyplněná pole. Zákazník může údaje před objednáním upravit.
<script>
  document.addEventListener('fapiFormMounted', function (event) {
    event.detail.api.prefillCustomer({
      email: 'zakaznik@example.com',
      company: 'Ukázková firma',
      ic: '12345679'
    });
  });
</script>

Událost fapiFormMounted vzniká při připojení každého formuláře. Uvedená ukázka proto vyplní každý formulář vložený na stránce. Předvyplněná firma nebo IČ zobrazí firemní údaje. Klíče, které metodě nepředáte, se nemění. Neprázdné hodnoty v fapi-form-data nebo URL parametrech fapi-form-… mají přednost před údaji předanými metodě.

Další formulář na vlastní děkovací stránce

Pokud chcete po objednávce nabídnout další nákup bez opakovaného zadávání kontaktu, může zákaznické údaje předat FAPI SDK, tedy skript pro práci s údaji objednávky:

<script src="https://form.fapi.cz/js/sdk/fapi.js"></script>

Nejprve připravte vlastní děkovací stránku s HTTPS, SDK a předáním identifikátoru objednávky do URL. Na stránku musí přijít parametr path původní objednávky. Správce webu zajistí, aby byly požadované formuláře připojené před zpracováním dat v SDK. To je předvyplní jednou, včetně více instancí stejného formuláře. Později přidaný formulář se automaticky nedoplní. Samotný vkládací kód formuláře údaje předchozí objednávky nenačítá.

Přebírají se kontaktní a fakturační údaje; samostatná doručovací adresa jen tehdy, pokud ji předchozí objednávka má a nový formulář ji povoluje. Produkty, způsob platby, poznámka a souhlasy patří k nové objednávce a tímto přenosem se nevyplní. Odkaz s parametrem path nesdílejte veřejně, protože zpřístupňuje údaje objednávky.

Zrušení předvyplnění prvního produktu

Otevřete nastavení svého formuláře: Prodejní formuláře → 2. Položky a ceny. Zapněte Vypnout předvyplnění prvního produktu a formulář uložte.