Wróć do bloga
Technologia

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

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

Wymagania techniczne eCoC

Elektroniczne świadectwo zgodności (eCoC) to nie tylko cyfrowa wersja papierowego dokumentu – to zaawansowany plik XML z określoną strukturą, podpisem elektronicznym i mechanizmem przekazywania do systemów urzędowych.

1. Format XML według schematu IVI

Czym jest schemat IVI?

IVI (Inter-Vehicle Information) to ustandaryzowany schemat XML opracowany przez Unię Europejską dla wymiany informacji o pojazdach między państwami członkowskimi.

Struktura 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>

Kluczowe 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 i końcowego)
  • Wyposażenie (systemy bezpieczeństwa, opcje)

Walidacja XSD

Każdy plik XML musi być walidowany według oficjalnego schematu XSD dostarczonego przez Komisję Europejską. Oznacza to, że:

  • Wszystkie wymagane pola muszą być wypełnione
  • Wartości muszą być zgodne z dozwolonymi zakresami
  • Struktura musi odpowiadać hierarchii schematu

2. Podpis elektroniczny XAdES

Czym jest XAdES?

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

Wymagania dla podpisu eCoC:

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

Proces podpisywania:

  1. Generowanie pliku XML eCoC
  2. Obliczanie skrótu (hash) dokumentu
  3. Szyfrowanie skrótu kluczem prywatnym
  4. Dodawanie informacji o certyfikacie i znaczniku czasu
  5. Walidacja poprawności podpisu

Weryfikacja podpisu:

System CEP automatycznie weryfikuje:

  • Czy podpis jest kwalifikowany
  • Czy certyfikat jest ważny
  • Czy dokument nie został zmodyfikowany
  • Czy znacznik czasu jest prawidłowy

3. Integracja z CEP poprzez EUCARIS

Czym jest EUCARIS?

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

Jak działa transmisja eCoC?

Krok 1: Krajowy punkt dostępu (NDI)

Każde państwo członkowskie ma swój National Access Point (NDI) do EUCARIS:

  • • W Polsce: system CEP prowadzony przez Ministerstwo Cyfryzacji
  • • Połączenie poprzez bezpieczny protokół (TLS 1.3)
  • • Uwierzytelnianie certyfikatem klienta

Krok 2: Przekazanie eCoC

Po wygenerowaniu i podpisaniu eCoC:

  1. System wysyła plik XML do NDI poprzez web service
  2. NDI przeprowadza walidację techniczną (XSD, XAdES)
  3. W przypadku powodzenia: eCoC jest zapisywany w CEP
  4. Zwracany jest unikalny identyfikator eCoC

Krok 3: Dostęp dla organów rejestracyjnych

Gdy właściciel pojazdu zgłasza się do rejestracji:

  1. Starosta wyszukuje eCoC w CEP po numerze VIN
  2. System EUCARIS pobiera eCoC z krajowej bazy
  3. Dokument jest weryfikowany i wykorzystywany do rejestracji

Wymagania techniczne integracji:

  • Protokół: SOAP/REST API
  • Szyfrowanie: TLS 1.3 minimum
  • Certyfikat: kwalifikowany certyfikat dla organizacji
  • Format danych: XML zgodny ze schematem IVI
  • Timeout: maksymalnie 30 sekund na transmisję

Wyzwania techniczne dla firm

Najczęstsze problemy:

  • Nieprawidłowa walidacja XML – brakujące lub błędne pola
  • Problemy z certyfikatem podpisu – wygaśnięcie, błędny typ
  • Błędy integracji z EUCARIS – timeout, błędy uwierzytelniania
  • Brak obsługi odpowiedzi zwrotnych – nieobsłużone kody błędów

Rozwiązania COC Desk:

Automatyczna walidacja przed wysyłką

Sprawdzamy każdy plik XML przed podpisaniem i transmisją

Zarządzanie certyfikatami

Monitorujemy ważność certyfikatów i przypominamy o odnowieniu

Niezawodna integracja EUCARIS

Automatyczne ponowienie prób w przypadku problemów sieciowych

Pełne logowanie

Kompletne logi transmisji do 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 ecocdesk w Twojej firmie.

eCoC w praktyce – wymagania techniczne (XML, XAdES, CEP) | COC Desk Blog | COC Desk