• Table of contents
• 01 E-posti kirjeldus
• 02 Sissetulev e-posti lüüs (parsimine)
• 03 Väljaminevad teavitused
• 04 SMTP-ühenduse sätted
• 05 Teavituste seaded EDI-Web-is
• 06 Millist saatja aadressi kasutatakse
  • 01 Docura kaudu, hoides kliendi aadressi saatjas. DNS
    • 01 SPF
    • 02 DKIM
    • 03 DMARC
    • 04 PTR ja HELO
    • 05 Pärast lisamist
• 07 Testimine ja tugi

01 E-posti kirjeldus¶

1. E-post on üks edastuskanalitest, mida Docura kasutab äridokumentide vahetamiseks partneritega. Kaasatud on kaks iseseisvat mehhanismi:
   1. Sissetulev - postkast Docura meiliserveris, kuhu partnerid saadavad dokumente automaatseks parsitud ja Docurasse toimetamiseks (jaotis 02).
   2. Väljaminev - teavitused, mida Docura saadab partneritele dokumendi vastuvõtmisel või saatmisel, koos dokumendi endaga lisana (jaotis 03).
2. E-post on mugav, sest partner ei vaja EDI-tarkvara, FTP-kontot ega sertifikaate - piisab postkastist. See teeb e-postist kiireima viisi ühenduse loomiseks vastaspoolega, kellel puudub üldse EDI.
3. E-posti nõrgad kohad on edastatavus (saatja domeeni SPF, DKIM ja DMARC, vt jaotis 06) ja asjaolu, et meilikliendid koostavad kirju väga erinevalt (vt jaotis 02).

02 Sissetulev e-posti lüüs (parsimine)¶

1. Sissetulevate dokumentide jaoks loob Docura oma meiliserverisse postkasti, domeeniga @edi.docura.net. Postkasti loob Docura tugi meiliserveri halduspaneelis – saatjal on vaja teada ainult aadressi.
2. Nimi lepitakse kokku Docura toega. Tüüpilised mustrid:
   1. companyname@edi.docura.net – standardjuhtum, üks lüüs partneri kohta. Firma nimi kirjutatakse ilma tühikuteta ja lühikesed loetavad lühendid on sobivad (näiteks ep@ Eesti Pagari kohta).
   2. companyname.country@edi.docura.net – kui on seotud mitu riiki või formaati, näiteks fristar.lv@edi.docura.net
   3. companyname.doctype@edi.docura.net – kui dokumenditüüpe käsitletakse eraldi, näiteks wolt.ee.aperak@edi.docura.net
3. Postkasti jälgitakse: Docura kogub perioodiliselt kirju, eraldab sisu, teisendab selle kokkulepitud formaati ja toimetab dokumendi kliendi Docura keskkonda. See töötab ka nende partnerite puhul, kes ei soovi üldse reaalset EDI-ühendust – seda nimetatakse mõnikord "pimedaks" EDI-ks.
4. Kirja enda kohta ei ole rangeid reegleid – saatja ei pea saatma ühte dokumenti kirja kohta:
   1. Kiri võib sisaldada mitut dokumenti või ühte arhiivi (näiteks zip) paljude failidega – kõik võetakse vastu ja töödeldakse.
   2. Peab klappima kokkulepitud dokumendipaigutus ja formaat, mitte failide arv kirja kohta.
5. Sisu, mida saab parsida:
   1. Exceli hinnakirjad – laetakse PRODUCTCATALOG / PRICAT-na (paigutus lepitakse eelnevalt kokku)
   2. XML-dokumendid – Docura XML või muu kokkulepitud formaat (INVOICE, ORDER, DESADV ja muud)
   3. Muud formaadid kokkuleppel – EDIFACT, CSV, Telema/Edisoft XML
6. Kaks režiimi dokumendi kirjast eemaldamiseks (valitakse iga seose jaoks koos Docura toega):
   1. Attachment – kõik kirja manused võetakse ükshaaval ja igaühte töödeldakse. See on tavaline režiim.
   2. Body – kogu kiri teisendatakse XML-iks ja töödeldakse. Kasutatakse, kui andmed asuvad kirja tekstis, mitte failis.
7. Filtrid otsustavad, mis aktsepteeritakse ja mis ignoreeritakse. Neid konfigureerib Docura seose kohta:
   1. Saatja filter (regulaaravaldis) – võtab kirju vastu ainult kokkulepitud aadressimaskilt.
   2. Teema filter (regulaaravaldis) – võtab kirju vastu ainult sobiva teemaga.
   3. Failinime filter (regulaaravaldis, näiteks (?i)(.*)(.xls|.xlsx)) koos failifiltri tüübiga (näiteks Error without notification). See on olemas, sest saatjad lisavad sageli logosid, pilte ja allkirju, samas kui iga manus töödeldakse – filter lõikab sellised failid välja.
8. Seega ei vaja saatja erilist distsipliini: piisab saatmisest kokkulepitud aadressile ja juhuslikud lisafailid filtreeritakse lihtsalt välja, selle asemel et parsimine katki läheks.
9. Mis filtreid ei läbi, see ei kao: kui seos on nii konfigureeritud, edastatakse kiri muutmata kujul veaaadressile, kusjuures algsed Saatja ja Saaja on liigutatud teemasse (muidu satuks selline kiri rämpsposti).
10. Algse kirja saab edastada ka kliendile (Copy email) – kasutatakse, kui vabas vormis kirju peab inimene nägema.
11. Töötav näide on Fristar_SIA: aadress fristar.lv@edi.docura.net aktsepteerib hinnakirju (Excel) ja XML-arveid ning leht kirjeldab kogu voogu partneri poolelt.
12. Lüüs ei ole mõeldud masspostitusteks: vastuvõtukiirus on piiratud (umbes 150 kirja minutis). Sellest kõrgemal lähevad kirjad tagasilükkamise logisse ja saatja blokeeritakse 24 tunniks. Hulgivahetus toimub FTP või API kaudu.

03 Väljaminevad teavitused¶

1. Väljaminevad kirjad on teavitused dokumentide kohta. Teavitus konfigureeritakse suhtepõhiselt: dokumendi tüüp, dokumendi olek, suund ja partner, nii et ühel organisatsioonil võib olla mitu erinevate seadetega teavitust.
2. Saajad kogutakse mitmest allikast:
   1. To – dokumendist endast võetud saaja e-posti aadress (Document-Invoice/Document-Parties/Receiver/E-mail)
   2. pluss kõik teavituses selgesõnaliselt loetletud aadressid
   3. pluss, mõnede partnerite puhul, saaja LOCCAT-ist võetud aadressid – kasutatakse, kui üks arve tuleb edastada paljudele kauplustele või tarnepunktidele
3. Reply-to võetakse dokumendi saatja e-posti aadressilt (Document-Invoice/Document-Parties/Sender/E-mail), et partneri vastus jõuaks õige isikuni.
4. Kirja sisu koostatakse XSLT malli (Email xslt) abil ja dokumenti saab lisada failina.
5. Vaikimisi saadetakse kõik teavitused Docura domeenilt: docuway@docura.net.

04 SMTP-ühenduse sätted¶

SMTP-ühendus on salvestatud mandaatide komplekt, mis ütleb Docurale, millist postkasti ja millist serverit saatmiseks kasutada. See luuakse ja seda hallatakse Docura veebirakenduses (vahekaart Teavitused, aken Uuenda smtp ühendust):

Väli	Tähendus
Kirjeldus	Vaba kommentaar, tavaliselt meiliserveri nimi
serverName	Saatja postkasti SMTP-serveri host
serverPort	SMTP-port, tavaliselt 25, 465 või 587
Kasutajanimi	Postkasti sisselogimine, st aadress, millelt e-kiri tegelikult saadetakse
Kasutaja parool	Selle postkasti parool
Ühenduse turvalisus	Krüpteerimisrežiim, tavaliselt SSL_TLS

1. Nupp Testi ühendust kontrollib salvestatud mandaate enne teavituse ümberlülitamist.
2. SMTP-ühenduse saab luua ka API kaudu (operatsioon createSmtpConnection): organizationId, description, fromName, serverName, serverPort, userName, userPassword, connectionSecurity.

05 Teavituste seaded EDI-Web-is¶

Saatja aadressid ei ole globaalsed - need määratakse teavituse enda juures: Teavitused - Muuda, vahekaart Teavituse informatsioon.

Väli	Tähendus
Email	Teavituse saaja(te) aadress(id)
From name (name <email>)	Aadress, kust teavitus saadetakse
Reply to (name <email>)	Aadress, kuhu partneri vastus läheb
Partner	Partnerorganisatsioon, millele teavitus kuulub
Smtp connection	Millist SMTP ühendust (postkasti) kasutatakse saatmiseks
Email xslt	XSLT mall, mis loob kirja sisu
Enabled	Lubatud / keelatud

1. Vahekaart SMTP näitab selle teavituse poolt kasutatavat ühendust, vahekaart XSLT näitab malli.
2. Saajaid, keda ei ole dokumendis endas, saab lisada teavituses täiendavalt, vaata jaotist 03.

06 Millist saatja aadressi kasutatakse¶

1. Vaikimisi: Docura domeen. Alates = docuway@docura.net, Vastus = kliendi aadress. Kohaletoimetatavus on tagatud, sest Docura domeenil on õiged SPF, DKIM, DMARC ja PTR kirjed. See hõlmab enamikku juhtumeid ja on soovitatav seadistus.
2. Alates = kliendi enda domeen. Kaks võimalust:
   1. Kliendi enda meiliserveri kaudu – kliendi SMTP-server, sisselogimisnimi ja parool salvestatakse SMTP-ühendusena. Kliendi domeeni SPF ja DKIM läbivad, sest e-kiri saadetakse tegelikult nende serveri poolt. See on kõige ohutum valik kliendi "Alates" jaoks.
   2. Docura meiliserveri kaudu, säilitades kliendi aadressi "Alates" väljal. Seejärel tuleb kliendi DNS eelnevalt ette valmistada, vastasel juhul lähevad sellised kirjad rämpsposti või lükatakse tagasi:
      

      TXT mail._domainkey "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAq4dvMit/5L1okysL1nzm3d+qsl1XYeEg8sUzuBHSWRzX8UQ2Xai6cYukmBU7N4Brn69+1xc8DbdUwlP1mpiYhf2qTK7yaYjZTnfyyyumTCFhkHGDfJmga6p2JsOIUQ5dFhlE4gQBUI4FY3a3XZM2gbUVTr08dGkpEJA3yrsbJ5akl88tJsvX4Osw1EJl6i9dn" "1yzX+VxFlD6imjDDgYvyu2sxzWhU6dGtvg7KsP+8x0mXXp9gGFT/odo5zbLjmD0VT9KMWNwRUlBAsOT7bCJgauEXk9ygSnCazZ5UpmGgKfPuXIEXGTEUzRSblTNqKsUjGZtdiWxBo2FXPqnT+AIPwIDAQAB" 
      
      TXT @ "v=spf1 ip4:78.46.44.41 ip4:78.46.44.49 ip4:178.63.30.140 a mx ~all" 
      
      TXT _dmarc "v=DMARC1;p=none" 
      

01 Docura kaudu, hoides kliendi aadressi saatjas. DNS¶

Kliendi From DNS-kirjed (SPF, DKIM, DMARC). Vajalik ainult ülaltoodud valiku 2.2 jaoks. Kõik kolm on TXT-kirjed samas domeenis, mida kasutatakse saatjas – @@ tähendab selle domeeni juurt, mitte alamdomeeni.

01 SPF¶

Domeeni kohta on lubatud ainult üks SPF-kirje. Kui teil see juba olemas on, siis ärge looge teist – lisage Docura aadressid olemasolevasse kirjesesse, säilitades kõik, mis seal juba on.

TXT @ "v=spf1 ip4:78.46.44.41 ip4:78.46.44.49 ip4:178.63.30.140 a mx ~all" 

~all on pehme režiim – muudelt aadressidelt saabunud e-kirjad märgitakse kahtlasteks, kuid toimetatakse kohale. -all lükkab need tagasi, nii et -all-i puhul peavad olema loetletud kõik domeeni saatjad.

02 DKIM¶

Uus kirje, see ei asenda midagi. mail on valija, nii et muud teie domeeni jaoks e-kirju allkirjastavad teenused ei ole mõjutatud.

TXT mail._domainkey "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAq4dvMit/5L1okysL1nzm3d+qsl1XYeEg8sUzuBHSWRzX8UQ2Xai6cYukmBU7N4Brn69+1xc8DbdUwlP1mpiYhf2qTK7yaYjZTnfyyyumTCFhkHGDfJmga6p2JsOIUQ5dFhlE4gQBUI4FY3a3XZM2gbUVTr08dGkpEJA3yrsbJ5akl88tJsvX4Osw1EJl6i9dn" "1yzX+VxFlD6imjDDgYvyu2sxzWhU6dGtvg7KsP+8x0mXXp9gGFT/odo5zbLjmD0VT9KMWNwRUlBAsOT7bCJgauEXk9ygSnCazZ5UpmGgKfPuXIEXGTEUzRSblTNqKsUjGZtdiWxBo2FXPqnT+AIPwIDAQAB" 

Kaks jutumärgiga stringi, sest üks TXT-string ei saa ületada 255 märki – DNS ühendab need lugemisel.

03 DMARC¶

Domeeni kohta on lubatud ainult üks DMARC-kirje. Kui teil on see juba olemas, jätke see selliseks, nagu see on. Alljärgnev kirje on mõeldud ainult domeenidele, millel see puudub.

TXT _dmarc "v=DMARC1;p=none" 

04 PTR ja HELO¶

Kuuluvad Docura saatmiserveritele, mitte teie domeenile. Neid haldab Docura, teie poolelt pole midagi vaja teha.

05 Pärast lisamist¶

DNS-i muudatused võtavad sõltuvalt TTL-ist aega mõnest minutist kuni 24 tunnini. Kui kirjed on nähtavad, paluge Docura toelt testkirja, vt jaotist 07. Kuni see läbib, jätkake saatmist Docura domeenilt.

07 Testimine ja tugi¶

1. Paluge Docura toel saata kliendi aadressile testkiri ja kontrollida algseid päiseid (From, Reply-to, SPF/DKIM/DMARC tulemus).
2. Sissetuleva lüüsi jaoks saatke üks tellimus või arve (tavaline kiri koos kõigi lisafailidega, mille teie meiliklient lisab) aadressile edi.docura.net ja paluge toel kinnitada, et see parsiti õigesti.
3. Kirjutage aadressile support@docura.net või kasutage EDI-Webi vestlust, kui teil on küsimusi lüüsi postkastide, filtrite, saatja aadresside ja DNS-kirjete kohta.