Nodali Jogi információk

Adatkiviteli és infrastruktúra-nyilvántartás

Az exportformátum-nyilvántartás verziója: 1.1
Hatályos: 2026. 07. 22.
Frissítve: 2026. 07. 22.

Az ügyféladat-export hatókörének, formátumainak, kapcsolatainak, korlátainak és infrastruktúra-országainak aktuális nyilvános leírása.

Az 1.1 géppel olvasható exportspecifikáció letöltése (JSON)

1. A nyilvántartás célja és hatóköre

A nyilvántartás a Nodali ügyféladatainak standard, hordozható exportját írja le. Működési specifikáció, nem a production adatbázisséma közzététele és nem jogi feltételek verziója. A konkrét hatókör az aktív moduloktól, az ügyfél jogaitól és az ellenőrzött kérelemtől függ.

2. Az export jelenlegi átadási módja

A standard export jogosult ügyfél kérésére készül, és a portál biztonságos letöltésével vagy más egyeztetett biztonságos módon kerül átadásra. A mód az adatok körétől és mennyiségétől függhet.

A jelenlegi verzió nem garantál nyilvános önkiszolgáló export-API-t.

Az EU Data Act szerinti szabályok, határidők és szolgáltatóváltás

3. Exportálható adatkategóriák

Az aktív modulok és jogosultságok szerint különösen:

Az üzemekhez és kapacitásokhoz az 1.1-es verzióban nincs külön adatkészlet. Ha szerepelnek a fiókban, a depók, útvonalak, járművek és más kapcsolódó objektumok megfelelő attribútumaiban, forrásadataiban vagy egyedi mezőiben kerülnek átadásra; helyüket a jegyzék rögzíti.

az ügyfél által átadott bemeneti adatok;
rendelések, küldemények és ügyfélazonosítók;
fuvarozók, működési státuszok és ügyfél szempontjából releváns előzményeik;
útvonalak, depók, telephelyek és kapacitások;
költség- és számlázási adatok;
tenantkonfiguráció, importmappingek és konnektorbeállítások;
felhasználók, szerepkörök és jogosultságok biztonságosan hordozható köre;
eredmények, jelentések és ügyfélmetaadatok;
az ügyfél által feltöltött, jogszerűen átvehető fájlok.
A technikai duplikátumokat nem kell ismételten exportálni. Ugyanazon objektum frissítése nem új objektum, ha a releváns előzmény megmarad.
Az üzemeltető belső működési és biztonsági adatai nem részei az exportnak.

Az alábbi katalógus a szabványos hordozható csomag műszaki specifikációja. Egy konkrét export csak azokat az adatkészleteket tartalmazza, amelyekhez az ügyfélnek adata és jogosultsága van.

Fiók, hozzáférés és aktív szolgáltatások

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`tenant`	`account/tenant.ndjson`	`id`	8 Mezők `id, slug, name, status, defaultCurrency, createdAt, updatedAt, deletedAt`	Nincs kapcsolat
`users`	`account/users.ndjson`	`id`	6 Mezők `id, email, fullName, status, createdAt, updatedAt`	Nincs kapcsolat
`memberships`	`account/memberships.ndjson`	`id`	6 Mezők `id, userId, roleCode, status, createdAt, updatedAt`	userId -> users.id
`entitlements`	`account/entitlements.ndjson`	`id`	6 Mezők `id, moduleCode, status, enabledAt, createdAt, updatedAt`	Nincs kapcsolat

Ügyfél- és működési törzsadatok

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`customers`	`master/customers.ndjson`	`id`	11 Mezők `id, customerId, name, email, phone, status, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id
`customer-locations`	`master/customer-locations.ndjson`	`id`	14 Mezők `id, customerId, locationCode, name, address, latitude, longitude, defaultUnloadingMinutes, accessNote, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	customerId -> customers.id; sourceFeedId -> import-sources.id
`depots`	`master/depots.ndjson`	`id`	12 Mezők `id, depotCode, name, address, latitude, longitude, type, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id
`carriers`	`master/carriers.ndjson`	`id`	7 Mezők `id, code, name, type, customerSpecific, createdAt, updatedAt`	Nincs kapcsolat
`drivers`	`master/drivers.ndjson`	`id`	10 Mezők `id, driverId, name, email, phone, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id
`vehicles`	`master/vehicles.ndjson`	`id`	10 Mezők `id, vehicleId, registrationNumber, name, vehicleType, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id

Rendelések, küldemények, csomagok és nyomkövetés

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`orders`	`logistics/orders.ndjson`	`id`	15 Mezők `id, orderId, customerId, customerLocationId, depotId, status, orderCreatedAt, promisedDeliveryAt, sourceFeedId, firstSeenAt, lastSeenAt, sourceData, createdAt, updatedAt, deletedAt`	customerId -> customers.id; customerLocationId -> customer-locations.id; depotId -> depots.id; sourceFeedId -> import-sources.id
`shipments`	`logistics/shipments.ndjson`	`id`	14 Mezők `id, shipmentId, status, carrierId, shippingMethod, originDepotId, promisedDeliveryAt, handedOverAt, deliveredAt, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	carrierId -> carriers.id; originDepotId -> depots.id; sourceFeedId -> import-sources.id
`order-shipments`	`logistics/order-shipments.ndjson`	`id`	5 Mezők `id, orderId, shipmentId, relationType, createdAt`	orderId -> orders.id; shipmentId -> shipments.id
`carrier-accounts`	`logistics/carrier-accounts.ndjson`	`id`	7 Mezők `id, carrierId, name, authType, status, createdAt, updatedAt`	carrierId -> carriers.id
`parcels`	`logistics/parcels.ndjson`	`id`	13 Mezők `id, shipmentId, carrierId, carrierAccountId, trackingNumber, status, lastTrackingEventAt, deliveredAt, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	shipmentId -> shipments.id; carrierId -> carriers.id; carrierAccountId -> carrier-accounts.id; sourceFeedId -> import-sources.id
`tracking-events`	`logistics/tracking-events.ndjson`	`id`	13 Mezők `id, parcelId, carrierId, carrierAccountId, trackingNumber, eventTime, rawStatus, normalizedStatus, location, countryCode, sourceFeedId, sourceData, createdAt`	parcelId -> parcels.id; carrierId -> carriers.id; carrierAccountId -> carrier-accounts.id; sourceFeedId -> import-sources.id

Útvonalak, megállók és telematika

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`routes`	`operations/routes.ndjson`	`id`	19 Mezők `id, routeId, routeCode, routeDate, depotId, driverId, vehicleId, status, plannedStartAt, plannedEndAt, actualStartAt, actualEndAt, plannedDistanceKm, actualDistanceKm, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	depotId -> depots.id; driverId -> drivers.id; vehicleId -> vehicles.id; sourceFeedId -> import-sources.id
`route-stops`	`operations/route-stops.ndjson`	`id`	17 Mezők `id, routeId, orderId, customerLocationId, sequence, stopType, plannedArrivalAt, actualArrivalAt, plannedDepartureAt, actualDepartureAt, address, latitude, longitude, status, sourceData, createdAt, updatedAt`	routeId -> routes.id; orderId -> orders.id; customerLocationId -> customer-locations.id
`telematics-activities`	`operations/telematics-activities.ndjson`	`id`	13 Mezők `id, driverId, vehicleId, activityDate, startedAt, finishedAt, distanceKm, durationSeconds, engineOnSeconds, sourceFeedId, sourceData, createdAt, updatedAt`	driverId -> drivers.id; vehicleId -> vehicles.id; sourceFeedId -> import-sources.id
`route-activity-matches`	`operations/route-activity-matches.ndjson`	`id`	12 Mezők `id, routeId, telematicsActivityId, driverId, vehicleId, matchMethod, confidence, allocatedDistanceKm, allocatedDurationSeconds, note, createdAt, updatedAt`	routeId -> routes.id; telematicsActivityId -> telematics-activities.id; driverId -> drivers.id; vehicleId -> vehicles.id

Költségek és működési kivételek

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`costs`	`finance/costs.ndjson`	`id`	19 Mezők `id, costId, relatedEntityType, relatedEntityId, orderId, shipmentId, parcelId, routeId, carrierId, depotId, customerId, costType, amount, currency, costDate, sourceFeedId, sourceData, createdAt, updatedAt`	orderId -> orders.id; shipmentId -> shipments.id; parcelId -> parcels.id; routeId -> routes.id; carrierId -> carriers.id; depotId -> depots.id; customerId -> customers.id; sourceFeedId -> import-sources.id
`exceptions`	`quality/exceptions.ndjson`	`id`	18 Mezők `id, entityType, entityId, orderId, shipmentId, parcelId, routeId, carrierId, type, severity, status, message, detectedAt, resolvedAt, source, details, createdAt, updatedAt`	orderId -> orders.id; shipmentId -> shipments.id; parcelId -> parcels.id; routeId -> routes.id; carrierId -> carriers.id

Egyedi mezők és külső hivatkozások

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`external-references`	`extensions/external-references.ndjson`	`id`	9 Mezők `id, entityType, entityId, sourceFeedId, sourceSystemName, externalKey, externalValue, createdAt, updatedAt`	sourceFeedId -> import-sources.id; entityId -> entity identified by entityType
`custom-field-definitions`	`extensions/custom-field-definitions.ndjson`	`id`	12 Mezők `id, entityType, key, label, description, dataType, visibleInReports, searchable, filterable, createdAt, updatedAt, deletedAt`	Nincs kapcsolat
`custom-field-values`	`extensions/custom-field-values.ndjson`	`id`	7 Mezők `id, definitionId, entityType, entityId, value, createdAt, updatedAt`	definitionId -> custom-field-definitions.id; entityId -> entity identified by entityType

Integrációk, importok, leképezés és párosítás

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`integrations`	`integrations/integrations.ndjson`	`id`	10 Mezők `id, type, name, status, billingStatus, activeFrom, activeTo, portableConfiguration, createdAt, updatedAt`	Nincs kapcsolat
`import-sources`	`integrations/import-sources.ndjson`	`id`	18 Mezők `id, integrationId, name, description, connectorType, status, sourceLabel, rawRetentionDays, dependencyTimeoutHours, allowedSenders, expectedFrequency, lastReceivedAt, lastProcessedAt, activeFrom, activeTo, createdAt, updatedAt, deletedAt`	integrationId -> integrations.id
`import-file-rules`	`integrations/import-file-rules.ndjson`	`id`	12 Mezők `id, importSourceId, name, filenamePattern, fileType, targetEntity, mappingProfileId, required, enabled, sortOrder, createdAt, updatedAt`	importSourceId -> import-sources.id; mappingProfileId -> mapping-profiles.id
`import-runs`	`integrations/import-runs.ndjson`	`id`	13 Mezők `id, importSourceId, triggerType, status, startedAt, finishedAt, recordsReceived, recordsValid, recordsWarning, recordsFailed, message, createdAt, updatedAt`	importSourceId -> import-sources.id
`import-files`	`integrations/import-files.ndjson`	`id`	15 Mezők `id, importRunId, importSourceId, fileRuleId, originalFilename, fileType, contentType, sizeBytes, sha256, status, errorMessage, rawExpiresAt, rawDeletedAt, createdAt, updatedAt`	importRunId -> import-runs.id; importSourceId -> import-sources.id; fileRuleId -> import-file-rules.id
`import-row-results`	`integrations/import-row-results.ndjson`	`id`	13 Mezők `id, importFileId, rowNumber, status, targetEntity, targetEntityId, sourceData, mappedData, errors, dependencyWaitStartedAt, rawExpiresAt, rawDeletedAt, createdAt`	importFileId -> import-files.id; targetEntityId -> entity identified by targetEntity
`mapping-profiles`	`integrations/mapping-profiles.ndjson`	`id`	17 Mezők `id, importSourceId, name, targetEntity, status, version, delimiter, decimalSeparator, dateFormat, timezone, identityTargetField, identityRequired, identityConfiguration, dependencyConfiguration, activatedAt, createdAt, updatedAt`	importSourceId -> import-sources.id
`mapping-rules`	`integrations/mapping-rules.ndjson`	`id`	16 Mezők `id, mappingProfileId, sourceField, targetType, targetField, customFieldDefinitionId, externalKey, transformType, transformConfiguration, required, identity, defaultValue, visibleInReports, sortOrder, createdAt, updatedAt`	mappingProfileId -> mapping-profiles.id; customFieldDefinitionId -> custom-field-definitions.id
`matching-rules`	`integrations/matching-rules.ndjson`	`id`	17 Mezők `id, importSourceId, name, leftSource, leftEntityType, leftField, rightSource, rightEntityType, rightField, targetEntity, matchType, configuration, priority, confidenceThreshold, enabled, createdAt, updatedAt`	importSourceId -> import-sources.id

Jelentések és exportelőzmények

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`report-definitions`	`reports/report-definitions.ndjson`	`id`	9 Mezők `id, name, module, queryConfiguration, columnsConfiguration, filtersConfiguration, createdByUserId, createdAt, updatedAt`	createdByUserId -> users.id
`scheduled-reports`	`reports/scheduled-reports.ndjson`	`id`	9 Mezők `id, reportDefinitionId, frequency, recipients, format, enabled, lastSentAt, createdAt, updatedAt`	reportDefinitionId -> report-definitions.id
`export-jobs`	`reports/export-jobs.ndjson`	`id`	8 Mezők `id, reportDefinitionId, exportType, format, status, createdByUserId, createdAt, finishedAt`	reportDefinitionId -> report-definitions.id; createdByUserId -> users.id

Előfizetések, használat, számlák és fizetések

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`billing-profile`	`billing/billing-profile.ndjson`	`tenantId`	19 Mezők `tenantId, billingName, companyId, vatId, billingEmail, contactEmail, contactPhone, billingPhone, billingAddress, registrationCountryCode, billingCountryCode, customerType, invoiceLanguage, taxRegime, paymentMode, currency, paymentTermsDays, createdAt, updatedAt`	tenantId -> tenant.id
`payment-methods`	`billing/payment-methods.ndjson`	`id`	13 Mezők `id, provider, type, cardBrand, cardLast4, cardExpiryMonth, cardExpiryYear, status, default, testMode, removedAt, createdAt, updatedAt`	Nincs kapcsolat
`subscriptions`	`billing/subscriptions.ndjson`	`id`	17 Mezők `id, productType, productCode, status, quantity, unitPrice, currency, activeFrom, currentPeriodStart, currentPeriodEnd, cancelAtPeriodEnd, cancelRequestedAt, cancelledAt, endedAt, createdByUserId, createdAt, updatedAt`	createdByUserId -> users.id
`subscription-events`	`billing/subscription-events.ndjson`	`id`	10 Mezők `id, productType, productCode, action, activeTo, unitPrice, currency, prorated, createdByUserId, createdAt`	createdByUserId -> users.id
`monthly-usage`	`billing/monthly-usage.ndjson`	`id`	9 Mezők `id, periodStart, periodEnd, processedUnits, orders, shipments, parcels, createdAt, updatedAt`	Nincs kapcsolat
`subscription-usage-segments`	`billing/subscription-usage-segments.ndjson`	`id`	15 Mezők `id, subscriptionId, periodStart, periodEnd, activeFrom, activeTo, billableDays, periodDays, monthlyUnitPrice, accruedAmount, currency, status, billingItemKey, createdAt, updatedAt`	subscriptionId -> subscriptions.id
`invoices`	`billing/invoices.ndjson`	`id`	29 Mezők `id, invoiceNumber, externalInvoiceId, invoiceType, status, subtotal, tax, total, currency, accountingCurrency, exchangeRate, issuedAt, dueAt, taxableSupplyAt, servicePeriodStart, servicePeriodEnd, paidAt, cancelledAt, variableSymbol, paymentReference, invoiceLanguage, taxRegime, reverseCharge, supplier, customer, vatValidationStatus, taxLegalNoteCode, taxReasonCode, createdAt`	Nincs kapcsolat
`invoice-items`	`billing/invoice-items.ndjson`	`id`	21 Mezők `id, invoiceId, lineNumber, productType, productCode, description, servicePeriodStart, servicePeriodEnd, quantity, unit, unitPrice, netAmount, taxRate, taxAmount, grossAmount, currency, prorated, subscriptionId, subscriptionEventId, metadata, createdAt`	invoiceId -> invoices.id; subscriptionId -> subscriptions.id; subscriptionEventId -> subscription-events.id
`payments`	`billing/payments.ndjson`	`id`	15 Mezők `id, invoiceId, provider, providerPaymentId, type, status, amount, currency, description, testMode, paidAt, cancelledAt, failedAt, createdAt, updatedAt`	invoiceId -> invoices.id
`payment-refunds`	`billing/payment-refunds.ndjson`	`id`	14 Mezők `id, paymentId, invoiceId, provider, providerRefundId, status, amount, currency, reason, requestedByUserId, requestedAt, processedAt, createdAt, updatedAt`	paymentId -> payments.id; invoiceId -> invoices.id; requestedByUserId -> users.id

Eredeti ügyfélfájlok

Adatkészlet	Csomagfájl	Elsődleges kulcs	Mezők	Kapcsolatok
`file-index`	`files/index.ndjson`	`id`	9 Mezők `id, importFileId, originalFilename, packagePath, mediaType, sizeBytes, sha256, createdAt, rawExpiresAt`	importFileId -> import-files.id
`original-files`	`files/original/*`	`packagePath`	1 Mezők `binary content in the original retained format`	packagePath -> file-index.packagePath

4. Kimeneti fájlok és formátumok

A jegyzék tartalmazza a specifikáció verzióját, a hatókört, minden bevont és kihagyott adatkészletet, rekordszámot, figyelmeztetést és ellenőrző összeget.

Átadási csomag: ZIP.
Csomagjegyzék: UTF-8 manifest.json.
Strukturált adatok: JSON Lines (NDJSON), soronként egy objektum.
Megőrzött eredeti ügyfélfájlok: eredeti formátumban a files/original/ alatt.
Dátum és idő: RFC 3339 / ISO 8601 időeltolással; dátum YYYY-MM-DD.
Fix pontosságú számok ponttal írt sztringként; pénzértékek ISO 4217 pénznemmel.
Minden fájl SHA-256 ellenőrző összege a jegyzékben.

5. Objektumok közötti kapcsolatok

A rendeléseket, küldeményeket, ügyfeleket, fuvarozókat, útvonalakat, telephelyeket és más objektumokat stabil azonosítók és a manifestben leírt hivatkozások kapcsolják össze. A releváns előzmény megmarad anélkül, hogy minden technikai frissítés új objektum lenne.

6. Az exportformátum verziója

A nyilvántartás és az exportformátum 1.1-es verziója 2026. 07. 22-től hatályos, és elkülönül a szerződéses dokumentumok verzióitól. A fájlnevek, kötelező mezők, jelentések vagy kapcsolatok változása új verziót igényel; opcionális mező visszafelé kompatibilisen hozzáadható.

7. Ismert korlátok

Csak az aktív modulokban elérhető és az ügyfél jogkörébe tartozó adatok szerepelnek.
Nagy vagy összetett exporthoz egyedileg egyeztetett biztonságos átadás szükséges lehet.
Önkiszolgáló API és rögzített elkészítési idő nem garantált.
Forráskód, algoritmusok, belső biztonsági naplók, hitelesítő adatok és más ügyfelek adatai kizártak.
A nyilvántartás nem teljes production adatbázisséma.

8. Infrastruktúra és joghatóság

Az alkalmazás és a PostgreSQL Dockerben, a VEDOS (korábban WEDOS) csehországi VPS-én fut. A mentések a Progity csehországi székhelyén lévő saját NAS-on vannak. A feltüntetett adatkezelés cseh joghatóság alá tartozik; IP-cím, pontos fizikai cím, hozzáférési adat és hálózati topológia nem nyilvános.

Infrastruktúra típusa	Ország / joghatóság	EU/EGT
Docker-alkalmazás — VEDOS VPS	Cseh Köztársaság	Igen
PostgreSQL Dockerben — VEDOS VPS	Cseh Köztársaság	Igen
Mentések — saját NAS a Progity székhelyén	Cseh Köztársaság	Igen

A hozzáférést szerepkörök és jogosultságok szabályozzák; a kliens–szerver kommunikáció HTTPS-t használ.

A hatósági kérelmek jogi vizsgálaton esnek át. Harmadik ország hatóságának nem adunk át adatot az uniós vagy az illetékes tagállami joggal ellentétesen; arányos műszaki, szervezési és szerződéses intézkedéseket alkalmazunk.

9. A nyilvántartás változástörténete

2026. 07. 22. — 1.1-es verzió: közzétett ZIP/JSONL-formátum, adatkészlet-, mező-, kapcsolat- és biztonsági kizárási katalógus.
2026. 07. 21. — 1.0 verzió: első közzététel.

10. Kapcsolat

Exportkérelmet vagy kérdést jogosult portálfiókból vagy a hello@noda.li címen lehet benyújtani. Az adatátadás előtt a kérelem észszerűen ellenőrizhető.