Rejestr eksportu danych i infrastruktury

Wersja rejestru formatu eksportu: 1.1
Obowiązuje od: 22.07.2026
Aktualizacja: 22.07.2026

Aktualny publiczny opis zakresu, formatów, relacji, ograniczeń i państw infrastruktury używanej do eksportu danych klientów.

Pobierz maszynowo czytelną specyfikację eksportu 1.1 (JSON)

1. Cel i zakres rejestru

Rejestr opisuje standardowy przenośny eksport danych klienta z Nodali. Jest specyfikacją operacyjną, a nie publikacją produkcyjnego schematu bazy ani wersją dokumentów prawnych. Zakres zależy od aktywnych modułów, praw klienta i zweryfikowanego wniosku.

2. Aktualny sposób udostępnienia eksportu

Standardowy eksport przygotowujemy na wniosek uprawnionego klienta i udostępniamy bezpiecznie w portalu albo inną uzgodnioną bezpieczną metodą. Sposób może zależeć od zakresu i wolumenu danych.

W bieżącej wersji nie gwarantujemy publicznie samoobsługowego API eksportowego.

Zasady, terminy i zmiana dostawcy według EU Data Act

3. Kategorie danych eksportowalnych

Zależnie od modułów i uprawnień eksport może obejmować:

Zakłady i moce nie mają w wersji 1.1 osobnego zbioru. Jeśli występują na koncie, są przekazywane w odpowiednich atrybutach, danych źródłowych lub polach niestandardowych depotów, tras, pojazdów i innych powiązanych obiektów; manifest wskazuje ich umiejscowienie.

dane wejściowe dostarczone przez klienta;
zamówienia, przesyłki i identyfikatory klientów;
przewoźników, statusy operacyjne i historię istotną dla klienta;
trasy, depoty, zakłady i moce;
dane kosztowe i rozliczeniowe;
konfigurację tenantu, mapowania importu i konfigurację konektorów;
użytkowników, role i uprawnienia w bezpiecznie przenośnym zakresie;
wyniki, raporty i metadane klienta;
pliki przesłane przez klienta, jeśli ma prawo je otrzymać.
Duplikaty techniczne nie muszą być eksportowane wielokrotnie. Aktualizacja tego samego obiektu nie jest nowym obiektem, jeśli zachowano istotną historię.
Wewnętrzne dane operacyjne i bezpieczeństwa operatora są wyłączone.

Poniższy katalog jest techniczną specyfikacją standardowego pakietu przenośnego. Konkretny eksport zawiera tylko zbiory, do których klient ma dane i uprawnienia.

Konto, dostęp i aktywne usługi

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`tenant`	`account/tenant.ndjson`	`id`	8 Pola `id, slug, name, status, defaultCurrency, createdAt, updatedAt, deletedAt`	Brak relacji
`users`	`account/users.ndjson`	`id`	6 Pola `id, email, fullName, status, createdAt, updatedAt`	Brak relacji
`memberships`	`account/memberships.ndjson`	`id`	6 Pola `id, userId, roleCode, status, createdAt, updatedAt`	userId -> users.id
`entitlements`	`account/entitlements.ndjson`	`id`	6 Pola `id, moduleCode, status, enabledAt, createdAt, updatedAt`	Brak relacji

Klienci i operacyjne dane podstawowe

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`customers`	`master/customers.ndjson`	`id`	11 Pola `id, customerId, name, email, phone, status, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id
`customer-locations`	`master/customer-locations.ndjson`	`id`	14 Pola `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 Pola `id, depotCode, name, address, latitude, longitude, type, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id
`carriers`	`master/carriers.ndjson`	`id`	7 Pola `id, code, name, type, customerSpecific, createdAt, updatedAt`	Brak relacji
`drivers`	`master/drivers.ndjson`	`id`	10 Pola `id, driverId, name, email, phone, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id
`vehicles`	`master/vehicles.ndjson`	`id`	10 Pola `id, vehicleId, registrationNumber, name, vehicleType, sourceFeedId, sourceData, createdAt, updatedAt, deletedAt`	sourceFeedId -> import-sources.id

Zamówienia, przesyłki, paczki i tracking

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`orders`	`logistics/orders.ndjson`	`id`	15 Pola `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 Pola `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 Pola `id, orderId, shipmentId, relationType, createdAt`	orderId -> orders.id; shipmentId -> shipments.id
`carrier-accounts`	`logistics/carrier-accounts.ndjson`	`id`	7 Pola `id, carrierId, name, authType, status, createdAt, updatedAt`	carrierId -> carriers.id
`parcels`	`logistics/parcels.ndjson`	`id`	13 Pola `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 Pola `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

Trasy, postoje i telematyka

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`routes`	`operations/routes.ndjson`	`id`	19 Pola `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 Pola `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 Pola `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 Pola `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

Koszty i wyjątki operacyjne

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`costs`	`finance/costs.ndjson`	`id`	19 Pola `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 Pola `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

Pola niestandardowe i referencje zewnętrzne

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`external-references`	`extensions/external-references.ndjson`	`id`	9 Pola `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 Pola `id, entityType, key, label, description, dataType, visibleInReports, searchable, filterable, createdAt, updatedAt, deletedAt`	Brak relacji
`custom-field-values`	`extensions/custom-field-values.ndjson`	`id`	7 Pola `id, definitionId, entityType, entityId, value, createdAt, updatedAt`	definitionId -> custom-field-definitions.id; entityId -> entity identified by entityType

Integracje, importy, mapowanie i dopasowanie

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`integrations`	`integrations/integrations.ndjson`	`id`	10 Pola `id, type, name, status, billingStatus, activeFrom, activeTo, portableConfiguration, createdAt, updatedAt`	Brak relacji
`import-sources`	`integrations/import-sources.ndjson`	`id`	18 Pola `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 Pola `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 Pola `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 Pola `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 Pola `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 Pola `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 Pola `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 Pola `id, importSourceId, name, leftSource, leftEntityType, leftField, rightSource, rightEntityType, rightField, targetEntity, matchType, configuration, priority, confidenceThreshold, enabled, createdAt, updatedAt`	importSourceId -> import-sources.id

Raporty i historia eksportów

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`report-definitions`	`reports/report-definitions.ndjson`	`id`	9 Pola `id, name, module, queryConfiguration, columnsConfiguration, filtersConfiguration, createdByUserId, createdAt, updatedAt`	createdByUserId -> users.id
`scheduled-reports`	`reports/scheduled-reports.ndjson`	`id`	9 Pola `id, reportDefinitionId, frequency, recipients, format, enabled, lastSentAt, createdAt, updatedAt`	reportDefinitionId -> report-definitions.id
`export-jobs`	`reports/export-jobs.ndjson`	`id`	8 Pola `id, reportDefinitionId, exportType, format, status, createdByUserId, createdAt, finishedAt`	reportDefinitionId -> report-definitions.id; createdByUserId -> users.id

Subskrypcje, użycie, faktury i płatności

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`billing-profile`	`billing/billing-profile.ndjson`	`tenantId`	19 Pola `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 Pola `id, provider, type, cardBrand, cardLast4, cardExpiryMonth, cardExpiryYear, status, default, testMode, removedAt, createdAt, updatedAt`	Brak relacji
`subscriptions`	`billing/subscriptions.ndjson`	`id`	17 Pola `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 Pola `id, productType, productCode, action, activeTo, unitPrice, currency, prorated, createdByUserId, createdAt`	createdByUserId -> users.id
`monthly-usage`	`billing/monthly-usage.ndjson`	`id`	9 Pola `id, periodStart, periodEnd, processedUnits, orders, shipments, parcels, createdAt, updatedAt`	Brak relacji
`subscription-usage-segments`	`billing/subscription-usage-segments.ndjson`	`id`	15 Pola `id, subscriptionId, periodStart, periodEnd, activeFrom, activeTo, billableDays, periodDays, monthlyUnitPrice, accruedAmount, currency, status, billingItemKey, createdAt, updatedAt`	subscriptionId -> subscriptions.id
`invoices`	`billing/invoices.ndjson`	`id`	29 Pola `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`	Brak relacji
`invoice-items`	`billing/invoice-items.ndjson`	`id`	21 Pola `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 Pola `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 Pola `id, paymentId, invoiceId, provider, providerRefundId, status, amount, currency, reason, requestedByUserId, requestedAt, processedAt, createdAt, updatedAt`	paymentId -> payments.id; invoiceId -> invoices.id; requestedByUserId -> users.id

Oryginalne pliki klienta

Zbiór danych	Plik w pakiecie	Klucz główny	Pola	Relacje
`file-index`	`files/index.ndjson`	`id`	9 Pola `id, importFileId, originalFilename, packagePath, mediaType, sizeBytes, sha256, createdAt, rawExpiresAt`	importFileId -> import-files.id
`original-files`	`files/original/*`	`packagePath`	1 Pola `binary content in the original retained format`	packagePath -> file-index.packagePath

4. Pliki wyjściowe i formaty

Manifest podaje wersję specyfikacji, zakres, wszystkie ujęte i pominięte zbiory, liczby rekordów, ostrzeżenia i sumy kontrolne.

Pakiet przekazania: ZIP.
Manifest pakietu: manifest.json w UTF-8.
Dane strukturalne: JSON Lines (NDJSON), jeden obiekt w wierszu.
Zachowane pliki oryginalne: pierwotny format w files/original/.
Data i czas: RFC 3339 / ISO 8601 ze strefą; data YYYY-MM-DD.
Liczby stałoprzecinkowe jako ciągi z kropką; kwoty z walutą ISO 4217.
Suma SHA-256 każdego pliku w manifeście.

5. Relacje między obiektami

Zamówienia, przesyłki, klienci, przewoźnicy, trasy, zakłady i inne obiekty są łączone stabilnymi identyfikatorami oraz referencjami opisanymi w manifeście. Istotna historia pozostaje bez uznawania każdej aktualizacji technicznej za nowy obiekt.

6. Wersja formatu eksportu

Wersja rejestru i formatu eksportu 1.1 obowiązuje od 22.07.2026 i jest niezależna od wersji dokumentów umownych. Zmiana nazw plików, pól obowiązkowych, znaczenia pól lub relacji wymaga nowej wersji; pole opcjonalne może zostać dodane zgodnie wstecznie.

7. Znane ograniczenia

Eksport obejmuje tylko dane z aktywnych modułów i w granicach praw klienta.
Duży lub złożony eksport może wymagać indywidualnie uzgodnionego bezpiecznego przekazania.
Nie gwarantujemy samoobsługowego API ani stałego czasu przygotowania.
Kod źródłowy, algorytmy, wewnętrzne logi bezpieczeństwa, dane dostępowe i dane innych klientów są wyłączone.
Rejestr nie jest pełnym produkcyjnym schematem bazy.

8. Infrastruktura i jurysdykcja

Aplikacja i PostgreSQL działają w Dockerze na VPS VEDOS (dawniej WEDOS) w Republice Czeskiej. Kopie zapasowe są przechowywane na własnym NAS w siedzibie Progity w Republice Czeskiej. Całe wskazane przetwarzanie podlega czeskiej jurysdykcji; adresy IP, dokładny adres fizyczny, dane dostępowe i topologia sieci nie są publikowane.

Typ infrastruktury	Państwo / jurysdykcja	UE/EOG
Aplikacja w Dockerze — VEDOS VPS	Republika Czeska	Tak
PostgreSQL w Dockerze — VEDOS VPS	Republika Czeska	Tak
Kopie — własny NAS w siedzibie Progity	Republika Czeska	Tak

Dostęp jest kontrolowany przez role i uprawnienia, a komunikacja klient–serwer używa HTTPS.

Wnioski władz podlegają ocenie prawnej. Dane nie są przekazywane władzom państw trzecich sprzecznie z prawem UE lub właściwego państwa członkowskiego; stosujemy proporcjonalne środki techniczne, organizacyjne i umowne.

9. Historia zmian rejestru

22.07.2026 — wersja 1.1: opublikowano konkretny format ZIP/JSONL oraz katalog zbiorów, pól, relacji i wyłączeń bezpieczeństwa.
21.07.2026 — wersja 1.0: pierwsza publikacja.

10. Kontakt

Wniosek o eksport lub pytanie można wysłać z uprawnionego konta portalu albo na hello@noda.li. Przed wydaniem danych wniosek może zostać rozsądnie zweryfikowany.