HANDLEIDING WEBSERVICES DICOS NETWERK VERSIE 1.6

Transcriptie

1 HANDLEIDING WEBSERVICES DICOS NETWERK VERSIE 1.6 Copyright Kred it B.V. Eindhoven Niets uit deze publicatie mag worden verveelvoudigd en/of openbaar gemaakt door middel van druk, fotokopie, microfilm, geluidsband, elektronisch of op welke andere wijze dan ook en evenmin in een retrieval systeem worden opgeslagen, zonder voorafgaande schriftelijke toestemming van Kred'it B.V.

2 0 Inhoudsopgave INHOUDSOPGAVE Inhoudsopgave Inleiding Algemeen Terminologie Techniek Versie DICOSCentrale Server Inleiding Algemeen LoginService Algemeen DICOSCentraleLoginAanmeldNaam LoginService.DICOSCentraleLogin DICOSCentraleLogout VerzoekNieuwWachtwoord ImAlive BeheerService Algemeen GetMedewerkerOverzicht GetMedewerker WijzigMedewerker NieuweMedewerker VerwijderMedewerker GetMeldingOverzicht GetMelding WijzigMedewerkerWachtwoord ZoekMedewerker AbonnementOpzeggen SchuldhulpService Algemeen GetSaldoVraagOverzicht GetSaldoVraag WijzigSaldoVraag NieuweSchuld GetSaldoVoorstelOverzicht GetSaldoVoorstel WijzigSaldoVoorstel GetAankondigingEindeOverzicht GetAankondigingEinde WijzigAankondigingEinde GetMeldingOverzicht GetMelding WijzigMelding GetKlantnummer GetKlant GetKlantSchuld GetAlleKlanten GetManagementInfo BBRService Versie: 16 september 2012 Blz.: 2 van 66

3 0 Inhoudsopgave Algemeen GetBBRAanmeldingOverzicht GetBBRAanmelding VerwerkBBRAanmelding GetBBROpdrachtOverzicht GetBBROpdracht VerwerkBBROpdracht GetBBROpdrachtCSV PutBBROpdrachtCSV GetBBRAfmeldingOverzicht GetBBRAfmelding VerwerkBBRAfmelding GetKlantnummer GetKlant GetKlantOpdracht GetAlleKlanten GetManagementInfo BerekeningService Algemeen GetVTLB DICOSAllegro Server Bijlage 1 - Structures van de webservices Inleiding AWUserInfo TMedewerker-Header en -Detail TMelding TKlantMelding-Header en -Detail TKlantGegevens TKlantGegevensAdres TKlantNummer TSchuldSharedHeader TSaldoVraag-Header en -Detail TDossierMedewerker TSaldoVoorstel-Header en -Detail TAankondigingEinde-Header en -Detail TKlantSchuld-Header en -Detail TOpdrachtSharedHeader TBBRAanmelding-Header en -Detail TBBROpdracht-Header en -Detail TBBRAfmelding-Header en -Detail TKlantOpdracht-Header en -Detail TFiltersettings TPaginaInfo TSorteerInfo Esortering(Enumerated type) TSRInfo TSRInfoCentrale TBBRInfoCentrale TDICOSGUID Bijlage 2 Foutmeldingen van de webservices Inleiding Meldingen Versie: 16 september 2012 Blz.: 3 van 66

4 1 Inleiding 1 INLEIDING 1.1 ALGEMEEN Deze handleiding heeft betrekking op het communicatie netwerk DICOS van Kred it. DICOS is een communicatie netwerk tussen schuldeisers (debiteuren, waaronder bijvoorbeeld ook allerlei organisaties vallen die in het budgetplan van klanten van schuldhulpverlenende instanties voorkomen) en schuldhulpverlenende organisaties (Allegro organisatie). DICOS staat voor Digitale communicatie met schuldeisers/schuldhulpverleners. Met behulp van DICOS kunnen gegevens digitaal, middels webservices, worden uitgewisseld. Voor de schuldhulpverlening betekent dit bijvoorbeeld het digitaal uitwisselen van verzoeken om en antwoorden met saldo-opgaaf van schulden. Voor budgetbeheer betekent dit bijvoorbeeld de aanlevering van maandelijkse facturen van klanten aan schuldhulpverlenende instanties. DICOS wordt uitgebreid beschreven in onder meer de 'Informatie analyse website DICOS'. In deze handleiding worden uitsluitend de te gebruiken webservices beschreven. Het onttrekken uit en aanleveren van gegevens aan Allegro, via de DICOS Centrale, wordt gerealiseerd met webservices. Het verwerken van gegevens gebeurt in Allegro via Allegro Portier. Daarnaast zijn enige andere functionaliteiten in Allegro van belang. Deze functionaliteiten worden in deze handleiding niet beschreven. DICOS is uitsluitend beschikbaar voor Allegro 3.0 en hoger. 1.2 TERMINOLOGIE In deze beschrijving wordt de volgende terminologie gebruikt: Allegro organisatie = een organisatie die met Allegro werkt (en dus schuldhulpverleningstrajecten en/of budgetbeheer uitvoert) Relatie = een persoon of organisatie die als relatie in Allegro is opgenomen. Schuldeiser = een organisatie die als schuldeiser of debiteur voorkomt in schuldhulpverleningstrajecten en/of budgetplannen. 1.3 TECHNIEK Voor de communicatie wordt gebruik gemaakt van SOAP-webservices, met in de header een zogenaamde 'sessionguid'. Bij aanmelden bij het DICOS netwerk (zie paragraaf 0) wordt een 'session-id' terug gegeven, die vervolgens weer meegegeven moet worden in de header van de daaropvolgende aanroepen van webservices. De webservices kunnen in 2 groepen worden gesplitst: De webservices die door de schuldeisers worden aangeroepen en beschikbaar zijn in de DICOS Centrale. Deze webservices vormen samen de DICOSCentrale Server. Deze webservices worden ook aangeroepen vanuit de website DICOS. Versie: 16 september 2012 Blz.: 4 van 66

5 1 Inleiding De webservices die door de Centrale worden aangeroepen bij de diverse Allegro organisaties en beschikbaar zijn in Allegro (module DICOS). Deze webservices vormen samen de DICOSAllegro Server. Schuldeiser Schuldeiser Website DICOS Centrale DICOSCentrale Server Allegroorganisatie DICOSAllegro Server Allegroorganisatie DICOSAllegro Server 1.4 VERSIE Versie 1.6 van deze handleiding is de juni versie van dit document, waarin zowel de SRals BBR-communicatie zijn getoetst en aangepast aan de ontwerpen voor Allegro DICOS en DICOS Beheer. Versie: 16 september 2012 Blz.: 5 van 66

6 2 DICOSCentrale Server 2 DICOSCENTRALE SERVER 2.1 INLEIDING Algemeen In dit hoofdstuk wordt een opsomming gegeven van de beschikbare webservices in de DICOS Centrale Server. Dit zijn de webservices die door schuldeisers en door de website DICOS aangeroepen kunnen worden. Van iedere webservice is een korte beschrijving opgenomen. Voor uitgebreide informatie over de webservices kan de WSDL worden geraadpleegd. Bij verschillende webservices wordt ook verwezen naar de structures. De structures zijn als bijlage opgenomen. Het betreft SOAP-webservices, met in de header een zogenaamde 'sessionguid'. Bij aanmelden bij DICOS wordt een 'session-id' terug gegeven, die vervolgens weer meegegeven moet worden in de header van de daaropvolgende aanroepen van webservices. Voorbeeld (C#): if (bgelukt) -- als de login gelukt is { Session["LoggedIn"] = true; Session.Timeout = 60; Session["SessionID"] = usr.sessionid; Session["Relatie"] = usr.relatie; Session["LastLogin"] = usr.laatstelogin; } Response.Redirect("AW_Home.aspx"); en dan vervolgens: protected void Page_Load(object sender, EventArgs e) { XService svcx = new XService(); svcx.url = DICOSWebSite.Properties.Settings.Default.DICOSWebSite_WRXService_XService; } ROClientIDHeader hdrroclientid = new ROClientIDHeader(); hdrroclientid.id = Convert.ToString(Session["SessionID"]); svcx.roclientidheadervalue = hdrroclientid; Versie: 16 september 2012 Blz.: 6 van 66

7 2 DICOSCentrale Server 2.2 LOGINSERVICE Algemeen De LoginService bevat alle methoden die te maken hebben met het aanmelden bij de DICOS Centrale DICOSCentraleLoginAanmeldNaam De service LoginService.DICOSCentraleLoginAanmeldNaam controleert of een persoon (medewerker bij een schuldeiser), door middel van ingegeven organisatienummer, aanmeldnaam en wachtwoord, toegang heeft tot de DICOS Centrale. De service vult ook, indien de persoon bekend is bij de Centrale, diverse gegevens bij de medewerker in de Centrale (zoals bijvoorbeeld datum en tijdstip laatste aanmelding bij de Centrale). Deze service dient dus gebruikt te worden indien een persoon zich aanmeldt bij de centrale. Output: Organisatienummer, aanmeldnaam en wachtwoord Gegevens van de persoon in de AWUserInfo (Organisatienaam, Achternaam medewerker, Voornaam medewerker, Geslacht medewerker, Telefoonnummer medewerker, adres medewerker, laatste aanmelddatum bij de Centrale, Indicatie Schuldhulpverlening, Indicatie Budgetbeheer, Indicatie Beheerder, Blokkering) (Zie ook paragraaf 4.2) Wachtwoord niet juist Geen gebruiker met deze aanmeldnaam Geen toegang (geblokkeerd) DICOSCentraleLogin De service LoginService.DICOSCentraleLogin controleert of een persoon (medewerker bij een schuldeiser), door middel van een ingegeven adres en wachtwoord toegang heeft tot de DICOS Centrale. De service vult ook, indien de persoon bekend is bij de Centrale, diverse gegevens bij de medewerker in de Centrale (zoals bijvoorbeeld datum en tijdstip laatste aanmelding bij de Centrale). Deze service dient dus gebruikt te worden indien een persoon zich aanmeldt bij de centrale. Output: adres en wachtwoord. Gegevens van de persoon in de AWUserInfo (Organisatienaam, Achternaam medewerker, Voornaam medewerker, Geslacht medewerker, Telefoonnummer medewerker, adres medewerker, laatste aanmelddatum bij de Centrale, Versie: 16 september 2012 Blz.: 7 van 66

8 2 DICOSCentrale Server Indicatie Schuldhulpverlening, Indicatie Budgetbeheer, Indicatie Beheerder, Blokkering) (Zie ook paragraaf 4.2). En daarnaast wordt de boolean ( true of false ) bwachtwoordwijzigen meegegeven om aan te geven of het wachtwoord gewijzigd dient te worden Wachtwoord niet juist Geen gebruiker met deze aanmeldnaam Geen toegang (geblokkeerd) adres niet gevuld Geen gebruiker met dit adres DICOSCentraleLogout Door de service LoginService.DICOSCentraleLogout aan te roepen wordt de huidige gebruiker uitgelogd uit de Centrale. - Output : Sessie niet gevonden VerzoekNieuwWachtwoord Door het aanroepen van de service LoginService.VerzoekNieuwWachtwoord wordt een verstuurd door de Centrale naar het opgegeven adres, mits bekend bij de Centrale. Output: Geen gebruiker met deze aanmeldnaam ImAlive Door het aanroepen van de service LoginService.ImAlive wordt als resultaat een boolean teruggeven die aangeeft of de gebruikerssessie nog actief is - Versie: 16 september 2012 Blz.: 8 van 66

9 2 DICOSCentrale Server Output: - ExtraInfoOmschrijving, wanneer het resultaat van de aanroep false is. Versie: 16 september 2012 Blz.: 9 van 66

10 2 DICOSCentrale Server 2.3 BEHEERSERVICE Algemeen De BeheerService bevat alle methoden die te maken hebben met het beheer van de diverse gegevens van de schuldeiser, zoals het beheer van medewerkers bij de schuldeiser die toegang moeten krijgen tot de DICOS Centrale GetMedewerkerOverzicht De service BeheerService.GetMedewerkerOverzicht geeft de gegevens van alle medewerkers van een schuldeiser (uniek organisatienummer), met uitzondering van de gegevens van de beheerder. Deze service kan gebruikt worden om gegevens op te halen van medewerkers. Output: Organisatienummer Gegevens van de medewerkers (Achternaam, voornaam, aanmeldnaam, wachtwoord, geslacht, telefoonnummer, etc.) in een array van de structure TMedewerkerDetail (zie paragraaf 4.3) GetMedewerker De service BeheerService.GetMedewerker geeft de gegevens van een specifieke medewerker van een schuldeiser (uniek organisatienummer). Deze service kan gebruikt worden om gegevens op te halen van één specifieke medewerker. Gegevens van de beheerder worden niet via deze service gegeven. Output: Organisatienummer, aanmeldnaam medewerker Gegevens van de medewerker (Achternaam, voornaam, aanmeldnaam, wachtwoord, geslacht, telefoonnummer, etc.) in de structure TMedewerkerDetail (zie paragraaf 4.3) Geen gebruiker met deze aanmeldnaam Dit betreft beheerder gegevens Versie: 16 september 2012 Blz.: 10 van 66

11 2 DICOSCentrale Server WijzigMedewerker De service BeheerService.WijzigMedewerker stuurt gewijzigde gegevens van een specifieke medewerker naar de DICOS Centrale. Deze service kan gebruikt worden wanneer de beheerder gegevens van een specifieke medewerker wilt wijzigen. Gegevens van de beheerder mogen niet via deze service gewijzigd worden (wijzigingen moeten op een andere wijze worden doorgegeven aan de DICOS Centrale). Gegevens die via deze webservice gewijzigd kunnen worden zijn: o Achternaam o Voornaam o Wachtwoord o Geslacht o Telefoonnummer o adres o Indicatie Schuldhulpverlening o Indicatie Budgetbeheer o Blokkering. Gegevens van de medewerker (Achternaam, voornaam, aanmeldnaam, wachtwoord, geslacht, telefoonnummer, etc.) in de structure TMedewerkerDetail (zie paragraaf 4.3). Output: - N.B. eventueel via deze webservice doorgegeven wijzigingen in de gegevens 'Aanmeldnaam', 'Laatste aanmelddatum' en 'Indicatie Beheerder' zullen door de DICOS Centrale nooit worden doorgevoerd Geen gebruiker met deze aanmeldnaam Dit betreft beheerder gegevens NieuweMedewerker De service BeheerService.NieuweMedewerker stuurt nieuwe gegevens van een specifieke medewerker naar de DICOS Centrale. Deze service kan gebruikt worden wanneer de beheerder gegevens van een nieuwe medewerker wilt toevoegen. Gegevens die, voor het toevoegen van een medewerker, via deze webservice gevuld kunnen worden zijn: o Achternaam o Voornaam o Aanmeldnaam o Wachtwoord o Geslacht Versie: 16 september 2012 Blz.: 11 van 66

12 2 DICOSCentrale Server o Telefoonnummer o adres o Indicatie Schuldhulpverlening o Indicatie Budgetbeheer o Blokkering. Voor het succesvol toevoegen van een nieuwe medewerker zijn minimaal 'Aanmeldnaam' en 'Wachtwoord' noodzakelijk. Gegevens van de medewerker (Achternaam, voornaam, aanmeldnaam, wachtwoord, geslacht, telefoonnummer, etc.) in de structure TMedewerkerDetail (zie paragraaf 4.3). Output: - N.B. eventueel via deze webservice doorgegeven wijzigingen in de gegevens 'Aanmeldnaam', 'Laatste aanmelddatum' en 'Indicatie Beheerder' zullen door de DICOS Centrale nooit worden doorgevoerd Aanmeldnaam niet gevuld Wachtwoord niet gevuld Deze aanmeldnaam komt al voor VerwijderMedewerker De service BeheerService.VerwijderMedewerker verwijdert gegevens van een specifieke medewerker van de DICOS Centrale. Deze service kan gebruikt worden wanneer de beheerder gegevens van een medewerker wilt verwijderen. Gegevens van de beheerder mogen niet via deze service verwijderd worden Organisatienummer, aanmeldnaam medewerker Output: Geen gebruiker met deze aanmeldnaam Dit betreft beheerder gegevens Versie: 16 september 2012 Blz.: 12 van 66

13 2 DICOSCentrale Server GetMeldingOverzicht De service BeheerService.GetMeldingOverzicht geeft de gegevens van alle meldingen van de DICOS Centrale vanaf een bepaalde datum. Deze service kan gebruikt worden om nieuwe meldingen op te halen. Dit kunnen bijvoorbeeld meldingen zijn over gepland onderhoud op de Centrale, of wijzigingen aan de website, of wijzigingen aan de webservices. Datum vanaf Output: Gegevens van diverse meldingen (datum melding, volgnummer melding, soort melding, tekst) in een array van de structure TMelding (zie paragraaf 4.4). ExtraInfoOmschrijving, wanneer het resultaat van de aanroep false is GetMelding De service BeheerService.GetMelding geeft de gegevens van een specifieke melding. Deze service kan gebruikt worden om gegevens op te halen van een specifieke melding. Output: Datum melding, volgnummer melding Gegevens van de melding (datum melding, volgnummer melding, soort melding, tekst) in de structure TMelding (zie paragraaf 4.4) Geen melding van deze datum Geen melding met dit volgnummer WijzigMedewerkerWachtwoord De service Beheerservice.WijzigMedewerkerWachtwoord wijzigt, mits het correcte huidige medewerker wachtwoord is ingegeven, het huidige medewerker wachtwoord. Organisatienummer, Medewerkercode, WachtwoordOud, WachtwoordNieuw Output: Wachtwoord niet juist Dit betreft beheerder gegevens Geen toegang tot deze organisatie Medewerker onbekend Versie: 16 september 2012 Blz.: 13 van 66

14 2 DICOSCentrale Server ZoekMedewerker De service Beheerservice.ZoekMedewerker geeft de gegevens van alle medewerkers van de organisatie terug die voldoen aan het zoekcriterium. Output: OrganisatieNummer, Naam(zoek criteria) Gegevens van de medewerkers die voldoen aan het zoekcriterium (Achternaam, voornaam, aanmeldnaam, wachtwoord, geslacht, telefoonnummer, etc.) in een array van de structure TMedewerkerHeader (zie paragraaf 4.3) Geen toegang tot deze organisatie AbonnementOpzeggen Met de service Beheerservice.abonnementOpzeggen kan de organisatie zijn/haar DICOS abonnement opzeggen. De service verzend na akkoord een bevestiging per naar de organisatie. Organisatienummer, Opzegdatum, OpzeggingsReden Output: - ExtraInfoOmschrijving, wanneer het resultaat van de aanroep false is. Versie: 16 september 2012 Blz.: 14 van 66

15 2 DICOSCentrale Server 2.4 SCHULDHULPSERVICE Algemeen De SchuldhulpService bevat alle methoden die te maken hebben met schuldhulpverlening. Of een medewerker deze webservices mag aanroepen, kan, desgewenst, afgevraagd worden middels de indicatie Schuldhulpverlening bij de aangemelde medewerker (zie LoginService) GetSaldoVraagOverzicht De service SchuldhulpService.GetSaldoVraagOverzicht kan worden gebruikt om alle klaarstaande verzoeken tot saldo opgaaf van de aangesloten Allegro organisaties voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Output: Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) De gegevens van alle verzoeken tot saldo opgaaf in een array van de structure TSaldoVraagHeader (zie paragraaf 4.10). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de daar klaarstaande verzoeken tot saldo opgaaf ophalen via de DICOSAllegro Server. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TSaldoVraagHeader worden teruggegeven Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening GetSaldoVraag De service SchuldhulpService.GetSaldoVraag kan worden gebruikt om één specifiek verzoek tot saldo opgaaf van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Output: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode, Allegro schuld volgnummer (identificerende gegevens juiste schuld, kunnen worden gehaald uit de eerder opgehaalde array). De gegevens van het verzoek tot saldo opgaaf in de structure TSaldoVraagDetail (zie paragraaf 4.10). Versie: 16 september 2012 Blz.: 15 van 66

16 2 DICOSCentrale Server De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en het specifieke verzoek tot saldo opgaaf ophalen via de DICOSAllegro Server Allegro organisatienummer onbekend Contract onbekend Schuld onbekend Saldo opgaaf is reeds gedaan Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken WijzigSaldoVraag De service SchuldhulpService.WijzigSaldoVraag kan worden gebruikt om één specifiek verzoek tot saldo opgaaf van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser af te handelen. Ter identificatie van de juiste schuld: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode en Allegro schuld volgnummer uit de structure TSaldoVraagHeader (zie paragraaf 4.10). Wijzigingen: klantnummer (verplicht te vullen), bedrag (saldo), referentie, overgedragen aan incassobureau (indicatie ja/nee), overgedragen aan incassobureau (tekstveld), opmerkingen (tekstveld) Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de wijzigingen én verwerken in de Centrale (klantnummer) én in een mutatie plaatsen in Allegro Portier, zodat de wijzigingen verder in Allegro afgehandeld kunnen worden (teruggemeld bedrag, teruggemelde referentie, overgedragen aan incassobureau en opmerkingen). Bij het plaatsen van de mutatie in Allegro Portier zullen ook de datum en gegevens van de medewerker van de schuldeiser die de saldo opgaaf heeft afgehandeld worden meegegeven (voornaam en achternaam medewerker, telefoonnummer en adres). Afhankelijk van welke gegevens wel of niet gevuld zijn (gewijzigd zijn) kunnen hierdoor verschillende soorten mutaties in Allegro Portier ontstaan Allegro organisatienummer onbekend Contract onbekend Versie: 16 september 2012 Blz.: 16 van 66

17 2 DICOSCentrale Server Schuld onbekend Saldo opgaaf is reeds gedaan Teruggemeld bedrag niet gevuld Klantnummer niet gevuld Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken NieuweSchuld De service SchuldhulpService.NieuweSchuld kan worden gebruikt om een extra schuld aan te melden bij een specifiek contract (aanvraag) van een aangesloten Allegro organisatie. De gegevens die nodig zijn ter identificatie van het juiste contract (aanvraag) en de juiste relatie (klantnummer schuldeiser kunnen worden gehaald uit een eerdere opvraag van, bijvoorbeeld GetSaldoVraag: voor deze klant wordt om saldo-opgaaf verzocht, maar van die klant hebben we nog een schuld openstaan. Het is wel noodzakelijk dat het klantnummer van de schuldeiser dan reeds bekend is in de DICOS Centrale. Ter identificatie van de juiste relatie: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Klantnummer, Wijzigingen: nieuw bedrag (verplicht te vullen), nieuwe referentie (verplicht te vullen), opmerkingen (tekstveld) Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de nieuwe schuld (bedrag, referentie, opmerkingen) in een mutatie plaatsen van Allegro Portier, zodat de toevoeging verder in Allegro afgehandeld kan worden. Bij het plaatsen van de mutatie in Allegro Portier zullen ook de datum en gegevens van de medewerker van de schuldeiser die de schuld heeft gemeld worden meegegeven (voornaam en achternaam medewerker, telefoonnummer en adres) Allegro organisatienummer onbekend Contract onbekend Klantnummer onbekend Bedrag niet gevuld Referentie niet gevuld Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken Klantnummer in deze SR-aanvraag onbekend Versie: 16 september 2012 Blz.: 17 van 66

18 2 DICOSCentrale Server GetSaldoVoorstelOverzicht De service SchuldhulpService.GetSaldoVoorstelOverzicht kan worden gebruikt om alle klaarstaande voorstellen tot saldo terugbetaling van de aangesloten Allegro organisaties voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) Output: De gegevens van alle verzoeken tot saldo terugbetaling in een array van de structure TSaldoVoorstelHeader (zie paragraaf 4.12). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de daar klaarstaande voorstellen tot saldo terugbetaling ophalen via de DICOSAllegro Server. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TSaldoVoorstelHeader worden teruggegeven Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening GetSaldoVoorstel De service SchuldhulpService.GetSaldoVoorstel kan worden gebruikt om één specifiek voorstel tot saldo terugbetaling van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Output: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode, Allegro schuld volgnummer (identificerende gegevens juiste schuld, kunnen worden gehaald uit de eerder opgehaalde array) De gegevens van het voorstel tot saldo terugbetaling in de structure TSaldoVoorstelDetail (zie paragraaf 4.12). De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en het specifieke voorstel tot saldo terugbetaling ophalen via de DICOSAllegro Server. Versie: 16 september 2012 Blz.: 18 van 66

19 2 DICOSCentrale Server ExtraInfoOmschrijving: Allegro organisatienummer onbekend Contract onbekend Schuld onbekend Saldo voorstel is reeds beantwoord Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken WijzigSaldoVoorstel De service SchuldhulpService.WijzigSaldoVoorstel kan worden gebruikt om één specifiek voorstel tot saldo terugbetaling van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser af te handelen. Ter identificatie van de juiste schuld: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode en Allegro schuld volgnummer uit de structure TSaldoVoorstelHeader (zie paragraaf 4.12). Wijzigingen: akkoord (ja/nee verplicht te vullen), overgedragen aan incassobureau (boolean( true of false )), overgedragen aan incassobureau omschrijving (tekstveld), opmerkingen (tekstveld) Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de wijzigingen (akkoord ja/nee, overgedragen aan incassobureau, overgedragen aan incassobureau omschrijving, opmerkingen) in een mutatie plaatsen van Allegro Portier, zodat de wijzigingen verder in Allegro afgehandeld kunnen worden. Bij het plaatsen van de mutatie in Allegro Portier zullen ook de datum en gegevens van de medewerker van de schuldeiser die het saldo voorstel heeft afgehandeld worden meegegeven (voornaam en achternaam medewerker, telefoonnummer en adres). Afhankelijk van welke gegevens wel of niet gevuld zijn (gewijzigd zijn) kunnen hierdoor verschillende soorten mutaties in Allegro Portier ontstaan. Indien ook een wijziging in het klantnummer is doorgegeven, zal deze wijziging verwerkt worden in de Centrale. Het kan zijn dat het klantnummer nu pas initieel wordt doorgegeven (de schuldeiser is pas opgenomen in DICOS nadat de aanmelding al heeft plaats gevonden of de SHV is pas gestart met DICOS nadat de aanmelding al heeft plaats gevonden) Allegro organisatienummer onbekend Versie: 16 september 2012 Blz.: 19 van 66

20 2 DICOSCentrale Server Contract onbekend Schuld onbekend Saldo voorstel is reeds beantwoord Akkoord ja/nee niet gevuld Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken GetAankondigingEindeOverzicht De service SchuldhulpService.GetAankondigingEindeOverzicht kan worden gebruikt om alle klaarstaande aankondigingen beëindiging SR(-NPS) waarop gereageerd moet worden van de aangesloten Allegro organisaties voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) Output: De gegevens van alle aankondigingen beëindiging in een array van de structure TAankondigingEindeHeader (zie paragraaf 4.13). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de daar klaarstaande voorstellen tot saldo terugbetaling ophalen via de DICOSAllegro Server. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TAankondigingEindeHeader worden teruggegeven Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening GetAankondigingEinde De service SchuldhulpService.GetAankondigingEinde kan worden gebruikt om één specifieke aankondiging beëindiging van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode, Allegro schuld volgnummer (identificerende gegevens juiste schuld, kunnen worden gehaald uit de eerder opgehaalde array) Versie: 16 september 2012 Blz.: 20 van 66

21 2 DICOSCentrale Server Output: De gegevens van de aankondiging beëindiging in de structure TAankondigingEindeDetail (zie paragraaf 4.13). De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de specifieke aankondiging beëindiging ophalen via de DICOSAllegro Server Allegro organisatienummer onbekend Contract onbekend Schuld onbekend Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken Aankondiging beëindiging is reeds afgehandeld WijzigAankondigingEinde De service SchuldhulpService.WijzigAankondigingEinde kan worden gebruikt om één specifieke aankondiging beëindiging van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser af te handelen. Ter identificatie van de juiste schuld: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode en Allegro schuld volgnummer uit de structure TAankondigingEindeHeader (zie paragraaf 4.13). Wijzigingen: akkoord (ja/nee verplicht te vullen), klantnummer, opmerkingen (tekstveld) Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de wijzigingen (akkoord ja/nee en opmerkingen) in een mutatie plaatsen van Allegro Portier, zodat de wijzigingen verder in Allegro afgehandeld kunnen worden. Bij het plaatsen van de mutatie in Allegro Portier zullen ook de datum en gegevens van de medewerker van de schuldeiser die het saldo voorstel heeft afgehandeld worden meegegeven (voornaam en achternaam medewerker, telefoonnummer en adres). Indien ook een wijziging in het klantnummer is doorgegeven, zal deze wijziging verwerkt worden in de Centrale. Het kan zijn dat het klantnummer nu pas initieel wordt doorgegeven (de schuldeiser is pas later opgenomen in DICOS of de SHV is pas later gestart met DICOS). Versie: 16 september 2012 Blz.: 21 van 66

22 2 DICOSCentrale Server Allegro organisatienummer onbekend Contract onbekend Schuld onbekend Akkoord ja/nee niet gevuld Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken Aankondiging beëindiging is reeds afgehandeld GetMeldingOverzicht De service SchuldhulpService.GetMeldingOverzicht kan worden gebruikt om alle klaarstaande meldingen van de aangesloten Allegro organisaties betreffende schuldhulpverlening voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) Output: De gegevens van alle meldingen in een array van de structure TKlantMeldingHeader (zie paragraaf 4.5). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de daar klaarstaande meldingen voor schuldhulpverlening ophalen via de DICOSAllegro Server. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TKlantMeldingHeader worden teruggegeven Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening GetMelding De service SchuldhulpService.GetMelding kan worden gebruikt om één specifieke melding van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Allegro organisatienummer, Allegro Melding Volgnummer (identificerende gegevens juiste melding, kunnen worden gehaald uit de eerder opgehaalde array) Output: De gegevens van de melding in de structure TKlantMeldingDetail (zie paragraaf 4.5). Versie: 16 september 2012 Blz.: 22 van 66

23 2 DICOSCentrale Server De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de specifieke melding ophalen via de DICOSAllegro Server Allegro organisatienummer onbekend Melding onbekend Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken Geen Schuldhulpverlening melding WijzigMelding De service SchuldhulpService.WijzigMelding kan worden gebruikt om één specifieke melding van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser af te handelen ('gelezen'). Organisatienummer, Allegro organisatienummer, Allegro Melding Volgnummer (identificerende gegevens juiste melding, kunnen worden gehaald uit de eerder opgehaalde array) Wijzigingen: klantnummer Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en daar de juiste service aanroepen. Indien ook een wijziging in het klantnummer is doorgegeven, zal deze wijziging verwerkt worden in de Centrale. Het kan zijn dat het klantnummer nu pas initieel wordt doorgegeven (de schuldeiser is pas later opgenomen in DICOS of de SHV is pas later gestart met DICOS) Allegro organisatienummer onbekend Melding onbekend Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken Geen Schuldhulpverlening melding Versie: 16 september 2012 Blz.: 23 van 66

24 2 DICOSCentrale Server GetKlantnummer De service SchuldhulpService.GetKlantNummer kan worden gebruikt om aan de hand van een ingegeven klantnummer de Allegro organisaties te achterhalen waar voor deze klant voor de, bij de DICOS Centrale aangemelde, schuldeiser schuldhulpverlening wordt uitgevoerd. Output: Organisatienummer, klantnummer De gegevens van de gevonden Allegro organisaties in de structure TKlantNummer (zie paragraaf 4.8). De DICOS Centrale zal, voor afhandeling van deze service, gegevens gebruiken uit de Centrale Klantnummer onbekend Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening GetKlant De service SchuldhulpService.GetKlant kan worden gebruikt om gegevens van de schuldhulpverlening van één specifieke klant van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Output: Organisatienummer, Allegro organisatienummer (kan worden gehaald uit de eerder opgehaalde array van GetKlantNummer), klantnummer De gegevens in een array (er kunnen immers meerdere schulden van één klant zijn voor deze schuldeiser bij dezelfde Allegro organisatie) van de structure TKlantSchuldHeader (zie paragraaf 4.14). De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de gegevens ophalen via de DICOSAllegro Server Allegro organisatienummer onbekend Contract onbekend Schuld onbekend Klantnummer onbekend Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met Versie: 16 september 2012 Blz.: 24 van 66

25 2 DICOSCentrale Server schuldhulpverlenende organisatie is verstreken GetKlantSchuld De service SchuldhulpService.GetKlantSchuld kan worden gebruikt om alle gegevens van één specifieke schuld van één specifieke klant van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro schuld relatiecode, Allegro schuld volgnummer (identificerende gegevens juiste schuld, kunnen worden gehaald uit de eerder opgehaalde array) Output: De gegevens van de schuld in de structure TKlantSchuldDetail (zie paragraaf 4.14). De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en daar de juiste service aanroepen Allegro organisatienummer onbekend Contract onbekend Schuld onbekend Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Maximale tijd voor tot stand brengen verbinding met schuldhulpverlenende organisatie is verstreken GetAlleKlanten De service SchuldhulpService.GetAlleKlanten kan worden gebruikt om alle klanten van de aangesloten Allegro organisaties op te halen waar voor de, bij de DICOS Centrale aangemelde, schuldeiser schuldhulpverlening wordt uitgevoerd. Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) Output: De gegevens in een array van de structure TKlantSchuldHeader (zie paragraaf 4.14). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de daar bekende schulden ophalen via de DICOSAllegroServer. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TKlantSchuldHeader worden teruggegeven. Versie: 16 september 2012 Blz.: 25 van 66

26 2 DICOSCentrale Server Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening GetManagementInfo De service SchuldhulpService.GetManagementInfo kan worden gebruikt om een managementinformatie op te halen voor de, bij de DICOS Centrale aangemelde, schuldeiser. Organisatienummer Output: ManagementInfo (In de structure TSRInfoCentrale zie paragraaf 4.25), ManagementInfoOnvolledig (Boolean( true of false ) De boolean ManagementInfoOnvolledig geeft aan of alle schuldhulpverlenende instanties konden worden bereikt, en zodoende dus een volledig overzicht aan managementinfo. Kan worden gegeven. Waarbij geldt true = onvolledig en false =volledig Organisatie geen toegang tot schuldhulpverlening Medewerker geen toegang tot schuldhulpverlening Versie: 16 september 2012 Blz.: 26 van 66

27 2 DICOSCentrale Server 2.5 BBRSERVICE Algemeen De BBRService bevat alle methoden die te maken hebben met budgetbeheer. Of een medewerker deze webservices mag aanroepen, kan, desgewenst, afgevraagd worden middels de indicatie Budgetbeheer bij de aangemelde medewerker (zie o.a. LoginService) GetBBRAanmeldingOverzicht De service BBRService.GetBBRAanmeldingOverzicht kan worden gebruikt om alle klaarstaande aanmeldingen voor budgetbeheer van de aangesloten Allegro organisaties voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) Output: De gegevens van alle aanmeldingen voor budgetbeheer in een array van de structure TBBRAanmeldingHeader (zie paragraaf 4.16). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de daar klaarstaande aanmeldingen voor budgetbeheer ophalen via de DICOSAllegro Server. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TBBRAanmeldingHeader worden teruggegeven Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer GetBBRAanmelding De service BBRService.GetBBRAanmelding kan worden gebruikt om één specifieke aanmelding voor budgetbeheer van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Output: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro opdracht soort, Allegro opdracht reservering, Allegro opdracht relatiecode, Allegro opdracht volgnummer (identificerende gegevens juiste opdracht, kunnen worden gehaald uit de eerder opgehaalde array). De gegevens van de aanmelding in de structure TBBRAanmeldingDetail (zie paragraaf 4.16). Versie: 16 september 2012 Blz.: 27 van 66

28 2 DICOSCentrale Server De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de specifieke aanmelding voor budgetbeheer ophalen via de DICOSAllegro Server Allegro organisatienummer onbekend Contract onbekend Opdracht onbekend Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer VerwerkBBRAanmelding De service BBRService.VerwerkBBRAanmelding kan worden gebruikt om één specifieke aanmelding voor budgetbeheer van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser af te handelen ( gelezen ). Ter identificatie van de juiste opdracht: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro opdracht soort, Allegro opdracht reservering, Allegro opdracht relatiecode en Allegro opdracht volgnummer uit de structure TOpdrachtSharedHeader (zie paragraaf 4.15). Wijzigingen: klantnummer (verplicht te vullen) Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de wijzigingen én verwerken in de Centrale (klantnummer) én in Allegro Allegro organisatienummer onbekend Contract onbekend Opdracht onbekend Klantnummer niet gevuld Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer Versie: 16 september 2012 Blz.: 28 van 66

29 2 DICOSCentrale Server GetBBROpdrachtOverzicht De service BBRService.GetBBROpdrachtOverzicht kan worden gebruikt om alle opdrachten voor budgetbeheer van de aangesloten Allegro organisaties voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Organisatienummer, Filter gegevens in de structure TFilterSettings(zie Paragraaf 4.20), Sortering gegevens in de structure TSorteerInfo(zie Paragraaf 4.22), Pagina gegevens in de structure TPaginaInfo(zie Paragraaf 4.21) Output: De gegevens van alle opdrachten voor budgetbeheer in een array van de structure TBBROpdrachtHeader(zie paragraaf 4.9). De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken en de opdrachten voor budgetbeheer ophalen via de DICOSAllegro Server. Afhankelijk van de Filter, Sortering en Pagina gegevens zullen de gegevens in een array van de structure TBBRAanmeldingHeader worden teruggegeven Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer GetBBROpdracht De service BBRService.GetBBROpdracht kan worden gebruikt om één specifieke opdracht voor budgetbeheer van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser op te halen. Output: 4.17). Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro opdracht soort, Allegro opdracht reservering, Allegro opdracht relatiecode, Allegro opdracht volgnummer (identificerende gegevens juiste schuld, kunnen worden gehaald uit de eerder opgehaalde array). De gegevens van de opdracht in de structure TBBROpdrachtDetail (zie paragraaf De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de specifieke opdracht voor budgetbeheer ophalen via de DICOSAllegro Server. Versie: 16 september 2012 Blz.: 29 van 66

30 2 DICOSCentrale Server Allegro organisatienummer onbekend Contract onbekend Opdracht onbekend Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer VerwerkBBROpdracht De service BBRService.VerwerkBBROpdracht kan worden gebruikt om één specifieke opdracht voor budgetbeheer van een aangesloten Allegro organisatie voor de, bij de DICOS Centrale aangemelde, schuldeiser te wijzigen. Ter identificatie van de juiste opdracht: Organisatienummer, Allegro organisatienummer, Allegro contract relatiecode, Allegro contract volgnummer, Allegro opdracht soort, Allegro opdracht reservering, Allegro opdracht relatiecode en Allegro opdracht volgnummer uit de structure TOpdrachtSharedHeader(zie paragraaf 4.15). Wijzigingen: klantnummer, periodebedrag, referentie, opmerkingen (tekstveld) Output: - De DICOS Centrale zal, voor afhandeling van deze service, met de aangegeven Allegro organisatie contact maken en de wijzigingen én verwerken in de Centrale (klantnummer) én in een mutatie plaatsen in Allegro Portier, zodat de wijzigingen verder in Allegro afgehandeld kunnen worden (periode bedrag, referentie en opmerkingen). Bij het plaatsen van de mutatie in Allegro Portier zullen ook de datum en gegevens van de medewerker van de schuldeiser die de aanmelding heeft afgehandeld worden meegegeven (voornaam en achternaam medewerker, telefoonnummer en adres). Afhankelijk van welke gegevens wel of niet gevuld zijn (gewijzigd zijn) kunnen hierdoor verschillende soorten mutaties in Allegro Portier ontstaan Allegro organisatienummer onbekend Contract onbekend Opdracht onbekend Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer GetBBROpdrachtOverzichtCSV De service BBRService.GetBBROpdrachtOverzichtCSV kan worden gebruikt om een CSV te downloaden van de DICOS Centrale met daarin alle opdrachten voor budgetbeheer van de aangesloten Allegro organisaties voor de, bij de DICOS Centrale aangemelde, schuldeiser. Organisatienummer. Versie: 16 september 2012 Blz.: 30 van 66

31 2 DICOSCentrale Server Output: CSV Binary De DICOS Centrale zal, voor afhandeling van deze service, met alle aangesloten Allegro organisaties contact maken, de opdrachten voor budgetbeheer ophalen via de DICOSAllegro Server, verwerken in een CSV - bestand en dit versturen. Kolommen: AllegroOrganisatieNummer niet wijzigbaar - identificatie AllegroContractRelatieCode niet wijzigbaar - identificatie AllegroContractVolgnummer niet wijzigbaar - identificatie AllegroOpdrachtSoort niet wijzigbaar - identificatie AllegroOpdrachtReservering niet wijzigbaar - identificatie AllegroOpdrachtRelatiecode niet wijzigbaar - identificatie AllegroOpdrachtVolgnummer niet wijzigbaar identificatie AllegroOrganisatieNaam niet wijzigbaar KlantAchternaam niet wijzigbaar KlantVoorvoegsels niet wijzigbaar KlantVoorletters niet wijzigbaar KlantGeboortedatum niet wijzigbaar Klantnummer wijzigbaar OpdrachtReferentie wijzigbaar OpdrachtDatum niet wijzigbaar OpdrachtBedrag wijzigbaar Opmerkingen leeg, invulbaar Organisatie geen toegang tot budgetbeheer Medewerker geen toegang tot budgetbeheer PutBBROpdrachtOverzichtCSV De service BBRService.PutBBROpdrachtOverzichtCSV kan worden gebruikt om het aangepaste (klantnummer, bedrag, referentie) Excelbestand te uploaden naar de DICOS Centrale. Gebruiker(in de structure AWUserInfo zie paragraaf 4.1), Organisatienummer, CSV bestand, Output: Meldingen(StringArray), De DICOS Centrale zal, voor afhandeling van deze service, het Excelbestand verwerken en vervolgens de wijzigingen in mutaties laten plaatsen in Allegro Portier bij de juiste Allegro organisaties, zodat de wijzigingen verder in Allegro afgehandeld kunnen worden (periode bedrag, referentie en opmerkingen). Bij het plaatsen van de mutatie in Allegro Portier zullen ook de datum en gegevens van de medewerker van de schuldeiser die het bestand heeft ge-upload worden meegegeven (voornaam en achternaam medewerker, telefoonnummer en adres). Afhankelijk van Versie: 16 september 2012 Blz.: 31 van 66