Slovenija – Elektronsko izdajanje računov e-SLOG

Funkcionalnosti

• Izvoz knjiženih izdanih računov in dobropisov v datoteke XML e-SLOG 2.0 INVOIC v200.

• Uvoz dokumentov XML e-SLOG 2.0 v osnutke prejetih računov oziroma dobropisov dobaviteljev. Iskanje priponk v datotekah PDF uporablja PyPDF2.PdfReader ter neposredno bere drevesa imen vdelanih datotek in povezane datoteke v katalogu PDF.

• Pripenjanje ustvarjene datoteke XML in normaliziranega nabora podatkov v obliki JSON ter beleženje izvoza in uvoza v razpravi na zapisu.

• Samodejno preverjanje skladnosti s priloženo shemo eSLOG20_INVOIC_v200.xsd za dokumente v imenskem prostoru e-SLOG 2.0, tudi s predponami. Neveljavni dokumenti in manjkajoča shema sprožijo napako.

• Uporaba načinov pošiljanja OCA s kodo eslog in podpora pošiljanju prek protokola HTTP, kadar je ustrezno nastavljeno.

• Uporaba kod UNECE za vrste in kategorije davkov ter merske enote pri preslikavi davkov in enot (l10n_si_account_tax_unece, uom_unece).

Nastavitev

Modul zahteva module account, account_invoice_export, account_invoice_import, l10n_si_account_tax_unece, l10n_si_config in uom_unece.

• Na zapisih kupcev izberite način pošiljanja e-SLOG.

• Za uporabo gumba Ustvari XML e-SLOG (Generate e-SLOG XML) je potrebno članstvo v skupini Uporabnik e-računov (e-Invoice User). Za dostop do nastavitev e-SLOG na ravni družbe je potrebna vloga Upravitelj e-računov (e-Invoice Manager). Upravitelj sam po sebi ne vključuje uporabniške vloge; za nastavitve in ustvarjanje XML dodelite obe vlogi.

• Za družbo in kupca vnesite naziv, državo, ulico ter identifikacijsko številko za DDV oziroma davčno številko. Številka s predpono države se izvozi z oznako VA; doda se tudi oznaka AHP. Pri številki brez predpone se uporabi samo AHP. Če so vse davčne kategorije na postavkah izdelkov O, generator izpusti sklice VA.

• Kategorijo UNECE nastavite na davčnih preslikavah fiskalnega položaja prek modula l10n_si_account_tax_unece. Postavke in povzetki najprej uporabijo kategorijo preslikave, nato privzeto kategorijo davka. Skupni S-KEU lahko pomeni storitev v EU AE ali izven sistema DDV izven EU O.

• Nastavite Opombe na fiskalnem položaju računa za ustrezno zakonsko klavzulo. Imajo prednost pred pravnimi opombami davka, opombami podprte nadrejene skupine in razlogom oprostitve DDV. Opombe, ki so prazne po odstranitvi oznak HTML, se preskočijo. Fiskalni položaji z istim davkom lahko zato izvozijo različne klavzule. XML vključuje klavzule in navedbo obračunavanja po plačani realizaciji. Manjkajoči razlogi za E, K, G in O preprečijo izvoz; za AE se brez nastavljene klavzule uporabi navedba Reverse charge (obrnjena davčna obveznost). Davčni modul zagotovi metapodatke UNECE in preslikave storitev S-KEU v EU v AE. Preverite pravno podlago dejanskega posla; Z ni kategorija za oprostitve domačih slovenskih dobav.

• Če želite v izvozu vključiti kode merskih enot, na merskih enotah nastavite kode UNECE z modulom uom_unece.

• Razčlenjevanje datotek PDF zahteva knjižnico PyPDF2, navedeno med zahtevanimi knjižnicami repozitorija.

Polje družbe Različica e-SLOG (e-SLOG Version) prikazuje podprto vrednost 2.0 in je samo za branje. ID prejemnika e-SLOG (e-SLOG Recipient ID) določa identifikator stranke v XML in ima prednost pred referenco in številko DDV. Kupec se izvozi iz poslovnega partnerja kupca; ID nastavite tam, ne samo na podrejenem kontaktu za račun. Ne določa ciljnega naslova HTTP ali povezave z imenikom prejemnikov.

Uporaba

1. Odprite knjižen izdani račun ali dobropis z načinom pošiljanja e-SLOG.

2. Izberite Ustvari XML e-SLOG (Generate e-SLOG XML). Dokument XML in njegov normalizirani nabor podatkov v obliki JSON se pripneta brez pošiljanja. Tudi standardni postopek pošiljanja računa po elektronski pošti vključuje ustrezno priponko XML e-SLOG.

3. Za postopek izvoza uporabite Pošlji e-račun (Send eBill). Pošiljanje prek HTTP se izvede le, če je omogočeno v načinu pošiljanja in je določen ciljni naslov URL.

4. S čarovnikom za uvoz prejetih računov naložite datoteko XML e-SLOG ali datoteko PDF, ki vsebuje XML.

Ustvarjena priponka ne dokazuje dostave ali sprejema dokumenta pri prejemniku. Če ciljni naslov HTTP ni določen, dejanje Pošlji e-račun (Send eBill) ustvari priponke ter lokalno nastavi invoice_exported; invoice_export_confirmed ostane neresničen. Tudi odpiranje standardnega postopka pošiljanja računa lahko ustvari priponko XML ali ponovno uporabi obstoječo. Ta postopek ne pripne normaliziranih podatkov JSON in ne zabeleži sporočila o ročnem ustvarjanju v razpravi na zapisu.

Vsebina izvoza in omejitve

• XML vsebuje identifikacijske podatke računa oziroma dobropisa, datum izdaje in datum zapadlosti, podatke o udeleženih strankah, valuto, postavke izdelkov, popuste, davčne povzetke, skupne zneske in preostali znesek za plačilo. Če so na voljo, se vključijo tudi sklici za plačilo, sklic na prvotni račun, ki ga dobropis popravlja, opis ter bančni podatki dobavitelja.

• Vsaka postavka zahteva eno razvrstitev DDV. Cena v XML je brez davka, tudi če cena v Odoo vključuje davek. Podprte skupine davkov vsebujejo en podrejeni davek, izražen v odstotkih, ali par odstotkovnih davkov za obrnjeno davčno obveznost z enako absolutno vrednostjo in nasprotnima predznakoma ter kategorijo UNECE AE. Nepodprte kombinacije davkov in davki, ki niso izraženi v odstotkih, povzročijo napako pri izvozu.

• Podprta je samo uradna struktura e-SLOG 2.0. Odstranjena sintetična struktura urn:eslog:invoice:1.0 ni bila uradni starejši profil e-SLOG.

• Iskanje priponk podpira vmesnike bralnika, drevesa imen vdelanih datotek, njihove podrejene vozle ter povezane datoteke v katalogu PDF. Preizkusi pridobijo XML iz dejanskih sintetičnih PDF in ga uvozijo z nameščenim PyPDF2. PDF brez vdelanega XML se obdeluje z nastavljenim nadomestnim postopkom.

• Uvoz ni popoln obrat izvoza: datumi zapadlosti, plačilni in bančni podatki, pravne klavzule ter ločeni stroški na ravni računa niso v celoti preslikani. Skupni zneski se lahko ponovno izračunajo iz postavk. Pred knjiženjem preverite osnutke, izbrane nabavne davke, privzete nastavitve in prilagoditvene postavke.

• Potrditev HTTP pomeni status 200, ne preverjenega poslovnega sprejema. Modul nima samodejnega preverjanja izmenjave ali načrtovalnika ponovnih poskusov.

Preverjene zahteve in meje standarda so opisane v zahtevah. Osnova za DDV lahko vključuje druge dajatve; to ne dovoljuje več razvrstitev DDV na eni postavki XML.

Uradne referenčne datoteke

Primeri XML in datoteke XSD v docs/official so uradne referenčne predloge. Ohranite njihovo vsebino, vključno z neuporabljenimi imenskimi prostori in izvirnim DOCTYPE sheme XML Signature. Predlog ne spreminjajte zaradi opozoril pregledovalnikov ali IDE. Po potrebi so dovoljeni le nefunkcionalni komentarji za ozko omejeno izključitev posameznih opozoril.

Opozorila o neuporabljenih imenskih prostorih so v primerih XML izključena. Pregledovalnik Xerces v PyCharm še vedno opozarja na deklaracijo imenskega prostora v uradnem DTD za XML Signature. Komentarji za izključitev opozoril na oznakah tega opozorila v prologu DTD ne odpravijo. Gre za namerno izjemo pri uradni datoteki, ne za dovoljenje za spreminjanje sheme. Preverjanje XSD med izvajanjem ostaja vključeno.

Vsak primer XML v docs/official/primeri_davcne_kode ima ločen test skladnosti s shemo in razčlenjevanja kategorij ter stopenj DDV. Test popisa zahteva posodobitev testnih primerov ob dodajanju ali odstranitvi uradnega primera.

TODO

• Preveriti poslovna pravila prejemnika poleg preverjanja strukture s shemo XSD.

• Dostava in poslovni sprejem pri prejemniku zahtevata nastavljeno storitev ter ločen integracijski dogovor; lokalno ustvarjanje dokumenta ju ne dokazuje.

Prijava napak

Napake se spremljajo v sistemu za prijavo težav repozitorija PMISuite. Pred prijavo preverite, ali je bila težava že prijavljena. Navedite različici modula in Odoo, korake za ponovitev težave ter pričakovani in dejanski rezultat. Uporabite izmišljene primere in odstranite občutljive podatke.

Avtorstvo in vzdrževanje

Vzdrževalci

Trenutni vzdrževalec:

Modul vzdržuje družba Luxim d.o.o., ki v okviru projekta PMISuite.com razvija orodja in rešitve za upravljanje programov.

Luxim je aktiven član združenja OCA (Odoo Community Association).