Autoform SK/CZ – firemné údaje + adresy (v2)

Integrácia: moduly, snippet alebo API

Vyberte si spôsob integrácie podľa platformy: hotové moduly, rýchly JS snippet alebo priama integrácia cez API. Funguje pre firemné údaje (RPO/ARES), VIES a autocomplete adries (v2).

Rýchly štart (snippet) Presety platforiem Pokročilé nastavenia

Ďalšie zdroje: Moduly na stiahnutie Dokumentácia API

Ak máte podporovanú platformu: modul je zvyčajne najrýchlejšia cesta.
Vlastné riešenie / iný systém: použite snippet alebo priamo API podľa dokumentácie.

Vložte licenciu do <head>

Licencia je viazaná na doménu a plán (limity). Meta tag patrí do HTML šablóny.

FREE Pri FREE kľúčoch meta tag netreba – stačí vložiť konfiguráciu + loader skript (krok 2+3).

<meta name="autofirmy-verification" content="META_KOD">

Nastavte selektory polí

V konfigurácii mapujete iba vaše inputy. Každá položka v fields je obyčajný CSS selektor.

Najčastejšie: #id, input[name="..."]

Hotové presety platforiem

Načítajte loader skript

Vložte tesne pred </body>. Loader sa postará o company + VAT + address autocomplete.

<script src="https://api-data.eu/api/js/rpo_ares_autocomplete_inc.js" defer></script>

Minimalistický snippet (odporúčané)

company + VAT + address

Dôležité: aj pri addressMode: 'combined' nastavte v praxi vždy fields.street na input „Ulica a č. domu“ (nie fullAddress). Loader pripína address autocomplete na street.

Ulica + číslo v 1 poli Ulica a číslo zvlášť

Najčastejší checkout: jedno pole „Ulica a č. domu“.

<!-- FREE kľúč: meta tag netreba. Platené plány: vlož meta do <head>. -->
<meta name="autofirmy-verification" content="META_KOD">
<script>
window.RPO_AUTOCOMPLETE_CONFIG = {
  apiKey: 'VAS_API_KEY',

  theme: 'auto',
  dropdown: { width: 'min' },

  addressMode: 'combined',
  countrySelect: '#CountryId', // ak máte select krajiny (SK/CZ)

  vies: 'on',
  debug: true,  // true / false - zapne vypne log v konzole

  fields: {
    company: '#FirmId',
    ico:     '#INId',
    dic:     '#TINId',
    vat:     '#INVATId',

    // adresa (combined) - stále mapujte na "street"
    street:  '#AddressId',
    city:    '#CityId',
    postal:  '#PostalId'
  },

  radius: { top: 0, bottom: 8 }
};
</script>
<script src="https://api-data.eu/api/js/rpo_ares_autocomplete_inc.js" defer></script>

Tip: ak máte v selecte krajiny default -1 („Vyberte krajinu“), nastavte ho pri loadnutí na SK, inak sa firemné vyhľadávanie (SK) nespustí, kým user nevyberie krajinu.

Ak máte dve samostatné polia (ulica + číslo), použite split.

<!-- FREE kľúč: meta tag netreba. Platené plány: vlož meta do <head>. -->
<meta name="autofirmy-verification" content="META_KOD">
<script>
window.RPO_AUTOCOMPLETE_CONFIG = {
  apiKey: 'VAS_API_KEY',
  theme: 'auto',
  dropdown: { width: 'min' },

  addressMode: 'split',
  countrySelect: '#CountryId',

  vies: 'on',

  fields: {
    company:     '#FirmId',
    ico:         '#INId',
    dic:         '#TINId',
    vat:         '#INVATId',

    street:      '#StreetId',
    descriptive: '#HouseNumberId',
    city:        '#CityId',
    postal:      '#PostalId'
  },

  radius: { top: 0, bottom: 8 }
};
</script>
<script src="https://api-data.eu/api/js/rpo_ares_autocomplete_inc.js" defer></script>

Čo sa dopĺňa

Firma, IČO/DIČ/IČ DPH, adresa, PSČ, mesto. Voliteľne VIES validácia.

Kedy sa spustí

Pri písaní do firmy/ulice. Detail sa dotiahne po výbere položky.

Čo si ustrážiť

Správne selektory + countrySelect. Ak je krajina „-1“, nastavte default SK.

Pokročilé nastavenia (nepovinné)

Kde vložiť kód (šablóny / templaty) - najčastejšie platformy

Toto je praktická časť, ktorú ľudia vždy hľadajú: kam to dať. Presné názvy sú podľa platformy. Vždy platí: meta do <head>, config + loader ideálne pred </body>.

BiznisWeb

Hlavička / head: vlož <meta ...> do hlavnej šablóny (layout / header).
Pätička / footer: vlož window.RPO_AUTOCOMPLETE_CONFIG + loader pred </body>.
Ak máš viac checkout šablón, vlož kód do tej, ktorá sa používa pri objednávke.

RýchlyWeb (Webix checkout)

Najčastejšie je to 1 stránka / 1 šablóna objednávky. Vlož snippet do tej istej šablóny, kde sú inputy.
Ak je checkout skladaný z include častí, hľadaj súbor s formulárom „Fakturačná adresa / Firemné údaje“.
Ak select krajiny štartuje na -1, nastav default SK (máme to v snippete).

WEXBO

Vkladá sa do stránky objednávky (kde sú inputy). Ak je to modul / plugin, vlož snippet do template, ktorý renderuje checkout formulár.

Atomer

Väčšinou má jednu hlavnú šablónu + stránku objednávky. Snippet patrí na checkout.

ShopTec

Vlož do layoutu (meta) a do šablóny checkoutu (config + loader).

Všeobecné pravidlo (keď nevieš názvy template)

Otvor stránku checkoutu.
V DevTools → Sources vyhľadaj text z tej stránky (napr. „Fakturačná adresa“), nájdeš šablónu.
Do šablóny vlož snippet čo najnižšie (pred koniec stránky), aby inputy už existovali.

Ako nájsť správne selektory polí (bez hádania)

Nehádaj selektory. Nájdi ich raz a je po probléme.

V prehliadači klikni pravým na input → Inspect.
Preferuj #id. Ak nie je, použi input[name="..."].
Over v konzole: document.querySelector('...') musí vrátiť element (nie null).
Keď je viac rovnakých polí, zúž selektor (napr. form#checkout input[name="company"]).

document.querySelector('#FirmId')

Vypnúť iba company alebo iba address autocomplete

Ak chcete dočasne vypnúť niektorú časť (napr. len firmy), použite toggles:

window.RPO_AUTOCOMPLETE_CONFIG = {
  apiKey: 'VAS_API_KEY',
  autocomplete: {
    company: true,
    address: true
  }
};

// alebo kratšie:
window.RPO_AUTOCOMPLETE_CONFIG.companyAutocomplete = false; // vypne firmy
window.RPO_AUTOCOMPLETE_CONFIG.addressAutocomplete = false; // vypne adresy

Vlastné farby dropdownu (theme: custom / custom-template)

theme: 'custom',
customTheme: {
  bg:        '#0b1120',
  bgHover:   '#020617',
  border:    '#1e293b',
  text:      '#e5e7eb',
  textMuted: '#94a3b8',
  highlight: '#38bdf8',
  shadow:    '0 22px 50px rgba(15,23,42,0.9)'
}

Šírka dropdownu + radius rohov

dropdown: { width: 'min' },  // 'min' | 'match' | číslo (px)
radius:   { top: 0, bottom: 8 }

Adresy (v2) - minChars, limit, debounce

Ak chcete doladiť UX (menej requestov / rýchlejšie reakcie), upravte:

address: {
  minChars: 3,
  limit: 8,
  debounce: 240
}

Krajina (countrySelect) a „-1“ default

Ak je select krajiny na začiatku -1 („Vyberte krajinu“), firemný autocomplete (SK) nebude bežať, kým user krajinu nezvolí. Toto je najčastejšia „vyzerá to nefunkčné“ chyba.

// voliteľné - nastav default SK pri loadnutí stránky
(function () {
  var sel = document.querySelector('#CountryId');
  if (sel && String(sel.value) === '-1') {
    sel.value = 'SK';
    sel.dispatchEvent(new Event('change', { bubbles: true }));
  }
})();

Presety platforiem (skopíruj / vlož)

Ak nechcete riešiť selektory, vyberte platformu. Ak vaša platforma nie je v zozname, použite „Vlastný web“, a upravte selektory podľa HTML.
FREE kľúče meta tag nepoužívajú – meta je iba pre platené plány.

Platforma

Tip: po vložení zmeňte VAS_API_KEY. Meta META_KOD je iba pre platené plány.

// Vyberte platformu vyššie…

Potrebujete poradiť s integráciou?

Urobíme to za vás. Napíšte nám a pošlite link na checkout + screenshot polí (firma/adresa).

apidataeu@gmail.com