• Scripturi necesare: PYUTIL, PYTDOC, PYMAIL, FAC_EE, FAC_EB
  • Versiune Python: 3.6
  • Module necesare pentru Python:
    • smtplib, email-to, urllib
    • oauth2client, google-api-python-client, google-auth-httplib2, google-auth-oauthlib

Soluţia este utilizabilă pe Windows şi pe Linux_WP.

Pentru a funcţiona cu o adresă gmail este necesară o adresă de email şi să activăm Gmail API pe platforma Google Cloud.

Pentru a funcţiona cu o adresă proprie de email este necesară o adresă de email, o parolă. Noi promovăm Gmail pentru o funcţionare fără probleme, deci recomandăm crearea unei adrese gmail, dacă nu există!

• Verificaţi dacă interpretorul Python versiunea 3.6 sau mai mare este instalat deja.
• În hUTIL lansaţi operaţia Instalare module Python pentru instalarea modulelor necesare pentru trimitere email. În cazul în care sunteţi pe server linux, consultaţi administratorul de server linux pentru instalarea modulelor necesare!

c11) Configurare cataloage şi hUTIL:

Fişiere resurse:

dbf\IMG\EMAIL\E_JPG.JPG  - Fişier imagine, pentru Varianta Optiune email+
dbf\LOG\EMAIL\E_LOG.TXT  - Fişier log, pentru ambele variante.

Configuraţi următoarele aliasuri în HUTIL:

Catalogul fişiere resurse: 'ppr' este deja configurat pentru HPRINT
Tipurile de documente H..: daca se transmit documente HPRINT, in Model va fi secventa
                           IMPRIMANTA= nume imprimanta pdf
                           // Nume fisier creat cu PDFCreator: nr.fac si cod client
                           {D}DOCNAME=F{Nr  }_{CodC  }
Catalogul PDF:             'pdf' indică catalogul în care se afla pdf-urile
                            de transmis, numele pdf-ului trebuie să fie Fnrfac.PDF
                            sau nrfac.PDF
Catalogul PRN:             'prn' daca se transmit documente model H,
                                 se va seta cccccc.lst,  caz in care se genereaza
                                   fisiere cu nume <nrfac>.PDF sau
                                 se va seta ccccccc/lst. caz in care se genereaza
                                   fisiere cu nume F<nrfac>.PDF       
Catalogul LOG:             'log' este necesar pentru log-uri email
Catalogul IMG:             'img' este necesar pentru Varianta Opţiune email

c12) Configurare parametri în hMARFA

Pentru trimiterea de email-urilor trebuie să configuraţi parametrii în hMARFA în funcţie de serverul de email folosit(GMAIL_API,MAIL_SRV).

La GMAIL_API:

// Configuratie pentru trimitere email prin Gmail API
SRV_TYPE := "GMAIL_API"
// Adresa de la care se trimite email-ul
FROM:="facturi_firma@gmail.com"

După ce aţi configurat parametrii, trebuie să creaţi un token din Gmail Cloud. Instrucţiuni pentru descărcare token din Gmail Cloud: instructiuni descarcare Gmail token

Tutorial descărcare Gmail token: https://youtu.be/YfpLrCqr9hQ

După descărcare vom redenumi fişierul JSON astfel: GOOGLE_OAUTH.JSON şi îl vom copia în DBF/MARFDEF/ respectiv DBF/SALDEF/

La MAIL_SRV:

// Configurare pentru trimitere email prin server email smpt.
SRV_TYPE := "MAIL_SRV"
// Parametri pentru operatia trimitere email
[EMAIL]
// Adresa de server email
HOST:="smtp.gmail.com"
// Port smtp
PORT:="587"
// Adresa de la care se trimite email-ul
FROM:="facturi_firma@gmail.com"
// Parola contului de la care se trimite email-ul
PSW:="parola_secreta"

c13) Configurare PDFCreator

• Lansaţi programul PDFCreator
• În tab-ul Profile activaţi salvare automată
• Specificaţi un catalog pentru salvare fişiere PDF.
  Atentie: acest catalog trebuie să se potrivească cu catalogul indicat în hUTIL, aliasul pdf!
• Activaţi şi memoraţi parola de adresă email!

În cazul în care doriţi să imprimaţi documentele din hMARFA într-un catalog distinct faţă de alte liste PDF pe care le realizaţi, procedaţi conform instrucţiunilor pentru a seta un nou profil de imprimantă PDF...

c21) Varianta de bază

• În Tipuri de documente importaţi fişierele 'E-FACBM1.TXT' şi 'E-FACBM2.TXT'
• Pentru a modifica continutul email-ului, modificaţi rândurile 'BODYX'
• Pentru adăugare de rânduri noi la conţinutul email-ului, adăugaţi-le la 'BODYX'.
  Aici 'X' reprezintă numărul de rânduri şi trebuie să fie în ordine crescătoare.

Câmpuri utilizabile în secţiunea BODY:

• Următoarele câmpuri provin din Societatea:
  {NUMESOC},{JUDET},{CODPOSTAL},{LOCALITATE},{SEC},{STRADA},{NR}
  {EMAIL},{TEL},{WEB},{MAP}

Pentru modificarea următoarelor câmpuri mergeţi la Formule:

• Câmpul {WEB} se referă la adresa de site şi trebuie să reprezinte un şir de caractere „www.xyz.xy“
• Câmpul {MAP} se referă la adresa de pe hartă.
  Cu ajutorul map.google.com puteţi să faceţi un link pe hartă.

Pentru modificare Subject, modificaţi valoarea de variabilă 'xf_subject' în secţiunea 'DECLARATII'.

Valorile de variabile 'xf_host', 'xf_port', 'xf_from', 'xf_password' provin din Parametri hMARFA. Nu le modificati!

De exemplu:

~~ contine descriere email varianta de baza
~~ tdoc.txt tine pana la sfarsit formular
~INCEPUT
    ~DECLARATII
        ~~Este preluat din hMARFA Parametri
        xf_host       = '{xf_host}'
        xf_port       = {xf_port}
        xf_from       = '{xf_from}'
        xf_password   = '{xf_psw}'
        
        xf_printName  = '{NUMESOC}'
        
        xf_to         = [{xf_adrTo}]
        xf_attach     = [{xf_fact}]
    ~SFIRSITDECLARATII

    BODY1=Buna ziua,
    BODY2=
    BODY3=Trimit atasat factura {xf_nrFac}.
    BODY4=
    BODY5=Cu stima,
    BODY6={NUMESOC}
    BODY7={JUDET}
    BODY8={CODPOSTAL} - {LOCALITATE}
    BODY9={SEC} {S} {STRADA}, {NR} 
    BODY10=email.: {EMAIL}   
    BODY11=tel.: {TEL}
    BODY12=web.: {WEB} 
    BODY13=harta: {MAP}
    BODY14=
    BODY15=Acest email a fost trimis automat din hMARFA.
    BODY16=Pentru corespondenta nu utilizati Reply. Scrieti la adresa {EMAIL}
~SFIRSITFORMULAR

c22) Varianta Opţiune email+ (e)

Atenţie: În această variantă conţinutul email-ului reprezintă o structură tip HTML.

• În Tipuri de documente importati fisierele 'E-FACEM1.TXT' şi 'E-FACEM2.TXT'.
• Pentru modificarea conţinutului email-ului modificaţi rândurile 'BODYX'
• Pentru adăugare rânduri noi la conţinutul email-ului, adăugaţi 'BODYX'.
  Aici 'X' reprezintă numărul de rânduri şi trebuie să fie în ordine crescătoare.

Câmpuri utilizabile în secţiunea BODY:

• Următoarele câmpuri provin din Societatea:
  {NUMESOC},{JUDET},{CODPOSTAL},{LOCALITATE},{SEC},{STRADA},{NR}
  {EMAIL},{TEL},{WEB},{MAP}

Pentru modificarea următoarelor câmpuri mergeţi la Formule:

• Câmpul {WEB} se referă la adresa de site şi trebuie să reprezinte un sir de caractere tip „www.xyz.xy“
• Câmpul {MAP} se refera lă adresa de pe hartă.
  Cu ajutorul map.google.com puteţi să faceţi un link pe hartă.

Pentru modificare Subject, modificaţi valoarea de variabilă 'xf_subject' în secţiunea 'DECLARATII'

Valorile de variabile 'xf_host', 'xf_port', 'xf_from', 'xf_password' provin din Parametri hMARFA. Nu le modificati!

• În această variantă, se completează fişierul HTML cu secţiunea BODY.

  • Pentru modificarea aspectului grafic al conţinutul email-ului, modificaţi secţiunea HTML în Formular.

Exemplu:

~~ tdoc.txt tine pana la sfarsit formular
~INCEPUT
    ~DECLARATII
        ~~Este preluat din hMARFA Parametri
        xf_host       = '{xf_host}'
        xf_port       = {xf_port}
        xf_from       = '{xf_from}'xf_password   = '{xf_psw}'
        
        xf_printName  = '{NUMESOC}'
        ~~Titlul 
        xf_attach = [{xf_fact}]
        xf_html       = '{xf_html}'
        xf_html_imgs  = {'xf_image' : '{xf_image}'}
    ~SFIRSITDECLARATII

    BODY1=Buna ziua,<br />
    BODY2=<br />
    BODY3=Trimitem atasat factura {xf_nrFac}.<br />
    BODY4=<br />
    BODY5=Cu stima,<br />
    BODY6={NUMESOC}<br />
    BODY7=<br />
    BODY8=<i>Acest email a fost trimis automat din hMARFA.</i><br />
    BODY9=<i>Pentru corespondenta nu utilizati Reply. 
             Scrieti la adresa de email de mai jos.</i><br/> 
~SFIRSITFORMULAR
<!--- contine descrierea email-ului in htm, logo-ul este definit in Formule --->
<html> 
...
</html>