source: Doc/Datamodel/payment_example.ttl @ 320

Last change on this file since 320 was 320, checked in by jkraaijeveld, 13 years ago

Added example and preliminary start of ontology in Doc/Datamodel?
File size: 16.2 KB
Line 
1@prefix rdf:            <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
2@prefix rdfs:           <http://www.w3.org/2000/01/rdf-schema#> .
3@prefix owl:            <http://www.w3.org/2002/07/owl#> .
4@prefix xsd:            <http://www.w3.org/2001/XMLSchema#> .
5@prefix skos:           <http://www.w3.org/2004/02/skos/core#> .
6@prefix foaf:           <http://xmlns.com/foaf/0.1/> .
7@prefix vs:             <http://www.w3.org/2003/06/sw-vocab-status/ns#> .
8@prefix scovo:          <http://purl.org/NET/scovo#> .
9@prefix void:           <http://rdfs.org/ns/void#> .
10@prefix qb:             <http://purl.org/linked-data/cube#> .
11@prefix dcterms:        <http://purl.org/dc/terms/> .
12@prefix interval:       <http://reference.data.gov.uk/def/intervals/>.
13@prefix org:            <http://www.w3.org/ns/org#> .
14@prefix vcard:          <http://www.w3.org/2006/vcard/ns#> .
15@prefix sdmx-concept:    <http://purl.org/linked-data/sdmx/2009/concept#> .
16
17@prefix payment:        <http://reference.data.gov.uk/def/payment#>.
18
19# Meta data -----------------------------------------------------------
20
21<http://reference.data.gov.uk/def/payment#>
22    a owl:Ontology;
23    owl:versionInfo "0.7";
24    rdfs:label "Payments ontology"@en;
25    rdfs:comment "Vocabulary for representing payments, such as government expenditures, using the data cube representation."@en;
26    dcterms:created  "2010-08-06"^^xsd:date;
27    dcterms:modified "2010-11-16"^^xsd:date;
28
29    dcterms:contributor [foaf:mbox "jeni@jenitennison.com"; foaf:name "Jeni Tennison"];
30    dcterms:contributor [foaf:mbox "dave@epimorphics.com";  foaf:name "Dave Reynolds"];
31
32    dcterms:license <http://www.opendatacommons.org/licenses/pddl/1.0/> ;
33    .
34   
35# -- Core classes -----------------------------------------------------------
36
37payment:PaymentDataset a rdfs:Class, owl:Class;
38    rdfs:label "Payment data set"@en;
39    rdfs:comment "A set of payments or expenditures, laid out as a cube of data"@en;
40    rdfs:subClassOf qb:DataSet;
41    vs:term_status "stable";
42    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
43    .
44
45payment:ExpenditureLine a rdfs:Class, owl:Class;
46    rdfs:label "Expenditure Line"@en;
47    rdfs:comment "An item of expenditure that can be classified or assigned to a cost centre"@en;
48    rdfs:subClassOf qb:Observation;
49    vs:term_status "stable";
50    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
51    .
52
53payment:Payment  a rdfs:Class, owl:Class;
54    rdfs:label "Payment"@en;
55    rdfs:comment "A payment to a supplier for some goods or services, may correspond to one or more expenditure lines"@en;
56    rdfs:subClassOf qb:Slice;
57    vs:term_status "stable";
58    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
59    # cardinality constraints
60    rdfs:subClassOf [ a owl:Restriction;
61        owl:onProperty payment:payer;
62        owl:minCardinality 1;
63    ];
64    rdfs:subClassOf [ a owl:Restriction;
65        owl:onProperty payment:payee;
66        owl:minCardinality 1;
67    ];
68    rdfs:subClassOf [ a owl:Restriction;
69        owl:onProperty payment:date;
70        owl:minCardinality 1;
71    ];
72    .
73
74payment:Purchase a rdfs:Class, owl:Class;
75    rdfs:label "Purchase"@en;
76    rdfs:comment "The overall goods or service for which the payment was made"@en;
77    vs:term_status "stable";
78    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
79    .
80
81# -- Property aliases to clarify structure for non-cube viewpoints --------
82
83payment:expenditureLine a rdf:Property, owl:ObjectProperty;
84    rdfs:label "expenditure line"@en;
85    rdfs:comment "Links a payment to the individual expenditure lines associated with it."@en;
86    rdfs:subPropertyOf qb:observation;
87    rdfs:domain payment:Payment;
88    rdfs:range  payment:ExpenditureLine;
89    vs:term_status "stable";
90    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
91    .
92
93# -- Dimensions - which can be used to structure the cube -----------------
94
95payment:payer a rdf:Property, owl:ObjectProperty, qb:DimensionProperty;
96    rdfs:label "payer"@en;
97    rdfs:comment "The entity which made the payment."@en;
98    rdfs:domain payment:Payment;
99    rdfs:range foaf:Agent;   
100    vs:term_status "stable";
101    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
102    .
103
104payment:payee a rdf:Property, owl:ObjectProperty, qb:DimensionProperty;
105    rdfs:label "payee"@en;
106    rdfs:comment "The entity to which the payment was made."@en;
107    rdfs:domain payment:Payment;
108    rdfs:range foaf:Agent;
109    vs:term_status "stable";
110    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
111    .
112
113payment:date a rdf:Property, owl:ObjectProperty, qb:DimensionProperty;
114    rdfs:label "date"@en;
115    rdfs:comment "The date the payment is deemed to have occurred."@en;
116    rdfs:domain payment:Payment;
117    rdfs:range interval:Interval;
118    vs:term_status "stable";
119    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
120    .
121
122payment:expenditureCategory a rdf:Property, owl:ObjectProperty, qb:DimensionProperty;
123    rdfs:label "expenditure category"@en;
124    rdfs:comment """The category of expenditure in some appropriate categorization scheme (such as the Best Value Account Code of Practice categories). If the scheme is hierarchical then this should at least designate the narrowest (most fine grain) applicable code and can additionally designate the broader codes. Multiple code schemes can be used within the same dataset and consuming applications can use the skos:inScheme (and the rdf:type) of the code to determine the scheme."""@en;
125    rdfs:domain payment:ExpenditureLine;
126    rdfs:range  skos:Concept;
127    vs:term_status "stable";
128    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
129    .
130
131payment:expenditureCode a rdf:Property, owl:DataTypeProperty;
132    rdfs:label "expenditure code"@en;
133    rdfs:comment """An (optional) internal code for the expenditure category. Such codes may not be useful across organizations but retaining them in a dataset may aid comparability of datasets within an organization and help with tracing back requests for further information. The internal code may actually be an amalgam of multiple different categories (e.g. may denote both the subjective and objective classifications of an expenditure)."""@en;
134    rdfs:domain payment:ExpenditureLine;
135    vs:term_status "stable";
136    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
137    .
138
139payment:payment a rdf:Property, owl:ObjectProperty, qb:DimensionProperty;
140    rdfs:label "payment"@en;
141    rdfs:comment "Indicates the payment of which this expenditure line is a part."@en;
142    rdfs:domain payment:ExpenditureLine;
143    rdfs:range payment:Payment;
144    vs:term_status "stable";
145    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
146    .
147
148# -- Measures - values that can be associated with a single observation in the cube ----------
149
150payment:grossAmount a rdf:Property, owl:DatatypeProperty, qb:MeasureProperty;
151    rdfs:label "gross amount"@en;
152    rdfs:comment "The amount paid, inclusive of any tax (whether reclaimable or not)"@en;
153    rdfs:range xsd:decimal;
154    rdfs:domain payment:ExpenditureLine;
155    vs:term_status "stable";
156    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
157    .
158
159payment:netAmount a rdf:Property, owl:DatatypeProperty, qb:MeasureProperty;
160    rdfs:label "net amount"@en;
161    rdfs:comment "The net amount of the payment. This is the effective cost to the payer after any reclaimable tax has been deducted."@en;
162    rdfs:range xsd:decimal;
163    rdfs:domain payment:ExpenditureLine;
164    vs:term_status "stable";
165    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
166    .
167
168# -- Attributes - qualify the measured value -------------------------------------------
169
170payment:currency a qb:AttributeProperty;
171    rdfs:label "currency"@en;
172    rdfs:comment "Currency in which a payment was made, typically attached to the dataset for single currency datasets."@en;
173    qb:concept sdmx-concept:currency;           # optional cross link
174    vs:term_status "stable";
175    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
176    .
177
178# -- Descriptive properties for Payments and Expenditure lines -------------------------
179
180payment:order
181  a rdf:Property ;
182  rdfs:label "order"@en ;
183  rdfs:comment "Indicates an order associated with this payment (optional)."@en;
184  rdfs:domain payment:Payment;
185    vs:term_status "stable";
186    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
187  .
188
189payment:invoice
190  a rdf:Property  ;
191  rdfs:label "invoice"@en ;
192  rdfs:comment "Indicates an invoice associated with this payment (optional)."@en;
193  rdfs:domain payment:Payment;
194    vs:term_status "stable";
195    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
196  .
197
198payment:contract
199  a rdf:Property ;
200  rdfs:label "contract"@en ;
201  rdfs:comment "Indicates a contract associated with this payment (optional)."@en;
202  rdfs:domain payment:Payment ;
203    vs:term_status "stable";
204    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
205  .
206
207payment:reference
208    a rdf:Property, owl:DatatypeProperty;
209    rdfs:label "reference"@en;
210    rdfs:comment """A reference number, code or label which identifies the payment. Not unique across different suppliers."""@en;
211    rdfs:domain payment:Payment ;
212    vs:term_status "stable";
213    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
214    .
215
216payment:totalNetAmount a rdf:Property, owl:DatatypeProperty;
217    rdfs:label "total net amount"@en;
218    rdfs:range xsd:decimal;
219    rdfs:domain qb:Slice;
220    vs:term_status "stable";
221    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
222    .
223
224payment:totalGrossAmount a rdf:Property, owl:DatatypeProperty, qb:MeasureProperty;
225    rdfs:label "total gross amount"@en;
226    rdfs:range xsd:decimal;
227    rdfs:domain qb:Slice;
228    vs:term_status "stable";
229    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
230    .
231
232payment:purchase a rdf:Property, owl:DatatypeProperty;
233    rdfs:label "purchase"@en;
234    rdfs:comment "Indicates the overall goods or service for which the payment was made."@en;
235    rdfs:domain payment:Payment;
236    rdfs:range  payment:Purchase;
237    vs:term_status "stable";
238    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
239    .
240
241payment:procurementCategory a rdf:Property, owl:ObjectProperty;
242    rdfs:label "procurement category"@en;
243    rdfs:comment "A classification for the goods or services for which the payment was made."@en;
244    rdfs:domain payment:Purchase;
245    rdfs:range skos:Concept;
246    vs:term_status "stable";
247    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
248    .
249
250payment:narrative
251  a rdf:Property , owl:DatatypeProperty ;
252  rdfs:label "narrative"@en ;
253  rdfs:comment "A narrative description of the goods or services that were supplied."@en ;
254  rdfs:domain payment:Purchase;
255    vs:term_status "stable";
256    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
257 .
258
259# -- Structure relationships -------------------------------------------------------
260
261payment:unit a rdf:Property, owl:ObjectProperty;
262    rdfs:label "unit"@en;
263    rdfs:comment """Optionally indicates a particular organizational
264unit (Department, Directorate etc) of the payer organization associated with the payment.
265Use org:classification to link the unit to a categorization of types of units to
266support cross-comparison. For example, in the UK Local Authority spend application
267then the ESDToolkit-maintained list of Department Types may be a suitable code list."""@en;
268    rdfs:domain payment:Payment;
269    vs:term_status "stable";
270    rdfs:range  org:OrganizationalUnit ;
271    .
272
273# -- Data structure definitions -------------------------------------------------------
274
275payment:payments-with-expenditure-structure a qb:DataStructureDefinition, rdfs:Resource;
276    rdfs:label "expenditure structure"@en;
277    rdfs:comment "The structure of a cube containing expenditure level information along with payments.";
278
279    qb:component
280        [qb:dimension payment:payer],
281        [qb:dimension payment:payee],
282        [qb:dimension payment:date],
283        [qb:dimension payment:expenditureCategory],
284        [qb:dimension payment:payment],
285
286        [qb:measure   payment:netAmount],
287
288        [qb:attribute payment:currency];
289
290    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
291    .
292
293payment:payment-slice a qb:SliceKey, rdfs:Resource;
294    rdfs:label "payment slice"@en;
295    rdfs:comment "The definition of a slice through an expenditure cube that corresponds to all the expenditures in a single payment."@en;
296    qb:componentProperty payment:payer, payment:payee, payment:date, payment:payment ;
297    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
298    .
299
300# -- Expenditure codes for capital/revenue -------------------------------------------------------
301
302payment:expenditure-category a skos:ConceptScheme, rdfs:Resource;
303    rdfs:label "Exenditure category scheme"@en;
304    rdfs:comment "A code scheme for classifying expenditures as capital/revenue."@en;
305    skos:hasTopConcept payment:capital, payment:revenue ;
306    vs:term_status "stable";
307    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
308    rdfs:seeAlso <http://www.hmrc.gov.uk/manuals/bimmanual/bim35010.htm> ;
309    .
310
311payment:ExpenditureCategory a rdfs:Class, owl:Class;
312    rdfs:label "Expenditure categories"@en;
313    rdfs:comment "The set of expenditure categories in the expenditure-category scheme for capital/revenue."@en ;
314    rdfs:subClassOf skos:Concept ;
315    vs:term_status "stable";
316    rdfs:seeAlso <http://www.hmrc.gov.uk/manuals/bimmanual/bim35010.htm> ;
317    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
318    .
319
320payment:capital a skos:Concept, payment:ExpenditureCategory, rdfs:Resource;
321    rdfs:label "Capital"@en;
322    rdfs:comment "Indicates a capital expenditure."@en;
323    skos:topConceptOf payment:expenditure-category;
324    skos:inScheme payment:expenditure-category;
325    skos:notation "Capital" ;
326    vs:term_status "stable";
327    rdfs:seeAlso <http://www.hmrc.gov.uk/manuals/bimmanual/bim35010.htm> ;
328    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
329    .
330
331payment:revenue a skos:Concept, payment:ExpenditureCategory, rdfs:Resource;
332    rdfs:label "Revenue"@en;
333    rdfs:comment "Indicates a revenue expenditure."@en;
334    skos:topConceptOf payment:expenditure-category;
335    skos:inScheme payment:expenditure-category;
336    skos:notation "Revenue" ;
337    vs:term_status "stable";
338    rdfs:seeAlso <http://www.hmrc.gov.uk/manuals/bimmanual/bim35010.htm> ;
339    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
340    .
341     
342# -- Support for recording redaction -------------------------------------------------------
343
344# payment:redacted a rdf:Property, owl:AnnotationProperty, qb:AttributeProperty;
345#     rdfs:label "redacted"@en;
346#     rdfs:comment """Annotation used to indicate that a particular property of the resource
347# has been redacted. Any value for the property present in the dataset will be a dummy
348# value (e.g. the string "REDACTED"). For example, if the payee information is
349# redacted the payment would be annotated with <code>:payment123 payment:redacted payment:payee</code>.
350# If only the payee name is redacted but other fields of the payee such as location
351# or internal reference number are correct then the redaction annotation would be attached
352# to the payee resource instead <code>:payee 123 payment:redacted rdfs:label</code>. Note that the
353# notion of redaction is context and dataset dependent so it is recommended that when
354# exporting datasets for cross-set integration then the redacted annotation and the
355# indicated properties should be omitted from the export."""@en;
356#     rdfs:range  rdf:Property ;
357#     vs:term_status "proposed";
358#     rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
359#     .
360
361payment:Redaction a rdfs:Class, owl:Class;
362    rdfs:label "Redaction"@en;
363    rdfs:comment """An instance of Redaction can be used in place of the actual value
364in a dataset to indicate that this is a replacement for the true data value which has
365been redacted. Typically the Redaction resource will be a blank note. It is recommended
366that it have an appropriate rdfs:label (e.g. REDACTED). If further information on the
367reaction is available then dcterms properties should be used to carry those, in partcular
368dct:description can be used to convey a description of the redaction and reasons"""@en;
369    vs:term_status "proposed";
370    rdfs:isDefinedBy <http://reference.data.gov.uk/def/payment#> ;
371    .
372   
Note: See TracBrowser for help on using the repository browser.