Do not process DataBoxCreditInfo response on server error
[libisds.git] / doc / government_journals
blobd362394cfb745cfbe315da6d41f5f9c0781c8d7b
1 Publishing Government Journals
2 ==============================
4 Source: Provozní řád Informačního systému datových schránek, (2011-06-19),
5     page 18.
7 ISDS specification describes some additional services built on top of ISDS.
8 One of them is publishing news by central administration (sections 4 and 5 of
9 365/200? Coll. act, Government Information Systems Act).
11 Permitted box owners (some government offices) can send a PDF journal
12 encapsulated into special XML document as part of ISDS message to dedicated
13 box, the message will be processed by a robot and decapsulated journal
14 placed on web ISDS portal.
16 The same box owner can cease publishing of a journal by sending other XML
17 document carrying journal identifier as an ISDS message to the same dedicated
18 box and the journal will be removed from web portal.
20 Non-normative: Specification does not mention whether it's possible to publish
21 or unpublish more journals by adding more documents into one message.
23 The dedicated recipient box ID is `uur3q2i' and the box owner name is `Portál
24 datových schránek (Ministerstvo vnitra)'.
26 XML schemata of ISDS documents used to deliver or un-publish journal are
27 described in 5th techical amendment of ISDS specification.
30 XML Document for Publishing Journal
31 ===================================
33 Structure:
34 docMeta
35     + docName – type xs:string, obligate, title of the journal
36     + effectiveFrom – type xs:date, obligate, date since the journal is valid
37     + effectiveTo – type xs:string, effectively sequence of spaces or xs:date,
38     |               optional, date till the journal is valid
39     + dataPdf – type xs:base64Binary, obligate, the PDF journal encoded into
40                 Base64, maximal size is 10 MB.
42 Non-normative: No acknowledgment is defined by specification.
45 XML Document for Un-publishing Journal
46 ======================================
48 Structure:
49 docMeta
50     + publishingDate – type xs:date, obligate, date since the journal is valid
51     + docErase – type xs:integer, obligate, journal identifier
53 Journal identifier is assigned by recipient robot when publishing a journal.
54 The identifier value can be found on web ISDS portal. It follows journal title
55 in brackets there.
57 Non-normative: No acknowledgment is defined by specification.