Co się zmieniło w adresie kontrahenta w SS02 (contractor.merge) w wersji 3.3
Jeśli po przejściu integracji na wersję 3.3 operacji SS02 (contractor.merge) żądanie z adresem kontrahenta nie jest przyjmowane albo w odpowiedzi pojawia się błąd w węźle ADDRESS/STREET, przyczyną jest nowa struktura adresu. Zmiana jest zgodna z normą ISO 20022 i jest dostępna od wersji 40.2.0.
⚠️ Zmiana jest niekompatybilna wstecz. Integracja, która przechodzi z wersji 3.2 lub starszej na 3.3, musi przebudować węzeł adresu zarówno w żądaniu, jak i w obsłudze odpowiedzi.
Jak było wcześniej
Adres kontrahenta był przekazywany w osobnych, płaskich węzłach:
- CITY
- POSTCODE
- STREET
- COUNTRY_ISO3166A2
Jak jest w wersji 3.3
Wymienione węzły zastąpił jeden węzeł ADDRESS z podwęzłami:
| Podwęzeł | Opis | Wymagany |
|---|---|---|
| STREET | Nazwa ulicy (bez numeru) | Tak |
| BUILDING_NUMBER | Numer budynku | Tak |
| ROOM | Numer lokalu | Nie |
| POSTCODE | Kod pocztowy | Tak |
| CITY | Miasto | Tak |
| COUNTRY | Kraj | Nie |
Numer budynku i numer lokalu przekazujesz teraz w osobnych węzłach BUILDING_NUMBER i ROOM, a nie razem z nazwą ulicy.
Limity znaków w adresie
- Każdy węzeł adresu może mieć maksymalnie 255 znaków.
- Suma znaków w węzłach STREET, BUILDING_NUMBER i ROOM po połączeniu nie może przekroczyć 255 znaków.
⚠️ Przekroczenie limitu wraca w odpowiedzi jako błąd w węźle ADDRESS/STREET.
Czego dotyczy zmiana
Zmiana dotyczy
- Wyłącznie wersji 3.3 operacji SS02 (contractor.merge).
- W wersji 3.3 płaskie węzły CITY, POSTCODE, STREET i COUNTRY_ISO3166A2 nie są przyjmowane w żądaniu ani zwracane w odpowiedzi.
Przykłady i specyfikacja
👉 Specyfikacja API Saldeo – pełny opis API.
👉 contractor_merge_request.xml – przykładowe żądanie XML.
👉 contractor_merge_response.xml – przykładowa odpowiedź XML (sukces).
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.