Fix using CURLOPT_XFERINFOFUNCTION curl option
[libisds.git] / doc / box
blob53bff91e408b8535d7b031f6bf73f14606b04675
1 Box specification
2 =================
4 Source: Provozní řád Informačního systému datových schránek, (2010-11-28)
5 Source: Webové služby ISDS pro vyhledávání datových schránek, version 2.16
6     (2011-01-25)
7 Source: Webové služby ISDS pro manipulaci s datovými schránkami, version 2.6
8     (2010-01-18) [DataMessage_ws.pdf], Page 6
9 Source: Webové služby rozhraní ISDS pro správu datových schránek, version 2.35
10     (2013-04-10), Page 23
11 Source: ISDS – Přehled změn (2017-05-27)
13 Box types
14 =========
16 Symbol      Number  Description
17 --------------------------------------------------------------------------
18             0       ISDS system
19 OVM         10      Standard government (state or municipality or similar)
20                     office
21 OVM_NOTAR   11      Notary (stopped being used, replaced with OVM_PFO)
22 OVM_EXEKUT  12      Executor (stopped being used, replaced with OVM_PFO)
23 OVM_REQ     13      Subsidiary office with OVM status assigned on request
24                     (section 6 and 7 of act)
25 OVM_FO      14      Natural person with OVM status
26                     (without identification number)
27 OVM_PFO     15      Natural person in business with OVM status
28                     (e.g. notary or executor)
29 OVM_PO      16      Juridical person with OVM status
30                     (arisen from previously existing PO or PO_REQ)
31 PO          20      Standard commercial organization (in trade registry)
32 PO_ZAK      21      Other organization based on law
33                     (stopped being used, replaced with PO)
34 PO_REQ      22      Organization with box assigned on request
35 PFO         30      Person in business
36 PFO_ADVOK   31      Lawyer
37 PFO_DANPOR  32      Tax consultant
38 PFO_INSSPR  33      Administrator of insolvency
39 PFO_AUDITOR 34      Statutory auditor
40 FO          40      Standard person
43 Box states
44 ==========
46 Value       Description 
47 -------------------------------------------------------
48 0 or empty  Error occurred while retrieving box state
49 1           Box is accessible.
50 2           Temporarily inaccessible (on owner's request)
51 3           Not yet active
52 4           Permanently inaccessible
53 5           Box has been removed
54 6           Temporarily inaccessible (by law)
56 Although state 6 exists, ISDS returns state 2 instead.
58 Only state 1 means box is capable of receiving messages.
59 User can log in even into inaccessible box. However some operations, like
60 message sending, are not allowed then.
63 Country values
64 ==============
66 The counries are denoted by two-letter abbreviation. Sometimes it can be full
67 or somewhat abbreviated name. Exact list of codes is in Appendix A of Webové
68 služby ISDS pro vyhledávání datových schránek.
70 Non-normative: It's a subset of ISO 3166-1 alpha-2 list with some non-standard
71 extensions (borrowed from International Post Union).
73 Missing codes: 
75 Value   Description
76 --------------------------------------------------
77 AQ      Antarctica
78 AS      Samoa (American)
79 AX      Åland Islands
80 BV      Bouvet Island
81 CC      Cocos (Keeling) Islands
82 CX      Christmas Island
83 EH      Western Sahara
84 GS      South Georgia & the South Sandwich Islands
85 GU      Guam
86 HM      Heard Island & McDonald Islands
87 MP      Northern Mariana Islands
88 NF      Norfolk Island
89 SJ      Svalbard & Jan Mayen
90 UM      US minor outlying islands
91 YT      Mayotte
93 Additional codes:
95 Value   Description
96 ------------------------
97 TA      Tristan da Cunha
98 XZ      Kosovo