Project

General

Profile

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

Wiki » 04 Transmission communication channels and API »

01 El. pašto aprašymas

  1. El. paštas yra vienas iš perdavimo kanalų, kuriuos Docura naudoja keistis verslo dokumentais su partneriais. Dalyvauja du nepriklausomi mechanizmai:
    1. Gaunami – pašto dėžutė Docura pašto serveryje, kur partneriai siunčia dokumentus automatiniam apdorojimui ir pristatymui į Docura (2 skyrius).
    2. Siunčiami – pranešimai, kuriuos Docura siunčia partneriams, kai dokumentas gaunamas arba išsiunčiamas, su pačiu dokumentu kaip priedu (3 skyrius).
  2. El. paštas yra patogus, nes partneriui nereikia EDI programinės įrangos, FTP paskyros ir sertifikatų – pakanka pašto dėžutės. Tai daro el. paštą greičiausiu būdu prijungti kontrahentą, kuris visiškai neturi EDI.
  3. Silpnosios el. pašto vietos yra pristatomumas (siuntėjo domeno SPF, DKIM ir DMARC, žr. 6 skyrių) ir tai, kad pašto klientai laiškus sudaro labai skirtingais būdais (žr. 2 skyrių).

02 Gaunamų el. laiškų šliuzas (analizavimas)

  1. Gaunamiems dokumentams „Docura“ sukuria pašto dėžutę savo pašto serveryje, domene @edi.docura.net. Pašto dėžutę sukuria „Docura“ palaikymo komanda pašto serverio administravimo skydelyje – siuntėjui tereikia žinoti adresą.
  2. Pavadinimas derinamas su „Docura“ palaikymo komanda. Tipiški šablonai:
    1. – standartinis atvejis, vienas šliuzas vienam partneriui. Įmonės pavadinimas rašomas be tarpų, tinka trumpi, lengvai skaitomi trumpiniai (pvz., ep@, skirtas „Eesti Pagar“).
    2. – kai susijusios kelios šalys ar formatai, pvz.,
    3. – kai dokumentų tipai tvarkomi atskirai, pvz.,
  3. Pašto dėžutė stebima: „Docura“ periodiškai renka laiškus, išskiria turinį, konvertuoja jį į sutartą formatą ir pristato dokumentą į kliento „Docura“ aplinką. Tai taip pat veikia partneriams, kurie visai nenori realaus EDI ryšio – kartais vadinamo „akluoju“ EDI.
  4. Nėra griežtos taisyklės dėl paties laiško – siuntėjas neprivalo siųsti vieno dokumento viename laiške:
    1. Laiškas gali turėti kelis dokumentus arba vieną archyvą (pvz., zip) su daugybe failų viduje – viskas paimama ir apdorojama.
    2. Turi atitikti sutartas dokumento išdėstymas ir formatas, o ne failų skaičius laiške.
  5. Turinys, kurį galima analizuoti:
    1. Excel kainoraščiai – įkeliami kaip PRODUCTCATALOG / PRICAT (išdėstymas derinamas iš anksto)
    2. XML dokumentai – „Docura“ XML arba kitas sutartas formatas (INVOICE, ORDER, DESADV ir kiti)
    3. Kiti formatai pagal susitarimą – EDIFACT, CSV, Telema/Edisoft XML
  6. Du dokumento išėmimo iš laiško režimai (pasirenkami pagal ryšį kartu su „Docura“ palaikymo komanda):
    1. Priedas – visi laiško priedai paimami po vieną ir kiekvienas apdorojamas. Tai įprastas režimas.
    2. Tekstas – visas laiškas konvertuojamas į XML ir apdorojamas. Naudojama, kai duomenys yra laiško tekste, o ne faile.
  7. Filtrai nusprendžia, kas priimama, o kas ignoruojama. Juos „Docura“ konfigūruoja ryšyje:
    1. Siuntėjo filtras (reguliarioji išraiška) – priima laiškus tik iš sutartos adreso kaukės.
    2. Temos filtras (reguliarioji išraiška) – priima laiškus tik su atitinkančia tema.
    3. Failo pavadinimo filtras (reguliarioji išraiška, pvz., (?i)(.*)(.xls|.xlsx)) kartu su failo filtro tipu (pvz., Error without notification). Tai yra todėl, kad siuntėjai dažnai prideda logotipų, nuotraukų ir parašų, o kiekvienas priedas yra apdorojamas – filtras pašalina tokius failus.
  8. Taigi siuntėjui nereikia jokios ypatingos disciplinos: pakanka siųsti sutartu adresu, o atsitiktinis papildomas failas bus tiesiog filtruojamas, o ne sulaužys analizavimą.
  9. Kas nepatenka pro filtrus, nėra prarandama: kai ryšys sukonfigūruotas taip, laiškas persiunčiamas nepakeistas klaidos adresu, perkeliant originalius „Nuo“ ir „Kam“ į temą (kitaip toks laiškas atsidurtų šlamšte).
  10. Originalus laiškas taip pat gali būti persiųstas klientui (Kopijuoti el. laišką) – naudojama, kai laisvo formato laiškus turi matyti žmogus.
  11. Veikiantis pavyzdys yra Fristar_SIA: adresas priima kainoraščius (Excel) ir XML sąskaitas faktūras, o puslapyje aprašomas visas srautas iš partnerio pusės.
  12. Šliuzas nėra skirtas masiniam siuntimui: priėmimo greitis yra ribotas (apie 150 laiškų per minutę). Viršijus šį limitą, laiškai patenka į atmetimo žurnalą, o siuntėjas blokuojamas 24 valandoms. Dideli mainai vykdomi per FTP arba API.

03 Išsiunčiami pranešimai

  1. Išsiunčiami laiškai yra pranešimai apie dokumentus. Pranešimas konfigūruojamas pagal ryšį: dokumento tipą, dokumento būseną, kryptį ir partnerį, todėl viena organizacija gali turėti kelis pranešimus su skirtingais nustatymais.
  2. Gavėjai renkami iš kelių šaltinių:
    1. Kam – gavėjo el. pašto adresas, paimtas iš paties dokumento (Document-Invoice/Document-Parties/Receiver/E-mail)
    2. plius visi adresai, aiškiai nurodyti pranešime
    3. plius, kai kuriems partneriams, adresai paimti iš gavėjo LOCCAT – naudojama, kai viena sąskaita faktūra turi būti pristatyta į daugelį parduotuvių ar pristatymo vietų
  3. Atsakyti kam imamas iš siuntėjo el. pašto dokumente (Document-Invoice/Document-Parties/Sender/E-mail), kad partnerio atsakymas pasiektų tinkamą asmenį.
  4. Laiško turinys sukuriamas XSLT šablonu (Email xslt), o dokumentas gali būti pridėtas kaip failas.
  5. Pagal numatytuosius nustatymus visi pranešimai siunčiami iš Docura domeno: .

04 SMTP ryšio nustatymai

SMTP ryšys – tai saugomas kredencialų rinkinys, nurodantis Docura, kokią pašto dėžutę ir kokį serverį naudoti siuntimui. Jis sukuriamas ir palaikomas Docura žiniatinklio programoje (skirtukas Pranešimai, langas Atnaujinti smtp ryšį):

Laukas Reikšmė
Aprašymas Laisvas komentaras, dažniausiai pašto serverio pavadinimas
serverName Siuntėjo pašto dėžutės SMTP serverio pagrindinis kompiuteris
serverPort SMTP prievadas, dažniausiai 25, 465 arba 587
Vartotojo vardas Pašto dėžutės prisijungimo vardas, t. y. adresas, iš kurio iš tikrųjų siunčiamas el. laiškas
Vartotojo slaptažodis Tos pašto dėžutės slaptažodis
Ryšio saugumas Šifravimo režimas, dažniausiai SSL_TLS
  1. Mygtukas Test connection patikrina išsaugotus kredencialus prieš perjungiant pranešimą.
  2. SMTP ryšį taip pat galima sukurti per API (operacija createSmtpConnection): organizationId, description, fromName, serverName, serverPort, userName, userPassword, connectionSecurity.

05 Pranešimų nustatymai EDI-Web

Siuntėjo adresai nėra globalūs – jie nustatomi pačiame pranešime: Pranešimai – Redaguoti, skirtukas Pranešimo informacija.

Laukas Reikšmė
El. paštas Pranešimo gavėjo(-ų) adresas(-ai)
Siuntėjo vardas (vardas <el. paštas>) Adresas, iš kurio siunčiamas pranešimas
Atsakyti kam (vardas <el. paštas>) Adresas, kuriuo partneris atsiųs atsakymą
Partneris Partnerio organizacija, kuriai priklauso pranešimas
Smtp ryšys Koks SMTP ryšys (pašto dėžutė) naudojamas siuntimui
El. pašto xslt XSLT šablonas, formuojantis laiško turinį
Įjungta Įjungta / išjungta
  1. Skirtuke SMTP rodomas šio pranešimo naudojamas ryšys, skirtuke XSLT rodomas šablonas.
  2. Gavėjus, kurių nėra pačiame dokumente, galima papildomai pridėti pranešime, žr. 03 skyrių.

06 Kuris siuntėjo adresas naudojamas

  1. Numatytasis: „Docura“ domenas. Nuo = , Atsakyti = kliento adresas. Pristatymas garantuojamas, nes „Docura“ domenas turi teisingus SPF, DKIM, DMARC ir PTR įrašus. Tai apima daugumą atvejų ir yra rekomenduojama sąranka.
  2. Nuo = kliento domenas. Dvi galimybės:
    1. Per kliento nuosavą pašto serverį – kliento SMTP serveris, prisijungimo vardas ir slaptažodis saugomi kaip SMTP ryšys. Kliento domeno SPF ir DKIM praeina, nes laiškas iš tikrųjų siunčiamas jų serverio. Tai saugiausias variantas, kai siuntėjas yra klientas.
    2. Per „Docura“ pašto serverį, išlaikant kliento adresą laukelyje „Nuo“. Tuomet kliento DNS turi būti paruoštas pirmiausia, kitaip tokie laiškai patenka į šlamštą arba yra atmetami:
      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 Per Docura, išsaugant kliento adresą From. DNS

DNS įrašai klientui From (SPF, DKIM, DMARC). Reikalinga tik 2.2 parinkčiai. Visi trys yra TXT įrašai tame pačiame domene, kuris naudojamas „From“ – @@ reiškia to domeno šaknį, o ne subdomeną.

01 SPF

Domenui leidžiamas tik vienas SPF įrašas. Jei jau turite, nekūrkite antro – pridėkite Docura adresus prie esamo įrašo, palikdami viską, kas jame jau yra.

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

~all yra „švelnus“ režimas – laiškai iš kitų adresų pažymimi kaip įtartini, bet pristatomi. -all juos atmeta, todėl su -all turi būti išvardintas kiekvienas domeno siuntėjas.

02 DKIM

Naujas įrašas, jis nieko nepakeičia. mail yra selektorius, todėl kitos paslaugos, pasirašančios el. laiškus jūsų domenui, nėra paveiktos.

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

Dvi cituojamos eilutės, nes viena TXT eilutė negali viršyti 255 simbolių – DNS jas sujungia, kai skaito.

03 DMARC

Domene leidžiamas tik vienas DMARC įrašas. Jei jau turite, palikite jį tokį, koks yra. Žemiau esantis įrašas skirtas tik tiems domenams, kurie jo neturi.

TXT _dmarc "v=DMARC1;p=none"

04 PTR ir HELO

Priklauso DOCURA siuntimo serveriams, o ne jūsų domenui. Prižiūri DOCURA, jums nieko nereikia daryti.

05 Pridėjus

Dėl TTL, DNS pakeitimai užtrunka nuo kelių minučių iki 24 valandų. Kai įrašai bus matomi, paprašykite Docura pagalbos tarnybos bandomojo laiško, žr. skyrių 07. Kol tai neįvyks, siųskite iš Docura domeno.

07 Testavimas ir palaikymas

  1. Paprašykite Docura palaikymo atsiųsti bandomąjį laišką kliento adresu ir patikrinkite pirmines antraštes (From, Reply-to, SPF/DKIM/DMARC rezultatas).
  2. Įeinantiems duomenims per šliuzą, atsiųskite vieną užsakymą ar sąskaitą faktūrą (įprastą laišką su visais papildomais failais, kuriuos pridėjo jūsų pašto klientas) adresu edi.docura.net ir paprašykite palaikymo patvirtinti, kad jis buvo tinkamai apdorotas.
  3. Rašykite el. paštu arba naudokite pokalbį EDI-Web dėl bet kokių klausimų apie šliuzo pašto dėžutes, filtrus, siuntėjų adresus ir DNS įrašus.

Source version: 15 · Status: fresh · Roman Startsev