Webservice v0103: verschil tussen versies

Versie van 20 dec 2019 om 07:39

Bij het switchen van LIP versie v0102 naar versie v0103 veranderen er een aantal zaken voor een deelnemer. Deze staan hieronder beschreven.

Authenticatie ESB

De ESB voor het LIP maakt gebruik van authenticatie. Hiervoor zijn 2 opties beschikbaar: Basic Authentication (username+password) en Client Certificate Authentication (deze werkt wegens technische beperkingen helaas alleen indien de deelnemer in staat is alleen het leaf-certificaat te sturen i.p.v. de volledige certificaatketen).

In het geval er gebruik wordt gemaakt van Basic Authentication verstrekt Functioneel Beheer een username+password combinatie aan de deelnemer. In het geval van Client Certificate Authentication dient de deelnemer het certificaat aan Functioneel Beheer te verstrekken.

Endpoints ESB

De ESB voor het LIP heeft andere endpoints voor de Pull, TracknTrace en IntakeCallback services. De te gebruiken waarde voor <PARTY> en/of de volledige URLs worden door Functioneel Beheer naar de deelnemer gecommuniceerd. De endpoints van de ESB maken geen gebruik van SOAP Actions.

Acceptatie

Productie

Message Signing ESB

De ESB voor het LIP gebruikt het www.dsplatform.nl certificaat (te downloaden met een willekeurige browser vanaf https://www.dsplatform.nl) voor de message signing. Deelnemers dienen dit certificaat te configureren voor het valideren van binnenkomende requests en responses.

Outbound IP adres ESB

Mocht de deelnemer inbound whitelisting op basis van ip adressen hanteren, dan dienen zij het volgens ip adres te whitelisten, zodat requests vanuit de ESB geaccepteerd kunnen worden: 204.79.147.97. Dit ip adres geldt zowel voor de acceptatie als productie omgeving van de ESB.

Authenticatie deelnemer

Om de ESB voor het LIP te voorzien van de juiste authenticatie gegevens, dient de deelnemer deze aan Functioneel Beheer te verstrekken.

Endpoints deelnemer

Om de ESB voor het LIP te voorzien van de juiste endpoint configuratie voor de Aanvraag en Intake services, dient de deelnemer deze informatie aan Functioneel Beheer te verstrekken. Denk hierbij aan URL's en eventuele SOAP Actions.

Message Signing Deelnemer

De deelnemer dient de gebruikte certificaten voor message signing per omgeving (acceptatie/productie) aan Functioneel Beheer te verstrekken, zodat deze in de ESB voor het LIP geconfigureerd kunnen worden.

Release Notes LIP

In onderstaande release notes zijn de exacte wijzigingen in de LIP web services terug te vinden.

========================================================================
LIP Webservices
========================================================================

Om de gebruikers van het LIP zo goed mogelijk te bedienen is het gewenst 
om informatie tussen het LIP en de betrokken netbeheerders uit te 
wisselen. Deze informatie-uitwisseling vindt plaats op basis van 
webservices, en wordt een koppeling genoemd. Deze release bevat alle
webservice beschrijvingen (wsdl's) en ondersteunende xml-materialen.

-------------------------------------------------------------------------------
Release v0103 build 20160703
-------------------------------------------------------------------------------
- Pull-, Intake-, IntakeCallback- en TracknTraceServices toegevoegd aan versie 
  v0103 t.b.v. DSP (47436 CR66B Aansluiten DSP). Hierbij zijn een aantal 
  aanpassingen die zijn doorgevoerd op de PushService nu ook doorgevoerd op 
  deze overige services (zoals SHA-256 signing en elementnamen starten 
  altijd met een hoofdletter).
- Element EmailAdres verwijdert onder element Behandelaar (behandelaar.xsd), 
  zodat de elementen in de webservice corresponderen met de schermvelden voor 
  behandelaar in het LIP.
- Alle elementen onder element Behandelaar (behandelaar.xsd) aangepast, zodat 
  deze qua lengte corresponderen met de veldlengtes van behandelaar binnen het 
  LIP.
- Element AdditioneleMelding onder element BijwerkenStatusRequest 
  (TracknTraceService.xsd) aangepast, zodat deze qua lengte correspondeert met 
  de veldlengtes binnen het LIP.
- Type AanvraagID verwijdert (in domeinen.xsd) en vervangen door Integer10 
  (in PullService.xsd) i.v.m. consistentie.
- PullService is uitgebreid met een operatie waarmee het verkoopdocument kan 
  worden opgehaald (in PullService.wsdl, PullService.xsd en bijlage.xsd).
  
-------------------------------------------------------------------------------
Release v0103 build 20160517
-------------------------------------------------------------------------------
- Toevoegen van een vlag 'IsEANKeuze' aan entiteit Product (als vervolg op 
  eerdere CR31) (product.xsd).
- Cardinaliteit van element Bijlage onder element Bijlagen (aanvraag.xsd) 
  aangepast van '1' naar '0'. Wanneer er wel   een opmerking wordt meegegeven, 
  maar geen bijlage (bijv. in een analoge aanvraag) wordt er niet langer 
  verplichting van een bijlage afgedwongen (33564). Ingebouwde workaround 
  (zie bug 30379) is niet langer nodig wanneer iedereen gebruik maakt van deze 
  versie.
- Cardinaliteit van element KvKNummer onder element Bedrijf 
  (relatiegegevens.xsd) aangepast van '1' naar '0'. Binnen het LIP is er 
  enkel een verplichting voor het KvKNummer voor netbeheerder organisaties, 
  maar niet voor coordinerende organisaties waardoor dit element niet langer 
  met een dummy waarde hoeft te worden gevuld. 
- Cardinaliteit van element Adres onder element Relatie (relatiegegevens.xsd) 
  aangepast van '1' naar '0'. Binnen het LIP wordt niet voor alle type 
  relaties verplichting van dit element afgedwongen. Bijvoorbeeld voor een 
  afwijkend correspondentieadres kan ook alleen een andere contactpersoon 
  worden opgegeven zonder adres.
- Cardinaliteit van alle verplichte elementen onder element Adres (adres.xsd) 
  aangepast van '1' naar '0'. Binnen het LIP wordt niet voor alle type 
  adressen verplichting van deze elementen afgedwongen. Bijvoorbeeld voor een 
  afwijkend correspondentieadres kan ook alleen een postbus-adres worden 
  opgegeven in plaats van een straatnaam-adres.
- Lengte van element Plaats verhoogd van 25 naar 128 (adres.xsd) en simpleType 
  Tekst128 gedefinieerd (domeinen.xsd). Dit voorkomt het afkappen van 
  plaatsnamen wanneer het LIP over een langere plaatsnaam beschikt.
- Correctie van simpleType Tekst254 naar Tekst256 (in domeinen.xsd en in 
  verkoopdocument.xsd). De default lengte van een string is in de use cases 
  niet 254, maar 256.
- Alle elementnamen starten met een hoofdletter. In eerdere versies is er 
  sprake van een mix van kleine letters (voor alle oorspronkelijke elementen 
  uit a.nl/ha.nl) en hoofdletters (voor alle nieuwe elementen in ma.nl). Het is 
  common practice om elementen te laten beginnen met een hoofdletter.

-------------------------------------------------------------------------------
Release v0103 build 20160505
-------------------------------------------------------------------------------
- Nieuwe versie v0103 gemaakt t.b.v. DSP (47436 CR66A Aansluiten DSP).
- AlgorithmSuite voor signing vervangen van 'Basic256' (=SHA-1 signing) door 
  'Basic256Sha256' (=SHA-256 signing) (AanvraagService.wsdl)
- NetbeheerderCode hernoemd naar generiekere OrganisatieCode (domeinen.xsd en 
  alle xsd's waarin dit type wordt gebruikt).
- OrganisatieCode toegevoegd aan entiteit Coordinerende (coordinerende.xsd).
- VerzorgingsgebiedContractCode toegevoegd aan entiteit Coordinerende 
  (coordinerende.xsd).

-------------------------------------------------------------------------------
Release v0102 build 20141212
-------------------------------------------------------------------------------
- PullService WSDL OphalenAanvraagIdsOutput dubbel opnieuw gecorrigeerd. Een 
  hernoemd naar OphalenAanvraagIdsMetStatus.

-------------------------------------------------------------------------------
Release v0102 build 20141205
-------------------------------------------------------------------------------
- Issue 18: Heeft geen wijziging in de xsd's en wsdl's tot gevolg. Wel zal 
  dezelfde waarde voor element Repeatcounter (header.xsd) in het request ook 
  worden teruggegeven door het LIP in de response.
- Issue 42: Corrigeren element notificatievoorkeur naar verplicht (minOccurs is 
  veranderd van '0' naar '1') en element notificatieNiveau naar optioneel 
  (minOccurs is veranderd van '1' naar '0') (aanvrager.xsd)
- Issue 43: Corrigeren simpleType Percentage van minExclusive naar minInclusive 
  (domeinen.xsd).
- Issue 45: Nieuw complexType PdfContent toegevoegd (in bijlage.xsd) dat wordt 
  gebruikt voor Bijlage in OphalenAanvraagPdfResponse (PullService.xsd).
- Issue 46: Corrigeren element Aanvraag naar optioneel (minOccurs is veranderd 
  van '1' naar '0') in OphalenAanvraagResponse (PullService.xsd). Tevens in 
  aanvulling hierop corrigeren element Bijlage naar optioneel (minOccurs is 
  veranderd van '1' naar '0') voor OphalenBijlageResponse en 
  OphalenAanvraagPdfResponse (PullService.xsd).
- CR26: Wijzigen van de symmetric binding assertion naar een asymmetric binding 
  assertion in alle wsdl's.

-------------------------------------------------------------------------------
Release v0102 build 20141118
-------------------------------------------------------------------------------
- Issue 9: Corrigeren lengte van 100 naar 1000 voor Tekst1000 (domeinen.xsd).
- CR 13: Toevoegen van aanvraagVersie en wijzigingsDatum in de aanvraag 
  (aanvraag.xsd). 

-------------------------------------------------------------------------------
Release v0102 build 20141016
-------------------------------------------------------------------------------
- E-mail pattern voorzien van de correcte escaping van '-'.
- terAttentieVan in Bedrijf (relatiegevens.xsd) hernoemd naar contactPersoon 
  en type Persoon.
- PullService WSDL OphalenAanvraagIdsOutput was dubbel en gaf problemen met 
  eclipse. Een hernoemd naar OphalenAanvraagIdsMetStatus.

-------------------------------------------------------------------------------
Release v0102 build 20141010
-------------------------------------------------------------------------------
- TitelVoorwaarde en URLVoorwaarde zijn nu enkelvoud (WI 19467)
- MaxLenght op NetbeheerderCode naar 10 (WI 19477)
- E-mailadres validatie pattern toegevoegd (WI 19475)

-------------------------------------------------------------------------------
Release v0102 build 20141002
-------------------------------------------------------------------------------
- GeaccepteerdeVoorwaarden zijn nu correct genest (WI 19139)
- IsCorrectie is nu optioneel (WI 19132)
- Status optioneel in Track & Trace (WI 19130)

-------------------------------------------------------------------------------
Release v0102 build 20140929
-------------------------------------------------------------------------------
- IsBetaald toegevoegd aan Track & Trace bijwerken status bericht (WI 17522)
- AanmaakDatum toegevoegd aan de Aanvraag en AanbiedDatum verwijderd. Tevens
  zijn de annotaties bijgewerkt (WI 17641)
- Intake berichten herschreven om meer generieke entiteiten te gebruiken en 
  meer informatie te verstrekken die op het moment van versturen al bekend is 
  over de aanvraag (WI 18617)

-------------------------------------------------------------------------------
Release v0102 build 20140922
-------------------------------------------------------------------------------
- SendTime en CreateTime toegevoegd als header elementen om het moment van 
  aanmaken en versturen van een bericht te kunnen bepalen (WI 17730)
- AansluitObject toekomstigeGebruiker annotatie verduidelijkt
- Aantal bijlages op 500 gelimiteerd omdat dit met het oog op de toekomst beter
  is. Vanuit de software wordt nog steeds 50 gelimiteerd (WI 17845)
- Toegevoegd <wsp:UsingPolicy wsdl:Required="true" /> aan de WSDLs (WI 17854)
- Aantal typoos in annotaties en elementen verbeterd.
- Verkoop document aangepast n.a.v. discussie met NBH's (WI 17963)

-------------------------------------------------------------------------------
Release v0102 build 20140911
-------------------------------------------------------------------------------
- Annotatie aanvraagdatum aangepast gelijk aan UC019 (WI 17641)
- isAfwijkendAdres verwijderd uit ContactPersoon.
- AdditioneleMeldingen toegevoegd aan het Track & Trace bericht en EmailAdres 
  toegevoegd aan de Track & Trace behandelaar.
- isPostcodeBijBenadering toegevoegd aan aanvraag en intake.
- Procesvariant toegevoegd aan product en verkoopdocument.
- heeftMeerdereBAGIds toevoegd aan Object in Aanvraag en Intake.
- heeftMeerdereCoordinerenden toevoegd aan de entiteit Coordinerende.
- heeftOverlap toevoegd aan product indien er meerdere netbeheerders worden 
  gevonden.
- isPostcodeBijBenadering toevoegd aan het AansluitObject.
- Aanleveringswijze toevoegd aan domeinen.xsd.
- isNamensAanvragende toegevoegd aan Aanvraag.
- isEANHandmatig toegevoegd aan Product (zowel in aanvraag als intake).

-------------------------------------------------------------------------------
Release v0102 build 20140905
-------------------------------------------------------------------------------
- Contact in uitvoering heeft verplicht e-mail en mobiel nummer (WI 16182)
- Aanbieddatum aan de aanvraag toegevoegd (WI 17364)
- BTW bedrag per Tarief soort toegevoegd aan het Verkoopdocument (WI 17126)
- Percentage als data type toegevoegd 0,00% - 100,00% (WI 17126)
- isAnoniem toegevoegd aan het intake bericht (WI 17358)
- Omschrijving van de bijlages naar 1000 characters opgehoogd (WI 17357)

-------------------------------------------------------------------------------
Release v0101 build 20140902
-------------------------------------------------------------------------------
- Namespace naar http://mijnaansluiting.nl/entiteiten/v0101 omgezet (WI 16494).
- Bijlages.xsd bijgewerkt met annotaties (WI16799).
- isNamensAanvraag in aanvraag.xsd hernoemd naar isNamensAanvragende (WI 16199).
- codeStelsel toegevoegd aan Coordinaten in domeinen.xsd (WI 16201).
- 'tariefcode' en 'bedrijfseigenKenmerk' toegevoegd onder 
  VerkoopDocumentRegels (WI 16218).
- 'bedrijfseigenKenmerk' toegevoegd aan product.xsd (WI 16218).
- Annotaties in verkoopdocument.xsd toegevoegd (WI 16218).
- ObjectType omgezet van enum naar String lengte 2 (WI 16207).
- ContactPersoonUitvoering toegevoegd aan aanvraag.xsd (WI 16182).
- Status hernoemd naar ProcesStatus aan en aan product.xsd toegevoegd (WI 16817).
- ProcesStatus heeft nu enkel nog maar de status nummers als waarde en uitleg 
  in de annotaties die overeenkomen met de UC  (WI 16817).
- FactuurOntvanger is altijd aanwezig in de aanvraag (WI 16208).
- Track & Trace definities met de UC gelijk getrokken (WI 16818).
- BagObjectCode is optioneel (WI 17016)
- NetbeheererID als Tekst definieerd en in domeinen.xsd geplaatst.
- SoortGebruiker enumeratie aangepast naar Aanvrager, Onbekend & 
  Anders (WI 16202)
- Contact persoon bijgewerkt (WI 16182)
- terAttentieVan toegevoegd aan Bedrijf (WI 16212)
- StatusInformatieCode vervangen door NotificatieVoorkeur (WI 16215)
- NetbeheerderCode ipv. netbeheerderID (WI 17019)
- VraagCode ipv. vraagID, AntwoordCode ipv. AntwoordID , VraagType en 
  NetbeheerderCode toevoegd. (WI 16798)
- maximum bijlage aantal naar 50 verhoogd en VraagCode toegevoegd aan de 
  bijlages. VraagCode en NetbeheerderCode toevoegd. (WI 16799)
- prijsIndicatieEenmalig & prijsIndicatieMaandelijks toegevoegd aan 
  het product (WI 16932).
- Verwijderd: isBouwAansluiting (WI 16984)
- Verwijderd: IsAfwijkendContact (WI 16985)
- Verwijderd: isBetaald (product.xsd), betalingswijze (product.xsd) en opmerking 
  (aanvraag.xsd) (WI 17014)
- plandatumstart en plandatumeinde zijn verwijderd (WI 17015)
- Annotaties bijgewerkt voor media in Product (WI 17020)
- NotificatieNiveau toegevoegd aan de Aanvrager (WI 17022)
- Annotatie voor de ToekomstigeGebruiker aangepast (WI 17023)
- StraatNEN optioneel gemaakt (WI 15851)
- Verwijderd (WI 15854):
    - jaarverbruik (product.xsd)
    - isHoofdnetAanwezig (product.xsd)
    - ruimteNummer (aansluitobject.xsd)
    - afstandTotWeg (aansluitobject.xsd)
    - status (objectStatus) (aansluitobject.xsd)
    - bouwJaar (aansluitobject.xsd)
    - bouwWeek (aansluitobject.xsd)
    - isBinnenBebouwdeKom (aansluitobject.xsd)
    - isVervuildeGrond (aansluitobject.xsd)
    - soortBestrating (aansluitobject.xsd)
- ResultCode is verplicht gemaakt in de response berichten (WI 16220).
- Telefoonnummer pattern geintroduceerd: [0-9+\-() ]{0,25} (WI 16189).
- isGereed toegevoegd aan de Intake koppeling (WI 16949)
- isCorrectie toegevoegd aan de Track & Trace koppeling (WI 16981)
- SoortAansluiting verwijderd van het aansluitobject (WI 16214)
- AanvraagCode element verwijderd uit de aanvraag (WI 16211)
- Herontwerp VerkoopDocument (WI 17126)

---------------------------------------------------------------------
Release v0101 build 20140814
---------------------------------------------------------------------
- Alle entiteiten waaruit de berichten zijn op gebouwd staan nu in 
  een eigen namespace in plaats van een aparte namespace voor elke 
  entiteit. 
- Elke service behoudt zijn eigen namespace voor de berichten. 
  Daarbij is het schema voor het bericht niet meer opgenomen in de 
  wsdl, maar is in een eigen schemabestand geplaatst dat wordt 
  geimporteerd in de wsdl. 

---------------------------------------------------------------------
Release v0101 build 140
---------------------------------------------------------------------
- Groeperen van alle afzonderlijke wsdl's en xsd's in een release.
- Toevoegen ObjectType aan 'intake.xsd'.