Rejestr eksportu danych

ppwrly.company-export · Bieżąca wersja: 1.0

Ten rejestr opisuje, jak przenieść dane firmy z ppwrly do innego dostawcy (Data Act, art. 26). Aktualizujemy go razem z formatem eksportu.

Procedura zmiany dostawcy i terminy

1. Pobierz eksport firmy w profilu firmy (właściciel albo administrator) albo wydaj nowemu dostawcy klucz dostępu — dostawca pobierze ten sam plik sam.
2. Zakończ umowę w profilu firmy. Zaczyna się 30 dni karencji: dane są tylko do odczytu, eksport i dostęp dla nowego dostawcy działają, a usunięcie można w każdej chwili anulować.
3. Po karencji firma i jej dane są usuwane według zasad opisanych niżej. „Usuń natychmiast” pomija karencję.
4. Eksport, dostęp dla nowego dostawcy i zmiana dostawcy są bezpłatne; nie ma kar za wcześniejsze rozwiązanie umowy.

Metody pobrania danych

• Eksport w panelu: plik JSON jednej firmy, który pobiera właściciel albo administrator firmy — najwyżej 5 razy na godzinę.
• Dostęp dla nowego dostawcy: dostawca pobiera ten sam plik kluczem dostępu (opis interfejsu niżej).

Format i wersja

Identyfikator formatu

ppwrly.company-export

Bieżąca wersja

1.0

Schemat maszynowy (JSON Schema)

/legal/data-export-register/company-export-1.0.schema.json

Plik JSON w UTF-8. Liczby dziesiętne jako napisy (bez utraty precyzji), chwile w ISO 8601 (UTC), daty jako RRRR-MM-DD.

Katalog pól

Każde pole pliku: ścieżka od korzenia ([] oznacza element tablicy), typ, czy może być puste i wersja formatu, w której się pojawiło.

Koperta pliku

• format Typ: string · Może być puste: nie · Od wersji 1.0 Identyfikator formatu: „ppwrly.company-export”.
• formatVersion Typ: string · Może być puste: nie · Od wersji 1.0 Wersja formatu MAJOR.MINOR — ta sama co w rejestrze.
• exportedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila migawki danych (pole zmienne).
• registerUrl Typ: string · Może być puste: nie · Od wersji 1.0 Adres rejestru formatów i procedur eksportu.

company

• company.id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.name Typ: string · Może być puste: nie · Od wersji 1.0 Nazwa firmy.
• company.taxId Typ: string · Może być puste: tak · Od wersji 1.0 Numer identyfikacji podatkowej (NIP / VAT).
• company.address Typ: string · Może być puste: tak · Od wersji 1.0 Adres — ulica i numer.
• company.address2 Typ: string · Może być puste: tak · Od wersji 1.0 Adres — druga linia.
• company.city Typ: string · Może być puste: tak · Od wersji 1.0 Miejscowość.
• company.postalCode Typ: string · Może być puste: tak · Od wersji 1.0 Kod pocztowy.
• company.country Typ: string · Może być puste: tak · Od wersji 1.0 Kraj siedziby (kod ISO 3166-1 alfa-2).
• company.industry Typ: string · Może być puste: tak · Od wersji 1.0 Branża.
• company.companySize Typ: string · Może być puste: tak · Od wersji 1.0 Wielkość firmy.
• company.website Typ: string · Może być puste: tak · Od wersji 1.0 Strona internetowa.
• company.subscriptionPlan Typ: string · Może być puste: nie · Od wersji 1.0 Plan usługi ppwrly.
• company.subscriptionExpires Typ: timestamp · Może być puste: tak · Od wersji 1.0 Koniec bieżącego okresu planu.
• company.pendingTier Typ: string · Może być puste: tak · Od wersji 1.0 Plan zaplanowany od następnego okresu.
• company.pendingTierEffectiveAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila zmiany na plan zaplanowany.
• company.trialEndsAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Koniec okresu próbnego.
• company.onboardingCompleted Typ: boolean · Może być puste: nie · Od wersji 1.0 Czy ukończono konfigurację firmy.
• company.createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.countries[]

• company.countries[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.countries[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.countries[].countryCode Typ: string · Może być puste: nie · Od wersji 1.0 Kraj rynku firmy (kod ISO 3166-1 alfa-2).
• company.countries[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.

company.products[]

• company.products[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.products[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.products[].sku Typ: string · Może być puste: nie · Od wersji 1.0 Kod produktu nadany przez firmę (SKU).
• company.products[].name Typ: string · Może być puste: nie · Od wersji 1.0 Nazwa produktu.
• company.products[].description Typ: string · Może być puste: tak · Od wersji 1.0 Opis produktu.
• company.products[].category Typ: string · Może być puste: tak · Od wersji 1.0 Kategoria produktu.
• company.products[].eanGtin Typ: string · Może być puste: tak · Od wersji 1.0 Kod EAN / GTIN.
• company.products[].isActive Typ: boolean · Może być puste: nie · Od wersji 1.0 Czy produkt jest aktywny (niezarchiwizowany).
• company.products[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.products[].updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.products[].productCountries[]

• company.products[].productCountries[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.products[].productCountries[].productId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator produktu.
• company.products[].productCountries[].countryCode Typ: string · Może być puste: nie · Od wersji 1.0 Kraj sprzedaży produktu (ISO 3166-1 alfa-2).
• company.products[].productCountries[].annualUnits Typ: integer · Może być puste: tak · Od wersji 1.0 Roczna liczba sztuk wprowadzanych na rynek.

company.products[].packagingComponents[]

• company.products[].packagingComponents[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.products[].packagingComponents[].productId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator produktu.
• company.products[].packagingComponents[].name Typ: string · Może być puste: nie · Od wersji 1.0 Nazwa elementu opakowania.
• company.products[].packagingComponents[].packagingType Typ: string · Może być puste: nie · Od wersji 1.0 Rodzaj opakowania (np. podstawowe, zbiorcze).
• company.products[].packagingComponents[].materialType Typ: string · Może być puste: nie · Od wersji 1.0 Materiał (kod słownika ppwrly).
• company.products[].packagingComponents[].materialSubtype Typ: string · Może być puste: tak · Od wersji 1.0 Podrodzaj materiału.
• company.products[].packagingComponents[].weightGrams Typ: decimal · Może być puste: nie · Od wersji 1.0 Masa elementu w gramach.
• company.products[].packagingComponents[].recycledContentPct Typ: decimal · Może być puste: tak · Od wersji 1.0 Zawartość recyklatu w procentach.
• company.products[].packagingComponents[].recycledContentSource Typ: string · Może być puste: tak · Od wersji 1.0 Źródło informacji o recyklacie.
• company.products[].packagingComponents[].recyclabilityGrade Typ: string · Może być puste: tak · Od wersji 1.0 Ocena przydatności do recyklingu.
• company.products[].packagingComponents[].isReusable Typ: boolean · Może być puste: nie · Od wersji 1.0 Czy element jest wielokrotnego użytku.
• company.products[].packagingComponents[].emptySpacePct Typ: decimal · Może być puste: tak · Od wersji 1.0 Pusta przestrzeń w procentach.
• company.products[].packagingComponents[].notes Typ: string · Może być puste: tak · Od wersji 1.0 Notatki firmy.
• company.products[].packagingComponents[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.products[].packagingComponents[].updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.products[].publicationVersions[]

• company.products[].publicationVersions[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.products[].publicationVersions[].productId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator produktu.
• company.products[].publicationVersions[].version Typ: integer · Może być puste: nie · Od wersji 1.0 Numer wersji karty publicznej.
• company.products[].publicationVersions[].publicToken Typ: string · Może być puste: nie · Od wersji 1.0 Część adresu karty publicznej z kodu QR.
• company.products[].publicationVersions[].snapshot Typ: json · Może być puste: nie · Od wersji 1.0 Migawka danych opublikowanych na karcie.
• company.products[].publicationVersions[].projectionFingerprint Typ: string · Może być puste: nie · Od wersji 1.0 Skrót danych wersji (porównanie z podglądem).
• company.products[].publicationVersions[].publishedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila publikacji.
• company.products[].publicationVersions[].publishedBy Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto, które opublikowało wersję.
• company.products[].publicationVersions[].withdrawnAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila wycofania wersji.
• company.products[].publicationVersions[].withdrawnBy Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto, które wycofało wersję.

company.products[].publicationVersions[].artifacts

• company.products[].publicationVersions[].artifacts.publicUrl Typ: string · Może być puste: tak · Od wersji 1.0 Adres karty publicznej (tylko wersja aktywna).
• company.products[].publicationVersions[].artifacts.qrCodePath Typ: string · Może być puste: tak · Od wersji 1.0 Trasa obrazu kodu QR w API (tylko wersja aktywna).

company.ppwrDeclarations[]

• company.ppwrDeclarations[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.ppwrDeclarations[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.ppwrDeclarations[].productId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator produktu.
• company.ppwrDeclarations[].version Typ: integer · Może być puste: nie · Od wersji 1.0 Numer wersji deklaracji.
• company.ppwrDeclarations[].status Typ: string · Może być puste: nie · Od wersji 1.0 Stan deklaracji.
• company.ppwrDeclarations[].producerName Typ: string · Może być puste: nie · Od wersji 1.0 Nazwa producenta w deklaracji.
• company.ppwrDeclarations[].producerAddress Typ: string · Może być puste: nie · Od wersji 1.0 Adres producenta w deklaracji.
• company.ppwrDeclarations[].packagingDescription Typ: string · Może być puste: nie · Od wersji 1.0 Opis opakowania.
• company.ppwrDeclarations[].materialComposition Typ: string · Może być puste: nie · Od wersji 1.0 Skład materiałowy.
• company.ppwrDeclarations[].recycledContentInfo Typ: string · Może być puste: tak · Od wersji 1.0 Informacja o recyklacie.
• company.ppwrDeclarations[].recyclabilityGrade Typ: string · Może być puste: tak · Od wersji 1.0 Ocena przydatności do recyklingu.
• company.ppwrDeclarations[].standardsReference Typ: string · Może być puste: tak · Od wersji 1.0 Normy i odniesienia.
• company.ppwrDeclarations[].complianceStatement Typ: string · Może być puste: tak · Od wersji 1.0 Oświadczenie producenta.
• company.ppwrDeclarations[].snapshotJson Typ: json · Może być puste: tak · Od wersji 1.0 Migawka danych, z których powstaje deklaracja i jej PDF.
• company.ppwrDeclarations[].missingItems Typ: json · Może być puste: tak · Od wersji 1.0 Lista brakujących danych w chwili utworzenia.
• company.ppwrDeclarations[].publicToken Typ: string · Może być puste: tak · Od wersji 1.0 Dawny klucz publicznej strony deklaracji (dana historyczna).
• company.ppwrDeclarations[].signedBy Typ: string · Może być puste: tak · Od wersji 1.0 Osoba podpisująca.
• company.ppwrDeclarations[].signedAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila podpisu.
• company.ppwrDeclarations[].pdfUrl Typ: string · Może być puste: tak · Od wersji 1.0 Dawny adres pliku PDF (dana historyczna).
• company.ppwrDeclarations[].qrCodeData Typ: string · Może być puste: tak · Od wersji 1.0 Dawna treść kodu QR deklaracji (dana historyczna).
• company.ppwrDeclarations[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.ppwrDeclarations[].updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.ppwrDeclarations[].artifacts

• company.ppwrDeclarations[].artifacts.pdfPath Typ: string · Może być puste: nie · Od wersji 1.0 Trasa API, która tworzy PDF deklaracji na żądanie.

company.eprRegistrations[]

• company.eprRegistrations[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.eprRegistrations[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.eprRegistrations[].countryCode Typ: string · Może być puste: nie · Od wersji 1.0 Kraj rejestracji ROP/EPR.
• company.eprRegistrations[].proName Typ: string · Może być puste: tak · Od wersji 1.0 Organizacja odzysku.
• company.eprRegistrations[].registrationNumber Typ: string · Może być puste: tak · Od wersji 1.0 Numer rejestrowy.
• company.eprRegistrations[].registrationDate Typ: date · Może być puste: tak · Od wersji 1.0 Data rejestracji.
• company.eprRegistrations[].expiryDate Typ: date · Może być puste: tak · Od wersji 1.0 Data wygaśnięcia.
• company.eprRegistrations[].status Typ: string · Może być puste: nie · Od wersji 1.0 Stan rejestracji.
• company.eprRegistrations[].contractReference Typ: string · Może być puste: tak · Od wersji 1.0 Numer umowy z organizacją odzysku.
• company.eprRegistrations[].notes Typ: string · Może być puste: tak · Od wersji 1.0 Notatki firmy.
• company.eprRegistrations[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.eprRegistrations[].updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.eprDeclarations[]

• company.eprDeclarations[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.eprDeclarations[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.eprDeclarations[].countryCode Typ: string · Może być puste: nie · Od wersji 1.0 Kraj deklaracji ROP/EPR.
• company.eprDeclarations[].periodType Typ: string · Może być puste: nie · Od wersji 1.0 Rodzaj okresu sprawozdawczego.
• company.eprDeclarations[].periodStart Typ: date · Może być puste: nie · Od wersji 1.0 Początek okresu.
• company.eprDeclarations[].periodEnd Typ: date · Może być puste: nie · Od wersji 1.0 Koniec okresu.
• company.eprDeclarations[].status Typ: string · Może być puste: nie · Od wersji 1.0 Stan deklaracji.
• company.eprDeclarations[].totalWeightKg Typ: decimal · Może być puste: tak · Od wersji 1.0 Łączna masa w kilogramach.
• company.eprDeclarations[].totalFeeEur Typ: decimal · Może być puste: tak · Od wersji 1.0 Łączna opłata w euro (szacunek).
• company.eprDeclarations[].submittedAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila złożenia.
• company.eprDeclarations[].dataJson Typ: json · Może być puste: tak · Od wersji 1.0 Dane deklaracji.
• company.eprDeclarations[].pdfUrl Typ: string · Może być puste: tak · Od wersji 1.0 Adres pliku PDF deklaracji.
• company.eprDeclarations[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.eprDeclarations[].updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.complianceChecklists[]

• company.complianceChecklists[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.complianceChecklists[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.complianceChecklists[].regulation Typ: string · Może być puste: nie · Od wersji 1.0 Regulacja listy kontrolnej (np. PPWR).
• company.complianceChecklists[].overallProgress Typ: decimal · Może być puste: nie · Od wersji 1.0 Postęp listy w procentach.
• company.complianceChecklists[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.complianceChecklists[].updatedAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila ostatniej zmiany.

company.complianceChecklists[].items[]

• company.complianceChecklists[].items[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.complianceChecklists[].items[].checklistId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator listy kontrolnej.
• company.complianceChecklists[].items[].stepNumber Typ: integer · Może być puste: nie · Od wersji 1.0 Numer kroku.
• company.complianceChecklists[].items[].titleKey Typ: string · Może być puste: nie · Od wersji 1.0 Klucz tłumaczenia tytułu kroku.
• company.complianceChecklists[].items[].descriptionKey Typ: string · Może być puste: nie · Od wersji 1.0 Klucz tłumaczenia opisu kroku.
• company.complianceChecklists[].items[].articleRef Typ: string · Może być puste: tak · Od wersji 1.0 Odniesienie do przepisu.
• company.complianceChecklists[].items[].deadline Typ: date · Może być puste: tak · Od wersji 1.0 Termin kroku.
• company.complianceChecklists[].items[].isCompleted Typ: boolean · Może być puste: nie · Od wersji 1.0 Czy krok jest wykonany.
• company.complianceChecklists[].items[].completedAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila wykonania.
• company.complianceChecklists[].items[].completedBy Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto, które oznaczyło wykonanie.
• company.complianceChecklists[].items[].notes Typ: string · Może być puste: tak · Od wersji 1.0 Notatki firmy.
• company.complianceChecklists[].items[].countryCode Typ: string · Może być puste: tak · Od wersji 1.0 Kraj kroku (dla kroków krajowych).
• company.complianceChecklists[].items[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.

company.billingHistory[]

• company.billingHistory[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.billingHistory[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.billingHistory[].billingTier Typ: string · Może być puste: tak · Od wersji 1.0 Plan, którego dotyczy płatność.
• company.billingHistory[].amount Typ: decimal · Może być puste: nie · Od wersji 1.0 Kwota.
• company.billingHistory[].currency Typ: string · Może być puste: nie · Od wersji 1.0 Waluta.
• company.billingHistory[].status Typ: string · Może być puste: tak · Od wersji 1.0 Stan płatności.
• company.billingHistory[].periodStart Typ: date · Może być puste: tak · Od wersji 1.0 Początek okresu rozliczeniowego.
• company.billingHistory[].periodEnd Typ: date · Może być puste: tak · Od wersji 1.0 Koniec okresu rozliczeniowego.
• company.billingHistory[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.

company.members[]

• company.members[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.members[].userId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator konta członka.
• company.members[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.members[].role Typ: string · Może być puste: nie · Od wersji 1.0 Rola w firmie (owner, admin, member).
• company.members[].invitedBy Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto zapraszające.
• company.members[].invitedAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila zaproszenia.
• company.members[].acceptedAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila przyjęcia zaproszenia.
• company.members[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.members[].email Typ: string · Może być puste: nie · Od wersji 1.0 Adres e-mail członka.
• company.members[].displayName Typ: string · Może być puste: tak · Od wersji 1.0 Wyświetlana nazwa członka.

company.invitations[]

• company.invitations[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.invitations[].companyId Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator firmy.
• company.invitations[].email Typ: string · Może być puste: nie · Od wersji 1.0 Zapraszany adres e-mail.
• company.invitations[].role Typ: string · Może być puste: nie · Od wersji 1.0 Rola z zaproszenia.
• company.invitations[].status Typ: string · Może być puste: nie · Od wersji 1.0 Stan zaproszenia.
• company.invitations[].invitedBy Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto zapraszające.
• company.invitations[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.
• company.invitations[].expiresAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Termin ważności zaproszenia.
• company.invitations[].resolvedAt Typ: timestamp · Może być puste: tak · Od wersji 1.0 Chwila rozstrzygnięcia (przyjęcie, odrzucenie, odwołanie).
• company.invitations[].resolvedBy Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto, które rozstrzygnęło zaproszenie.

company.companyAuditLog[]

• company.companyAuditLog[].id Typ: uuid · Może być puste: nie · Od wersji 1.0 Identyfikator wiersza.
• company.companyAuditLog[].userId Typ: uuid · Może być puste: tak · Od wersji 1.0 Konto wykonujące (puste po usunięciu konta albo dla zdarzeń systemu).
• company.companyAuditLog[].companyId Typ: uuid · Może być puste: tak · Od wersji 1.0 Identyfikator firmy.
• company.companyAuditLog[].action Typ: string · Może być puste: nie · Od wersji 1.0 Rodzaj zdarzenia.
• company.companyAuditLog[].entityType Typ: string · Może być puste: tak · Od wersji 1.0 Rodzaj obiektu zdarzenia.
• company.companyAuditLog[].entityId Typ: uuid · Może być puste: tak · Od wersji 1.0 Identyfikator obiektu zdarzenia.
• company.companyAuditLog[].details Typ: json · Może być puste: tak · Od wersji 1.0 Szczegóły zdarzenia (bez adresów IP).
• company.companyAuditLog[].createdAt Typ: timestamp · Może być puste: nie · Od wersji 1.0 Chwila utworzenia.

Pola zmienne między pobraniami

Poza tymi polami dwa pobrania tej samej firmy bez zmian w danych dają ten sam plik.

• exportedAt — Chwila migawki — inna przy każdym pobraniu.
• company.companyAuditLog[] — Wpisy „company.export” powstałe po migawce wcześniejszego z porównywanych artefaktów (każde pobranie zostawia ślad w dzienniku firmy).

Historia wersji formatu

• 1.0 (2026-10-24) — Pierwsza wersja eksportu firmy: koperta, dane firmy, produkty z opakowaniami i kartami, deklaracje, rejestracje i deklaracje EPR, listy kontrolne, historia płatności bez identyfikatorów Stripe’a, członkowie, zaproszenia i dziennik firmy bez adresów IP.

Znane ograniczenia

• Pliki PDF deklaracji powstają na żądanie poza eksportem — eksport zawiera dane, z których powstają, i trasę pobrania.
• Kwota polskiej opłaty produktowej jest wyłącznie w kalkulatorze — eksport zawiera dane wejściowe (produkty, opakowania, kraje), nie kwotę.
• Instrukcje sortowania pokazywane na karcie publicznej nie są częścią migawki wersji — pochodzą ze słownika ppwrly w chwili wyświetlenia.
• Raporty CSV z panelu są niepełne względem eksportu — kompletne dane zawiera wyłącznie eksport JSON.
• Eksport powstaje w pamięci w całości (bez strumieniowania); bardzo duży katalog produktów wydłuża czas odpowiedzi.

Dostęp dla nowego dostawcy (interfejs delegowany)

Właściciel albo administrator firmy może wydać dostawcy docelowemu delegację dostępu (domyślnie 30, najwyżej 90 dni). Dostawca pobiera ten sam artefakt co panel żądaniem GET z nagłówkiem „Authorization: Bearer <token>”. Token pokazujemy raz; baza trzyma wyłącznie jego skrót. Delegację można cofnąć w każdej chwili — cofnięta albo wygasła daje odpowiedź 401. Delegacja daje wyłącznie odczyt eksportu jednej firmy.

Metoda, Adres

GET /api/v1/portability/company-export

Uwierzytelnienie

nagłówek Authorization: Bearer <klucz>; klucz zaczyna się od ppwrly_pt_

Zakres

company_export:read

Ważność

domyślnie 30 dni, najwyżej 90 dni

Limity

10 pobrań na godzinę jednym kluczem, 30 żądań na godzinę z adresu IP, najwyżej 5 aktywnych kluczy na firmę

Kody błędów

• 401 · Powód w odpowiedzi: brak — Brak nagłówka, inny schemat niż Bearer, token nieznany, zniekształcony, cofnięty albo wygasły — zawsze ta sama odpowiedź, bez wskazania, który przypadek zaszedł.
• 429 · Powód w odpowiedzi: portability_download_limit — Więcej niż 10 pobrań jedną delegacją w ciągu godziny.
• 429 · Powód w odpowiedzi: brak — Więcej niż 30 żądań z jednego adresu IP (dla IPv6 — z jednej sieci /64) w ciągu godziny.

Cofnięcie klucza

Cofnięcie działa od razu dla każdego nowego pobrania. Pobranie, które odczytało delegację przed cofnięciem, kończy się artefaktem z chwili swojego startu; pobranie, które trafi na cofnięcie w trakcie zatwierdzania, dostaje 401.

Usunięcie danych po zakończeniu umowy