Adatkiviteli és infrastruktúra-nyilvántartás
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.2 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 1.2-es verzió külön adatkészleteket ad a terepi dolgozókhoz, látogatásokhoz, tervezéshez, diszpécseri változásokhoz, mobil munkához és GPS-pontokhoz. Az export csak az ügyfélhez ténylegesen tárolt és a megőrzési beállítás szerint még megőrzött adatokat tartalmazza.
- 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őkid, slug, name, status, defaultCurrency, createdAt, updatedAt, deletedAt |
Nincs kapcsolat |
users |
account/users.ndjson |
id |
6 Mezőkid, email, fullName, status, createdAt, updatedAt |
Nincs kapcsolat |
memberships |
account/memberships.ndjson |
id |
6 Mezőkid, userId, roleCode, status, createdAt, updatedAt |
userId -> users.id |
entitlements |
account/entitlements.ndjson |
id |
6 Mezőkid, 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őkid, customerId, name, email, phone, status, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt |
sourceFeedId -> import-sources.id |
customer-locations |
master/customer-locations.ndjson |
id |
14 Mezőkid, 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őkid, depotCode, name, address, latitude, longitude, type, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt |
sourceFeedId -> import-sources.id |
carriers |
master/carriers.ndjson |
id |
7 Mezőkid, code, name, type, customerSpecific, createdAt, updatedAt |
Nincs kapcsolat |
drivers |
master/drivers.ndjson |
id |
10 Mezőkid, driverId, name, email, phone, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt |
sourceFeedId -> import-sources.id |
vehicles |
master/vehicles.ndjson |
id |
10 Mezőkid, vehicleId, registrationNumber, name, vehicleType, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt |
sourceFeedId -> import-sources.id |
field-workers |
master/field-workers.ndjson |
id |
15 Mezőkid, workerId, userId, driverId, name, email, phone, status, homeDepotId, timeZone, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt |
userId -> users.id; driverId -> drivers.id; homeDepotId -> depots.id; sourceFeedId -> import-sources.id |
skills |
master/skills.ndjson |
id |
8 Mezőkid, code, name, description, status, createdAt, updatedAt, deletedAt |
Nincs kapcsolat |
field-worker-skills |
master/field-worker-skills.ndjson |
id |
8 Mezőkid, fieldWorkerId, skillId, level, validFrom, validTo, createdAt, updatedAt |
fieldWorkerId -> field-workers.id; skillId -> skills.id |
field-worker-availability |
master/field-worker-availability.ndjson |
id |
8 Mezőkid, fieldWorkerId, availableFrom, availableTo, availabilityType, note, createdAt, updatedAt |
fieldWorkerId -> field-workers.id |
worker-resources |
master/worker-resources.ndjson |
id |
9 Mezőkid, fieldWorkerId, vehicleId, resourceType, resourceCode, validFrom, validTo, createdAt, updatedAt |
fieldWorkerId -> field-workers.id; vehicleId -> vehicles.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őkid, 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őkid, 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őkid, orderId, shipmentId, relationType, createdAt |
orderId -> orders.id; shipmentId -> shipments.id |
carrier-accounts |
logistics/carrier-accounts.ndjson |
id |
7 Mezőkid, carrierId, name, authType, status, createdAt, updatedAt |
carrierId -> carriers.id |
parcels |
logistics/parcels.ndjson |
id |
13 Mezőkid, 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őkid, 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 |
21 Mezőkid, routeId, routeCode, routeDate, depotId, driverId, vehicleId, status, plannedStartAt, plannedEndAt, actualStartAt, actualEndAt, plannedDistanceKm, actualDistanceKm, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt, dispatchPlanVersionId, planningRunId |
depotId -> depots.id; driverId -> drivers.id; vehicleId -> vehicles.id; sourceFeedId -> import-sources.id; dispatchPlanVersionId -> dispatch-plan-versions.id; planningRunId -> optimisation-runs.id |
route-stops |
operations/route-stops.ndjson |
id |
22 Mezőkid, routeId, orderId, customerLocationId, sequence, stopType, plannedArrivalAt, actualArrivalAt, plannedDepartureAt, actualDepartureAt, address, latitude, longitude, status, sourceData, createdAt, updatedAt, serviceVisitId, dispatchPlanVersionId, timeWindowStart, timeWindowEnd, plannedServiceDurationSeconds |
routeId -> routes.id; orderId -> orders.id; customerLocationId -> customer-locations.id; serviceVisitId -> service-visits.id; dispatchPlanVersionId -> dispatch-plan-versions.id |
telematics-activities |
operations/telematics-activities.ndjson |
id |
13 Mezőkid, 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őkid, routeId, telematicsActivityId, driverId, vehicleId, matchMethod, confidence, allocatedDistanceKm, allocatedDurationSeconds, note, createdAt, updatedAt |
routeId -> routes.id; telematicsActivityId -> telematics-activities.id; driverId -> drivers.id; vehicleId -> vehicles.id |
telematics-location-points |
operations/telematics-location-points.ndjson |
id |
20 Mezőkid, tenantId, occurredAt, receivedAt, fieldWorkerId, driverId, vehicleId, mobileDeviceId, trackingSessionId, routeId, serviceVisitId, latitude, longitude, accuracyM, speedMps, headingDegrees, altitudeM, source, sequenceNo, createdAt |
tenantId -> tenant.id; fieldWorkerId -> field-workers.id; driverId -> drivers.id; vehicleId -> vehicles.id; mobileDeviceId -> mobile-devices.id; trackingSessionId -> location-tracking-sessions.id; routeId -> routes.id; serviceVisitId -> service-visits.id |
derived-route-geometries |
operations/derived-route-geometries.ndjson |
id |
12 Mezőkid, trackingSessionId, routeId, fieldWorkerId, vehicleId, startedAt, endedAt, encodedGeometry, distanceKm, pointCount, calculationMethod, createdAt |
trackingSessionId -> location-tracking-sessions.id; routeId -> routes.id; fieldWorkerId -> field-workers.id; vehicleId -> vehicles.id |
Terepi munkák, tervezés és mobil munkavégzés
| Adatkészlet | Csomagfájl | Elsődleges kulcs | Mezők | Kapcsolatok |
|---|---|---|---|---|
service-jobs |
field/service-jobs.ndjson |
id |
14 Mezőkid, jobId, customerId, customerLocationId, orderId, title, description, priority, status, requiredSkills, requiredResources, createdAt, updatedAt, deletedAt |
customerId -> customers.id; customerLocationId -> customer-locations.id; orderId -> orders.id |
service-visits |
field/service-visits.ndjson |
id |
16 Mezőkid, visitId, serviceJobId, customerLocationId, status, priority, timeWindowStart, timeWindowEnd, plannedDurationSeconds, actualStartAt, actualEndAt, assignedFieldWorkerId, assignedVehicleId, createdAt, updatedAt, deletedAt |
serviceJobId -> service-jobs.id; customerLocationId -> customer-locations.id; assignedFieldWorkerId -> field-workers.id; assignedVehicleId -> vehicles.id |
dispatch-plans |
field/dispatch-plans.ndjson |
id |
9 Mezőkid, planId, serviceDate, status, timeZone, publishedVersionId, createdByUserId, createdAt, updatedAt |
publishedVersionId -> dispatch-plan-versions.id; createdByUserId -> users.id |
dispatch-plan-versions |
field/dispatch-plan-versions.ndjson |
id |
9 Mezőkid, dispatchPlanId, versionNumber, status, source, optimisationRunId, publishedAt, createdByUserId, createdAt |
dispatchPlanId -> dispatch-plans.id; optimisationRunId -> optimisation-runs.id; createdByUserId -> users.id |
dispatch-assignments |
field/dispatch-assignments.ndjson |
id |
12 Mezőkid, dispatchPlanVersionId, serviceVisitId, fieldWorkerId, vehicleId, routeId, sequence, plannedArrivalAt, plannedDepartureAt, status, createdAt, updatedAt |
dispatchPlanVersionId -> dispatch-plan-versions.id; serviceVisitId -> service-visits.id; fieldWorkerId -> field-workers.id; vehicleId -> vehicles.id; routeId -> routes.id |
dispatch-events |
field/dispatch-events.ndjson |
id |
9 Mezőkid, dispatchPlanId, dispatchPlanVersionId, eventType, actorUserId, actorFieldWorkerId, occurredAt, details, createdAt |
dispatchPlanId -> dispatch-plans.id; dispatchPlanVersionId -> dispatch-plan-versions.id; actorUserId -> users.id; actorFieldWorkerId -> field-workers.id |
dispatch-exceptions |
field/dispatch-exceptions.ndjson |
id |
14 Mezőkid, dispatchPlanId, serviceVisitId, fieldWorkerId, vehicleId, type, severity, status, message, detectedAt, resolvedAt, details, createdAt, updatedAt |
dispatchPlanId -> dispatch-plans.id; serviceVisitId -> service-visits.id; fieldWorkerId -> field-workers.id; vehicleId -> vehicles.id |
optimisation-runs |
field/optimisation-runs.ndjson |
id |
13 Mezőkid, runId, productCode, serviceDate, status, triggerType, matrixProvider, vehicleCount, visitCount, startedAt, finishedAt, requestedByUserId, createdAt |
requestedByUserId -> users.id |
optimisation-run-inputs |
field/optimisation-run-inputs.ndjson |
id |
6 Mezőkid, optimisationRunId, inputType, entityId, inputData, createdAt |
optimisationRunId -> optimisation-runs.id |
optimisation-run-results |
field/optimisation-run-results.ndjson |
id |
7 Mezőkid, optimisationRunId, resultType, entityId, sequence, resultData, createdAt |
optimisationRunId -> optimisation-runs.id |
visit-status-events |
field/visit-status-events.ndjson |
id |
9 Mezőkid, serviceVisitId, fieldWorkerId, status, occurredAt, latitude, longitude, note, createdAt |
serviceVisitId -> service-visits.id; fieldWorkerId -> field-workers.id |
work-logs |
field/work-logs.ndjson |
id |
10 Mezőkid, serviceVisitId, fieldWorkerId, startedAt, endedAt, durationSeconds, workType, note, createdAt, updatedAt |
serviceVisitId -> service-visits.id; fieldWorkerId -> field-workers.id |
checklist-responses |
field/checklist-responses.ndjson |
id |
10 Mezőkid, serviceVisitId, fieldWorkerId, checklistCode, itemCode, responseType, responseValue, answeredAt, createdAt, updatedAt |
serviceVisitId -> service-visits.id; fieldWorkerId -> field-workers.id |
visit-notes |
field/visit-notes.ndjson |
id |
8 Mezőkid, serviceVisitId, authorUserId, authorFieldWorkerId, note, visibility, createdAt, updatedAt |
serviceVisitId -> service-visits.id; authorUserId -> users.id; authorFieldWorkerId -> field-workers.id |
material-usages |
field/material-usages.ndjson |
id |
9 Mezőkid, serviceVisitId, fieldWorkerId, materialCode, description, quantity, unit, createdAt, updatedAt |
serviceVisitId -> service-visits.id; fieldWorkerId -> field-workers.id |
proof-of-service |
field/proof-of-service.ndjson |
id |
8 Mezőkid, serviceVisitId, type, fileId, capturedAt, capturedByFieldWorkerId, metadata, createdAt |
serviceVisitId -> service-visits.id; fileId -> original-files.id; capturedByFieldWorkerId -> field-workers.id |
customer-confirmations |
field/customer-confirmations.ndjson |
id |
8 Mezőkid, serviceVisitId, confirmationType, confirmedByName, confirmedAt, signatureFileId, note, createdAt |
serviceVisitId -> service-visits.id; signatureFileId -> original-files.id |
mobile-devices |
field/mobile-devices.ndjson |
id |
10 Mezőkid, fieldWorkerId, platform, appVersion, deviceModel, status, firstSeenAt, lastSeenAt, createdAt, updatedAt |
fieldWorkerId -> field-workers.id |
location-tracking-sessions |
field/location-tracking-sessions.ndjson |
id |
12 Mezőkid, fieldWorkerId, driverId, vehicleId, mobileDeviceId, routeId, startedAt, endedAt, status, pointIntervalSeconds, createdAt, updatedAt |
fieldWorkerId -> field-workers.id; driverId -> drivers.id; vehicleId -> vehicles.id; mobileDeviceId -> mobile-devices.id; routeId -> routes.id |
customer-notification-events |
field/customer-notification-events.ndjson |
id |
10 Mezőkid, serviceVisitId, channel, templateCode, status, recipientMasked, sentAt, deliveredAt, failedAt, createdAt |
serviceVisitId -> service-visits.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őkid, 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őkid, 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őkid, 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őkid, entityType, key, label, description, dataType, visibleInReports, searchable, filterable, createdAt, updatedAt, deletedAt |
Nincs kapcsolat |
custom-field-values |
extensions/custom-field-values.ndjson |
id |
7 Mezőkid, 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őkid, type, name, status, billingStatus, activeFrom, activeTo, portableConfiguration, createdAt, updatedAt |
Nincs kapcsolat |
import-sources |
integrations/import-sources.ndjson |
id |
18 Mezőkid, 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őkid, 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őkid, 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őkid, 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őkid, 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őkid, 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őkid, 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őkid, 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őkid, name, module, queryConfiguration, columnsConfiguration, filtersConfiguration, createdByUserId, createdAt, updatedAt |
createdByUserId -> users.id |
scheduled-reports |
reports/scheduled-reports.ndjson |
id |
9 Mezőkid, reportDefinitionId, frequency, recipients, format, enabled, lastSentAt, createdAt, updatedAt |
reportDefinitionId -> report-definitions.id |
export-jobs |
reports/export-jobs.ndjson |
id |
8 Mezőkid, 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őktenantId, 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őkid, provider, type, cardBrand, cardLast4, cardExpiryMonth, cardExpiryYear, status, default, testMode, removedAt, createdAt, updatedAt |
Nincs kapcsolat |
subscriptions |
billing/subscriptions.ndjson |
id |
17 Mezőkid, 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őkid, productType, productCode, action, activeTo, unitPrice, currency, prorated, createdByUserId, createdAt |
createdByUserId -> users.id |
monthly-usage |
billing/monthly-usage.ndjson |
id |
14 Mezőkid, periodStart, periodEnd, processedUnits, orders, shipments, parcels, createdAt, updatedAt, serviceVisits, successfulPlanRuns, successfulRoutesRuns, activeVehicleDays, activeWorkerDays |
Nincs kapcsolat |
subscription-usage-segments |
billing/subscription-usage-segments.ndjson |
id |
22 Mezőkid, subscriptionId, periodStart, periodEnd, activeFrom, activeTo, billableDays, periodDays, monthlyUnitPrice, accruedAmount, currency, status, billingItemKey, createdAt, updatedAt, quantity, unit, dailyUnitPrice, activeVehicleCount, activeWorkerCount, usageDate, productCode |
subscriptionId -> subscriptions.id |
invoices |
billing/invoices.ndjson |
id |
29 Mezőkid, 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őkid, 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őkid, 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őkid, 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őkid, importFileId, originalFilename, packagePath, mediaType, sizeBytes, sha256, createdAt, rawExpiresAt |
importFileId -> import-files.id |
original-files |
files/original/* |
packagePath |
1 Mezőkbinary 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.2-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. 29. — 1.2-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ő.