Integrácia v2: LIVE editor a kód
Naklikajte si nastavenia podľa platformy, polí, krajín, adries, VIES a vzhľadu dropdownu. Výsledkom je hotový JS snippet, ktorý stačí skopírovať do webu.
Prepni si živý náhľad alebo hotový snippet.
Vložte HTML časť checkoutu a my automaticky zistíme selektory pre polia.
Ako na integráciu (3 kroky)
<meta name="autofirmy-verification" content="META_KOD">fields je obyčajný CSS selektor.
</body>. Loader sa postará o company + VAT + address autocomplete.
<script src="https://api-data.eu/api/js/rpo_ares_autocomplete_inc.js" defer></script>Pokročilé nastavenia (nepovinné)
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>.
- 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.
- 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 defaultSK(máme to v snippete).
- 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.
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žiinput[name="..."]. - Over v konzole:
document.querySelector('...')musí vrátiť element (nienull). - Keď je viac rovnakých polí, zúž selektor (napr.
form#checkout input[name="company"]).
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 }));
}
})();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 adresyAk chcete doladiť UX (menej requestov / rýchlejšie reakcie), upravte:
address: {
minChars: 3,
limit: 8,
debounce: 240
}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).