Wróć do bloga
Technologia

eCoC w praktyce – wymagania techniczne (XML, XAdES, CEP)

15 listopada 2025
eCoC w praktyce – wymagania techniczne (XML, XAdES, CEP)

Techniczne wymogi eCoC

Elektroniczne świadectwo zgodności (eCoC) to coś więcej niż cyfrowa kopia papierowego dokumentu – to złożony plik XML o ściśle określonej strukturze, opatrzony podpisem elektronicznym i wyposażony w mechanizm przekazywania do systemów urzędowych.

1. Format XML zgodny ze schematem IVI

Czym jest schemat IVI?

IVI (Inter-Vehicle Information) to ujednolicony schemat XML stworzony przez Unię Europejską na potrzeby wymiany informacji o pojazdach pomiędzy państwami członkowskimi.

Budowa pliku XML eCoC:

<?xml version="1.0" encoding="UTF-8"?>
<CoC xmlns="http://ec.europa.eu/ivi/schemas/coc">
  <CoCHeader>
    <CoCNumber>E1234567890</CoCNumber>
    <IssueDate>2025-01-15</IssueDate>
    <ManufacturerCode>ABC123</ManufacturerCode>
  </CoCHeader>
  <VehicleData>
    <VIN>WDB9634021L123456</VIN>
    <TypeApprovalNumber>e1*2018/858*00123*00</TypeApprovalNumber>
    <Category>N3</Category>
    <Variant>001</Variant>
    <Version>A</Version>
    <!-- Ponad 100 dodatkowych elementów danych -->
  </VehicleData>
  <!-- Dane techniczne, emisja, masy, wymiary itd. -->
</CoC>

Najważniejsze elementy danych:

  • Identyfikacja pojazdu (VIN, typ, wariant, wersja)
  • Homologacja (numer WE, kategoria, data wydania)
  • Parametry techniczne (masa, wymiary, osiągi)
  • Emisja spalin (norma Euro, wartości CO2, NOx)
  • Producent (dane producenta bazowego oraz końcowego)
  • Wyposażenie (systemy bezpieczeństwa, dostępne opcje)

Walidacja XSD

Każdy plik XML trzeba zwalidować względem oficjalnego schematu XSD udostępnionego przez Komisję Europejską. W praktyce oznacza to, że:

  • Wszystkie wymagane pola muszą zostać uzupełnione
  • Wartości muszą mieścić się w dozwolonych zakresach
  • Struktura musi odzwierciedlać hierarchię schematu

2. Podpis elektroniczny XAdES

Czym jest XAdES?

XAdES (XML Advanced Electronic Signatures) to standard podpisu elektronicznego przeznaczony dla dokumentów XML, zdefiniowany w normie ETSI TS 103 171.

Wymogi wobec podpisu eCoC:

  • Kwalifikowany podpis elektroniczny zgodny z rozporządzeniem eIDAS
  • Format podpisu: co najmniej XAdES-BES
  • Certyfikat wydany przez kwalifikowanego dostawcę usług zaufania
  • Algorytm podpisu: co najmniej RSA-SHA256

Przebieg podpisywania:

  1. Utworzenie pliku XML eCoC
  2. Wyliczenie skrótu (hash) dokumentu
  3. Zaszyfrowanie skrótu kluczem prywatnym
  4. Dołączenie informacji o certyfikacie oraz znacznika czasu
  5. Sprawdzenie poprawności podpisu

Weryfikacja podpisu:

System CEP samoczynnie sprawdza:

  • czy podpis ma charakter kwalifikowany
  • czy certyfikat zachowuje ważność
  • czy dokument nie został zmieniony
  • czy znacznik czasu jest poprawny

3. Połączenie z CEP poprzez EUCARIS

Czym jest EUCARIS?

EUCARIS (European Car and Driving Licence Information System) to europejski system wymiany danych o pojazdach i prawach jazdy pomiędzy krajami UE.

Jak przebiega transmisja eCoC?

Krok 1: Krajowy punkt dostępu (NDI)

Każde państwo członkowskie ma własny National Access Point (NDI) do EUCARIS:

  • • W Polsce: system CEP prowadzony przez Ministerstwo Cyfryzacji
  • • Łączność przez bezpieczny protokół TLS
  • • Uwierzytelnienie certyfikatem klienta

Krok 2: Przekazanie eCoC

Gdy eCoC zostanie utworzone i podpisane:

  1. System przekazuje plik XML do NDI za pomocą web service
  2. NDI wykonuje walidację techniczną (XSD, XAdES)
  3. Po pomyślnej weryfikacji eCoC zostaje zapisane w CEP
  4. W odpowiedzi zwracany jest unikalny identyfikator eCoC

Krok 3: Dostęp dla organów rejestracyjnych

Kiedy właściciel pojazdu przychodzi po rejestrację:

  1. Starosta odnajduje eCoC w CEP po numerze VIN
  2. System EUCARIS pobiera eCoC z bazy krajowej
  3. Dokument zostaje zweryfikowany i wykorzystany do rejestracji

Techniczne wymogi integracji:

  • Protokół: według specyfikacji NAP danego państwa członkowskiego
  • Szyfrowanie: bezpieczne połączenie TLS
  • Certyfikat: kwalifikowany certyfikat organizacji
  • Format danych: XML zgodny ze schematem IVI

Techniczne wyzwania dla firm

Najczęstsze trudności:

  • Błędna walidacja XML – braki lub niepoprawne pola
  • Kłopoty z certyfikatem podpisu – wygaśnięcie, niewłaściwy typ
  • Usterki integracji z EUCARIS – przekroczenia czasu, błędy uwierzytelniania
  • Brak obsługi odpowiedzi zwrotnych – pominięte kody błędów

Odpowiedzi eCoC EU²:

Automatyczna walidacja przed wysyłką

Każdy plik XML weryfikujemy jeszcze przed podpisaniem i przesłaniem

Zarządzanie certyfikatami

Pilnujemy terminów ważności certyfikatów i przypominamy o ich odnowieniu

Niezawodna integracja EUCARIS

Automatyczne ponawianie prób przy problemach sieciowych

Pełne logowanie

Kompletne logi transmisji na potrzeby analizy i raportowania

Masz pytania o eCoC?

Skontaktuj się z naszym zespołem ekspertów. Chętnie odpowiemy na wszystkie pytania i pomożemy wdrożyć system eCoC EU² w Twojej firmie.

eCoC w praktyce – wymagania techniczne (XML, XAdES, CEP) | eCoC EU² Blog | eCoC EU²