Budget-as-Code/schemas/valsts-budzeta-izpilde-0.1.xsd

<?xml version="1.0" encoding="UTF-8"?>
<!--
  Valsts budžeta izpilde kā dati — mērķa shēma v0.1
  PPP Asociācija (PPPA), Valsts Pirmkods (VPK). Melnraksts.
  Pāris ar budžeta likuma shēmu valsts-budzets-0.1.xsd: likums ir plāns, izpilde ir fakts.
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns="urn:pppa:vpk:budzeta-izpilde:0.1"
           xmlns:i="urn:pppa:vpk:budzeta-izpilde:0.1"
           targetNamespace="urn:pppa:vpk:budzeta-izpilde:0.1"
           elementFormDefault="qualified" attributeFormDefault="unqualified" version="0.1" xml:lang="lv">

  <xs:annotation>
    <xs:documentation xml:lang="lv">
      Valsts budžeta izpilde pa mēnešiem kā dati. Avots: Valsts kases datu kopa „Valsts budžeta izpilde pa iestādēm,
      budžeta programmām/apakšprogrammām un klasifikācijas kodiem” (data.gov.lv, CC0). Avota apraksts un pārbaudes:
      contracts/B03-valsts-budzeta-izpilde.source.odcs.yaml. Pārveidošanas noteikumi: mappings/B03-izpilde.yaml.

      Viens Execution ieraksts ir viena avota rinda: mēnesis × iestāde × budžeta veids × programma/apakšprogramma × funkcija ×
      saistību veids × projekts × klasifikācijas kods × konsolidācijas pazīme. Summas ir mēneša apjoms, nevis uzkrājums no gada sākuma.

      Identifikatori sakrīt ar budžeta likuma datukopu (urn:pppa:vpk:budzets:0.1): resora kods, programmas un apakšprogrammas kods,
      funkcijas kods, saistību veida kods. Atribūts purpose norāda likuma mērķi (lv-vb-GGGG.pr.RR.PP.AA.SS), ja tāds likumā ir.

      Kopsummas netiek glabātas: tās aprēķina no Execution ierakstiem.
    </xs:documentation>
  </xs:annotation>

  <!-- ============================================================ identifikatori -->
  <xs:simpleType name="DocumentId">
    <xs:annotation><xs:documentation xml:lang="lv">Izpildes dokumenta identifikators: lv-vbi-GGGG (budžeta gads) un, ja dokuments ir sadalīts daļās, .pNNN vai .names.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:ID"><xs:pattern value="lv-vbi-[0-9]{4}(\.p[0-9]{3}|\.names)?"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="ExecutionId">
    <xs:annotation><xs:documentation xml:lang="lv">Izpildes fakta identifikators: lv-vbi-GGGG.mMM.&lt;12 heksadecimālas zīmes&gt;. Zīmes ir SHA-1 no avota rindas atslēgas (mappings/B03-izpilde.yaml, id.key), tāpēc atkārtotā ielādē tas pats fakts saņem to pašu identifikatoru.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:ID"><xs:pattern value="lv-vbi-[0-9]{4}\.m(0[1-9]|1[0-2])\.[0-9a-f]{12}"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="LawRef">
    <xs:annotation><xs:documentation xml:lang="lv">Atsauce uz budžeta likuma datukopas ierakstu (urn:pppa:vpk:budzets:0.1), piemēram lv-vb-2026 vai lv-vb-2026.pr.22.19.03.00.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:string"><xs:pattern value="lv-vb-[0-9]{4}(-r[0-9]+)?(\.[A-Za-z0-9_-]+)*"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Nmr">
    <xs:annotation><xs:documentation xml:lang="lv">Iestādes reģistrācijas numurs (11 cipari); sasaista ar UR un Valsts kancelejas organizāciju reģistru (VPK ID).</xs:documentation></xs:annotation>
    <xs:restriction base="xs:string"><xs:pattern value="[0-9]{11}"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="ResortCode">
    <xs:annotation><xs:documentation xml:lang="lv">Budžeta resora (ministrijas vai citas centrālās valsts iestādes) kods, divi cipari. Tas pats kods budžeta likumā un VPK ID pirmajos divos ciparos.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:string"><xs:pattern value="[0-9]{2}"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="ProgrammeCode">
    <xs:annotation><xs:documentation xml:lang="lv">Programmas vai apakšprogrammas kods PP.AA.SS, kā budžeta likumā (piemēram 19.03.00). Programmai bez apakšprogrammām apakšprogrammas kods ir programmas kods.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:string"><xs:pattern value="[0-9]{2}\.[0-9]{2}\.[0-9]{2}"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="FunctionCode">
    <xs:annotation><xs:documentation xml:lang="lv">Valdības funkciju klasifikācijas kods (COFOG), piemēram 09.200.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:string"><xs:pattern value="[0-9]{2}\.[0-9]{3}"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Amount">
    <xs:annotation><xs:documentation xml:lang="lv">Summa euro par mēnesi, kā publicēta. Negatīva vērtība nozīmē samazinājumu (atmaksu, korekciju) vai finansēšanā līdzekļu izlietojumu.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:decimal"><xs:fractionDigits value="2"/></xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Month">
    <xs:restriction base="xs:int"><xs:minInclusive value="1"/><xs:maxInclusive value="12"/></xs:restriction>
  </xs:simpleType>

  <!-- ============================================================ vārdnīcas -->
  <xs:simpleType name="Flow">
    <xs:annotation><xs:documentation xml:lang="lv">
      resource — iestādes resursi izdevumu segšanai (dotācija no vispārējiem ieņēmumiem, pašu ieņēmumi, ārvalstu finanšu palīdzība,
      speciālā budžeta sociālās apdrošināšanas iemaksas, transferti); atbilst likuma pielikumu pozīcijai „Resursi izdevumu segšanai”.
      Valsts pamatbudžeta nodokļu ieņēmumi šajā avotā nav. expenditure — izdevumi; financing — finansēšana.
    </xs:documentation></xs:annotation>
    <xs:restriction base="xs:token">
      <xs:enumeration value="resource"/>
      <xs:enumeration value="expenditure"/>
      <xs:enumeration value="financing"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Fund">
    <xs:annotation><xs:documentation xml:lang="lv">basic — valsts pamatbudžets; special — valsts speciālais budžets; loans — aizdevumu un atmaksu budžets; donations — ziedojumi un dāvinājumi.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:token">
      <xs:enumeration value="basic"/>
      <xs:enumeration value="special"/>
      <xs:enumeration value="loans"/>
      <xs:enumeration value="donations"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Block">
    <xs:annotation><xs:documentation xml:lang="lv">core — valsts pamatfunkciju īstenošana; eu — Eiropas Savienības politiku instrumentu un pārējās ārvalstu finanšu palīdzības līdzfinansētie projekti un pasākumi. Tās pašas vērtības kā budžeta likumā.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:token">
      <xs:enumeration value="core"/>
      <xs:enumeration value="eu"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Consolidation">
    <xs:annotation><xs:documentation xml:lang="lv">
      net — „Visu resoru NETO – bez transfertiem” (summējams, lai iegūtu izpildi bez savstarpējiem transfertiem);
      basicTransfers — pamatbudžeta savstarpējie transferti un atmaksas; basicSpecialTransfers — pamatbudžeta un speciālā budžeta
      savstarpējie transferti; specialTransfers — speciālā budžeta savstarpējie transferti. Nekonsolidētu izpildi iegūst, saskaitot visas četras.
    </xs:documentation></xs:annotation>
    <xs:restriction base="xs:token">
      <xs:enumeration value="net"/>
      <xs:enumeration value="basicTransfers"/>
      <xs:enumeration value="basicSpecialTransfers"/>
      <xs:enumeration value="specialTransfers"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="Scheme">
    <xs:annotation><xs:documentation xml:lang="lv">Kura klasifikācija ir atribūtā code: ekk — izdevumu ekonomiskā klasifikācija; revenue — ieņēmumu klasifikācija; financing — finansēšanas klasifikācija. Tās pašas vērtības kā budžeta likumā.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:token">
      <xs:enumeration value="ekk"/>
      <xs:enumeration value="revenue"/>
      <xs:enumeration value="financing"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="LawMatch">
    <xs:annotation><xs:documentation xml:lang="lv">Kā izpildes fakts sasaistīts ar tā paša gada budžeta likumu: subprogramme — likumā ir šī resora apakšprogramma; programme — likumā ir tikai programma; none — likumā šādas programmas nav (piemēram, izveidota gada laikā) vai likums nav ielādēts.</xs:documentation></xs:annotation>
    <xs:restriction base="xs:token">
      <xs:enumeration value="subprogramme"/>
      <xs:enumeration value="programme"/>
      <xs:enumeration value="none"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="NameKind">
    <xs:restriction base="xs:token">
      <xs:enumeration value="resort"/>
      <xs:enumeration value="institution"/>
      <xs:enumeration value="programme"/>
      <xs:enumeration value="function"/>
      <xs:enumeration value="commitment"/>
      <xs:enumeration value="project"/>
      <xs:enumeration value="code"/>
      <xs:enumeration value="lawCode"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- ============================================================ ieraksti -->
  <xs:complexType name="SourceType">
    <xs:annotation><xs:documentation xml:lang="lv">Avota datne, no kuras dokuments izveidots, ar kontrolsummu un publicēšanas laiku.</xs:documentation></xs:annotation>
    <xs:attribute name="publisher" type="xs:string" use="required"/>
    <xs:attribute name="dataset" type="xs:anyURI" use="required"/>
    <xs:attribute name="url" type="xs:anyURI" use="required"/>
    <xs:attribute name="sha256" use="required"><xs:simpleType><xs:restriction base="xs:string"><xs:pattern value="[0-9a-f]{64}"/></xs:restriction></xs:simpleType></xs:attribute>
    <xs:attribute name="modified" type="xs:dateTime" use="required"><xs:annotation><xs:documentation xml:lang="lv">Datnes pēdējo izmaiņu laiks portālā.</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="rows" type="xs:nonNegativeInteger" use="required"/>
  </xs:complexType>

  <xs:complexType name="NameType">
    <xs:annotation><xs:documentation xml:lang="lv">Koda nosaukums, kā avotā (iestāde, resors, programma, funkcija, saistību veids, projekts, klasifikācijas kods, likuma griezuma kods).</xs:documentation></xs:annotation>
    <xs:simpleContent>
      <xs:extension base="xs:string">
        <xs:attribute name="kind" type="NameKind" use="required"/>
        <xs:attribute name="key" type="xs:string" use="required"/>
      </xs:extension>
    </xs:simpleContent>
  </xs:complexType>

  <xs:complexType name="ExecutionType">
    <xs:annotation><xs:documentation xml:lang="lv">Viens izpildes fakts: summa par mēnesi vienā avota griezumā.</xs:documentation></xs:annotation>
    <xs:attribute name="id" type="ExecutionId" use="required"/>
    <xs:attribute name="month" type="Month" use="required"/>
    <xs:attribute name="flow" type="Flow" use="required"/>
    <xs:attribute name="fund" type="Fund" use="required"/>
    <xs:attribute name="block" type="Block"/>
    <xs:attribute name="consolidation" type="Consolidation" use="required"/>
    <xs:attribute name="resort" type="ResortCode" use="required"/>
    <xs:attribute name="institution" type="Nmr" use="required"/>
    <xs:attribute name="institutionCode" type="xs:string" use="required"><xs:annotation><xs:documentation xml:lang="lv">Iestādes kods Valsts kases sistēmā (mainās starp gadiem; pastāvīgais ir institution).</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="programme" type="ProgrammeCode" use="required"/>
    <xs:attribute name="subprogramme" type="ProgrammeCode" use="required"/>
    <xs:attribute name="function" type="FunctionCode"/>
    <xs:attribute name="commitmentKind" type="xs:string"><xs:annotation><xs:documentation xml:lang="lv">Saistību veida kods (10 cipari), kā budžeta likuma 11. pielikumā; 0000000000 — bez saistību veida.</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="project" type="xs:string"><xs:annotation><xs:documentation xml:lang="lv">Projekta ārējais kods, ja izpilde attiecas uz projektu.</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="scheme" type="Scheme" use="required"/>
    <xs:attribute name="code" type="xs:string" use="required"><xs:annotation><xs:documentation xml:lang="lv">Zemākā līmeņa klasifikācijas kods (EKK, ieņēmumu vai finansēšanas klasifikācija).</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="group" type="xs:string"><xs:annotation><xs:documentation xml:lang="lv">EKK grupa četru ciparu līmenī (1000, 2000 … 9000) — tas līmenis, kurā izdevumi noteikti budžeta likumā.</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="lawCode" type="xs:string"><xs:annotation><xs:documentation xml:lang="lv">Pozīcija likuma pielikumu griezumā (piemēram 1000, A300, 21710), ja avots to norāda.</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="purpose" type="LawRef"><xs:annotation><xs:documentation xml:lang="lv">Budžeta likuma mērķis (Purpose), kuram atbilst izpilde: tā paša gada likums, šī resora apakšprogramma vai programma.</xs:documentation></xs:annotation></xs:attribute>
    <xs:attribute name="lawMatch" type="LawMatch" use="required"/>
    <xs:attribute name="amount" type="Amount" use="required"/>
    <xs:attribute name="srcRow" type="xs:positiveInteger" use="required"><xs:annotation><xs:documentation xml:lang="lv">Rindas numurs avota datnē (bez virsrakstu rindas).</xs:documentation></xs:annotation></xs:attribute>
  </xs:complexType>

  <!-- ============================================================ saknes elements -->
  <xs:element name="BudgetExecution">
    <xs:annotation><xs:documentation xml:lang="lv">Viena budžeta gada izpilde (vai tās daļa), kā publicēta konkrētā Valsts kases datnē.</xs:documentation></xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Source" type="SourceType"/>
        <xs:element name="Name" type="NameType" minOccurs="0" maxOccurs="unbounded"/>
        <xs:element name="Execution" type="ExecutionType" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="id" type="DocumentId" use="required"/>
      <xs:attribute name="year" type="xs:gYear" use="required"/>
      <xs:attribute name="asOfMonth" type="Month" use="required"><xs:annotation><xs:documentation xml:lang="lv">Pēdējais mēnesis, par kuru datnē ir dati.</xs:documentation></xs:annotation></xs:attribute>
      <xs:attribute name="law" type="LawRef"><xs:annotation><xs:documentation xml:lang="lv">Tā paša gada budžeta likuma datukopa, pret kuru sasaistīti mērķi.</xs:documentation></xs:annotation></xs:attribute>
      <xs:attribute name="generated" type="xs:dateTime" use="required"/>
    </xs:complexType>
    <xs:key name="executionKey"><xs:selector xpath="i:Execution"/><xs:field xpath="@id"/></xs:key>
    <xs:key name="nameKey"><xs:selector xpath="i:Name"/><xs:field xpath="@kind"/><xs:field xpath="@key"/></xs:key>
  </xs:element>
</xs:schema>