# Pasvaldibu-registrs

Latvijas pašvaldību saraksts ar vienotu identifikatoru — **ATVK kodu** — lietošanai citās Valsts PirmKods datu kopās
(plānošanas dokumenti, budžets, rīcības plāni). Datu kopās pašvaldību norāda ar ATVK kodu, nevis ar nosaukumu.

| Datne | Saturs |
|---|---|
| [`data/pasvaldibas-atvk.xml`](data/pasvaldibas-atvk.xml) | **reģistrs** — 42 pašvaldības: 7 valstspilsētas un 35 novadi |
| [`schemas/pasvaldibu-registrs-0.1.xsd`](schemas/pasvaldibu-registrs-0.1.xsd) | reģistra shēma; viena datne, bez iekļautām shēmām |
| [`data/pasvaldibas-atvk.csv`](data/pasvaldibas-atvk.csv) | tas pats saraksts tabulā — apskatei un izklājlapām |
| [`editor/pasvaldibu-registrs.html`](editor/pasvaldibu-registrs.html) | ProcessGit skatītājs: atverot XML datni, tā tiek parādīta kā tabula ar meklēšanu (`data/processgit.viewer.json`) |
| [`exports/pasvaldibas-atvk-sdmx21.xml`](exports/pasvaldibas-atvk-sdmx21.xml) | tas pats saraksts SDMX-ML 2.1 formātā (statistikas datu apmaiņai) |
| [`tools/build.py`](tools/build.py) | sagatavo visas trīs datnes |
| [`tools/reader.py`](tools/reader.py) | lasa reģistru (lokāli vai no ProcessGit), pārbauda pret shēmu, izvada tabulu, JSON vai CSV |

Galvenā ir XML datne. CSV un SDMX datnes tiek sagatavotas no tās pašas programmas, tās nelabo atsevišķi. Izmaiņas — `CHANGELOG.md`.

## Ieraksts

```xml
<Municipality atvk="0001000" kind="valstspilseta"><Name>Rīga</Name></Municipality>
<Municipality atvk="0038001" kind="novads"><Name>Madonas novads</Name><FormerCode>0038000</FormerCode></Municipality>
```

| Lauks | Nozīme |
|---|---|
| `atvk` | **ATVK kods**, 7 cipari — pašvaldības unikālais identifikators |
| `kind` | `valstspilseta` vai `novads` |
| `Name` | teritorijas nosaukums, kā klasifikatorā |
| `FormerCode` | iepriekšējais ATVK kods, ja teritorija mainīta |
| `validFrom`, `validTo`, `successor` | spēkā esamība un pēctecis (apvienošanas gadījumā) |

Shēma pārbauda: ATVK kods ir 7 cipari un neatkārtojas; nosaukumi neatkārtojas;
pēctecis ir šajā reģistrā.

## Identifikators

**ATVK kods** — kods Administratīvo teritoriju un teritoriālā iedalījuma vienību klasifikatorā
(MK 15.06.2021. noteikumi Nr. 379). Tas ir noteikts ar normatīvo aktu, unikāls, publicēts mašīnlasāmā formā,
un to jau lieto Finanšu ministrija un Valsts kase pašvaldību finansēšanā un pārskatos.

ATVK kods apzīmē teritoriju. Ja teritoriju maina, mainās arī kods: Madonas novadam pēc Varakļānu pievienošanas ir 0038001
(iepriekš 0038000). Vecie kodi netiek atkārtoti izmantoti.

Pašvaldībām VPK ID nepiešķir: [Valsts institūciju reģistrā](https://processgit.org/Valsts-Pirmkods/Organizations_register) pašvaldību nav
(resors 90 slēgts, identifikatori 90-0001–90-0004 atsaukti). Datu kopās pašvaldības norāda ar ATVK kodu, piemēram rīcības plānā
`municipalities="0005000 0007000"`, NAP2027 — `atvk="0001000"`.

## Kurš ko nosaka

| Kas | Kurš | Avots |
|---|---|---|
| Pašvaldību saraksts un nosaukumi, apvienošana | Saeima | Administratīvo teritoriju un apdzīvoto vietu likuma pielikums |
| ATVK kodi | Ministru kabinets; klasifikatoru uztur Centrālā statistikas pārvalde | MK noteikumi Nr. 379; CSP KLASIS |
| Vēsture un robežas | Valsts zemes dienests | Valsts adrešu reģistrs |
| Juridiskā persona, reģistrācijas numurs | Uzņēmumu reģistrs | Publisko personu un iestāžu saraksts |

## Avots un ierobežojumi

Saraksts sagatavots no MK noteikumu Nr. 379 pielikuma MK 18.08.2026. noteikumu Nr. 492 redakcijā (spēkā no 22.08.2026),
https://likumi.lv/ta/id/324030. Juridiski saistošs ir oficiālajā izdevumā „Latvijas Vēstnesis” publicētais teksts.

- Saraksts vēl nav salīdzināts ar CSP KLASIS un Valsts adrešu reģistra atvērtajiem datiem.
- Nosaukumi — kā klasifikatorā (teritorijas nosaukums, piemēram „Rīga”), nevis pašvaldības kā juridiskas personas nosaukums.
- Iekļauts tikai ATVK pirmais līmenis; pagasti un novadu pilsētas nav iekļauti.

## SDMX eksports

`exports/pasvaldibas-atvk-sdmx21.xml` ir SDMX-ML 2.1 kodu saraksts (`Codelist`) PPPA:CL_LV_PASVALDIBA(1.0).
SDMX (ISO 17369) ir statistikas datu un klasifikāciju apmaiņas standarts, ko lieto Eurostat, ECB, OECD un nacionālie
statistikas biroji. Datne atbilst oficiālajai SDMX-ML 2.1 shēmai (https://github.com/sdmx-twg/sdmx-ml, tags `v2.1`,
ieejas punkts `SDMXMessage.xsd`); shēmas datnes šajā repozitorijā netiek glabātas.

## Lietošana

```
pip install lxml
python3 tools/reader.py                  # visas pašvaldības
python3 tools/reader.py 0038001          # pēc ATVK koda (arī pēc iepriekšējā koda)
python3 tools/reader.py --json           # JSON;  --csv — CSV
python3 tools/reader.py --remote         # lasīt no ProcessGit, bez lokālas kopijas
```

Pārbaude ar xmllint:

```
xmllint --noout --schema schemas/pasvaldibu-registrs-0.1.xsd data/pasvaldibas-atvk.xml
```

## Izmaiņas

Izmaiņas sarakstā (jauns MK noteikumu grozījums) veic `tools/build.py`, palaiž to un iesniedz kā git commit,
norādot grozījumu noteikumu numuru un spēkā stāšanās datumu.