Book Contents

Book Index

Komunikace

Book Contents

Book Index

Listovní pošta

Export zásilek pomocí služby PostServis

Číslo procesu: CRM006

Ident. č. skriptu: FCRM056

Soubor: PostService.PAS

Popis skriptu: Skript pro export listovní pošty do služby PostServis.

Adresa ve stromu:

Parametry skriptu:

EnvelopeType - 0

Typ exportované zásilky. Pokud je tento parametr zadán, bere skript přednostně hodnotu parametru. V případě, že parametr není zadán, doplní se hodnota z pole Druh zásilky.

 

Možné hodnoty parametru:

 

  • 165 - Doporučeně Evropa
  • 169 - Doporučeně
  • 171 - Doporučeně s dodejkou
  • 172 - Doporučeně s dodejkou do vlastních rukou
  • 173 - Doporučeně s dodejkou do vlastních rukou výhradně jen adresáta
  • 175 - Doporučeně do vlastních rukou
  • 176 - Doporučeně do vlastních rukou výhradně jen adresáta
  • 194 - Obyčejně Evropa
  • 195 - Obyčejně

UserName

Jméno uživatele služby PostServis.

Password

Heslo uživatele pro přihlášení ke službě PostServis.

PrintType - 0

Parametr pro určení způsobu vytisknutí dokumentu. 0 - jednostranný tisk, 1 - oboustranný tisk.

TestMode - NE

Pokud je parametr nastaven na hodnotu Ano - posílá se dokument do testovacího prostředí služby PostServis.

WriteNoteToDoc - ANO

Pokud je parametr nastaven na hodnotu Ano, doplní se do dokladu listovní pošty odeslané poznámka o exportování dokumentu do služby PostServis.

SilentMode - Ne

Pokud je parametr nastaven na hodnotu Ano, nezobrazí se při běhu skriptu a exportu potvrzovací hlášení. Vytváří se pouze logovací soubor s případnými chybami.

Pomocí tohoto skriptu exportujeme obálky listovní pošty odeslané a jejich přílohy do služby PostServis. Tuto službu poskytuje Česká pošta. Zákazník předává data ke zpracování v elektronické podobě a Postservis je tiskne, obálkuje – tedy transformuje do fyzické podoby. Vyrobené zásilky okamžitě předává k doručení. Takto je možné odeslat až 8 "*.pdf" souborů o počtu 8 listů A4.

Aby bylo možné zásilku exportovat musí být v dokladu listovní pošty odeslané vyplněn Partner nebo Kontaktní osoba Adresáta i Odesílatele. Zároveň, zde musí být vyplněny jejich adresy. Před exportem je nutné pomocí parametrů nastavit uživatelské jméno a heslo pro přihlášení ke službě PostServis. Je nutné mít také nastaven typ exportované zásilky (parametrem skriptu nebo v poli Druh zásilky).

Skript je spustitelný nad jedním dokladem (obálkou) listovní pošty odeslané, nad označenými záznamy nebo nad filtrem. Po spuštění dojde k vyexportování obálek se všemi přílohami ve formátu "*.pdf" do služby PostServis. Přílohy budou vyexportovány vždy v tom pořadí, v jakém byly k dokladu připojeny. V tomto pořadí budou také vytisknuty a zařazeny do zásilky službou PostServis.

Vytvoření dopisu z dokladu

Číslo procesu: CRM006

Ident. č. skriptu: FCRM036

Soubor: Sale_CreateEnvelopes.PAS

Popis skriptu: Vytvoření obálky listovní pošty odeslané z dokladů prodeje a upomínek v IS K2.

Adresa ve stromu:

Parametry skriptu:

AbbrOfActivity

Zkratka aktivity. Hodnota z parametru se předvyplní do pole Zkratka ve formuláři.

ActivityComment

Komentář k aktivitě. Hodnota z parametru se předvyplní do pole Komentář ve formuláři.

AddAdr - Ne

Ano - pokud adresa (PSČ) adresáta v nových adresách neexistuje, skript ji vytvoří; Ne - adresa vytvořena není a doklad listovní pošty je vytvořen bez adresy adresáta.

AddressType - 2

Typ adresy. 1 - Fakturační; 2 - Dodací.

Book - OV

Parametr pro volbu knihy marketingu, do které se budou vytvářet doklady Listovní pošty odeslané.

Campaign

Kampaň aktivity. Hodnota z parametru se předvyplní do pole Kampaň ve formuláři.

CD1 - Ne

Ano - doklady listovní pošty se vytváří k centrále zákazníka; Ne - doklady listovní pošty jsou vytvářeny k Dod./Odb. z dokladu.

CountSheetsInEnvelope - Ne

Ano - při seskupování příloh do obálky se, při nastaveném maximálním počtu, počítají listy. Ne - při seskupování příloh do obálky se počítají stránky.

CreateActivity - Ne

Ano - k dokladům Listovní pošty odeslané jsou vytvářeny skriptem aktivity; Ne - aktivity se nevytváří.

DateFromActivity

Datum od v aktivitě. Hodnota z parametru se předvyplní do pole Datum od ve formuláři.

DateToActivity

Datum do v aktivitě. Hodnota z parametru se předvyplní do pole Datum do ve formuláři.

DescriptionOfActivity

Popis aktivity. Hodnota z parametru se předvyplní do pole Popis v aktivitě.

Document - Ne

Ano - provede se export sestavy zadané v parametru ReportForPDF do formátu "*.pdf" a dokument se připojí na 9. stranu vytvořeného dokladu listovní pošty; Ne - export se neprovede.

KindOfShipment - 2000000235 (Doporučená zásilka)

Druh zásilky. Doplní se do hlavičky vytvořeného dokladu Listovní pošty odeslané.

Opportunity

Příležitost aktivity. Hodnota z parametru se předvyplní do pole Příležitost ve formuláři.

PagesInEnvelope - 0

Maximální počet stránek, případně listů, v jedné obálce. Pokud je nastaven parametr na hodnotu 0, doklady se neseskupují.

Proof - Ne

Ano - vytvoří se provázání vytvořeného dokladu Listovní pošty odeslané a dokladu z něhož, je obálka vytvářena, přes jejich 9. strany; Ne - nedojde k provázání těchto dokladů.

Protocol - Ne

Ano - po vytvoření záznamů se zobrazí detailní protokol o vytvořených dokladech případně aktivitách; Ne - protokol se nezobrazí.

ReportForPDF

Parametr pro určení názvu sestavy, která se bude exportovat do formátu "*.pdf".

ResponsiblePersonOfActivity - 1

Zodpovědná osoba aktivity. Hodnota zadaná v tomto parametru se předvyplní do pole Zodpovědná osoba ve formuláři.

TypeDocument

Typ dokumentu (přílohy na 9. straně dokladu).

TypeOfActivity

Typ aktivity. Hodnota z parametru se předvyplní do pole Typ aktivity ve formuláři.

TypeOfExport - 1

1 - export podle Dodavatele/Odběratele; 2 - export podle Dokladu.

TypeOfShipment - 108 (Faktura přijatá)

Typ zásilky, který se dosadí do položky dokladu Listovní pošty odeslané.

LocateLhefolder - 1

Složka aktivity. Hodnota parametru se předvyplní do pole Složka ve formuláři. Vytvořená aktivita je zařazena do této složky.

DescriptionOfDocument

Hodnota z parametru se předvyplní do pole Popis z dokladu ve formuláři. V případě, že uživatel zapíše do tohoto parametru jakýkoliv text, zatrhávací pole Popis z dokladu nebude ve formuláři nastaveno a tento text se dosadí do pole Popis v hlavičce vytvořených dokladů Listovní pošty odeslané. Pokud v tomto parametru není žádná hodnota doplněna, zatrhávací pole Popis z dokladu je ve formuláři nastaveno a do hlaviček vytvořených dokladů se doplní popis z dokladů prodeje nebo upomínek.

Pomocí tohoto skriptu je možné vytvářet záznamy (dopisy) v knize Listovní pošta odeslaná přímo z dokladů prodeje v IS K2 a ze záznamů v knize upomínek. Tento skript je spustitelný nad veškerými doklady prodeje a upomínkami. Po spuštění skriptu se zobrazí uživatelský formulář, kde je možné nastavit některé náležitosti nutné pro vytvoření dokladu Listovní pošty odeslané.

Linked Graphics K2_SKRIPT

Obr.: Formulář Vytvoření nové pošty z dokladu K2

Do formuláře se načítají ty doklady, nad kterými je skript spuštěn, tzn., pokud se skript spustí nad knihou, načtou se do formuláře doklady celé knihy. Pokud skript běží nad jedním dokladem, bude ve formuláři pouze jedna položka. Pokud jsou některé doklady označeny hvězdičkou, načítá skript pouze tyto záznamy. Po načtení záznamů jsou všechny ve formuláři označeny hvězdičkou. Toto označení lze korigovat pomocí standardních ikon s hvězdičkami, nebo kombinací kláves Shift+Enter a Ctrl+Mezera. Pouze k označeným záznamům se poté vytvoří doklady listovní pošty.

Využitím parametru PagesInEnvelope je možné přílohy v podobě "*.PDF" souborů seskupovat. Toto seskupování je funkční pouze při typu exportu dle Dokladu. Přílohy se pak seskupují do obálek listovní pošty odeslané dle Dod./Odb. a Adresy. Parametrem PagesInEnvelope určujeme maximální počet stránek, případně listů, v jedné vytvořené obálce. Pokud je parametr nastaven na hodnotu 0, doklady se neseskupují. Toto seskupování je možné využít, např. pro export do služby PostServis.

Popis polí:

Adresa z centrály

Pokud je pole zatrženo, vytváří skript doklad Listovní pošty odeslané k centrále zákazníka (adresa z centrály je dosazena do pole Adresát).

Vytvoření aktivity

Skript umožňuje také vytváření aktivit k jednotlivým obálkám listovní pošty. Po zatržení tohoto pole se ve formuláři zobrazí záložka Aktivity, kde je možné zadat základní údaje o aktivitě.

Protokol

Zatrhávací pole, které určuje, zda se po vytvoření záznamů zobrazí detailní protokol o vytvořených obálkách Listovní pošty odeslané a nových aktivitách.

Doklad na 9. straně

Po zatržení tohoto pole budou vzniklé doklady Listovní pošty odeslané vzájemně provázány s doklady prodeje nebo upomínkami přes jejich 9. strany.

Dokument na 9. straně

Pole je přístupné, pouze pokud je nastaven parametr ReportForPDF, ve kterém je nutné zadat název sestavy pro export do formátu "*.PDF". V případě, že je pole Dokument na 9. straně zatrženo, provede se export zadané sestavy do "*.PDF" a tento doklad se zařadí na 9. stranu vzniklého dokladu listovní pošty.

Typ exportu

Typ exportu dle Dokladu vytvoří ke každému označenému dokladu ve formuláři novou obálku v knize Listovní pošta odeslaná s příslušnou položkou. Pokud je nastaven typ exportu podle Dodavatele/Odběratele, doklady ve formuláři se stejným zákazníkem se seskupí a vytvoří se k nim obálka Listovní pošty odeslané s položkami, jejichž počet odpovídá počtu seskupených dokladů.

Typ adresy

Skript podporuje rozšířené adresáty v IS K2. V tomto poli je možný výběr typu adresy adresáta vzniklého dokladu v knize Listovní pošta odeslaná.

Typ zásilky

Pole pro výběr typu zásilky, který se dosadí do položky dokladu listovní pošty.

Kniha

Pole pro výběr knihy marketingu, ve které se doklady Listovní pošty odeslané budou vytvářet.

Druh zásilky

Pole pro volbu druhu zásilky. Hodnota je dosazena do hlavičky vzniklého dokladu listovní pošty.

Popis z dokladu

Pokud je toto pole zatrženo, dosadí se do hlavičky vytvořeného dokladu Listovní pošty odeslané popis z dokladu prodeje nebo upomínky. Pokud toto pole zatrženo není, doplní se do hlavičky dokladů Listovní pošty odeslané zde zadaný text.

Uložit jako parametry skriptu

Stisknutím tohoto tlačítka dojde k uložení parametrů skriptu. Parametry se nastaví dle hodnot vyplněných ve formuláři.

Po zatržení pole Vytvořit aktivity se ve formuláři zobrazí další záložka Aktivita. Zde je možné předdefinovat pole pro vytvoření aktivit.

Linked Graphics K2_SKRIPT

Obr.: Formulář Vytvoření nové pošty z dokladu K2 - záložka Aktivita

Do polí na této záložce formuláře může uživatel doplnit příslušné hodnoty a ty se poté dosadí do nově vytvořených aktivit. Jedná se o pole Typ aktivity, Zkratka, Popis, Umístit do složky, Kampaň, Příležitost, Datum od, Datum do, Zodpovědná osoba a Komentář.

Po stisknutí tlačítka OK ve formuláři dojde k vytvoření dokladů v knize Listovní pošta odeslaná, popř. k vytvoření nadefinovaných aktivit.

Změna podacího čísla

Číslo procesu: CRM006

Id. číslo skriptu: FCRM030

Soubor: ChangeFilingNumber.pas

Popis skriptu: Skript umožní změnit popř. zadat některá pole obálek v podacím archu.

Adresa ve stromu:

Parametry skriptu:

Bez parametrů.

Pomocí tohoto skriptu je možné hromadně změnit některá pole v položkách podacího archu, tzn. v obálkách, které jsou zde zařazeny. Hromadně lze měnit pole Podací číslo, Hmotnost, Cena služby, Udaná cena, Placeno v hotovosti. Obálky v podacím archu jsou již jednou potvrzeny. Po doplnění polí touto funkcí se obálka automaticky potvrdí podruhé.

Skript je možné spustit nad konkrétním podacím archem. Po spuštění se zobrazí formulář, ve kterém je uveden seznam všech položek archu, tzn. jednotlivých zásilek.

Linked Graphics K2_SKRIPT

Obr.: Formulář Změna podacího čísla

U zobrazených položek je možné v tomto formuláři zadat příslušné hodnoty jednotlivých polí v editovatelných sloupcích. Hodnoty lze v těchto sloupcích měnit pomocí klávesy Enter. Uložení zadaných hodnot provede obsluha pomocí tlačítka OK.

Book Contents

Book Index

Česká pošta Listovní pošta - Nastavení parametrů pro komunikaci

Číslo procesu: CRM013

Id. číslo skriptu: FCRM

Soubor: CeskaPostaApiSettingsLetterPost.pas

Popis skriptu: Skript slouží k uložení konfigurace pro komunikaci s Českou poštou a k nastavení vlastností listovních zásilek. Zde zadané hodnoty vlastností zásilek mají přednost před hodnotami zadanými v konkrétním záznamu odeslané pošty (např. Druh zásilky (doporučené psaní)). Nastavení se ukládá pro jednotlivé Knihy listovní pošty. Pokud tedy pro konkrétní knihu listovní pošty existuje nastavení komunikace pro Českou poštu, pak při prvním potvrzení záznamu odeslané pošty automaticky probíhá odeslání dat pro Českou poštu. Klávesou Insert přidáváme řádky jednotlivých nastavení.

Adresa ve stromu: Komunikace / Listovní pošta / Odeslaná pošta / Česká pošta - Nastavení parametrů pro komunikaci.

Vybrané parametry skriptu:

Zobrazit formulář s nastavením při potvrzení zásilky - Ne

Ano: Při prvním potvrzení zásilky, kdy dochází k odeslání dat do České pošty, se zobrazí formulář s vybranými poli, která lze naplnit pro vytvářenou datovou větu údaji, které v aktuální zásilce vyplněny nejsou nebo mají být změněny.

Kniha listovní pošty - ' '

Kniha listovní pošty, pro kterou bude nastavení platit.

Sekce Identifikace odesílatele

Nutno vyplnit povinná pole údaji, které klient získá od České pošty:

  • URL pro komunikaci
  • Api klíč
  • Tajný klíč
  • Technologické číslo podavatele
  • PSČ podací pošty
  • ID CČK zákazníka

Číslo podacího místa - ' '

Tlačítkem Vytvořit podací místo je nutné zaregistrovat svou firmu (podací místo) u České pošty. Je povinné vyplnit adresu odesílatele a také adresu adresáta dobírkové částky. (Do datové věty a na štítek se jako adresa odesílatele použije adresa z uloženého podacího místa - nikoliv tedy adresa uvedená v zásilce.)

Pozor: Jakmile je podací místo vytvořeno, tak jej nelze následně editovat, např. doplnit další údaje. Lze vytvořit pouze nové podací místo. Proto doporučujeme formulář řádně vyplnit všemi údaji. Tlačítkem OK formulář uzavřeme a podací místo zaregistrujeme. Číslo podacího místa se doplní automaticky do pole Číslo podacího místa v hlavním formuláři.

Poznámka: Seznam dalších námi zaregistrovaných podacích míst lze vyvolat tlačítkem Zobrazit seznam podacích míst. Neplatná nebo nepoužívaná podací místa lze zrušit pomocí skriptu Česká pošta - Zrušit vybrané podací místo.

Sekce Nastavení polí a služeb

Typ zásilky (prefix) - ' '

U listovní pošty např. "RR" (doporučené psaní), nebo lze do hranatých závorek uvést programový název pole z modulu Listovní pošta odeslaná (včetně externích polí), z něhož se má hodnota načíst. Pokud nebude vyplněno, čte se hodnota z pole Druh na listovní poště. Typ zásilky je pro odeslání dat povinný.

Doplňkové služby - ' '

Požadované doplňkové služby. Zadáváme jednotlivá čísla nebo písmena služeb oddělená "+" . Služby (ve stejném formátu) lze zadávat přímo do vybraného pole (i externího) přímo v zásilce a zde poté uvést název programového pole do hranatých závorek.

Poznámka: Použití služeb je vhodné komunikovat s obchodním zástupcem České pošty s nímž klient jedná. U listovní pošty např. pro druh "RR" (doporučené psaní) je nutné uvést některou ze služeb 50 až 60.

Sekce Tisk štítků

Při potvrzení dokladu nezobrazovat a netisknout - Ne

Ano: Při prvním potvrzení zásilky se štítek nezobrazí ani v PDF prohlížeči, ani se neodešle na tiskárnu.

Ne: Zobrazení či tisk se řídí parametrem "Zobrazit náhled".

Zobrazit náhled - Ne

Ano: Zobrazí náhled štítku v prohlížeči PDF. Buďto v prohlížeči specifikovaném v parametru "Příkazový řádek pro spuštění tisku", nebo není-li zadán, pak ve výchozím prohlížeči.

Ne: Provádí se tisk přímo na tiskárnu.

Název tiskárny - ' '

V názvu tiskárny lze použít také zástupné znaky, např: :\\ANUP.k2.int\M452*

Příkazový řádek pro spuštění tisku - ' '

Odkaz na spustitelný soubor PDF programu, v němž se mají zobrazit štítky.

Příklad zadání: C:\Program Files\Tracker Software\PDF Viewer\PDFXCview.exe

Parametry příkazového řádku pro tisk - ' '

Zadání odeslání tisku štítku z PDF programu na tiskárnu.

Příklad zadání pro PDF Viewer: /printto "%s" "%s"

Typ štítku

Výběr požadovaného štítku. Pro listovní poštu je vhodný např. štítek Id 39.