EksternKommunikation.BeskedService (2024-2)

Denne service indeholder webservicekald til at tilgå og gensend webservicebeskeder herunder hente webservicebeskeder afsendte såvel som fejlet, genafsendelse af webservicebeskeder on demand.

Forretningsbeskrivelse

For at administrere webservicebeskeder til og for serviceaftagere anvendes disse metoder til tilgå sendte/fejlede webservicebeskeder og giver mulighed for at få genfremsende webservicebeskeder.

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'GI:EksternKommunikation.AbonnementService (2023-3)'.





Metoder


GetBeskeder (GET /v1/beskedtyper {XXX filter})

Denne metode læser afsendte webservicebeskeder.

Forretningsregler:

  • Sluttidspunkt for perioden skal max være på dagsdato og skal ligge eller i fortiden.
  • Startildspunkt må ikke være større en sluttildspunkt
  • Det er kun muligt at hente beskeder sendt til den kaldende myndighede, dog kan STAR se alle afsendte beskeder
  • Hvis søgningen / metoden returnerer for mange beskeder kastes fejlen 9470 - 'Din søgning gav for mange resultater. Begræns din filtrering'
  • Metoden kan nu bruges i form af "paging", dvs. man kan nu via sideNummer og sideStoerrelse vælge, om resultatet skal komme ud i flere sider og hvor mange resultater der må være pr. side.
    OBS!! Til brug af paging antager vi, at slutbrugeren ved hvordan paging bruges. Dvs. sideNummer altid starter fra 1 og at for stor sideStørrelse reducere systemets ydeevne og forværre brugeroplevelsen på grund af længere indlæsningstider.

TBD: Hvilke filtre der skal være pt arbejder der med CPR-nummer, en periode, en eller alle beskedtyper og om man vil se alle beskeder, kun kvitteret eller kun fejlet

GensendWebservicebeskeder (POST /v1/Webservicebesked/action/Gensend)

Denne metode giver serviceaftager mulighed for at genudsende webservicebeskeder for en given borger og/eller beskedtype. Serviceaftagere, der ønsker at anvende metoden, vil selv skulle understøtte dette.

Forretningsregler:

  • Der kun muligt at få genudsendt webservicebeskeder der er mindre en 6 måneder gamle
  • For beskedtyper der er borgerrelateret, sendes der kun de webservicebeskeder der er tilknyttet den myndighed der forsøger at genudsende, det vil sige enten A-kasse eller Jobcenter alt efter indholdet i requestet.
  • Hvis det webservicebeskeder uden borgerrelation, f.eks. Taxonomy, sendes webservicebeskerne alle til myndigheden
  • Der kan kun modtages beskedtyper der abonneres på.
  • Kald med parameter
    • Angives en borger sendes kun beskeder der vedrørende denne 
    • Angives en beskedtype sendes kun beskeder der vedrørende denne 
    • Angives begge vil begge parameter skulle være opfyld for de beskeder der sendes
    • Angives hverken borger eller beskedtype, vil alle beskeder for alle borgere i perioden blive genafsendt
    • Der sendes kun i den valget tidsperiode
      • Angives ikke en slutdato sendes indtil sendes afsendte besked der er afsendt
  • Alle beskeder inkl. fejlede sendes 
  • Ved fejl vil der gensendes efter normale regler og indtil den besked er der fejlet er aftaget er borger spærret for nye beskeder. Der gensendes efter de normale fejlrutiner