/ API
Obecné Jak začít PAMICA POHODA
Kontakty

Odeslání e-mailu přes XML komunikaci

XML komunikace programu POHODA podporuje funkci odesílání e-mailu.

Tato funkce je pevně svázána s tiskem do PDF.

Aby bylo možné odesílání e-mailu přes XML používat, je nutné v programu POHODA v Uživatelském nastavení v sekci „E-mail“ nastavit a nadefinovat e-mailového klienta.


Definice XML email

XML e-mail se definuje pomocí bloku: prn:pdf a element prn:sendMail


Definice elementu sendMail v print.xsd
      xsd:element name="sendMail" type="prn:sendMailType"
        xsd:annotation
           xsd:documentationOdeslat PDF emailem./xsd:documentation
        /xsd:annotation
      xsd:sequence

Možnosti XML e-mailu

XML e-mail v programu POHODA podporuje stejné funkce jako vestavěný e-mailový klient.

Můžete definovat vlastní hodnoty jednotlivých parametrů e-mailové zprávy přímo ve vstupním XML požadavku:


      sendMail
        prn:to
          prn:emailfakturace@obchod.cz/prn:email
        /prn:to
        prn:subjectFaktura č. 250100007/prn:subject
        prn:bodyPosíláme vám fakturu za zboží ve formátu PDF , Faktura_250100007.pdf/prn:body
      /sendMail

Alternativně lze využít funkci „vložit proměnnou“, která načte hodnotu z vybraného záznamu v programu POHODA.

Každý parametr e-mailového klienta má předdefinovaný seznam proměnných, které lze použít:


      sendMail
        prn:to
          prn:email<EmailDokladu>/prn:email
        /prn:to
        prn:subject<NazevSestavy>/prn:subject
        prn:bodyPosíláme vám fakturu za zboží ve formátu PDF , Faktura č. <CisloDokladu>/prn:body
      /sendMail

Některé parametry e-mailové zprávy umožňují vložit jako proměnnou i databázové pole.

Seznam dostupných proměnných najdete v GUI programu POHODA v e-mailovém klientu.

Parametry e-mailu lze kombinovat – použít vlastní hodnoty i proměnné z Pohody.


Nastavení XML e-mailu

XML e-mail umožňuje nastavit:

  • příjemce (komu)
  • kopie (CC)
  • skrytá kopie (BCC)
  • předmět
  • text zprávy
  • přílohy
  • prioritu e-mailu
  • oznámení o doručení
  • oznámení o přečtení

Lze načítat hodnoty ze záznamu/dokladu pomocí proměnných – např. e-mail z hlavní nebo dodací adresy.


      xsd:complexType name="sendMailType"
        xsd:all
           xsd:element name="to"  type="prn:emailsType"  minOccurs="0"
           xsd:element name="cc"  type="prn:emailsType"  minOccurs="0"
           xsd:element name="bcc"  type="prn:emailsType"  minOccurs="0"
           xsd:element name="subject"  type="typ:string255"  minOccurs="0"
           xsd:element name="body"  type="xsd:string"  minOccurs="0"
           xsd:element name="attachments"  type="prn:attachmentType"  minOccurs="0"
           xsd:element name="priority"  type="prn:priorityType"  minOccurs="0"
           xsd:element name="returnReceipt"  type="typ:boolean"  minOccurs="0"
           xsd:element name="disposNotif"  type="typ:boolean"  minOccurs="0"
        /xsd:all
      /xsd:complexType

Vzorový příklad pro odeslání PDF emailem vydané faktury, která již existuje v programu POHODA
 dat:dataPackIem id="send01" version="2.0"
        prn:print version="1.0"
          -- výběr agendy --
          prn:record agenda="vydane_faktury"
            -- výběr záznamu --
            ftr:filter
              ftr:id16/ftr:id
            /ftr:filter
          prn:record
          prn:printerSettings
            -- výběr tiskové sestavy --
            prn:report
              prn:id190/prn:id
            /prn:report
            
            prn:pdf
              prn:fileNamec:\POHODA\XML\XMLtisk\PDF\FV_250100007.pdf/prn:fileName
              -- odeslání emailu, nastavení emailové zprávy --
              sendMail
                prn:to
                  prn:emailfakturace@obchod.cz/prn:email
                /prn:to
                prn:subjectFaktura č. 250100007/prn:subject
                prn:bodyPosíláme vám fakturu za zboží ve formátu PDF , Faktura_250100007.pdf/prn:body
              /sendMail
            /prn:pdf
          /prn:printerSettings
        /prn:print
/dat:dataPackIem
STÁHNOUT