{
  "manifestVersion": 1,
  "dataset": {
    "id": "sumal-timber-permits",
    "name": "SUMAL timber-transport permits",
    "description": "Timber-transport permits (\"avize\") tracked by SUMAL 2.0, Romania's national wood-traceability system operated by the Ministerul Mediului, Apelor și Pădurilor via STS, as exposed by the public Inspectorul Pădurii lookup. Two tables: permits, one row per authorisation with its detail (issuer, transporter, declared volume and species, validity window), and permit_locations, one row per permit with where it is currently plotted on the public map. Photographs attached to a permit ('poze') are deliberately not republished — only their count is kept.",
    "descriptions": {
      "ro": "Avizele de transport al materialelor lemnoase urmărite de SUMAL 2.0, sistemul național de trasabilitate a lemnului operat de Ministerul Mediului, Apelor și Pădurilor prin STS, preluate din instrumentul public de căutare Inspectorul Pădurii. Două tabele: unul cu câte un rând pentru fiecare aviz și detaliile lui (emitent, transportator, volumul și speciile declarate, intervalul de valabilitate), și unul cu locul unde este afișat în prezent fiecare aviz pe harta publică. Fotografiile atașate unui aviz nu sunt republicate aici — se păstrează doar numărul lor.",
      "en": "Timber-transport permits (\"avize\") tracked by SUMAL 2.0, Romania's national wood-traceability system operated by the Ministerul Mediului, Apelor și Pădurilor via STS, as exposed by the public Inspectorul Pădurii lookup. Two tables: permits, one row per authorisation with its detail (issuer, transporter, declared volume and species, validity window), and permit_locations, one row per permit with where it is currently plotted on the public map. Photographs attached to a permit ('poze') are deliberately not republished — only their count is kept."
    },
    "names": {
      "ro": "Avize de transport lemn — SUMAL",
      "en": "SUMAL timber-transport permits"
    },
    "sourceUrl": "https://inspectorulpadurii.ro/",
    "license": {
      "id": "ro-official-acts-public-domain",
      "name": "Romanian official acts and public-interest information — outside copyright",
      "url": "https://legislatie.just.ro/Public/DetaliiDocument/7816",
      "attribution": "Date despre autorizațiile de transport al masei lemnoase publicate de Ministerul Mediului, Apelor și Pădurilor — SUMAL 2.0, prin Inspectorul Pădurii",
      "notes": "Legea 8/1996 privind dreptul de autor, art. 9, excludes from copyright both official texts of an administrative nature and simple facts and data. Each row here is drawn from an official permit — an `aviz de însoțire a materialului lemnos` the state issues and tracks through SUMAL 2.0 — and permit registers of this kind, together with the bare facts they carry (volumes, dates, coordinates, issuer and transporter identity), are exactly the administrative-act and factual-data category the statute excludes from copyright. They are also public-interest information under Legea 544/2001 and re-usable public-sector information under Legea 179/2022 — Romania's transposition of EU Directive 2019/1024 on open data and the reuse of public-sector information. HOWEVER, and a reuser must weigh this: checked on 2026-09-02, inspectorulpadurii.ro publishes no licence, terms or legal page of any kind — the app is a single-route React page showing a live map, with no footer and no /terms, /legal or /about route — and robots.txt sets an empty \"Disallow:\" for every user agent, placing no restriction on the API path used here. No explicit reuse licence has therefore been found for this data, and none should be assumed; this dataset rests on the legal position above rather than on any grant from the Ministerul Mediului, Apelor și Pădurilor, and anyone republishing it should make their own assessment. Treat this dataset accordingly: it is a DERIVED work, republishing a subset of what the /api/aviz/locations and /api/aviz/{codAviz} endpoints return — the fields captured in the permits and permit_locations tables — with the source's own photographs (poze) deliberately excluded, since they are binary attachments rather than tabular data; only their count (num_poze) is kept. The publisher may change, restrict or withdraw this API at any time without notice; re-check this page and the API's own behaviour before relying on it for anything beyond casual analysis."
    },
    "cadence": "daily",
    "tags": [
      "forestry",
      "timber",
      "romania",
      "transport",
      "sumal",
      "permits",
      "environment"
    ],
    "sources": []
  },
  "ingest": {
    "id": "01M1NQFRMGFMD6ZG1GD0B9BQ29",
    "startedAt": "2026-09-04T08:10:14.032Z",
    "snapshotDate": "2026-09-04",
    "catalogSnapshotId": 4,
    "params": {
      "maxDetailRequests": 500
    },
    "outOfBand": true
  },
  "baseUrl": "https://data-directory.fsn1.your-objectstorage.com/public/sumal-timber-permits",
  "catalog": {
    "url": "https://data-directory.fsn1.your-objectstorage.com/catalog/sumal-timber-permits/v/01M1NQFRMGFMD6ZG1GD0B9BQ29/catalog.ducklake",
    "latestUrl": "https://data-directory.fsn1.your-objectstorage.com/catalog/sumal-timber-permits/catalog.ducklake",
    "sha256": "2e502bfffbd81a6f76b08853c71db8c2d554152c90d334496b9d50b9480b5bc3",
    "duckdbVersion": "v1.5.5",
    "attachExample": "ATTACH 'ducklake:https://data-directory.fsn1.your-objectstorage.com/catalog/sumal-timber-permits/catalog.ducklake' AS lake (READ_ONLY); SELECT * FROM lake.main.permits LIMIT 5;"
  },
  "queryHints": {
    "examples": [
      {
        "title": "Permits issued in the last week",
        "sql": "SELECT cod_aviz, emitent_denumire, transportator_denumire, volum_total, valabilitate_emitere\nFROM permits\nWHERE valabilitate_emitere >= now() - INTERVAL 7 DAY\nORDER BY valabilitate_emitere DESC",
        "description": "valabilitate_emitere is the leading sort column, so this range prunes well."
      },
      {
        "title": "Total declared volume moved by each transporter this month",
        "sql": "SELECT transportator_denumire, transportator_cui, sum(volum_total) AS total_m3, count(*) AS permits\nFROM permits\nWHERE valabilitate_emitere >= date_trunc('month', now())\nGROUP BY 1, 2\nORDER BY total_m3 DESC\nLIMIT 20"
      },
      {
        "title": "Where currently tracked depot-type permits are plotted",
        "sql": "SELECT l.cod_aviz, l.lat, l.lng, p.emitent_denumire, p.volum_total\nFROM permit_locations AS l\nJOIN permits AS p USING (cod_aviz)\nWHERE l.tip_aviz = 2\nORDER BY l.cod_aviz",
        "description": "tip_aviz is the leading sort column on permit_locations; 2 is \"Depozit\"."
      }
    ]
  },
  "tables": [
    {
      "name": "permits",
      "description": "One row per timber-transport permit (\"aviz\", codAviz) issued under SUMAL 2.0, with the detail SUMAL records for it: who issued it, who is transporting, the declared volume and species, and the validity window. has_finished_transport flips from false to true once SUMAL records the transport as complete, which is why this table upserts on cod_aviz instead of appending — a permit is one evolving record, not a one-off event.",
      "descriptions": {
        "ro": "Câte un rând pentru fiecare aviz de transport („codAviz”) emis în SUMAL 2.0, cu detaliile pe care SUMAL le păstrează pentru el: cine l-a emis, cine face transportul, volumul și speciile declarate și intervalul de valabilitate. hasFinishedTransport trece din fals în adevărat după ce SUMAL înregistrează transportul ca finalizat — de aceea acest tabel se actualizează (upsert) pe cod_aviz, nu se adaugă la infinit: avizul este o înregistrare care evoluează, nu un eveniment care se întâmplă o singură dată.",
        "en": "One row per timber-transport permit (\"aviz\", codAviz) issued under SUMAL 2.0, with the detail SUMAL records for it: who issued it, who is transporting, the declared volume and species, and the validity window. has_finished_transport flips from false to true once SUMAL records the transport as complete, which is why this table upserts on cod_aviz instead of appending — a permit is one evolving record, not a one-off event."
      },
      "rowCount": 998,
      "lastRunRows": 498,
      "totalBytes": 54455,
      "sortBy": [
        "valabilitate_emitere",
        "cod_aviz"
      ],
      "searchColumns": [],
      "primaryKey": [
        "cod_aviz"
      ],
      "writeMode": "upsert",
      "storage": "lake",
      "columns": [
        {
          "name": "cod_aviz",
          "type": "VARCHAR",
          "nullable": false,
          "description": "The permit code, e.g. \"DA26022347000207757509020046\". Assigned by SUMAL at issue; the primary key of this table.",
          "descriptions": {
            "ro": "Codul avizului, de exemplu „DA26022347000207757509020046”. Atribuit de SUMAL la emitere; este cheia primară a acestui tabel.",
            "en": "The permit code, e.g. \"DA26022347000207757509020046\". Assigned by SUMAL at issue; the primary key of this table."
          },
          "min": "DA26008560000201764809020743",
          "max": "DC26034330000012733609010920",
          "distinctApprox": 876
        },
        {
          "name": "tip_aviz",
          "type": "INTEGER",
          "nullable": true,
          "description": "Numeric permit-type code (tipAviz); see nume_tip_aviz for its name and permit_locations.tip_aviz for the same code on the location row.",
          "descriptions": {
            "ro": "Codul numeric al tipului de aviz („tipAviz”); vezi nume_tip_aviz pentru numele lui și permit_locations.tip_aviz pentru același cod pe rândul de locație.",
            "en": "Numeric permit-type code (tipAviz); see nume_tip_aviz for its name and permit_locations.tip_aviz for the same code on the location row."
          }
        },
        {
          "name": "nume_tip_aviz",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Human-readable permit type as named by SUMAL, e.g. \"Depozit\" (depot), \"Locul Recoltării\" (harvesting site) or \"Alte situații\" (other situations).",
          "descriptions": {
            "ro": "Tipul avizului, așa cum este numit de SUMAL, de exemplu „Depozit”, „Locul Recoltării” sau „Alte situații”.",
            "en": "Human-readable permit type as named by SUMAL, e.g. \"Depozit\" (depot), \"Locul Recoltării\" (harvesting site) or \"Alte situații\" (other situations)."
          }
        },
        {
          "name": "has_finished_transport",
          "type": "BOOLEAN",
          "nullable": true,
          "description": "Whether SUMAL has recorded this permit's transport as finished. Flips from false to true after issue — the reason this table is upserted rather than appended.",
          "descriptions": {
            "ro": "Dacă SUMAL a înregistrat transportul acestui aviz ca fiind finalizat. Trece din fals în adevărat după emitere — motivul pentru care tabelul se actualizează prin upsert, nu se adaugă la infinit.",
            "en": "Whether SUMAL has recorded this permit's transport as finished. Flips from false to true after issue — the reason this table is upserted rather than appended."
          }
        },
        {
          "name": "nr_identificare",
          "type": "VARCHAR",
          "nullable": true,
          "description": "The vehicle or transport identifier tied to this permit (typically a licence plate), as recorded by SUMAL.",
          "descriptions": {
            "ro": "Identificatorul vehiculului sau al transportului asociat acestui aviz (de regulă un număr de înmatriculare), așa cum apare în SUMAL.",
            "en": "The vehicle or transport identifier tied to this permit (typically a licence plate), as recorded by SUMAL."
          }
        },
        {
          "name": "nr_apv",
          "type": "VARCHAR",
          "nullable": true,
          "description": "\"Autorizație de Punere în Valoare\" number: the forestry harvesting authorisation this timber was cut under, when the permit names one. Kept as text — it can be a long numeric code with no reason to be treated as a quantity.",
          "descriptions": {
            "ro": "Numărul „Autorizației de Punere în Valoare”: actul de exploatare forestieră sub care a fost tăiat lemnul, atunci când avizul îl menționează. Păstrat ca text, fiindcă poate fi un cod numeric lung fără niciun motiv să fie tratat ca o cantitate.",
            "en": "\"Autorizație de Punere în Valoare\" number: the forestry harvesting authorisation this timber was cut under, when the permit names one. Kept as text — it can be a long numeric code with no reason to be treated as a quantity."
          }
        },
        {
          "name": "provenienta",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Free-text origin as written by SUMAL: a depot name, a harvesting-site description, or a reference to another permit for transshipped timber.",
          "descriptions": {
            "ro": "Proveniența, ca text liber scris de SUMAL: numele unui depozit, descrierea unui loc de recoltare sau o trimitere către un alt aviz, pentru lemn transbordat.",
            "en": "Free-text origin as written by SUMAL: a depot name, a harvesting-site description, or a reference to another permit for transshipped timber."
          }
        },
        {
          "name": "id_aviz",
          "type": "BIGINT",
          "nullable": true,
          "description": "SUMAL's own internal numeric id for this permit (volum.idAviz), distinct from the human-facing cod_aviz code.",
          "descriptions": {
            "ro": "Identificatorul numeric intern al SUMAL pentru acest aviz („volum.idAviz”), diferit de codul cod_aviz, care este cel văzut de public.",
            "en": "SUMAL's own internal numeric id for this permit (volum.idAviz), distinct from the human-facing cod_aviz code."
          }
        },
        {
          "name": "volum_total",
          "type": "DECIMAL(12,4)",
          "nullable": true,
          "description": "Total declared volume of timber on this permit, in cubic metres (volum.total). Matched marfa.total in every permit inspected while building this connector.",
          "descriptions": {
            "ro": "Volumul total de lemn declarat pe acest aviz, în metri cubi („volum.total”). A coincis cu „marfa.total” la fiecare aviz verificat la construirea acestui conector.",
            "en": "Total declared volume of timber on this permit, in cubic metres (volum.total). Matched marfa.total in every permit inspected while building this connector."
          },
          "unit": "m3"
        },
        {
          "name": "marfa_grupe_specii",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Species groups declared on this permit (e.g. \"RĂȘINOASE\", \"FAG\"), as SUMAL's own comma-joined summary string.",
          "descriptions": {
            "ro": "Grupele de specii declarate pe acest aviz (de exemplu „RĂȘINOASE”, „FAG”), ca text rezumat, unit prin virgulă, produs chiar de SUMAL.",
            "en": "Species groups declared on this permit (e.g. \"RĂȘINOASE\", \"FAG\"), as SUMAL's own comma-joined summary string."
          }
        },
        {
          "name": "marfa_specii",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Individual species declared on this permit (e.g. \"MOLID , BRAD\"), as SUMAL's own comma-joined summary string.",
          "descriptions": {
            "ro": "Speciile declarate pe acest aviz (de exemplu „MOLID , BRAD”), ca text rezumat, unit prin virgulă, produs chiar de SUMAL.",
            "en": "Individual species declared on this permit (e.g. \"MOLID , BRAD\"), as SUMAL's own comma-joined summary string."
          }
        },
        {
          "name": "marfa_sortimente",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Timber assortments/products declared on this permit (e.g. \"Lemn rotund\", \"Cherestele\"), as SUMAL's own comma-joined summary string.",
          "descriptions": {
            "ro": "Sortimentele de lemn declarate pe acest aviz (de exemplu „Lemn rotund”, „Cherestele”), ca text rezumat, unit prin virgulă, produs chiar de SUMAL.",
            "en": "Timber assortments/products declared on this permit (e.g. \"Lemn rotund\", \"Cherestele\"), as SUMAL's own comma-joined summary string."
          }
        },
        {
          "name": "emitent_denumire",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Name of the entity that issued this permit.",
          "descriptions": {
            "ro": "Denumirea entității care a emis acest aviz.",
            "en": "Name of the entity that issued this permit."
          }
        },
        {
          "name": "emitent_cui",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Fiscal code (CUI/CIF) of the issuing entity. Kept as text: Romanian fiscal codes can carry a leading \"RO\" prefix and must not be treated as a number.",
          "descriptions": {
            "ro": "Codul de identificare fiscală (CUI/CIF) al entității emitente. Păstrat ca text: un CUI românesc poate avea prefixul „RO” și nu trebuie tratat ca număr.",
            "en": "Fiscal code (CUI/CIF) of the issuing entity. Kept as text: Romanian fiscal codes can carry a leading \"RO\" prefix and must not be treated as a number."
          }
        },
        {
          "name": "transportator_identificator",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Identifier SUMAL has on file for the transporter (typically the same value as nr_identificare).",
          "descriptions": {
            "ro": "Identificatorul pe care SUMAL îl are înregistrat pentru transportator (de regulă aceeași valoare ca nr_identificare).",
            "en": "Identifier SUMAL has on file for the transporter (typically the same value as nr_identificare)."
          }
        },
        {
          "name": "transportator_denumire",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Name of the transporting entity.",
          "descriptions": {
            "ro": "Denumirea entității care efectuează transportul.",
            "en": "Name of the transporting entity."
          }
        },
        {
          "name": "transportator_cui",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Fiscal code (CUI/CIF) of the transporting entity. Kept as text for the same reason as emitent_cui.",
          "descriptions": {
            "ro": "Codul de identificare fiscală (CUI/CIF) al transportatorului. Păstrat ca text, din același motiv ca emitent_cui.",
            "en": "Fiscal code (CUI/CIF) of the transporting entity. Kept as text for the same reason as emitent_cui."
          }
        },
        {
          "name": "transportator_tip",
          "type": "VARCHAR",
          "nullable": true,
          "description": "How SUMAL classifies the transporter, e.g. \"SUMAL\" for one registered in the system.",
          "descriptions": {
            "ro": "Cum clasifică SUMAL transportatorul, de exemplu „SUMAL” pentru unul înregistrat în sistem.",
            "en": "How SUMAL classifies the transporter, e.g. \"SUMAL\" for one registered in the system."
          }
        },
        {
          "name": "transportator_non_sumal",
          "type": "BOOLEAN",
          "nullable": true,
          "description": "True when the transporter is not itself registered in SUMAL.",
          "descriptions": {
            "ro": "Adevărat când transportatorul nu este el însuși înregistrat în SUMAL.",
            "en": "True when the transporter is not itself registered in SUMAL."
          }
        },
        {
          "name": "beneficiar_tip",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Legal nature of the beneficiary: \"FIZICA\" (individual) or \"JURIDICA\" (legal entity).",
          "descriptions": {
            "ro": "Natura juridică a beneficiarului: „FIZICA” (persoană fizică) sau „JURIDICA”.",
            "en": "Legal nature of the beneficiary: \"FIZICA\" (individual) or \"JURIDICA\" (legal entity)."
          }
        },
        {
          "name": "destinatar_tip",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Legal nature of the consignee, same vocabulary as beneficiar_tip.",
          "descriptions": {
            "ro": "Natura juridică a destinatarului, cu același vocabular ca beneficiar_tip.",
            "en": "Legal nature of the consignee, same vocabulary as beneficiar_tip."
          }
        },
        {
          "name": "valabilitate_emitere",
          "type": "TIMESTAMPTZ",
          "nullable": true,
          "description": "When this permit was issued (UTC).",
          "descriptions": {
            "ro": "Momentul emiterii acestui aviz (UTC).",
            "en": "When this permit was issued (UTC)."
          },
          "min": "2026-08-29 06:31:33.534+00",
          "max": "2026-09-04 07:49:35.098+00"
        },
        {
          "name": "valabilitate_finalizare",
          "type": "TIMESTAMPTZ",
          "nullable": true,
          "description": "The deadline by which the transport authorised by this permit must be completed (UTC).",
          "descriptions": {
            "ro": "Termenul până la care trebuie finalizat transportul autorizat de acest aviz (UTC).",
            "en": "The deadline by which the transport authorised by this permit must be completed (UTC)."
          }
        },
        {
          "name": "tip_marfa",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Cargo-type classification SUMAL records for unusual transports (e.g. containerised cargo). Null on every permit inspected while building this connector; kept because the field exists in the API.",
          "descriptions": {
            "ro": "Clasificarea tipului de marfă, folosită de SUMAL pentru transporturi neobișnuite (de exemplu marfă în container). A fost nulă la fiecare aviz verificat la construirea acestui conector; păstrată pentru că există în API.",
            "en": "Cargo-type classification SUMAL records for unusual transports (e.g. containerised cargo). Null on every permit inspected while building this connector; kept because the field exists in the API."
          }
        },
        {
          "name": "angajat",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Employee identifier SUMAL records against this permit, when one applies. Null on every permit inspected while building this connector.",
          "descriptions": {
            "ro": "Identificatorul angajatului înregistrat de SUMAL pentru acest aviz, atunci când se aplică. A fost nul la fiecare aviz verificat la construirea acestui conector.",
            "en": "Employee identifier SUMAL records against this permit, when one applies. Null on every permit inspected while building this connector."
          }
        },
        {
          "name": "remorca",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Trailer identifier SUMAL records against this permit, when one applies. Null on every permit inspected while building this connector.",
          "descriptions": {
            "ro": "Identificatorul remorcii înregistrat de SUMAL pentru acest aviz, atunci când se aplică. A fost nul la fiecare aviz verificat la construirea acestui conector.",
            "en": "Trailer identifier SUMAL records against this permit, when one applies. Null on every permit inspected while building this connector."
          }
        },
        {
          "name": "identificator_container",
          "type": "VARCHAR",
          "nullable": true,
          "description": "Container identifier, for timber shipped in a container. Blank on every permit inspected while building this connector.",
          "descriptions": {
            "ro": "Identificatorul containerului, pentru lemn transportat în container. A fost gol la fiecare aviz verificat la construirea acestui conector.",
            "en": "Container identifier, for timber shipped in a container. Blank on every permit inspected while building this connector."
          }
        },
        {
          "name": "num_poze",
          "type": "INTEGER",
          "nullable": true,
          "description": "How many photographs SUMAL has attached to this permit. The photographs themselves are deliberately not republished here (see the licence notes) — this is only their count.",
          "descriptions": {
            "ro": "Câte fotografii a atașat SUMAL acestui aviz. Fotografiile în sine nu sunt republicate aici — vezi notele despre licență — aceasta este doar numărătoarea lor.",
            "en": "How many photographs SUMAL has attached to this permit. The photographs themselves are deliberately not republished here (see the licence notes) — this is only their count."
          }
        },
        {
          "name": "first_seen_date",
          "type": "DATE",
          "nullable": false,
          "description": "The first run day (UTC) on which we saw this permit. Maintained automatically by the upsert loader — never overwritten, only widened.",
          "descriptions": {
            "ro": "Prima zi de rulare (UTC) în care am întâlnit acest aviz. Este menținută automat de sistemul de încărcare cu upsert: nu este suprascrisă, doar extinsă.",
            "en": "The first run day (UTC) on which we saw this permit. Maintained automatically by the upsert loader — never overwritten, only widened."
          }
        },
        {
          "name": "last_seen_date",
          "type": "DATE",
          "nullable": false,
          "description": "The most recent run day (UTC) on which this permit was still returned by the API.",
          "descriptions": {
            "ro": "Cea mai recentă zi de rulare (UTC) în care acest aviz a mai apărut în răspunsul API-ului.",
            "en": "The most recent run day (UTC) on which this permit was still returned by the API."
          }
        }
      ],
      "files": [
        {
          "url": "https://data-directory.fsn1.your-objectstorage.com/public/sumal-timber-permits/v/01M1NQFRMGFMD6ZG1GD0B9BQ29/permits.parquet",
          "sizeBytes": 54455,
          "rowCount": 998,
          "etag": "\"5462957ad1b75c8ec2ebd1b8ed43a54e\"",
          "stats": {
            "valabilitate_emitere": {
              "min": "2026-08-29 06:31:33.534+00",
              "max": "2026-09-04 07:49:35.098+00"
            },
            "cod_aviz": {
              "min": "DA26008560000201764809020743",
              "max": "DC26034330000012733609010920"
            }
          }
        }
      ],
      "example": [
        {
          "cod_aviz": "DC26033752000012453008290931",
          "tip_aviz": 2,
          "nume_tip_aviz": "Depozit",
          "has_finished_transport": true,
          "nr_identificare": "MS13FIR",
          "nr_apv": null,
          "provenienta": "DEPOZIT PADURENI",
          "id_aviz": 48792403,
          "volum_total": 0.3,
          "marfa_grupe_specii": "RĂȘINOASE",
          "marfa_specii": "MOLID",
          "marfa_sortimente": "Cherestele",
          "emitent_denumire": "Timber Logistic S.R.L.",
          "emitent_cui": "50481202",
          "transportator_identificator": "MS13FIR",
          "transportator_denumire": "Timber Logistic S.R.L.",
          "transportator_cui": "50481202",
          "transportator_tip": "SUMAL",
          "transportator_non_sumal": false,
          "beneficiar_tip": "FIZICA",
          "destinatar_tip": "FIZICA",
          "valabilitate_emitere": "2026-08-29T06:31:33.534Z",
          "valabilitate_finalizare": "2026-08-29T12:31:33.534Z",
          "tip_marfa": null,
          "angajat": null,
          "remorca": null,
          "identificator_container": null,
          "num_poze": 3,
          "first_seen_date": "2026-09-02T00:00:00.000Z",
          "last_seen_date": "2026-09-02T00:00:00.000Z"
        },
        {
          "cod_aviz": "DC26030859000010819108290940",
          "tip_aviz": 2,
          "nume_tip_aviz": "Depozit",
          "has_finished_transport": true,
          "nr_identificare": "GL76GGG",
          "nr_apv": null,
          "provenienta": "depozit piscu",
          "id_aviz": 48792558,
          "volum_total": 0.9408,
          "marfa_grupe_specii": "RĂȘINOASE",
          "marfa_specii": "MOLID",
          "marfa_sortimente": "Cherestele",
          "emitent_denumire": "Gigi Forest 2012 S.R.L.",
          "emitent_cui": "30168252",
          "transportator_identificator": "GL76GGG",
          "transportator_denumire": "Gigi Forest 2012 S.R.L.",
          "transportator_cui": "30168252",
          "transportator_tip": "SUMAL",
          "transportator_non_sumal": false,
          "beneficiar_tip": "FIZICA",
          "destinatar_tip": "FIZICA",
          "valabilitate_emitere": "2026-08-29T06:40:49.702Z",
          "valabilitate_finalizare": "2026-08-29T08:40:49.702Z",
          "tip_marfa": null,
          "angajat": null,
          "remorca": null,
          "identificator_container": null,
          "num_poze": 3,
          "first_seen_date": "2026-09-02T00:00:00.000Z",
          "last_seen_date": "2026-09-02T00:00:00.000Z"
        }
      ]
    },
    {
      "name": "permit_locations",
      "description": "Where a currently tracked SUMAL timber-transport permit is right now: one row per permit (cod_aviz), carrying the coordinates and the depot/site id the public map itself plots. This is a live snapshot from /api/aviz/locations, not a historical record of every past location: a permit's row reflects the position it had at fetch time, and it stays untouched (not deleted) once the permit drops out of that endpoint's current window.",
      "descriptions": {
        "ro": "Unde este plasat în prezent, pe harta publică, fiecare aviz de transport urmărit: câte un rând pentru fiecare aviz (cod_aviz), cu coordonatele și identificatorul depozitului sau al locului pe care harta însăși le afișează. Acesta este un instantaneu curent, preluat din „/api/aviz/locations”, nu o istorie completă a tuturor locațiilor avute vreodată: un rând reflectă poziția avută la momentul preluării, iar avizul rămâne aici neșters (nu dispare) și după ce iese din fereastra curentă a acelui capăt de API.",
        "en": "Where a currently tracked SUMAL timber-transport permit is right now: one row per permit (cod_aviz), carrying the coordinates and the depot/site id the public map itself plots. This is a live snapshot from /api/aviz/locations, not a historical record of every past location: a permit's row reflects the position it had at fetch time, and it stays untouched (not deleted) once the permit drops out of that endpoint's current window."
      },
      "rowCount": 107588,
      "lastRunRows": 95595,
      "totalBytes": 1098457,
      "sortBy": [
        "tip_aviz",
        "cod_aviz"
      ],
      "searchColumns": [],
      "primaryKey": [
        "cod_aviz"
      ],
      "writeMode": "upsert",
      "storage": "lake",
      "columns": [
        {
          "name": "cod_aviz",
          "type": "VARCHAR",
          "nullable": false,
          "description": "The permit's code (codAviz), e.g. \"DA26022347000207757509020046\". Stable identifier of one timber-transport permit; joins to permits.cod_aviz.",
          "descriptions": {
            "ro": "Codul avizului („codAviz”), de exemplu „DA26022347000207757509020046”. Identificatorul stabil al unui aviz de transport; se leagă de permits.cod_aviz.",
            "en": "The permit's code (codAviz), e.g. \"DA26022347000207757509020046\". Stable identifier of one timber-transport permit; joins to permits.cod_aviz."
          },
          "min": "AP26000051000002293608310842",
          "max": "LC26006777000609773309011459",
          "distinctApprox": 127308
        },
        {
          "name": "id_depozit",
          "type": "BIGINT",
          "nullable": true,
          "description": "SUMAL internal id of the depot or site (idDepozit) this permit is plotted at on the map. SUMAL sends -1 as a sentinel meaning \"not applicable\" (observed on every \"Alte situații\" permit and a scattered few of other types); this column stores that as null rather than a fake numeric id.",
          "descriptions": {
            "ro": "Identificatorul intern SUMAL al depozitului sau al locului („idDepozit”) pe care acest aviz este plasat pe hartă. SUMAL trimite -1 ca valoare-santinelă pentru „nu se aplică” (observată la fiecare aviz de tip „Alte situații” și, ocazional, la alte tipuri); această coloană păstrează acea valoare ca null, nu ca un identificator fals.",
            "en": "SUMAL internal id of the depot or site (idDepozit) this permit is plotted at on the map. SUMAL sends -1 as a sentinel meaning \"not applicable\" (observed on every \"Alte situații\" permit and a scattered few of other types); this column stores that as null rather than a fake numeric id."
          }
        },
        {
          "name": "tip_aviz",
          "type": "INTEGER",
          "nullable": true,
          "description": "Numeric permit-type code as returned by this endpoint (tipAviz): observed values include 1 (harvesting site), 2 (depot), 7, 9 and 10 (other situations). permits.nume_tip_aviz gives the human-readable name for the same code.",
          "descriptions": {
            "ro": "Codul numeric al tipului de aviz, așa cum îl întoarce acest capăt de API („tipAviz”): valorile observate includ 1 (loc de recoltare), 2 (depozit), 7, 9 și 10 (alte situații). permits.nume_tip_aviz dă numele pentru același cod.",
            "en": "Numeric permit-type code as returned by this endpoint (tipAviz): observed values include 1 (harvesting site), 2 (depot), 7, 9 and 10 (other situations). permits.nume_tip_aviz gives the human-readable name for the same code."
          },
          "min": 1,
          "max": 10
        },
        {
          "name": "lat",
          "type": "DOUBLE",
          "nullable": true,
          "description": "Latitude of the plotted location (WGS 84).",
          "descriptions": {
            "ro": "Latitudinea locației afișate (WGS 84).",
            "en": "Latitude of the plotted location (WGS 84)."
          },
          "unit": "degrees"
        },
        {
          "name": "lng",
          "type": "DOUBLE",
          "nullable": true,
          "description": "Longitude of the plotted location (WGS 84).",
          "descriptions": {
            "ro": "Longitudinea locației afișate (WGS 84).",
            "en": "Longitude of the plotted location (WGS 84)."
          },
          "unit": "degrees"
        },
        {
          "name": "first_seen_date",
          "type": "DATE",
          "nullable": false,
          "description": "The first run day (UTC) this permit appeared in the locations endpoint. Maintained automatically by the upsert loader — never overwritten, only widened.",
          "descriptions": {
            "ro": "Prima zi de rulare (UTC) în care acest aviz a apărut la acest capăt de API. Este menținută automat de sistemul de încărcare cu upsert: nu este suprascrisă, doar extinsă.",
            "en": "The first run day (UTC) this permit appeared in the locations endpoint. Maintained automatically by the upsert loader — never overwritten, only widened."
          }
        },
        {
          "name": "last_seen_date",
          "type": "DATE",
          "nullable": false,
          "description": "The most recent run day (UTC) this permit still appeared in the locations endpoint. A permit that has since dropped out (transport finished, or it rolled out of the endpoint's window) keeps its last known position here rather than being deleted.",
          "descriptions": {
            "ro": "Cea mai recentă zi de rulare (UTC) în care acest aviz a mai apărut la acest capăt de API. Un aviz care între timp a ieșit din listă (transport finalizat, sau ieșit din fereastra curentă) își păstrează aici ultima poziție cunoscută, în loc să fie șters.",
            "en": "The most recent run day (UTC) this permit still appeared in the locations endpoint. A permit that has since dropped out (transport finished, or it rolled out of the endpoint's window) keeps its last known position here rather than being deleted."
          }
        }
      ],
      "files": [
        {
          "url": "https://data-directory.fsn1.your-objectstorage.com/public/sumal-timber-permits/v/01M1NQFRMGFMD6ZG1GD0B9BQ29/permit_locations.parquet",
          "sizeBytes": 1098457,
          "rowCount": 107588,
          "etag": "\"c30cddb1423193e7284a6c3ef0bb9c7b\"",
          "stats": {
            "tip_aviz": {
              "min": 1,
              "max": 10
            },
            "cod_aviz": {
              "min": "AP26000051000002293608310842",
              "max": "LC26006777000609773309011459"
            }
          }
        }
      ],
      "example": [
        {
          "cod_aviz": "AP26000051000002293608310842",
          "id_depozit": 863244,
          "tip_aviz": 1,
          "lat": 46.541875,
          "lng": 26.791401,
          "first_seen_date": "2026-09-02T00:00:00.000Z",
          "last_seen_date": "2026-09-02T00:00:00.000Z"
        },
        {
          "cod_aviz": "AP26000051000002293608310934",
          "id_depozit": 916853,
          "tip_aviz": 1,
          "lat": 46.560101,
          "lng": 26.808894,
          "first_seen_date": "2026-09-02T00:00:00.000Z",
          "last_seen_date": "2026-09-02T00:00:00.000Z"
        }
      ]
    }
  ],
  "generatedAt": "2026-09-04T08:18:44.655Z"
}
