Offerte Service API

Inleiding

De OfferteService een cruciaal onderdeel van het http://Mijnaansluiting.nl platform, is ontworpen met een sterke nadruk op gebruiksvriendelijkheid. Deze service stelt gebruikers in staat om hun aanvragen snel en efficiënt in te dienen en te beheren.

Transformatie naar REST-gebaseerde Service

De overgang naar een REST-gebaseerde service heeft aanzienlijke verbeteringen met zich meegebracht:

• Meer flexibiliteit en schaalbaarheid

• Betere compatibiliteit met moderne architecturen, middleware en netwerken

Deze verbeteringen hebben een directe positieve impact op de gebruikerservaring, verkorten de doorlooptijd van aanvragen en verhogen de algehele efficiëntie van netwerkbeheer. Door deze transitie kunnen gebruikers nu profiteren van een robuustere en toekomstbestendige infrastructuur, wat resulteert in een meer gestroomlijnd en betrouwbaar offerteproces

Handleiding

Met deze methode kunnen gebruikers een offerte item aanmaken. De waarden in de response kunnen worden gebruikt om het offertebestand te uploaden

Het /offerte endpoint met de POST -methode biedt de functionaliteit om een offerte item aan te maken

Bij het aanmaken van een offerteitem met de POST /offerte methode, hoeven geen queryparameters worden meegegeven.

curl -X 'POST' \
  'https://[environment].mijnaansluiting.nl/services/offerte/offerte' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' 

Deze methode stelt gebruikers in staat om een specifieke offerte bij te werken. Het offerte-ID moet in de URL worden gespecificeerd, en de wijzigingen worden doorgegeven in de body van het verzoek.

Het /offerte endpoint met {offerteId} met de GET-methode biedt de functionaliteit om een offerte op te halen.

Bij het opvragen van een lijst van aanvragen met de GET /offerte/{offerteid} methode, kunnen de volgende urlparameters worden gebruikt om de resultaten te filteren en te pagineren:

1. offerteId (string): De Id van de op te halen offerte.

codevoorbeeld (curl):

curl -X PATCH\ 
-H "Authorization: Bearer [[accessToken]]"\ 
-H "Accept: application/json"\ 
-H "Content-Type: application/json"\ 
"//offerte/{offerteId}"

Deze methode stelt gebruikers in staat om de statussen van een aansluiting in een specifieke offerte bij te werken. Het offerte-ID moet in de URL worden gespecificeerd, en de wijzigingen worden doorgegeven in de body van het verzoek.

Het /offerte endpoint met {offerteId} met de PATCH-methode biedt de functionaliteit om de status van een aansluiting in een een offerte te wijzigen.

Bij het aanpassen van een offerte met de PATCH /offerte/{offerteid} methode, kunnen de volgende url-parameters worden gebruikt om de resultaten te filteren en te pagineren:

1. offerteId (string): De Id van de offerte.

codevoorbeeld (curl):

curl -X PATCH\ 
-H "Authorization: Bearer [[accessToken]]"\ 
-H "Accept: application/json"\ 
-H "Content-Type: application/json"\ 
"//offerte/{offerteId}/bulk"

Deze methode stelt gebruikers in staat om de statussen vaan aansluitingen een specifieke offerte bij te werken. Het offerte-ID moet in de URL worden gespecificeerd, en de wijzigingen worden doorgegeven in de body van het verzoek.

Het /offerte endpoint met {offerteId} met de PATCH-methode biedt de functionaliteit om de status van aansluitingen in een een offerte te wijzigen.

Bij het aanpassen van een offerte met de PATCH /offerte/{offerteid} methode, kunnen de volgende url-parameters worden gebruikt om de resultaten te filteren en te pagineren:

1. offerteId (string): De Id van de offerte.

Uitleg over het bijwerken van aanvragen met PATCH /offerte/{offerteId}

Bij het bijwerken van een offerte met de PATCH /offerte/{offerteId} methode, kunnen verschillende niveaus van specificatie worden gebruikt om te bepalen welke onderdelen van de offerte worden bijgewerkt. Hieronder volgt een gedetailleerde uitleg van de mogelijke scenario's:

1. Specificeer disciplineId's in de body:

   • Als een of meerdere disciplineId's in de body van het verzoek worden gespecificeerd, worden alleen de betreffende disciplineId's bijgewerkt.

2. Specificeer objectId's maar geen disciplineId's in de body:

   • Als een of meerdere objectId's worden gespecificeerd, maar niet de onderliggende disciplineId's, worden alle onderliggende disciplineId's van die objectId's bijgewerkt.

3. Geen objectId's of disciplineId's gespecificeerd in de body:

   • Als er geen objectId's of disciplineId's in de body worden gespecificeerd, worden alle onderliggende disciplineId's van de gehele offerte bijgewerkt.

4. Het betreft ALTIJD alleen de disciplineId’s van de betreffende netbeheerder.

5. Combinaties van bovenstaande scenario's zijn mogelijk in 1 verzoek.

Deze flexibiliteit in specificatie maakt het mogelijk om gerichte updates uit te voeren op verschillende niveaus van de offerte, afhankelijk van de verstrekte parameters in de body van het verzoek.

codevoorbeeld (curl):

curl -X PATCH\ 
-H "Authorization: Bearer [[accessToken]]"\ 
-H "Accept: application/json"\ 
-H "Content-Type: application/json"\ "//offerte/{offerteId}/bulk"

Deze methode wordt gebruikt om de intakevragen voor een specifieke offerte op te halen. Het offerte-ID moet in de URL worden gespecificeerd. Met de IntakeService kunt u voorbereidende informatie aanvragen vóór het indienen van aanvragen die onder handen zijn bij eindgebruikers. De GET /offerte/{offerteId}/intake draagt zorg voor het ontvangen van deze aanvragen, het terugsturen van informatie naar LIP+ om de onderhande zijnde offerte aan te passen gaat via een andere service: De POST /offerte/{offerteId}/intake Vervolgens kunt u het gehele traject van voortgang, wijziging of afwijzing van deze offerte in uw bestaande proces integreren met andere, aanvullende, services.

Bij het opvragen van een intake met de GET /offerte/{offerteid}/intake methode, kunnen de volgende url-parameters worden gebruikt om de resultaten te filteren en te pagineren:

1. offerteId (string): De Id van de offerte.

codevoorbeeld (curl):

curl -X GET\ 
-H "Authorization: Bearer [[accessToken]]"\ 
-H "Accept: application/json"\ 
-H "Content-Type: application/json"\ "//offerte/{offerteId}/intake"

Met deze methode kunnen netbeheerders antwoorden op intakevragen indienen voor een specifieke offerte. Het offerte-ID moet in de URL worden gespecificeerd, en de antwoorden worden in de body van het verzoek doorgegeven.

Bij het opvragen van een intake met de POST /offerte/{offerteid}/intake methode, kunnen de volgende url-parameters worden gebruikt om de resultaten te filteren en te pagineren:

1. offerteId (string): De Id van de offerte.

codevoorbeeld (curl):

curl -X POST\ 
-H "Authorization: Bearer [[accessToken]]"\ 
-H "Accept: application/json"\ 
-H "Content-Type: application/json"\ "//offerte/{offerteId}/intake"

Deze methode stelt gebruikers in staat om de aansluit-gereed data voor een specifieke offerte op te halen. Het offerte-ID moet in de URL worden gespecificeerd om de juiste gegevens te retourneren.

Bij het opvragen van een intake met de GET /offerte/{offerteId}/aansluit-gereed-datum methode, kunnen de volgende url-parameters worden gebruikt om de resultaten te filteren en te pagineren:

1. offerteId (string): De Id van de offerte.

codevoorbeeld (curl):

curl -X GET\ 
-H "Authorization: Bearer [[accessToken]]"\ 
-H "Accept: application/json"\ 
-H "Content-Type: application/json"\ "//offerte/{offerteId}/aansluit-gereed-datum"