Plugin OBERON posiela vydané faktúry do účtovného systému OBERON dvomi možnými spôsobmi: priamo cez webovú službu (WebServices API), alebo ako export do natívneho OBERON XML na ručný import.
Kde to nájdete
Systém > Pluginy > OBERON (účtovníctvo) na /admin/plugins.
Test spojenia je aj na Nastavenia > Diagnostika integrácií (/admin/settings/integrations).
1. Rozhodnite sa medzi webovou službou a XML
Ak vyplníte Adresu webovej služby OBERON (napr. http://192.0.2.10:21001 alebo https://vasafirma.server1.oberonlink.sk), export ide priamo cez API — vyžaduje automatickú úlohu „WebServices API - OBERON“ (G2) zapnutú v OBERON Automation Center. Necháte-li pole prázdne, plugin použije len export do XML na ručný import.
2. Vyplňte prihlásenie a prevádzku
Zadajte Používateľa a Heslo OBERON účtu (heslo sa po uložení zašifruje a už sa nezobrazuje). Názov prevádzky vyplňte iba vtedy, ak vaša účtovná jednotka prevádzky používa — ovplyvňuje číselný rad faktúr; inak ho nechajte prázdny.
Polia a nastavenia
| Pole | Povinné | Význam |
|---|---|---|
| Adresa webovej služby | nie | Prázdne = len XML export bez priameho API |
| Používateľ, Heslo | podľa API | Prihlásenie do webovej služby OBERON |
| Názov prevádzky | nie | Len pri účtovnej jednotke s prevádzkami |
| Automatická synchronizácia | nie | Po zaplatení objednávky odošle faktúru automaticky; bez toho len ručne tlačidlom „Odoslať do OBERON“ |
| Typ dokladu | nie (predvolené „Faktúra“) | Musí presne sedieť s číselníkom OBERON, inak ho OBERON odmietne |
| Typ DPH | nie | Text z číselníka OBERON; prázdne necháva OBERON doplniť predvolený |
| DPH pri doprave a poplatkoch | nie (predvolené „sadzba dokladu“) | Doprava nemá v e-shope vlastnú sadzbu DPH — použitie sadzby dokladu je správna voľba pre slovenské účtovníctvo; nulovú sadzbu voľte len po dohode s účtovníčkou |
| Exportovať len uhradené faktúry | nie | Bez zaškrtnutia sa exportujú aj vystavené neuhradené faktúry (patria do Knihy pohľadávok rovnako ako uhradené) |
3. Otestujte pripojenie
Na Nastavenia > Diagnostika integrácií nájdite OBERON a spustite test spojenia — je jedna z mála integrácií s reálnym testom (nielen kontrolou vyplnených polí).
Čo sa deje na pozadí
Pri zapnutej automatickej synchronizácii sa faktúra odošle po zaplatení objednávky; bez nej ostáva tlačidlo „Odoslať do OBERON“ na faktúre k dispozícii kedykoľvek. Typ dokladu a typ DPH sa posielajú ako text — musia doslovne sedieť s tým, čo má OBERON vo vlastnom číselníku, inak doklad odmietne.
Časté problémy
- OBERON odmieta doklad kvôli typu → text v poli Typ dokladu alebo Typ DPH nesedí presne s číselníkom OBERON; skopírujte ho odtiaľ doslovne.
- Test spojenia zlyhá → skontrolujte adresu webovej služby (port,
https/http) a prihlasovacie údaje; over aj to, že je úloha „WebServices API - OBERON“ v Automation Center skutočne zapnutá. - Faktúra sa neodoslala automaticky → over prepínač automatickej synchronizácie; bez neho treba faktúru odoslať ručne.
- Neuhradené faktúry v OBERON-e nevidno → zaškrtnuté „Exportovať len uhradené faktúry“ ich zámerne vynecháva.
- DPH pri doprave nesedí s očakávaním účtovníčky → prepnite voľbu „DPH pri doprave a poplatkoch“ na nulovú sadzbu, ak sa tak s ňou dohodnete; predvolená sadzba dokladu je správna pre bežné slovenské účtovníctvo.