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

XML komunikace - tisk dokladu/záznamu

XML komunikace programu POHODA podporuje dva základní druhy tisku:

  • Standardní tisk na tiskárnu.
  • Tisk do PDF.

To vám umožňuje rozhodnout se, zda chcete tisknout přímo na tiskárnu, nebo uložit tiskovou sestavu jako PDF soubor.

Při tisku/uložení sestavy do PDF lze nastavit, aby se PDF soubor:

  • Uložil na disk.
  • Vrátil jako součást XML odpovědi.
  • Odeslal e-mailem jako příloha.

Definice XML tisk

XML tisk lze definovat jako:

  • Samostatný požadavek na tisk v XML dokumentu.
  • Blok, který je součástí XML požadavku na vytvoření nového dokladu/záznamu.

To vám umožňuje rozhodnout se, zda chcete tisknout záznam ihned po jeho vytvoření, nebo tisknout již existující záznamy.

Pro volání XML tisku je nutné v XML požadavku použít blok: print a to buď v samostatném XML požadavku,


Definice elementu print v print.xsd
      xsd:element name="print" type="prn:printType"
        xsd:annotation
           xsd:documentationTisk vybraného záznamu./xsd:documentation
        /xsd:annotation
      xsd:sequence

nebo v XML požadavku na importu záznamu/dokladu.


Definice elementu print v invoice.xsd
      xsd:element name="print" type="prn:agendaPrintType" minOccurs="0"
        xsd:annotation
           xsd:documentationPo vytvoření záznamu se provede jeho tisk./xsd:documentation
        /xsd:annotation
      xsd:sequence

Možnosti XML tisk

XML tisk v programu POHODA podporuje:

  • tisk dokladových sestav
  • tisk soupisek

Tiskové sestavy typu "štítek" nejsou v rámci XML komunikace podporovány.

To vám umožňuje tisknout buď konkrétní záznam (např. jednu fakturu), nebo soupisku více záznamů (např. tiskovou sestavu „Vydané faktury“).


Nastavení XML tisku

XML tisk umožňuje nastavit:

  • tisk jedné nebo více tiskových sestav současně
  • počet kopií
  • datum tisku
  • parametry tiskové sestavy dle dialogu „Tisk“ v programu POHODA

Jeden XML požadavek = tisk jedné tiskové sestavy.

Pro tisk více sestav je nutné volat více XML požadavků s blokem: printerSettings.


      xsd:complexType name="agendaPrintType"
        xsd:sequence
           xsd:element name="printerSettings"  type="printerSettingsType" minOccurs="0" maxOccurs="unbounded"
        /xsd:sequence
      /xsd:complexType

Struktura XML tisku

      print
        record	/record		..povinné, pokud voláte samostatný tisk. Výběr záznamu/ů z programu POHODA pro tisk.
        printerSettings 	..povinné, parametry pro nastavení tisku.
          report    /report	..povinné,výběr tiskové sestavy pro tisk.
            printer    /printer	..nepovinné,výběr tiskárny.
            pdf    /pdf	..nepovinné, uložení tiskové sestavy do PDF souboru.
            parameters    /parameters	..nepovinné, nastavení tiskové sestavy.
        /printerSettings
      /print

Poznámky:

  • Pokud je tisk volán jako samostatný požadavek, je element <record> povinný.
  • Pokud je tisk součástí importu dokladu/záznamu, element <record> se neuvádí – tiskne se právě vytvořený záznam.
  • Pokud není uveden element <printer>, použije se výchozí tiskárna.
  • Pokud jsou uvedeny současně elementy <printer> a <pdf>, má přednost element <pdf>.
  • Parametry tiskové sestavy kopírují nastavení z dialogu „Tisk“ v programu POHODA.


Vzorový příklad pro import a tisk vydané faktury na tiskárnu
 dat:dataPackIem id="Print01" version="2.0"
        .. vytvoření faktury
        inv:invoice version="2.0"
          inv:invoiceHeader
            inv:invoiceTypeissuedInvoice/inv:invoiceType
            inv:textFaktura včetně položek/inv:text
            inv:noteVytvoření faktury a tisk/inv:note
          /inv:invoiceHeader
          inv:invoiceDetail
            inv:invoiceItem
              inv:textPlatba za služby./inv:text
              inv:quantity1/inv:quantity
              inv:rateVAThigh/inv:rateVAT
              inv:homeCurrency
                 inv:unitPrice1000/inv:unitPrice
              /inv:homeCurrency
            /inv:invoiceItem
          /inv:invoiceDetail
          
          .. blok pro definici tisku
           inv:print
             prn:printerSettings
               prn:report
                 prn:id190/prn:id
               /prn:report
             /prn:printerSettings
           inv:print
           
         /inv:invoice
/dat:dataPackIem
STÁHNOUT

Vzorový příklad pro tisk vydané faktury, která již existuje v programu POHODA
 dat:dataPackIem id="Print01" 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:printerSettings
        /prn:print
/dat:dataPackIem
STÁHNOUT