Project

General

Profile

View source (English) EN RU ET LT LV Latviešu
English Русский Eesti Lietuvių

Wiki » 04 Transmission communication channels and API »

01 E-pasta apraksts

  1. E-pasts ir viens no pārsūtīšanas kanāliem, ko Docura izmanto, lai apmainītos ar biznesa dokumentiem ar partneriem. Ir iesaistīti divi neatkarīgi mehānismi:
    1. Ienākošie – pastkaste Docura pasta serverī, kur partneri sūta dokumentus automātiskai parsēšanai un piegādei uz Docura (02. sadaļa).
    2. Izejošie – paziņojumi, ko Docura sūta partneriem, saņemot vai nosūtot dokumentu, ar pašu dokumentu kā pielikumu (03. sadaļa).
  2. E-pasts ir ērts, jo partnerim nav nepieciešama EDI programmatūra, nav FTP konta un nav sertifikātu – pietiek ar pastkasti. Tas padara e-pastu par ātrāko veidu, kā savienot darījuma partneri, kuram vispār nav EDI.
  3. E-pasta vājās vietas ir piegādājamība (sūtītāja domēna SPF, DKIM un DMARC, skatiet 06. sadaļu) un fakts, ka pasta klienti veido vēstules ļoti dažādos veidos (skatiet 02. sadaļu).

02 Ienākošo e-pastu vārteja (parsēšana)

  1. Ienākošajiem dokumentiem Docura izveido pastkasti savā pasta serverī, domēnā @edi.docura.net. Pastkasti izveido Docura atbalsta dienests pasta servera administrēšanas panelī – sūtītājam jāzina tikai adrese.
  2. Nosaukums tiek saskaņots ar Docura atbalsta dienestu. Tipiski paraugi:
    1. – standarta gadījums, viena vārteja katram darījumu partnerim. Uzņēmuma nosaukums tiek rakstīts bez atstarpēm, un īsi, lasāmi saīsinājumi ir pieņemami (piemēram, ep@ priekš Eesti Pagar).
    2. – ja ir iesaistītas vairākas valstis vai formāti, piemēram, .
    3. – ja dokumentu veidi tiek apstrādāti atsevišķi, piemēram, .
  3. Pastkaste tiek uzraudzīta: Docura periodiski savāc vēstules, izņem saturu, konvertē to saskaņotā formātā un piegādā dokumentu klienta Docura vidē. Tas darbojas arī darījumu partneriem, kuri vispār nevēlas īstu EDI savienojumu – dažreiz to sauc par “aklo” EDI.
  4. Nav stingru noteikumu par pašu vēstuli – sūtītājam nav jāsūta viens dokuments katrā vēstulē:
    1. Vēstule var saturēt vairākus dokumentus vai vienu arhīvu (piemēram, zip) ar daudziem failiem iekšpusē – viss tiek paņemts un apstrādāts.
    2. Jāsakrīt ir saskaņotajam dokumenta izkārtojumam un formātam, nevis failu skaitam katrā vēstulē.
  5. Saturam, ko var parsēt:
    1. Excel cenrāži – ielādēti kā PRODUCTCATALOG / PRICAT (izkārtojums tiek saskaņots iepriekš).
    2. XML dokumenti – Docura XML vai cits saskaņots formāts (INVOICE, ORDER, DESADV un citi).
    3. Citi formāti pēc vienošanās – EDIFACT, CSV, Telema/Edisoft XML.
  6. Divi dokumenta izņemšanas veidi no vēstules (tiek izvēlēti katrai attiecībai kopā ar Docura atbalsta dienestu):
    1. Pielikums – visi vēstules pielikumi tiek ņemti pa vienam un katrs tiek apstrādāts. Tas ir parastais režīms.
    2. Pamatteksts – visa vēstule tiek konvertēta XML formātā un apstrādāta. Tiek izmantots, ja dati atrodas vēstules tekstā, nevis failā.
  7. Filtri lemj, kas tiek pieņemts un kas tiek ignorēts. Tos konfigurē Docura attiecībā:
    1. Sūtītāja filtrs (regulārā izteiksme) – pieņem vēstules tikai no saskaņotas adreses maskas.
    2. Temata filtrs (regulārā izteiksme) – pieņem vēstules tikai ar atbilstošu tematu.
    3. Failu nosaukumu filtrs (regulārā izteiksme, piemēram, (?i)(.*)(.xls|.xlsx)) kopā ar failu filtra tipu (piemēram, Error without notification). Tas ir tāpēc, ka sūtītāji bieži pievieno logotipus, attēlus un parakstus, bet katrs pielikums tiek apstrādāts – filtrs šādus failus nogriež.
  8. Tātad sūtītājam nav nepieciešama īpaša disciplīna: pietiek nosūtīt uz saskaņoto adresi, un dīvains papildu fails vienkārši tiks filtrēts, nevis sabojās parsēšanu.
  9. Tas, kas neiziet cauri filtriem, netiek zaudēts: ja attiecība ir konfigurēta šādi, vēstule tiek pārsūtīta nemainīta uz kļūdu adresi, ar oriģinālo "No" un "Kam" pārvietotiem uz tematu (citādi šāda vēstule nonāktu surogātpastā).
  10. Oriģinālā vēstule var tikt pārsūtīta arī klientam (Copy email) – tiek izmantots, ja brīva formāta vēstules ir jāredz cilvēkam.
  11. Darbojošs piemērs ir Fristar_SIA: adrese pieņem cenrāžus (Excel) un XML rēķinus, un lapā ir aprakstīta visa plūsma no partnera puses.
  12. Vārteja nav paredzēta masveida sūtījumiem: saņemšanas ātrums ir ierobežots (apmēram 150 vēstules minūtē). Virs tā vēstules nonāk noraidīto vēstuļu žurnālā, un sūtītājs tiek bloķēts uz 24 stundām. Lielapjoma apmaiņa notiek, izmantojot FTP vai API.

03 Izejošie paziņojumi

  1. Izejošās vēstules ir paziņojumi par dokumentiem. Paziņojums tiek konfigurēts atkarībā no saistības: dokumenta veida, dokumenta statusa, virziena un partnera, tāpēc vienai organizācijai var būt vairāki paziņojumi ar dažādiem iestatījumiem.
  2. Saņēmēji tiek apkopoti no vairākiem avotiem:
    1. Kam — saņēmēja e-pasts, kas ņemts no paša dokumenta (Document-Invoice/Document-Parties/Receiver/E-mail)
    2. plus visas adreses, kas skaidri norādītas paziņojumā
    3. plus, dažiem partneriem, adreses, kas ņemtas no saņēmēja LOCCAT – tiek izmantotas, ja viens rēķins jāpiegādā daudziem veikaliem vai piegādes punktiem
  3. Atbildēt uz tiek ņemts no sūtītāja e-pasta dokumentā (Document-Invoice/Document-Parties/Sender/E-mail), lai partnera atbilde nonāktu pie īstās personas.
  4. Vēstules pamatteksts tiek veidots, izmantojot XSLT veidni (Email xslt), un dokuments var tikt pievienots kā fails.
  5. Pēc noklusējuma visi paziņojumi tiek sūtīti no Docura domēna: .

04 SMTP savienojuma iestatījumi

SMTP savienojums ir saglabāts akreditācijas datu kopums, kas norāda Docura, kura pastkaste un kurš serveris jāizmanto sūtīšanai. Tas tiek izveidots un uzturēts Docura tīmekļa lietojumprogrammā (cilne Paziņojumi, logs Atjaunināt smtp savienojumu):

Lauks Nozīme
Apraksts Brīvs komentārs, parasti pasta servera nosaukums
serverName Sūtītāja pastkastes SMTP servera resursdators
serverPort SMTP ports, parasti 25, 465 vai 587
Lietotājvārds Pastkastes pieteikšanās dati, t.i., adrese, no kuras e-pasts faktiski tiek nosūtīts
Lietotāja parole Šīs pastkastes parole
Savienojuma drošība Šifrēšanas režīms, parasti SSL_TLS
  1. Poga Pārbaudīt savienojumu pārbauda saglabātos akreditācijas datus pirms paziņojuma pārslēgšanas.
  2. SMTP savienojumu var izveidot arī, izmantojot API (operācija createSmtpConnection): organizationId, description, fromName, serverName, serverPort, userName, userPassword, connectionSecurity.

05 Paziņojumu iestatījumi pakalpojumā EDI-Web

Sūtītāja adreses nav globālas – tās tiek iestatītas pašā paziņojumā: Paziņojumi – Rediģēt, cilne Paziņojuma informācija.

Lauks Nozīme
E-pasts Paziņojuma saņēmēja(-u) adrese(-es)
Sūtītāja vārds (vārds <e-pasts>) Adrese, NO kuras paziņojums tiek sūtīts
Atbildēt uz (vārds <e-pasts>) Adrese, uz kuru tiks nosūtīta partnera atbilde
Partneris Partneru organizācija, kurai paziņojums pieder
SMTP savienojums Kurš SMTP savienojums (pastkaste) tiek izmantots sūtīšanai
E-pasta XSLT XSLT veidne, kas veido vēstules pamattekstu
Iespējots Iespējots / atspējots
  1. Cilne SMTP parāda šī paziņojuma izmantoto savienojumu, cilne XSLT parāda veidni.
  2. Saņēmējus, kuri nav norādīti pašā dokumentā, var papildus pievienot paziņojumā, skatiet 03. sadaļu.

06 Kura sūtītāja adrese tiek izmantota

  1. Noklusējums: Docura domēns. No = , Atbildēt uz = klienta adresi. Piegāde ir garantēta, jo Docura domēnam ir pareizi SPF, DKIM, DMARC un PTR ieraksti. Tas aptver lielāko daļu gadījumu un ir ieteicamā iestatīšana.
  2. No = klienta paša domēna. Divas iespējas:
    1. Izmantojot klienta paša pasta serveri – klienta SMTP serveris, pieteikšanās vārds un parole tiek saglabāti kā SMTP savienojums. Klienta domēna SPF un DKIM iziet, jo pasts patiešām tiek nosūtīts no viņu servera. Šī ir drošākā iespēja klienta "No" adreses izmantošanai.
    2. Izmantojot Docura pasta serveri, saglabājot klienta adresi laukā "No". Tad vispirms ir jāsagatavo klienta DNS, pretējā gadījumā šādas vēstules nonāk surogātpastā vai tiek noraidītas:
      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 Caur Docura, klienta adreses saglabāšana laukā No. DNS

Klienta DNS ieraksti (SPF, DKIM, DMARC) no. Nepieciešams tikai opcijai 2.2 iepriekš. Visi trīs ir TXT ieraksti vienā un tajā pašā domēnā, kas tiek izmantots laukā No - @@ nozīmē šī domēna sakni, nevis apakšdomēnu.

01 SPF

Katram domēnam ir atļauts tikai viens SPF ieraksts. Ja jums jau ir viens, neizveidojiet otru – pievienojiet Docura adreses esošajam ierakstam, saglabājot visu, kas tur jau ir.

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

~all ir maigais režīms – e-pasti no citām adresēm tiek atzīmēti kā aizdomīgi, bet piegādāti. -all tos noraida, tāpēc ar -all ir jāuzskaita katrs domēna sūtītājs.

02 DKIM

Jauns ieraksts, tas neko neaizstāj. mail ir selektors, tāpēc citi pakalpojumi, kas paraksta e-pastu jūsu domēnam, netiek ietekmēti.

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

Divas citētas virknes, jo viena TXT virkne nevar pārsniegt 255 rakstzīmes – DNS tās apvieno lasot.

03 DMARC

Katram domēnam atļauts tikai viens DMARC ieraksts. Ja jums jau tāds ir, atstājiet to, kā ir. Zemāk redzamais ieraksts ir paredzēts tikai domēniem, kuriem tāda nav.

TXT _dmarc "v=DMARC1;p=none"

04 PTR un HELO

Pieder Docura sūtīšanas serveriem, nevis jūsu domēnam. Uztur Docura, jums nekas nav jādara.

05 Pēc pievienošanas

DNS izmaiņas stājas spēkā no dažām minūtēm līdz 24 stundām atkarībā no TTL. Kad ieraksti ir redzami, lūdziet Docura atbalsta dienestam testa vēstuli, skatīt sadaļu 07. Līdz tas iziet, turpiniet sūtīt no Docura domēna.

07 Testēšana un atbalsts

  1. Lūdziet Docura atbalsta dienestam nosūtīt testa vēstuli uz klienta adresi un pārbaudīt neapstrādātās galvenes (From, Reply-to, SPF/DKIM/DMARC rezultātu).
  2. Ienākošajai vārtejai nosūtiet vienu pasūtījumu vai rēķinu (parastu vēstuli ar jebkādiem papildu failiem, ko pievieno jūsu e-pasta klients) uz adresi edi.docura.net un lūdziet atbalsta dienestam apstiprināt, ka tā ir pareizi parsēta.
  3. Rakstiet uz vai izmantojiet tērzēšanu pakalpojumā EDI-Web, ja jums ir jautājumi par vārtejas pastkastēm, filtriem, sūtītāju adresēm un DNS ierakstiem.

Source version: 15 · Status: fresh · Roman Startsev