SPIN2-wiki - Príspevky používateľa [sk]

Logistika - Číselníky produktov - Produkt

2024-12-09T12:05:29Z

Ivan.michalik: /* Import voliteľných údajov */

{{Pozor|'''Táto stránka už nie je aktualizovaná. Aktuálnu dokumentáciu nájdete na odkaze:'''
https://wiki.assecosolutions.sk/sk/home/public/qasida/documentation/modules/sklady/produkt/produkt}}

__TOC__

Voľbou sa zobrazí okno Číselník produktov, slúžiace na evidenciu produktov, ktoré sú predmetom vašej obchodnej činnosti. Pod pojmom produkt rozumieme tovar, materiál, služby, obaly... Evidencia produktov prebieha v karte Produkt, pričom ostatné karty majú charakter doplňujúcich údajov k produktu. Nové produkty ako aj doplňujúce údaje k produktom dopĺňate v otvorenej karte s príslušným názvom, pričom okno s produktmi je východiskovým pre ostatné karty.

== Produkt ==

Evidencia produktov, ktoré sú predmetom vašej obchodnej činnosti. Nové produkty priraďujete do evidencie kliknutím na akciu ''Pridať''. 
 • ''Kód produktu'': jednoznačné číslo evidencie produktu - ručne 
• ''typ produktu'' (materiál, tovar...) - vyberač 
• '''''od verzie 24.5''''' pribudli nové typy produktov: '''Jednoúčelový poukaz, Sprepitné a Záloha''''' 
• ''Názov produktu'': názov produktu - ručne 
• ''Platnosť'': platnosť produktu - vyberač 
• ''Colný sadzobník'': priradenie produktu k colnému sadzobníku pre účely štatistického výkazu Intrastat - výber z číselníka 
• ''Koef. MJ-MJCS'': prepočítavací koeficient medzi skladovou mernou jednotkou a mernou jednotkou colného sadzobníka - ručne 
• ''Klasifikácia'' - CPA: jednotná klasifikácia produkcie - vyberač 
• ''Koef. MJ-MJKP'': prepočítavací koeficient medzi skladovou mernou jednotkou a mernou jednotkou klasifikácie produkcie - ručne 
• ''Sadzba DPH'': zaradenie produktu do daňového sadzobníka - vyberač 
• ''Účtovný druh'': priradenie účtovnej skupiny k produktu – vyberač 
• ''Merná jednotka'': evidencia produktu v mernej jednotke na sklade (kg, m2, ks) - použite vyberač 
• ''Hmotnosť MJ'': fyzikálny rozmer MJ - ručne 
• ''MJ 2'': merná jednotka dodávateľa - vyberač 
• ''Hmotnosť MJ 2'': fyzikálny rozmer MJ 2 - ručne 
• ''Koef. MJ-MJ 2'': prepočítavací koeficient medzi skladovou mernou jednotkou a mernou jednotkou dodávateľa MJ 2 - ručne 
• ''MJ3'': merná jednotka dodávateľa, napr. paleta - ručne 
• ''Koef. MJ-MJ3'': prepočítavací koeficient medzi skladovou mernou jednotkou a mernou jednotkou dodávateľa MJ 3 – ručne 
• ''Typ spotr. dane'': spotrebná daň pre príslušné produkty - vyberač 
• ''Koef. MJ-MJSD'': prepočítavací koeficient medzi skladovou mernou jednotkou a mernou jednotkou spotrebnej dane - ručne 
• ''Skladová položka'' : priradenie produktu k skladovej evidencii, okrem služieb - prepínač 
• ''Kategória'': skupina, kategória produktu - výber z číselníka (strom) 
• ''Náhradný produkt'': ak produkt skončí, ktorým produktom sa má nahradiť – výber z číselníka 
• ''Org. štruktúra'': vyberač z číselníka 
• ''Ek. objekt'': vyberač z číselníka 
• ''Internet položka'': pri internetových obchodoch – prepínač 
• ''Popis produktu'': ľubovoľná charakteristika produktu - ručne 

Keď kliknete na ikonku ''Sledovať'' vedľa položky, kde vyberáte typ produktu, rozbalia sa ďalšie možnosti sledovania vlastností produktu:

• ''Evidovať dátumy'': možnosť evidovania dátumu príjmu a exspirácie produktu - vyberač 
• ''Evidovať série'': pri produktoch s informáciou o sériovom čísle - vyberač 

 
Po naplnení položiek formulára kliknite na akciu ''Zapísať'', čím zapíšete údaje produktu, ktorý je pripravený na ďalšie spracovanie.

=== Akcie nad oknom na záložke Produkt===

====Hromadná zmena ceny====

Táto akcia vykoná zmenu ceny označených produktov vybraného cenníka k dátumu.
Takže označíte si produkty, ktorým chcete zmeniť cenu a kliknete na akciu Hromadná zmena ceny. Program zobrazí dialógové okno, v ktorom:
# vyberiete cenník, na ktorom má byť zmena zapísaná,
# vyberiete dátum, od ktorého má zmena platiť (do vtedy platná cena bude k dátumu -1 deň ukončená)
# a zadáte novú cenu.

Potvrdením na OK sa zmena ceny vykoná na všetkých označených produktoch.

{{Info|Hromadnú zmenu ceny má možnosť vykonať len ten používateľ, ktorý má práva na zápis na vybraný cenník.}}

Aby sa akcia nad oknom zobrazila, je potrebné mať nastavený setup - Nastavenia - logistika ''Hromadná zmena ceny produktov'' (S_PROD_SETCENA_HROMADNE) na Áno.

== Volit. údaje ==

Doplňujúca vlastnosť produktu, ktorá ho bližšie charakterizuje, pre prednaplnené atribúty, napr.: farba, provízia, kvalita, veľkosť... Po naplnení položiek formulára kliknite na akciu ''Zapísať''. Nové voliteľné údaje naplníte vo voľbe ''Číselníky => Spoločné číselníky => Voliteľný údaj k evidencii (Typ evidencie: Produkt).''

== Ceny ==

V tejto záložke nájdete zobrazenie hodnôt k predplneným odbytovým a dodávateľským druhom cien, ktoré využívate pri predaji daného produktu.

Nad oknom máte možnosť vybrať si zobrazenie :

* '''Aktívne''' - zobrazujú sa iba platné, nenulové, aktívne používané ceny k vybranému produktu.

* '''Aktuálne''' - zobrazujú sa platné ceny ku všetkým zadefinovaným druhom cien (Kód cenníka) vybraného produktu. Cenník sa zobrazí aj vtedy, ak pre vybraný produkt v ňom nie je zadefinovaná cena. V tom prípade je položka Cena bez DPH a Cena s DPH prázdna

* '''Všetky''' - zobrazujú sa všetky ceny, aj ''neplatné'', k Druhom ciem (cenníkom), ktoré majú zadefinovanú cenu. Ak v niektorom cenníku nie je pre vybraný produkt zadefinovaná cena, v tomto zobrazení cenník neuvidíte.

Pri zobrazení '''Aktuálne''' môžete v tomto okne upraviť pre vybraný produkt cenu a jej platnosť.

Pri zmene ceny program ukončí aktuálnu cenu k dátumu = aktuálny dátum -1 deň a založí novú cenu s platnosťou s dátumom Platnosť od k aktuálnemu dátumu.
Obdobne to platí pokiaľ upravujete spolu s cenou aj dátum Platnosť od. Program ukončí platnosť pôvodnej ceny k dátumu = zadaný dátum -1 deň a založí novú cenu s platnosťou od zadaného dátumu.

=== Ako zmeniť cenu v tomto okne ===

Nové hodnoty cien štandardne priraďujete do evidencie v okne ''Cenník'' (''Logistika => Cenotvorba => Cenník''). Po naplnení položiek formulára kliknete na akciu ''Zapísať''.

Pokiaľ chcete meniť cenu produktu v tomto okne '''Produkty / Ceny''', je potrebné nastaviť cez Program / Nastavenie logistika setup '''Nastavenie zadávania cien k produktu''' - '''S_PROD_SETCENA'''. V setupe vyberáte stĺpec, ktorý chcete editovať, vyberáte medzi hodnotami - 1 2 3 4, ľubovoľnú kombináciu týchto hodnôt:

* ''1'' - ''editovať cenu bez Dph'' - keď máte nastavený setup na '''1''', kliknutím do príslušného cenníka v stĺpci '''Cena bez DPH''' môžete zmeniť cenu bez DPH. Cena bude zmenená k aktuálnemu dátumu. Automaticky sa upraví aj Cena s DPH.

* ''2'' - editovať cenu s Dph - keď máte nastavený setup na '''2''', kliknutím do príslušného cenníka v tomto stĺpci '''Cena s DPH''' môžete zmeniť cenu s DPH. Cena bude zmenená k aktuálnemu dátumu a automaticky sa upraví aj údaj v stĺpci Cena bez DPH.

* ''3'' - editovať koeficient - pokiaľ zvolíte možnosť '''3''', máte možnosť meniť '''Cenu bez DPH''' na základe zmeny koeficientu zadaného v stĺpci '''Koeficient'''.
Koeficient sa prepočíta vzorcom údajom v stĺpci Skl.cena.
Skl.cena je skladová cena produktu, ktorá sa preberá z druhu ceny (cenníka), ktorý je zadaný v setupe S_PRMODIPOSLEDNACENA ( do setupu sa napĺňa kód platného dodávateľského druhu ceny, do ktorého sa zapisuje posledná nákupná cena pri príjme).
** ak je v setupe S_PRMODIPOSLEDNACENA nastavený druh ceny (cenník), potom sa Cena bez DPH (a následne aj cena s DPH) zmení vzorcom ((100 + koeficient)/100)x skl.cena. Záznam s druhom ceny zo setupu je v okne zvýraznený červenou farbou.
** ak je v setupe S_PRMODIPOSLEDNACENA nie je nastavený druh ceny (cenník), resp. setup neexistuje, potom sa do údaja Skl.cena berie maximálna cena z príjmu. Cena bez DPH (a z nej následne cens DPH) sa vypočíta vzorcom koeficient x skl.cena.

* ''4'' - editovať dátum Platnosti od - Pokiaľ chcete meniť nielen cenu, ale aj dátum Platnosti od, pridajte do setupu aj '''4'''. Potom upravujete cenu v príslušnom stĺpci ( Cena s DPH, Cena bez DPH, alebo Koeficient) a ešte upravíte dátum v stĺpci '''Platnosť od'''.
Pokiaľ vyberiete dátum iný, ako je aktuálny, po zápise sa v zobrazení ''Aktuálne'' nebudú nachádzať. Ceny s platnosťami inými, ako k aktuálnemu dátumu môžete prezerať ak si nad oknom nastavíte zobrazenie ''Všetky''.

[[Súbor:Podukt_ceny.png|900px]]

Zmenu ceny v okne '''Produkt / Cena''' robíte, ak máte nad oknom nastavené zobrazenie '''Aktuálne'''.
Zmenu ceny môže robiť iba používateľ, ktorý má právo na daný cenník.

== Skladová karta ==

Priradenie skladovej karty k produktu. Skladovú kartu produktu môžete vytvoriť iba pre produkt, ktorý má v číselníku produktov zadefinovanú skladovú položku. Ináč program neumožní vytvoriť skladovú kartu. Skladovú kartu zakladáte pre sklad zvolený v políčku ''Sklad''. Nové skladové karty produktov priraďujete do evidencie kliknutím na tlačidlo ''Pridať''. Po vyplnení riadkov formulára kliknite na akciu ''Zapísať'', čím produktu priradíte skladovú kartu. Každý produkt môže mať v sklade len jednu skladovú kartu.

== Väzba ==

Definovanie väzby produktu na produkt.
Pri vystavovaní dokladov potom, keď vyberiete v položkách "hlavný" produkt, pri zápise položky dokladu sa automaticky dotiahne do dokladu aj zväzbený produkt. Napr. hlavný produkt nápoj, zväzbený produkt obal (fľaša).

Nové väzby produktov zadávate do evidencie kliknutím na akciu ''Pridať''.

• ''Kód produktu'': automaticky prednaplnené podľa aktuálneho produktu

• ''Množstvo'': množstvo aktuálneho produktu - zadávate ručne

• ''Zväzbený produkt'': produkt, ktorý sa naviaže na aktuálny - vyberáte z číselníka produktov

• ''Množstvo'': množstvo zväzbeného produktu - zadávate ručne

• ''Typ väzby'': povinná / nepovinná / Zálohovaný obal / recyklačný poplatok... - vyberáte z ponuky

• ''Poznámka'' : ručne

Po vyplnení riadkov formulára kliknite na akciu ''Zapísať''.

== Čiarový kód ==

Definovanie čiarových kódov pre produkt. Nové čiarové kódy zadávate do evidencie kliknutím na akciu ''Pridať''. 
• ''Čiarový kód'': názov čiarového kódu - ručne 
• ''Kód druhu ceny'': výber z číselníka 
• ''Ktorá MJ'' : merná jednotka, pre ktorú platí čiarový kód – ručne 
• ''Typ EAN kódu'': výber z číselníka 
 
Po vyplnení riadkov formulára kliknite na akciu ''Zapísať''.

== DPH ==

Priradenie sadzby DPH k produktu. Novú sadzbu priradíte produktu kliknutím na akciu ''Pridať''. 
• ''Sadzba DPH'': výber z číselníka 
• ''Platnosť od'': nastavenie začiatku platnosti DPH – vyberač (prepínač) 
• ''Platnosť do'': nastavenie konca platnosti DPH – vyberač (prepínač) 
Ostatné stĺpce sa vyplnia podľa výberu sadzby DPH automaticky. Kliknutím na akciu ''Zapísať'' uložíte nastavenie DPH pre produkt.

== Dodávateľ/Odberateľ ==

priradenie dodávateľov a odberateľov k produktu. Okno medzi dodávateľmi a odberateľmi prepnete v hornej časti prepínačmi ''Odberateľ'' a ''Dodávateľ''. Vlastnosť má význam pri generovaní nákupnej objednávky z predajnej objednávky, kde systém automaticky ponúkne dodávateľa s najnižšou dodávateľskou cenou a obdobne. Prepínače Aktuálne a Všetky slúžia na výber už naplnených dodávateľov a odberateľov k produktu v závislosti od systémového dátumu. Nových dodávateľov a odberateľov produktov priraďujete do evidencie kliknutím na akciu ''Pridať''. 
• ''Dodávateľ/Odberateľ'': kód a názov dodávateľa produktu - vyberač 
• ''Kód druhu ceny'': dodávateľský druh ceny - vyberač 
• ''Cena'': hodnota nákupnej ceny produktu – ručne 
• ''Množstvo od'': počet produktov, od ktorého platí nastavená cena - ručne 
• ''Dodacia lehota'': dodacia lehota pre produkt u dodávateľa - ručne 
• ''Platnosť od'': nastavenie začiatku platnosti nákupnej ceny – vyberač (prepínač) 
• ''Platnosť do'': nastavenie konca platnosti nákupnej ceny – vyberač (prepínač) 
• ''Match code'': kód produktu u dodávateľa - ručne 
• ''Poznámka'' : stručná charakteristika - ručne 

Po vyplnení riadkov formulára kliknite na akciu ''Zapísať''.

{{Info|Platnosť do môže byť neobmedzená (00.00.0000).}}

== Import voliteľných údajov ==

Nad oknom Produkty je možné pridať voliteľnú akciu, ktorá naimportuje z excelovského súboru k jednotlivým produktom voliteľné údaje. Bližšie informácie získate u vášho konzultanta.
[https://asseco-spin.sk/sk/spin2/index.php/Okno_Produkt_-_Import_volite%C4%BEn%C3%BDch_%C3%BAdajov#Import_volite.C4.BEn.C3.BDch_.C3.BAdajov_nad_oknom_Produkt| Import VU nad oknom Produkt]

[[category:Číselníky]]

Posielanie emailov zo SPIN2

2022-04-19T07:35:57Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa pre predajné objednávky je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_PO_EMAIL_KOD 
* Adresa prijímateľa pre dodacie listy je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_DL_EMAIL_KOD 
* Predmet a telo správy môže obsahovať premenne, ktoré sa automaticky nahradia správnymi hodnotami daného dokladu - toto môžete aj zadať v preddefinovaných textoch - predmet správy je text s kodom HD_PREDMET, telo správy je text s kódom HD_TEXT: 
{{Info|'''Predajná objednávka''' 
<<cislo>> - číslo dokladu 
<<datum>> - datum založenia dokladu 
'''Dodací list''' 
<<cislo>> - cislo dokladu 
<<cisloPO>> - cislo predajnej objednavky 
<<datumDL>> - datum zalozenia dodacieho listu }}

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail faktúry v rámci HDF 

* '''F_PO_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail predajnej objednávky v rámci HDF 

* '''F_DL_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail dodacieho listu v rámci HDF 

Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:33:22Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa pre predajné objednávky je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_PO_EMAIL_KOD 
* Adresa prijímateľa pre dodacie listy je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_DL_EMAIL_KOD 
* Predmet a telo správy môže obsahovať premenne, ktoré sa automaticky nahradia správnymi hodnotami daného dokladu - toto môžete aj zadať v preddefinovaných textoch - predmet správy je text s kodom HD_PREDMET, telo správy je text s kódom HD_TEXT: 
{{Info|'''Predajná objednávka''' 
<<cislo>> - číslo dokladu 
<<datum>> - datum založenia dokladu 
'''Dodací list''' 
<<cislo>> - cislo dokladu 
<<cisloPO>> - cislo predajnej objednavky 
<<datumDL>> - datum zalozenia dodacieho listu }}

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:32:28Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia '''„Hromadná distribúcia“''' je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa pre predajné objednávky je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_PO_EMAIL_KOD 
* Adresa prijímateľa pre dodacie listy je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_DL_EMAIL_KOD 
* Predmet a telo správy môže obsahovať premenne, ktoré sa automaticky nahradia správnymi hodnotami daného dokladu - toto môžete aj zadať v preddefinovaných textoch - predmet správy je text s kodom HD_PREDMET, telo správy je text s kódom HD_TEXT: 
{{Info|'''Predajná objednávka''' 
<<cislo>> - číslo dokladu 
<<datum>> - datum založenia dokladu 
'''Dodací list''' 
<<cislo>> - cislo dokladu 
<<cisloPO>> - cislo predajnej objednavky 
<<datumDL>> - datum zalozenia dodacieho listu }}

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:30:48Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia '''„Hromadná distribúcia“''' je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa pre predajné objednávky je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_PO_EMAIL_KOD 
* Adresa prijímateľa pre dodacie listy je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_DL_EMAIL_KOD 
* Predmet a telo správy môže obsahovať premenne, ktoré sa automaticky nahradia správnymi hodnotami daného dokladu - toto môžete aj zadať v preddefinovaných textoch - predmet správy je text s kodom HD_PREDMET, telo správy je text s kódom HD_TEXT: 
'''Predajná objednávka''' 
<<cislo>> - číslo dokladu 
<<datum>> - datum založenia dokladu 
'''Dodací list''' 
<<cislo>> - cislo dokladu 
<<cisloPO>> - cislo predajnej objednavky 
<<datumDL>> - datum zalozenia dodacieho listu 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:24:35Z

Ivan.michalik: /* Info */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia '''„Hromadná distribúcia“''' je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:24:09Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia '''„Hromadná distribúcia“''' je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:19:48Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:18:35Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:18:10Z

Ivan.michalik: /* Hromadná distribúcia faktúr */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:15:57Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Predajná objednávka“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_PO_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie predajných objednávok. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Dodací list“ sa nachádza akcia '''Hromadná distribúcia'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DL_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie dodacích listov. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:12:39Z

Ivan.michalik: /* Info */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná aj v oknách : Predajná objednávka a Dodací list. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-04-19T07:09:54Z

Ivan.michalik: /* Pracovný postup */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

V okne predajných objednávok v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_objednavka.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná predajná objednávka vytlačená alebo odoslaná e-mailom. Ak nebola predajná objednávka spracovaná, zobrazí sa prázdny reťazec.

V okne dodacích listov v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pkdlLog.getLog4Hd(dl.sof_vd.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bol daný dodací list vytlačený alebo odoslaný e-mailom. Ak nebol dodací list spracovaný, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-01-07T13:14:33Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Adresa pre kópiu CC je predpĺňaná ak je nastavený sof_setup F_FA_EMAIL_CC = A a ak k firme existujú spojenia s poznámkou #FA-CC# 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-01-07T13:08:15Z

Ivan.michalik: /* Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tak, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2022-01-07T13:05:44Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 - hromadná distribúcia faktúr ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_CC = A''' 
Ak k firme existujú spojenia s poznámkou #FA-CC# použijú sa na poslanie CC v maile
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "Dokument" (e-dokument danej faktúry), kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony - je potrebný skript netsyst-4627-setup.sql 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2019-05-14T10:57:25Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony 

* SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
* SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
* SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
* SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
* SIGNATUREURX : celé číslo , šírka podpisu 
* SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2019-05-14T10:56:37Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
* Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony 

SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

* Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
* Jednotka pre rozmery je bod , 1 palec = 72 bodov 
SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
SIGNATUREURX : celé číslo , šírka podpisu 
SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2019-05-14T10:55:55Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
* Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony 

SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
SIGNATUREURX : celé číslo , šírka podpisu 
SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2019-05-14T10:54:20Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
* Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony 

SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 
Rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 
SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
SIGNATUREURX : celé číslo , šírka podpisu 
SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2019-05-14T10:52:37Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
* Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony 

SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf 
SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom 

rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf): 
Jednotka pre rozmery je bod , 1 palec = 72 bodov 

SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov 
SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov 
SIGNATUREURX : celé číslo , šírka podpisu 
SIGNATUREURY : celé číslo , výška podpisu 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2019-05-14T10:47:24Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

'''Nastavenia''' 
* Ak chceme na podpísanom PDF zobraziť ikonu Signature valid, je potrebné v nastaveniach definovať pole pre umiestnenie ikony 

SIGNATUREVISIBLE : A/N , či má byť podpis viditeľný v pdf
SIGNATUREMARK : A/N , či sa má v podpise zobraziť ikona s nadpisom

rozmery podpisu v pdf (musia byt nastavene ak sa podpis zobrazuje v pdf):
Jednotka pre rozmery je bod , 1 palec = 72 bodov
SIGNATURELLX : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica x (0 je v ľavom dolnom rohu stránky), celková šírka strany je cca 600 bodov
SIGNATURELLY : celé číslo , ľavý spodný okraj obdĺžnika s podpisom , súradnica y (0 je v ľavom dolnom rohu stránky), celková výška strany je cca 800 bodov
SIGNATUREURX : celé číslo , šírka podpisu
SIGNATUREURY : celé číslo , výška podpisu

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

DPH - Prepočet a uzavretie daňového priznania - Účtovníctvo

2018-03-20T13:19:42Z

Ivan.michalik: /* Prepočet DP */

== Prepočet DP ==
V tomto okne sa vykonáva spracovanie daňového priznania. V rámci spracovania daňového priznania DPH je potrebné vykonať tieto operácie:
* Prepočítať daňové priznanie DPH (t.j. aktualizovať jednotlivé riadky daňového priznania)
* Preúčtovať položky účtované na analytický účet DPH neuplatnená na účet DPH uplatnená
* Vypočítať sumu DPH, pri ktorej sa uplatňuje koeficient a sumu DPH, pri ktorej nevzniká nárok na odpočet. Vypočítanú sumu zaúčtovať na analytické účty vytvorené na tento účel
* Zaúčtovať výslednú sumu záväzkov/pohľadávok z DPH voči štátu
* Uzavrieť daňové priznanie DPH, tak aby v ňom nebolo možné uskutočňovať dodatočné zmeny mazaním alebo opravovaním dokladov

{{Info| Podmienkou na pomerné krátenie dane na vstupe koeficientom je správne zadefinovaný spôsob výpočtu koeficientu. Tento musí byť zadefinovaný v okne Otvorenie daňového priznania, pri poslednom daňovom priznaní za predchádzajúci kalendárny/hospodársky rok. Systém vyžaduje túto informáciu pri prepočet prvého daňového priznania DPH v aktuálnom kalendárnom/hospodárskom roku. Skontroluje, či je zadefinovaný spôsob výpočtu koeficientu, ak nie je zadaný, potom ho dodefinujte.}}
Okno sa skladá z týchto záložiek:

'''Prepočet a spracovanie'''

V záložke Prepočet DP v ľavej časti okna myšou označte daňové priznanie DPH, ktoré chcete prepočítať. Kliknite na akciu '''Prepočet'''. Výsledné hodnoty jednotlivých riadkov daňového priznania DPH si môžete prezrieť v záložke Prepočet DP v pravej časti okna.

'''Tlač okna'''

Nastavte sa na príslušné prepočítané priznanie, prípadne priznanie prepočítajte. Kliknite na akciu '''Tlačiť'''. V okne Tlač údajov zadajte parametre pre tlač a voľbu potvrďte kliknutím na tlačidlo '''OK'''.

'''Tlač tlačovej zostavy nad oknom'''

Nastavte sa na príslušné prepočítané priznanie, prípadne priznanie prepočítajte. Kliknite na akciu '''Zostavy''' v hornej časti obrazovky. Následne sa otvorí okno Prezeranie zostavy, kliknite na vyberač zo zoznamu tlačových výstupov definovaných nad oknom. Zobrazí sa zoznam dostupných tlačových výstupov. Zo zoznamu vyberte tlačový výstup, ktorý chcete vytlačiť. Kliknite na akciu '''Tlačiť!''' pre okamžitú tlač na predvolenú tlačiareň alebo '''Tlačiť''' pri zmene tlačiarne alebo iných parametrov tlače. V okne Tlač údajov zadajte parametre pre tlač a voľbu potvrďte kliknutím na tlačidlo '''OK'''.

'''Export tlačiva'''

Kliknite na akciu '''Spec.ex''', zvoľte jednu z možností:
* Tlačivo daňového priznania Adobe xfdf - zobrazí v Adobe prehliadači tlačivo daňového priznania s aktuálnymi hodnotami. Tlačivo je možné iba zobraziť a vytlačiť, na uloženie je potrebná aplikácia Adobe Acrobat
* Tlačivo potvrdenia o podaní daňového priznania Adobe xfdf - zobrazí v Adobe prehliadači tlačivo potvrdenia o podaní daňového priznania s aktuálnymi hodnotami. Tlačivo je možné iba zobraziť a vytlačiť, na uloženie je potrebná aplikácia Adobe Acrobat
* XML súbor pre import DP cez portál DRSR - uloží vybraté daňové priznanie s aktuálnymi hodnotami do xml tvaru vhodného pre načítanie cez stránku www.drsr.sk
* Tlačivo vyhlásenia o podaní daňového priznania elektronickou formou Adobe xfdf - zobrazí v Adobe prehliadači tlačivo vyhlásenie o podaní daňového priznania s aktuálnymi hodnotami. Tlačivo je možné iba zobraziť a vytlačiť, na uloženie je potrebná aplikácia Adobe Acrobat
* XML export všetkých daňových dokladov na DP - vyexportuje zaradené daňové doklady na daňovom priznaní aj s ich položkami do xml tvaru
* XML daňového priznania SPIN - vyexportuje daňové priznanie v xml štruktúre definovanej v SPINe.

'''Kontrola smerovania'''

Kliknutím na akciu '''Kontrola smerovania''' možno skontrolovať, či sú nasmerované všetky daňové doklady do tlačiva daňového priznania.

'''Uzavretie DP'''

Kliknutím na akciu '''Uzavretie DP''' máte možnosť uzavrieť ( vpíšte Dátum ) alebo otvoriť ( zmažte Dátum ) príslušné priznanie. Potvrďte kliknutím na '''OK'''.

'''''Tlačivo Daňového priznania DPH pre rok 2018'''''

tlačivo bolo rozšírené o telefónne číslo a emailovú adresu firmy ako aj osoby oprávnenej na podanie DP DPH (OOKZAPD).

Polia sa vypĺňajú nasledovne:

1/ ''Adresa sídla alebo trvalého pobytu''

•''Telefónne číslo'' - berie sa z okna Firma - Spojenia - Do práce (WORK)

•''Emailová adresa'' - berie sa z okna Firma - Spojenia - Email

2/ ''Meno a priezvisko osoby oprávnenej na podanie daňového priznania''

•''Telefónne číslo'' - berie sa z okna Firma - Osoby - Osoba oprávnená konať za platiteľa dane

•''Emailová adresa'' - berie sa z okna Firma - Spojenia na osoby (Osoba oprávnená konať za platiteľa dane) - Email

== Preúčtovanie neuhradenej DPH ==

V záložke Preúčtovanie neuhradenej DPH vykoná systém preúčtovanie tých položiek DPH, ktoré sú zaradené na označené daňové priznanie DPH. Preúčtovanie sa týka položiek DPH, pri ktorých vzniká nárok na odpočet (t.j. DPH „na vstupe“)v danom období, ale samotný doklad je zaúčtovaný v nasledujúcom účtovnom období podľa dátumu kedy došiel. Položky sú preúčtované z analytického účtu pre DPH neuplatnenú na analytický účet pre DPH uplatnenú. Tieto analytické účty sú nastavené v okne Položky daňového dokladu.

V záložke Preúčtovanie neuhradenej DPH kliknite na akciu '''Prepočet''', potvrďte kliknutím na '''OK''', zobrazí sa Vám vytvorený účtovný doklad o preúčtovaní. Opakovaný prepočet pôvodný doklad zmaže a vytvorí nový s novým poradovým číslom.

== Preúčtovanie koeficientom ==

Ak platiteľ dane realizuje zdaniteľné plnenia, pri ktorých má nárok na odpočet dane a zdaniteľné plnenia, pri ktorých má nárok len na pomerný odpočet alebo nemá nárok na odpočet, je potrebné odpočet dane upraviť podľa koeficientu. V záložke Preúčtovanie koeficientom preúčtuje systém sumu DPH, pri ktorej sa uplatňuje koeficient a tiež sumu DPH, pri ktorej nevzniká nárok na odpočet. Obe sumy zaúčtuje na analytické účty vytvorené na tento účel. Tieto účty sú zadefinované v okne Nastavenie preúčtovania DPH.

V záložke Preúčtovanie koeficientom kliknite na akciu '''Prepočet''', potvrďte kliknutím na '''OK''', zobrazí sa Vám vytvorený účtovný doklad o preúčtovaní. Opakovaný prepočet pôvodný doklad zmaže a vytvorí nový s ďalším poradovým číslom.

== Odvody DPH ==

Záložka Odvody DPH slúži na zaúčtovanie výslednej sumy záväzku/pohľadávky z DPH voči Daňovému úradu. Účet pre zaúčtovanie výslednej sumy záväzku/pohľadávky je nastavený v okne Nastavenie preúčtovania DPH.

V záložke Odvody DPH kliknite na akciu '''Prepočet''', potvrďte kliknutím na '''OK''', zobrazí sa Vám vytvorený účtovný doklad o preúčtovaní. Opakovaný prepočet pôvodný doklad zmaže a vytvorí nový s ďalším poradovým číslom.

== Smerované sumy do DP ==

V záložke Smerované sumy do DP sú zobrazené údaje o smerovaní položiek daňových dokladov do jednotlivých riadkov priznania. Údaje v záložke sú aktualizované po prepočítaní daňového priznania DPH v záložke Prepočet DP.

== Info ==

V záložke Info sú podrobne zobrazené niektoré prepočty súvisiace so spracovaním DPH, napríklad: prepočet lokálneho koeficientu K´ , prepočet ročného koeficientu K, výpočet riadku pre odpočítanie dane. Údaje v záložke Info sú aktualizované po prepočítaní daňového priznania DPH v záložke Prepočet DP.

{{Info|Celé vyššie popísané spracovanie daňového priznania DPH vrátane príslušných preúčtovaní, je možné vykonať tiež pomocou jedinej akcie Všetko. Tento postup plnohodnotne nahradí všetky vyššie popísané postupy týkajúce sa spracovania daňového priznania DPH.}}

== Parametre prepočtu ==

V tejto záložke je možné zapísať doplňujúce hodnoty do tlačiva priznania DPH, napr. Úprava odpočítanej dane pri investičnom majetku, ktoré nie je možné automaticky vypočítať systémom.

Po zápise hodnôt je potrebné opätovne prepočítať priznanie ( v záložke Prepočet DPH ), aby sa doplnené hodnoty preniesli do priznania DPH.

== Nastavenie platiteľa DPH ==

[[category:Účtovníctvo]]
V prípade, že spoločnosť potrebuje na tlačive DPH nastaviť iný typ platiteľa ako je zvyčajne, je potrebné to zadefinovať v okne ''Tlačivo daňového priznania DPH''.
v prvej záložke ''Tlačivo'', sa postavíte na platné tlačivo DPH a v záložke Parametre, sa nachádza výber plátcov

[[Súbor:UCT_DPH.jpg]]

Uvedený výber sa prejaví tak v tlačivo DPH ako aj v xml exporte na Finančnú správu.

Posielanie emailov zo SPIN2

2017-07-10T13:45:58Z

Ivan.michalik: /* Odoslanie faktúry e-mailom ako podpísaný PDF dokument */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:44:33Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Príklad :'' FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:36:58Z

Ivan.michalik: /* Odoslanie faktúry e-mailom ako podpísaný PDF dokument */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Príklad :'' FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Príklad :'' FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:35:55Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
''Príklad :'' FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
''Možné premenné :'' 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:32:43Z

Ivan.michalik: /* MU - Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie užívateľského textového reťazca, ktorým sa v subjekte e-mailu faktúry nahradí pôvodný default textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa číslo objednávky nedoplní 
 
{{Info|
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>}}

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:28:51Z

Ivan.michalik: /* MU - Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
 

* '''HDF_SUBJ_T''' - nečíselníkový MÚ typu reťazec
Definovanie textového reťazca, ktorým sa v subjekte e-mailu faktúry pri HDF nahradí pôvodný textový reťazec "Elektronická faktúra:" 
Ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa použije pôvodný text "Elektronická faktúra:" (pôvodný stav) 
* '''HDF_SUBJ_O''' - číselníkový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
Definovanie či sa na koniec subjektu e-mailu faktúry pri HDF doplní číslo objednávky ( dl.sof_faktura.cislo_objednavky) 
Ak hodnota MU = "A" doplní sa číslo objednávky 
Ak hodnota MU = "N" alebo ak MU nebude pre danú firmu zadaný alebo ak MU nebude definovaný tak sa nedoplní nič 
 
Subjekt e-mailu bude vyskladaný následovne :
<nazov firmy mandanta> + " - " + <HDF_SUBJ_T> + <cislo faktury> + " " + <cislo objednavky>

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:03:46Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr k prijatým platbám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T13:02:30Z

Ivan.michalik: /* Nastavenia */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

V okne „Faktúra k prijatej platbe“ sa nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:59:15Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_DD1_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie DD1 dokladov k prijatým zálohám. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:55:56Z

Ivan.michalik: /* Info */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:54:35Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17.03.11 je Akcia podporovaná aj v okne Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
Od verzie 17_3 je pridaná možnosť hromadnej distribúcie faktúr (HDF) do okna Faktúra k prijatej platbe (DD1). 
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:52:45Z

Ivan.michalik: /* Info */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17_3 je pridaná možnosť hromadnej distribúcie faktúr (HDF) do okna Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}
Od verzie 17_3 je pridaná možnosť hromadnej distribúcie faktúr (HDF) do okna Faktúra k prijatej platbe (DD1). 
To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:50:08Z

Ivan.michalik: /* Zhrnutie */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Od verzie 17_3 je pridaná možnosť hromadnej distribúcie faktúr (HDF) do okna Faktúra k prijatej platbe (DD1). 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:44:17Z

Ivan.michalik: /* Odoslanie faktúry e-mailom ako podpísaný PDF dokument */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:43:21Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Názov pdf súboru, ktorý bude vytvorený pred odoslaním 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:40:01Z

Ivan.michalik: /* Odoslanie faktúry e-mailom ako podpísaný PDF dokument */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:39:34Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
Ak nie je setup nastavený, názov súboru je vytvorený ako reťazec FA_ + Evidenčné číslo faktúry 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:32:15Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Hodnotou setupu je reťazec zložený z premenných a oddeľovacích znakov 
Premenné v reťazci budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Príklad : FA_CISLO_DOKLADU 
FA_ ostane nezmenené 
CISLO_DOKLADU bude nahradené evidenčným číslom faktúry 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

Posielanie emailov zo SPIN2

2017-07-10T12:29:46Z

Ivan.michalik: /* SPIN1 - SOF_SETUP */

[[category:Konzultant]]

== Posielanie emailov zo SPIN2 ==

=== Zhrnutie ===

'''1. Poslať údaje poštou''' 
* Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“''. 
* Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
* Akcia je podporovaná nad všetkými štandardnými oknami údajov v SPIN2. 
* Adresa prjímateľa nie je predpĺňaná, je nutné ju zadávať ručne. 
* Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail. 
'''2. Poslať mailom''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplní sa jedno spojenie na osobu alebo firmu. Typ spojenia = EMAIL. 
* Odosielanie je možné iba nad jedným záznamom. 

{{Tip| ak chcem odoslať e-mail na viac e-mailových adries, je možné to riešiť tal, že v jednom spojení typu EMAIL zadám viac adries. 
Formát : adresa1; adresa2 
Príklad : fakturacne@assecosol.sk; ekonomicke@assecosol.sk}}

'''3. Hromadná distribúcia faktúr''' 
* Odoslať môžeme vybranú ''„Zostavu nad oknom“''. 
* Odosielané údaje sú vo formáte '''PDF'''. 
* Akcia je podporovaná nad vybranými oknami údajov v SPIN2. 
* Akcia je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
* Adresa prijímateľa je predpĺňaná - predplnia sa všetky vyhovujúce spojenia na firmu alebo osobu priradenú firme. Typ spojenia = EMAIL. Poznámka k spojeniu = hodnota sof_setupu F_FA_EMAIL_KOD 
* Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom. 

=== Nastavenia ===

==== SPIN1 - SOF_SETUP ====
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_EMAIL_PDF_NAME = FA_CISLO_DOKLADU''' 
Hodnotou setupu je zoznam premenných a oddeľovacích znakov 
Premenné budú nahradené za hodnoty z faktúry, oddeľovacie znaky v reťazci ostanú nezmenené 
Možné premenné : 
CISLO_DOKLADU - evidenčné číslo faktúry 
FIRMA_ICO - ičo odberateľa 
FIRMA_NAZOV - názov odberateľa 
VARIABILNY_SYMBOL - variabilný symbol 
DD - deň z dátumu vystavenia 
MM - mesiac z dátumu vystavenia 
YYYY - rok z dátumu vystavenia 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
A = pripojí sa ISDOC 
N = nepripojí sa ISDOC 
 

==== SPIN2 - Nastavenia ====

'''Program - Nastavenia - Spoločné nastavenia - Email''' 
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]
[[Súbor:EMAIL_SPIN2_Posielanie_16.png ]]

{{Pozor|Niektoré nastavenia sú aplikované iba pri spôsobe posielana e-mailov cez SMTP server. 
Napríklad : Pridať odosielateľa medzi Bcc adresátov, Požadovať potvrdenie o doručení}}

'''Program - Nastavenia - Spoločné nastavenia - Podpisovanie PDF''' 
[[Súbor:EMAIL_SPIN2_Posielanie_22.png ]]
 

==== MU - Nastavenia ====
* '''EL_DOKLAD''' - číselníkový MÚ s hodnotam A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 
* '''FA_ISDOC''' - číselnikový s hodnotami A/N
( tento MÚ nesmie byť dátového typu Áno/Nie !!!) 

== Poslať údaje poštou ==

=== Info ===

{{Info|Akcia '''„Poslať údaje poštou“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme buď vybranú ''„Zostavu nad oknom“'', alebo samotné ''„Okno údajov“.'' 
Odosielané údaje môžu byť buď vo formáte '''XLS''' alebo '''PDF'''. 
Akcia '''„Poslať údaje poštou“''' je podporovaná nad všetkými oknami údajov v SPIN2. 
Odosielanie je možné aj nad viacerými označenými záznamami. Odosiela sa vždy iba jeden mail.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať údaje poštou“''' nájdeme v menu '''„Program“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_01.png]] 

* Otvorí sa dialógové okno '''„Odoslanie údajov emailom“'''. 
* Zvolíme typu výstupu (Zostava nad oknom / Okno údajov) a formát údajov (PDF / XLS). 
* V prípade odosielania ''„Zostavy nad oknom”'' si v tomto kroku môžeme zvoliť konkrétnu zostavu a tiež jej orientáciu (Na výšku, Na šírku, Podľa nastavenia Windows). 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv.

 [[Súbor:EMAIL_SPIN2_Posielanie_02.png]] 

* Ak nad oknom nie je definovná žiadna zostava, combobox je disablovaný. V tomto prípade je možné iba odoslanie Okna údajov. 
* V prípade odosielania ''„Okna údajov“'' si v tomto kroku môžeme zvoliť aké riadky chceme exportovať (Načítané, Označené, Všetky).

 [[Súbor:EMAIL_SPIN2_Posielanie_19.png]] 

* Po potvrdení '''„OK“''' sa otvorí dialógové okno '''„Správa“'''.
* Adresy nie sú predpĺňane, je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.
* Môžeme doplniť text ''„Predmetu”'' správy.
* Môžeme doplniť text ''„Tela“'' správy. Použitý text tela správy sa odpamätáva. Predvolený je posledne použitý text.
* Príloha je vytvorené a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_03.png]] 

* Po potvrdení '''„OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_04.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_05.png]] 

== Poslať mailom ==

=== Info ===

{{Info|Akcia '''„Poslať mailom“''' umožňuje odoslanie údajov mailom. 
Odoslať môžeme vybranú ''„Zostavu nad oknom“'' vo formáte '''PDF'''. 
Akcia '''„Poslať mailom“''' je podporovaná v oknách : Príjemka, Výdajka, Dodací list, Cenový dopyt, Cenová ponuka, Nákupná objednávka, Predajná objednávka, Odberateľská faktúra, Odberateľská faktúra zálohová. 
Odosielanie je možné iba nad jedným záznamom.}}

{{Pozor|Odosielanie emailu je možné iba nad jedným záznamom. Ak boli označené viaceré záznamy, vyberie sa prvý a akcia sa vykonáva nad ním.}}

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Poslať mailom“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_06.png]] 

* Otvorí sa dialógové okno '''„Posielanie dokumentu“''' 
* V okne je combobox obsahujúci názvy zostáv, ktoré sú definované nad daným oknom. Vyberieme jednu zo zostáv. 

 [[Súbor:EMAIL_SPIN2_Posielanie_07.png]] 

* Ak nad oknom nie je definovná žiadna zostava, užívateľ je o tom informovaný hláškou. Zároveň je combobox disablovaný. V tomto prípade kliknutie na akýkoľvek button ukončí akciu bez vykonania čohokoľvek. 

 [[Súbor:EMAIL_SPIN2_Posielanie_18.png]] 

* Po potvrdení '''„OK”''' sa otvorí dialógové okno '''„Správa”'''.
* Adresáti typu ''„Pre”'' sú predpĺňaný, nie je nutné ich zadávať ručne. Adresátov typu ''„Pre, Cc, Bcc"'' môžeme zadať ručne, alebo ich môžeme vybrať z vyberača. Vyberače ponúkajú e-mailové adresy z číselníka spojení firiem a osôb s typom spojenia ''„EMAIL"''.

{{Info|Logika na predvyplnenie adresáta typu „Pre”:
* ak je v hlavičke dokladu vyplnená osoba (kontaktná osoba, referent, ...) - zistíme, či má osoba vyplnené kontaktné údaje typu EMAIL
* ak má osoba vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto
* ak nieje v hlavičke dokladu vyplnená osoba prípadne ak vyplnená osoba nemá vyplnené kontaktné údaje typu EMAIL - zistíme, či má firma vyplnené kontaktné údaje typu EMAIL
* ak má firma vyplnené kontaktné údaje typu EMAIL - vyberieme prvú emailovu adresu a predplníme túto.}}

* Text ''„Predmetu”'' správy je predplnený automaticky. Tento závisí od typu evidencie, nad ktorou sa posiela.
* Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_08.png]] 

* Po potvrdení „'''OK“''' sa zobrazí '''„Info“''' o úspešnom odoslaní Emailu.

 [[Súbor:EMAIL_SPIN2_Posielanie_09.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

 [[Súbor:EMAIL_SPIN2_Posielanie_10.png]] 

== Hromadná distribúcia faktúr ==

=== Info ===

{{Info|Akcia '''„Hromadná distribúcia faktúr“''' (HDF) je nástroj na hromadné distribuovanie vyšlých faktúr (FV) a zálohových vyšlých faktúr (ZFV). 
Distribúcia môže prebiehať 2 kanálmi: 
* Elektronickým dokladom so zaslaním e-mailom vo formáte PDF 
* Papierovým dokladom – vytlačenie dokladu a zaslanie poštou 
Akcia '''„Hromadná distribúcia faktúr“''' je podporovaná v oknách : Odberateľská faktúra, Odberateľská faktúra zálohová. 
Tlač / Odosielanie je možné nad viacerými záznamami. Každý doklad je odosielaný samostatným e-mailom.}}

To, či sa má faktúra vytlačiť alebo odoslať mailom je parametrizovateľné až na úroveň odberateľa. Tlačiť, resp. odoslať mailom môžeme vybranú ''„Zostavu nad oknom“'' vo formáte PDF.
V prípade odosielania emailov sa označené doklady pošlú jednotlivo na adresu definovanú pri firme, typ spojenia MAIL. Je možné nadefinovať adresu a meno, pod ktorými sa budú vytvorené doklady odosielať – funkčné na setup. Ak toto nie je nastavené, použije sa e-mail a meno z prostredia.
V prípade odosielania emailov je možné zasielané PDF podpísať elektronickým podpisom

=== Nastavenia ===

V oknách „Vyšlá faktúra“ a „Zálohová vyšlá faktúra“ sa vo voľbe Iné akcie nachádza akcia '''Hromadná distribúcia faktúr'''. Na zobrazenie tejto akcie je potrebné nastaviť SOF SETUP: 
* '''F_FV_HDF = {[0],1}''' 
Možnosť hromadnej distribúcie faktúr. 
0 = akcia HDF sa nezobrazuje 
1 = akcia HDF sa zobrazuje 

Funkčnosť HDF je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_TYP = {'P',['E']}''' 
Defaultný spôsob hromadnej distribúcie. 
Používa sa ak odberateľ nemá definovaný MU EL_DOKLAD. 
P = tlač 
E = e-mail 

Ak chceme používať funkčnosť HDF naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „Zasielanie elektronických dokladov“ kód='''”EL_DOKLAD”''' hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky.
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 

{{Pozor|Pri definovaní hodnôt MÚ '''EL_DOKLAD''' a '''FA_ISDOC''' je nutné požiť číselníkové hodnoty s kódmi A a N a s hodnotami Áno, Nie. Nevyberajte dátový typ Áno/Nie - ten systém v tomto prípade nerozoznáva.}}

 [[Súbor:EMAIL_SPIN2_Posielanie_20.png]] 

V spojeniach firmy alebo spojeniach osôb priradených ku firme zadefinujte spojenia typu „EMAIL“, kde budú definované e-mailové adresy adresátov pre zasielanie el. dokladov (faktúr). V poznámke spojenia musí byť pre daného adresáta definovaný špeciálny príznak (napr. '''#FA#'''). Tento príznak sa definuje v SOF SETUP-e: 
* '''F_FA_EMAIL_KOD = #FA#''' 
Kód (v poli 'Poznámka') e-mailovej adresy, na ktorú sa bude posielať e-mail v rámci HDF 

 [[Súbor:EMAIL_SPIN2_Posielanie_21.png]] 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Zvolíme konkrétnu zostavu.
* Pre prípad tlače môžeme v tomto kroku zvoliť tlačiareň, vykonať jej nastavenia, nastaviť orientáciu tlače (Na výšku, Na šírku, Podľa nastavenia Windows), prípad počet kópií.
* Pre prípad posielania mailom môžeme zeditovať text „Tela“ správy. Text ''„Tela“'' správy je predplnený posledne použitým textom pre príslušnú evidenciu. Text sa odpamätáva. V prípade potreby je možné text ručne editovať, prípadne ho môžeme vybrať z vyberača preddefinovaných textov pre danú evidenciu. Ponúkané sú preddefinované texty príslušnej evidencie. Dostupné sú iba texty typu poznámka.
* Príloha je vytvorená a priložená automaticky. V tomto kroku je možné ručne ''„Priadať”'' ďalšiu prílohu, ''„Zmazať”'' vybranú prílohu, ''„Prezrieť“'' vybranú prílohu.
* Či má byť príloha odoslaná komprimovaná a či má byť požadované potvrdenie o doručení je predvolené podľa definícii v ''„Nastaveniach“''. V tomto kroku je možné predvolené nastavenie ešte zmeniť.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. Podľa nastavenia MU '''„EL_DOKLAD“''' sa rozhodne, či bude doklad smerovaný na zvolenú tlačiareň, alebo bude odoslaný e-mail na všetky adresy definované v spojeniach daného odberateľa (viď. vyššie). 

Každý e-mail môže obsahovať prílohy (podľa nastavení): 
• Tlačivo faktúry vo formáte PDF s elektronickým podpisom 
• Faktúru vo formáte ISDOC, ak bude pre daného odberateľa nastavená (MÚ) 

Záznam o vykonanej operácii bude zaznamenaný do logovacieho súboru '''(SOF_FA_IMEX_LOG)''', ktorý bude obsahovať (okrem štandardných atribútov): 
• Typ – [PRINT | EMAIL] 
• Dátum spracovania 
• Zoznam e-mailových adries alebo tlačiareň 
• Užívateľ, ktorý vykonal operáciu 

V okne faktúr v záložke hlavička je možné pridať dtb. stĺpec s definíciou '''(dl.pksofImExLog.getimexlog4hdf (dl.sof_faktura.ep_id))'''. Táto funkcia vracia informáciu o tom, kedy a akým spôsobom bola daná faktúra vytlačená alebo odoslaná e-mailom. Ak nebola faktúra spracovaná, zobrazí sa prázdny reťazec.

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Pri pokuse o opätovné spracovanie dokladu pomocou HDF sa zobrazí dialógové okno s oznamom, ktorý obsahuje dátum a typ spracovania a s voľbu ďalšieho postupu.

 [[Súbor:EMAIL_SPIN2_Posielanie_14.png]] 

* Ukážka prijatého Emailu (ide o mail doručený prijímateľovi Bcc) :

Predmetom (subject) každého e-mailu bude reťazec v tvare: '''Názov mandanta + “ – elektronický doklad č. : “ + Číslo dokladu'''

 [[Súbor:EMAIL_SPIN2_Posielanie_15.png]] 

=== Odoslanie faktúry e-mailom ako podpísaný PDF dokument ===

Ak chceme zasielať faktúry v PDF s el. podpisom, je potrebné nastaviť nasledujúce SOF SETUP-y: 
* '''F_FA_EMAIL_PDF_EL_PODPIS = {'A',['N']}''' 
Či budú zasielané faktúry vo formáte PDF s el. podpisom 
A = PDF s el. podpisom 
N = PDF bez el. podpisu 
* '''F_FA_EMAIL_PDF_PATH = C:\pbdl\PDF''' 
Cesta pracovného adresára, kde bude uložený pdf súbor pred odoslaním 
Ak nie je nastavená, berie sa z ini súboru zo sekcie "System" parameter "ExportPath" - platí pre SPIN1 
 

=== Odoslanie dodacieho listu ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a tlače aj naskenované súbory dodacích listov k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_DODLIST_PATH"'''
Cesta k skenovaným súborom dodacích listov k faktúre - do hodnoty nastavíte presnú cestu.
Akú príponu budete používať, nastavíte setupom:
* '''"F_FA_HDF_DODLIST_FILEEXT"'''
prípona skenovaných súborov (default = '''"jpg"'''). 

Zadefinujte marketingový údaj firmy:
* '''FA_DODLIST'''
Číselníkový MÚ s hodnotami A - Áno/N - Nie (tento MÚ nesmie byt dátového typu Áno/Nie).
Pri jednotlivých firmách potom vyberte zvolenú hodnotu. 
Rozhodujete tak, či sa má posielať faktúra pre túto firmu aj s naskenovaným dodacím listom. 

Okrem marketingových údajov pri jednotlivých firmách môžete nastaviť pre všetky firmy, resp, všetky ostatné, ktoré nemajú vyplnený marketingový údaj, SOF setup:
* '''"F_FA_HDF_DODLIST"'''. 
Hodnoty (prednastavená je hodnota '''MN'''): 
* '''"MA"''', '''"MN"''' - najprv sa systém pozerá na MÚ firmy '''"FA_DODLIST"''', až potom na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) 
* '''"AN"''', '''"AA"''' - vždy sa systém pozerá na hodnotu setupu (Áno/Nie podľa druhého znaku hodnoty) bez ohľadu na nastavenie MÚ firmy '''"FA_DODLIST"'''. 
 

=== K emailu s faktúrou pripojiť ISDOC ===

Funkcionalitu HDF je možné rozšíriť o ISDOC, Funkčnosť ISDOC je primárne naviazaná na nastavenie MÚ pri jednotlivých firmách. Ak ale chceme používať rovnaké nastavenie HDF pre všetky firmy, resp. pre ostatné, ktoré nemajú nastavené MÚ, nastavíme SOF SETUP: 
* '''F_FA_HDF_ISDOC = {'A',['N']}''' 
Či má byť súčasťou e-mailu aj ISDOC dokument. 
* Používa sa ak odberateľ nemá definovaný MU FA_ISDOC. 
** A = pripojí sa ISDOC 
** N = nepripojí sa ISDOC 

Ak chceme používať funkčnosť ISDOC naviazanú na nastavenie MÚ pri jednotlivých firmách, je potrenmé v okne '''''Spoločné - Firmy a kontakty - Marketingové údaje firmy''''' zadefinovať nový číselníkový marketingový údaj : 
* „ISDOC - Zasielanie elektronických dokladov“ kód = '''”FA_ISDOC”''', hodnoty =[A|N], default = “N”. 
Tým firmám, ktoré budú mať vyplnený MÚ s hodnotou „A“, budú zasielané faktúry elektronicky vo formáte ISDOC. 
Tento marketingový údaj sa pre jednotlivé firmy vypĺňa v okne '''''Spoločné - Firmy a kontakty - Firma''''' - v záložke ''Marketingové údaje''. 
 

=== K emailu s faktúrou pripojiť E-dokumenty z db ===

Ak je hromadné elektronické odoslanie faktúr zapnuté, je možné nastaviť, či majú byť súčasťou e-mailu a aj E-dokumenty z db k faktúre.
V SOF setupe je potrebné nastaviť:
* '''"F_FA_HDF_EDOKUMENTY" = {'I','E',['N']}'''
* Spôsob spracovania e-dokumentov v HDF
** ak bude hodnota setupu '''"N"''' tak pri generovaní e-mailu nebudú ako príloha pripojené žiadne e-dokumenty spracovavanej faktúry
** ak bude hodnota setupu '''"I"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré majú nastavený dohodnutý príznak
** ak bude hodnota setupu '''"E"''' tak pri generovaní e-mailu budú ako príloha pripojené všetky e-dokumenty spracovavanej faktúry, ktoré nemajú nastavený dohodnutý príznak
 
Názov dokumentu pripojeného k e-mailu sa vyskladá z názvu a typu dokumentu uloženého pre daný dokument v '''dl.dl_dok_dokument, dl.dl_dok_typ, dl.dl_dok_ext'''
 
* Dohodnutý príznak pre e-dokument faktúry môže byť buď :
** 1. Vyplnený VU pre evidenčnu položku "e-dokument" danej faktúry, kód VU = '''"_HDF_EDOKUMENT_SPRAC"'''
** 2. Pole '''"Poznamka"''' pre "e-dokument" danej faktúry obsahuje dohodnuty reťazec '''"###"'''
 

== Posielanie faktúr e-mailom zo SPIN2 ako podpísané PDF dokumenty ==

=== Info ===

{{Info|Funkčnosť, ktorá umožňuje zasielanie e-mailu s prílohou vo formáte PDF s elektronickým podpisom je rozšírením štandardnej funkcionality akcie ''''Hromadná distribúcia faktúr''''.}}

=== Nastavenia ===

V okne '''''Program -> Nastavenia -> Spoločné nastavenia -> Podpisovanie PDF''''' je možné špecifikovať nastavenia elektronického podpisu pre prihláseného používateľa. 
Obsahuje tieto atribúty: 
* '''Názov certifikátu pre podpis PDF''' [text] - platný osobný certifikát definovaný v MS Windows 
* '''Kontakt pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom 
* '''Metóda šifrovania hesla PDF''' [text] - Strenght128, Aes128, Aes256 
* '''Miesto pre podpis PDF''' [text] - miesto podpisu 
* '''Dôvod pre podpis PDF''' [text] - textová informácia, ktorá sa zobrazuje s el. podpisom

{{Tip|Ako zistím čo vpísať do poľa : '''Názov certifikátu pre podpis PDF'''? 
Napríklad cez prehliadač Internet Exporer 
-- > Nástroje -- > Možnosti siete internet -- > Obsah -- > Certifikáty}}

[[Súbor:EMAIL_SPIN2_Posielanie_23.png]] 

'''Sof_Setup''' 
* Aktivácuia funkcionality sa zapína setupom : '''„F_FA_EMAIL_PDF_EL_PODPIS“''' = "A", (hodnoty [ A / N ], Default = "N") 

=== Pracovný postup ===

* Otvoríme vybrané okno údajov. Akciu '''„Hromadná distribúcia faktúr“''' nájdeme v menu '''„Údaje“'''.

 [[Súbor:EMAIL_SPIN2_Posielanie_11.png]] 

* Otvorí sa dialógové okno '''„Výber zostavy na Tlač/E-mail“'''.
* Nastavíme parametre.

 [[Súbor:EMAIL_SPIN2_Posielanie_12.png]] 

* Po potvrdení '''„OK“''' v dialógovom okne program spracuje všetky označené (selektované) FV alebo ZFV. 

 [[Súbor:EMAIL_SPIN2_Posielanie_13.png]] 

* Po potvrdení '''„OK“''' sa vytvorí požadovaná faktúra vo formáte PDF. Tato faktúra bude podpísaná elektronickým podpisom, ktorý je definovaný pre prihláseného používateľa. V prípade, že takýto certifikát v MS Windows nie je definovaný alebo platný, program zobrazí chybu a e-mail nebude odoslaný. 

 [[Súbor:EMAIL_SPIN2_Posielanie_24.png]] 

=== Signature valid ===

[[Súbor:Sof17.jpg]] 

{{Info|Podmienkou správneho fungovania je existencia '''exportovateľného''' certifikátu v MS Windows pre každého používateľa, ktorý bude odosielať elektronicky podpísané dokumenty vo formáte PDF.}}

AGROTRADE

2017-01-12T14:21:30Z

Ivan.michalik: /* Režim - kartóny */

= Režim - balíčky =

* Prevodka

Setupy
Pracovný postup

* Dodací list

Setupy
Pracovný postup

* Inventúra

Setupy
Pracovný postup

= Režim - kartóny =
* Prevodka

Setupy
Pracovný postup

* Dodací list z predajnej objednávky

Setupy
Pracovný postup

* Potvrdzovanie prebratia tovaru vodičom

Setupy
Pracovný postup

* Inventúra

Setupy
Pracovný postup

'''Návrat na :''' [[Mobilný skladník - zákaznícke riešenia]]

AGROTRADE

2017-01-12T14:20:52Z

Ivan.michalik: /* Režim - balíčky */

= Režim - balíčky =

* Prevodka

Setupy
Pracovný postup

* Dodací list

Setupy
Pracovný postup

* Inventúra

Setupy
Pracovný postup

= Režim - kartóny =
* Prevodka
* Dodací list z predajnej objednávky
* Potvrdzovanie prebratia tovaru vodičom
* Inventúra

'''Návrat na :''' [[Mobilný skladník - zákaznícke riešenia]]

AGROTRADE

2017-01-12T14:19:25Z

Ivan.michalik: /* Režim - balíčky */

= Režim - balíčky =

* Prevodka

aaa

* Dodací list

aaa

* Inventúra

aaa

= Režim - kartóny =
* Prevodka
* Dodací list z predajnej objednávky
* Potvrdzovanie prebratia tovaru vodičom
* Inventúra

'''Návrat na :''' [[Mobilný skladník - zákaznícke riešenia]]