/
RSM-027: Opdatering af kundestamdata

RSM-027: Opdatering af kundestamdata

Indholdsfortegnelse

 

>> Link til ændringslog >>

Overblik

Forretningstransaktionen anvendes af en elleverandør til at sende opdaterede kundestamdata på et målepunkt til målepunktsadministratoren.

Aktivitetsdiagram

Opdatering af kundestamdata

Transaktionsstart

Transaktionen startes af en Request change Customer characteristics med MarketDocument type = D15, som sendes af elleverandøren. En meddelelse kan indeholde en eller flere transaktioner.

Meddelelsen kan indeholde en af følgende årsagskoder (ProcessType):

Årsagskode

Dansk navn

Engelsk navn

Årsagskode

Dansk navn

Engelsk navn

D20

Elvarme

Electrical heating

D29

Sekundær tilflytning

Secondary move-in

E03

Skift af elleverandør

Change of balance supplier

E34

Opdatering af kundestamdata

Update master data consumer

E65

Almindelig tilflytning

Customer move-in

Modtagelse i DataHub

I tilfælde af at der sker verifikationsfejl i forhold til skemaet, skal meddelelsen afvises synkront med en HTTP Error.

Derefter valideres meddelelsen i overensstemmelse med forretningsreglerne (BRS), og hvis der er fejl afvises meddelelsen.

Hvis der ikke opdages fejl ved kontrol af Request change Customer characteristics behandler DataHub anmodningen.

Meddelelses indhold

Request change Customer characteristics indeholder en header og en Payload klasse beskrevet herunder.

Contextual model

image-20250611-212537.png
Figur 1. Klasse diagram: Request change Customer characteristics contextual model

Assembly mode

image-20250611-212546.png
Figur 2. Klasse diagram: Request change Customer Characteristics assembly model

Header Information

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

MarketDocument

1

 

Meddelelses-ID

MarketDocument / mRID

An..36

1

Unik identifikation af meddelelsen.
DataHub bruger UUID.

Meddelelsesnavn

MarketDocument / type

An..3
kode

1

type = D15 - Anmod om opdatering af kundestamdata -

Forretningsårsag

MarketDocument /Process / ProcessType

An..3
kode

1

Se transaktionsstart for liste.

Marked

MarketDocument / BusinessSector / type

An..2

0..1

type = 23 - Electricity Supply Industry

Afsender-ID

MarketDocument / Sender_MarketParticipant / mRID

An..16

1

Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode.
CodingScheme = A10 angives for 13 cifret GLN.
CodingScheme = A01 angives for 16 tegns EIC-kode.

Afsender rolle

MarketDocument / Receiver_MarketParticipant / MarketRole / type

An..3

1

Mulige afsendere:
Type = DDQ - Elleverandør

Modtager-ID

MarketDocument / Receiver_MarketParticipant / mRID

An..16

1

Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode.
CodingScheme = A10 angives for 13 cifret GLN.
CodingScheme = A01 angives for 16 tegns EIC-kode.

Modtager rolle

MarketDocument / Sender_MarketParticipant / MarketRole / type

An..3

1

Mulige modtagere:
Type = DDZ - DataHub

Meddelelsesdato

MarketDocument / createdDateTime

Datetime

1

ISO-8601 standard anvendes.

Dato og tid i UTC+0. Angiver oprettelsesdato for anmodning.
Format: YYYY-MM-DDThh:mm:ssZ

Payload - Attribut beskrivelse

Navn

Cim Attribut

længde

Kardi-nalitet

Beskrivelse

MktActivityRecord

1..*

 

Transaktions-ID

MktActivityRecord / mRID

An..36

1

Afsenders unikke identifikation af transaktionen.

Proces-ID

MktActivityRecord / BusinessProcessReference_ MktActivityRecord / mRID

An..36

0..1

ID genereret af DataHub til identifikation af den specifikke proces.

Det er frivilligt for aktøren at medsende proces-ID i efterfølgende meddelelser til DataHub.

Proces-ID benyttes ikke i forbindelse med BRS-015.

Startdato

MktActivityRecord / Start_DateAndOrTime / dateTime

Datetime

0..1

ISO-8601 standard anvendes.

Dato og tid i UTC+0. Angiver starttidspunkt (skæringsdato) for proces.
Format: YYYY-MM-DDThh:mm:ssZ

Navn

Cim Attribut

længde

Kardi-nalitet

Beskrivelse

MktActivityRecord / MarketEvaluationPoint

1..1

 

Målepunkts-ID

MktActivityRecord / MarketEvaluationPoint / mRID

An..18

1

Entydig identifikation af et målepunkt. GSRN = 18 cifre. CodingScheme = A10

Elvarme

MktActivityRecord / MarketEvaluationPoint / ServiceCategory / electricalHeating

Boolean

0..1

Angiver om el­leverandøren eventuelt skal korrigere elafgiften. true = elvarme.
Ændres/opdateres kun i forbindelse med elvarmeproces (BRS-041)

CVR/CPR 1

MktActivityRecord / MarketEvaluationPoint / firstCustomer_MarketParticipant / mRID

Hvor attribut PartyID_String:
codingScheme = ARR (CPR nr.),
codingScheme = VAT (CVR nr.),

An..10

0..1

Feltet udfyldelses med CPR for privat (10 cifre) eller CVR nr. for Erhverv (8 cifre).

 

Indhold af felt slettes ved at indsende felt blankt med angivelse af ARR/VAT i CodingScheme.

Kundenavn 1

 

MktActivityRecord / _MarketEvaluationPoint / FirstCustomer_MarketParticipant / name

An..132

0..1

Navn på person eller virksomhed

CPR 2

MktActivityRecord / MarketEvaluationPoint / SecondCustomer_MarketParticipant / mRID

Hvor attribut PartyID_String:
codingScheme = ARR (CPR nr.)

An..10

0..1

Feltet udfyldelses med CPR for privat, med 10 cifre.

Hvis CVR benyttes, må CPR 2 ikke udfyldes

Indhold af felt slettes ved at indsende felt blankt med angivelse af ARR i CodingScheme.

Kundenavn 2 

MktActivityRecord / MarketEvaluationPoint / SecondCustomer_MarketParticipant / name

An..132

0..1

Navn på kunde nr. 2 i husstand.

Hvis CVR benyttes i CVR/CPR 1 attribut, må Kundenavn 2 ikke udfyldes

Hemmelig navn

MktActivityRecord / MarketEvaluationPoint / protectedName

True = beskyttet
False = ikke beskyttet

Boolean

0..1

Angiver om der er registreret navne- og adresse beskyttelse på målepunktet.

Note:
ProtectedName anvendes for kunder
ProtectedAddress anvendes for kontakter

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation

0..*

 

Adresse type 

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / type

An..3
Kode

1

Typen af kontakt adresse, som kan være:
D01 Teknisk adresse
D04 Juridisk adresse
Feltet er obligatorisk hvis kontakt ændres/opdateres

DAR reference

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / geoInfoReference

An..36

0..1

 

Udgives af de danske myndigheder

Hemmelig adresse

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / protectedAddress

True = beskyttet
False = ikke beskyttet

Boolean

0..1

Angiver om der er registreret navne- og adresse beskyttelse for kontaktperson

Note:
ProtectedName anvendes for kunder
ProtectedAddress anvendes for kontakter

Kontaktnavn 

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / name

An..132

0..1

Navn på kontakt­person

Attention 

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / Attn_Names / name

An..40

0..1

Dette er et supplementsfelt til Navn. Det kan anvendes til attention eller c/o.

Telefon

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / ituPhone/ phone1

An..15

0..1

Telefonnummer på kontakten kan angives som cifre eller en kombination af tegnet '+' og cifre.

Mobil

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / ituPhone/ phone2

An..15

0..1

Mobilnummer på kontakten kan angives som cifre eller en kombination af tegnet '+' og cifre.

E-mail 

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / electronicAddress

An..60

0..1

Mail til kontakten. Ved flere e-mails adskilles de med semikolon.

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / MainAddress / Streetaddress

0..1

 

Postnummer

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / postalCode

An..4

0..1

Postnummer For målepunkts adresse:
I Danmark <= 4 tegn, foranstillede nuller anvendes.

Postboks

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / poBox

An..40

0..1

 

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / MainAddress / Streetaddress / StreetDetail

0..1

 

Vejkode

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / StreetDetailn / code

An..4

0..1

Vejkoden skal altid have fire cifre, og disse skal være i intervallet 0001-9899. Vejkoden udgør sammen med kommunekode en entydig identifikation af den navngivne vej med tilhørende vejnavn.

Vejnavn

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / StreetDetail / name

An..40

0..1

 

Husnummer

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / StreetDetail / number

An..6

0..1

Bokstaver i husnummer skal være versaler

 

Etage

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / StreetDetail / floorIdentification

An..4

0..1

Eksempler på Etage: S, 1, 2 - skal angives hvis relevant (f.eks. ved etagebyggeri

Dørnummer

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress StreetAddress / StreetDetail /suiteNumber

An..4

0..1

th, tv, m.f. og andre - skal angives hvis relevant (fx ved etagebyggeri)

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

 

Navn

Cim Attribut

Længde

Kardi-nalitet

Beskrivelse

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / MainAddress / Streetaddress / TownDetail

0..1

 

Kommunekode

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / TownDetail / code

An..3

0..1

Kommunekode er et nul og 3 cifre, DataHub bruge kun de 3 cifre. Meddelelsen vil blive afvist hvis der indsendes 4 cifre.

Bynavn

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / TownDetail / name

An..25

0..1

 

Supplerende bynavn

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / TownDetail / section

An..34

0..1

fx Erritsø

Landekode

MktActivityRecord / MarketEvaluationPoint / UsagePointLocation / mainAddress / StreetAddress / TownDetail / country

An..2