Webservice v0103
Bij het switchen van LIP versie v0102 naar versie v0103 veranderen er een aantal zaken voor een deelnemer. Deze staan hieronder beschreven.
Inhoud
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
Pull | https://qas.dsplatform.nl/XISOAPAdapter/MessageServlet?senderParty=<PARTY>?&senderService=BC_<PARTY>&receiverParty=&receiverService=&interface=PullServicePort&interfaceNamespace=http://mijnaansluiting.nl/pullservice/v0103 |
TracknTrace | https://qas.dsplatform.nl/XISOAPAdapter/MessageServlet?senderParty=<PARTY>?&senderService=BC_<PARTY>&receiverParty=&receiverService=&interface=TracknTraceServicePort&interfaceNamespace=http://mijnaansluiting.nl/trackntraceservice/v0103 |
IntakeCallback | https://qas.dsplatform.nl/XISOAPAdapter/MessageServlet?senderParty=<PARTY>?&senderService=BC_<PARTY>&receiverParty=&receiverService=&interface=IntakeCallbackServicePort&interfaceNamespace=http://mijnaansluiting.nl/intakeservice/v0103 |
Productie
Pull | https://www.dsplatform.nl/XISOAPAdapter/MessageServlet?senderParty=<PARTY>?&senderService=BC_<PARTY>&receiverParty=&receiverService=&interface=PullServicePort&interfaceNamespace=http://mijnaansluiting.nl/pullservice/v0103 |
TracknTrace | https://www.dsplatform.nl/XISOAPAdapter/MessageServlet?senderParty=<PARTY>?&senderService=BC_<PARTY>&receiverParty=&receiverService=&interface=TracknTraceServicePort&interfaceNamespace=http://mijnaansluiting.nl/trackntraceservice/v0103 |
IntakeCallback | https://www.dsplatform.nl/XISOAPAdapter/MessageServlet?senderParty=<PARTY>?&senderService=BC_<PARTY>&receiverParty=&receiverService=&interface=IntakeCallbackServicePort&interfaceNamespace=http://mijnaansluiting.nl/intakeservice/v0103 |
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.
Webservice v0103 documentatie
Via de volgende URL is een ZIP bestand te downloaden waarin uitgebreide documentatie met betrekking tot webservice v0103 staat. De XSD is hierin ook opgenomen.
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'.