Søk

Customer Mobile Management API (CMMA)

Phonero implementerer Telias CMMA grensesnitt for vedlikehold av abonnementsporteføljen. Utvikling av API-støtte har høy prioritet og vil bli gradvis utvidet med ny funksjonalitet fremover.

Det som er dokumentert på denne siden er Phoneros tilleggsinformasjon og spesialtilpasninger av Telias standardiserte grensesnitt.

Hoved-dokumentasjon for CMMA-grensesnittet:

https://customer-mobile-management.telia.io/v1/

Historikk

Dato	Versjon	Endring
21.09.2026	1.0	Phoneros tilpasninger til Telias CMMA. Første versjon.

Generell informasjon

Før integrasjon settes i drift, blir Phoneros systemer og datastrukturer synkronisert med kundens strukturer. Som del av denne aktiviteten blir Phoneros objekter påført kundens ID i et eget felt (3. part ID). Dette lar kunden benytte ID'er fra sitt eget system til å identifisere objekter i Phoneros database. Dette gjelder objekter av typen Billing Account (fakturakonto) og Product (abonnement).

I tillegg til dokumentasjonen som er formidlet her, er det laget egne beskrivelser av Phoneros datastrukturer og forretningsregler som er relevant for kunder som skal integrere sine systemer. Denne tilleggsinformasjonen formidles i forbindelse med onboarding og planlegging av detaljer rundt integrasjonen.

Billing Accounts

Funksjon	Status	Merknader
List billing accounts	Implementert	Returnerer en liste med fakturakontoer som matcher søkekriterier. Cursor benyttes dersom kriteriene gir mer enn 1000 treff.
Create billing account	Implementert	Oppretter ny fakturakonto. Se avsnitt om Spesialfunksjoner for å angi egen ID på nye fakturakontoer.
Update billing account	Implementert	Oppdatere navn Endre status til "PendigClosed" (evt. reaktivere - se avsnitt om spesialfunksjoner nedenfor) Flytte fakturakonto til et annet sted i hierarkiet (inkl. evt. alle tilknyttede abonnement) NB! Denne er IKKE implementert: Endre fakturakontakt
Get reference data	Ikke implementert	Reference data er ikke benyttet i Phoneros implementasjon.
Create event listener	N/A	Asynkrone funksjoner er ikke støttet.
Delete event listener	N/A	-

Products

Funksjon	Status	Merknader
List products	Implementert	Returnerer en liste med abonnement i henhold til søkekriterier.
Get product	Implementert	Returnerer et enkelt abonnement.
Update product	Delvis implementert	Støttes i dag: Flytte abonnement til ny fakturakonto Endre navn på bruker av abonnementet (for abonnement av typen "Personlig") Andre attributter og funksjoner er IKKE støttet p.t.
Check product qualification	Ikke implementert	-
Get product status	Ikke implementert	-
Suspend product	Ikke implementert	-
Unsuspend product	Ikke implementert	-
Create event listener	Ikke implementert	-
Delete event listener	Ikke implementert	-
List tasks	Ikke implementert	-

Invoices

Funksjon	Status	Merknader
List invoices	Implementert	Henter liste med overordnet fakturainformasjon
Get complete invoice	Implementert	Henter detaljert informasjon for en spesifikk faktura ID.
Get partial invoice	Ikke implementert	-
Get invoice report	Ikke implementert	-

Spesialfunksjoner og Phonero-spesifikke attributter

Billing Account

Phonero har ikke et felt for Beskrivelse (Description) på sine fakturakontoer. I API'et er dette feltet er benyttet til å støtte funksjonalitet som ikke er tilgjengelig i Telias standard grensesnitt:

1. Mulighet til å angi kundens egen ID ved opprettelse av ny fakturakonto

API'et støtter ikke å angi ID ved opprettelse av ny fakturakonto (Billing Account). Phonero har derfor laget spesiell støtte for dette ved å bruke feltet "Description".

For lagre kundens ID på en ny fakturakonto benyttes følgende notasjon:

[EXTERNALID]:[<ID>]
Dataype: String(50)

<ID> er kundens egen ID på fakturakonto. Denne kan senere benyttes i API-kall, 
f.eks. ved en GET.

2. Mulighet til å angi kode for å deaktivere eller reaktivere fakturakonto

I API-standarden til Telia er det ikke en egen kommando/funksjonskall for å deaktivere en fakturakonto. Det kan likevel være hensiktsmessig for noen kunder å ha en slik mulighet, f.eks. i forbindelse med omorganiseringer hvor man ønsker at gamle avdelinger ikke lenger skal vises i portaler eller returneres via API'et.

For å deaktivere en fakturakonto (Billing Account), kan man via API'et gjøre en UPDATE med følgende key/value attributter i objektets "Description" felt:

[STATUSCHANGE]:[Deactivate]

Å angi "Deactivate" vil medføre at fakturakontoen midlertidig får status "PendingClosed". Kontoen vil ligge i denne statusen inntil forretningsregler for karantenetid er oppfylt. Etter at karantenetiden er slutt, blir kontoen automatisk deaktivert. Fakturakontoer i status "PendingClosed" blir returnert i API'et inntil karanteneregler er oppfylt og status endres til "Closed". Fakturakontoer med status "Closed" vil ikke bli returnert via API'et.

Fakturakontoer som har fått status "PendingClosed" kan også reaktiveres i karanteneperioden. Etter karanteneperioden er reaktivering ikke lenger mulig og man må evt. opprette en ny fakturakonto.

[STATUSCHANGE]:[Reactivate]

3. Kundespesifikke

Enkelte andre funksjoner knyttet til Billing Account er også gjort tilgjengelig for å støtte kundespesifikke behov. Disse er:

Angi verdi for EHF-feltet "EHFAccountingCustomerParty".
Gruppering av faktura basert på kundespesifikk kode/ID for koststed.

Disse kan diskuteres nærmere etter ønske.

Product

For Product er det en definert mekanisme for operatørspesifikke utvidelser gjennom feltet "characteristics". I Phoneros implementasjon er det benyttet to egendefinerte felt:

"characteristics": {
                "bedriftsnett": "false",
                "thirdPartyId": "12345"
            },

Felt: "bedriftsnett"
Datatype: bool (true/false)
Tilgang: Lese

Felt: "thirdPartyId"
Datatype: String(20)
Tilgang: Lese/skrive

Feltet "bedriftsnett" kan ha verdien true/false og henviser til hvorvidt det aktuelle abonnementet er inkludert i en sentralbord-løsning eller ikke. Avhengig av hva man skal gjøre med et abonnement kan det være nødvendig å ta hensyn til om abonnementet inngår i sentralbordkø(er). En ansatt som bytter rolle/arbeidssted skal kanskje ha en annen konfigurasjon for sentralbord-løsningen?

Feltet "thirdPartyId" benyttes til å angi kundens egen ID på et abonnement. Mange vil kanskje benytte AnsattId eller tilsvarende, men feltet støtter i praksis en hvilken som helst verdi. Vær oppmerksom på at API'et IKKE tar hensyn til hvilken type ID som benyttes. På objektet Product er det også et felt for EmployeeId. Per nå blir EmployeeId-feltet ikke tatt hensyn til og det blir ikke lagret i Phoneros systemer.

Funksjonalitet som ikke er implementert

Organizations

Phoneros støtter ikke bruken av Organizations. Tilgangen til data- og datastrukturer settes på organisasjonsnivå (org.nr.) eller evt. på et annet avtalt nivå i hierarkiet.

Offerings

Offerings er i praksis en produktkatalog over tjenester som kan bestilles gjennom "Orders". Denne funksjonaliteten er ikke implementert.

Orders

Orders er den funksjonaliteten som benyttes for å plassere en ordre/bestilling. Denne benyttes både til mobil-tjenester/mobilabonnement og andre typer bestillinger som f.eks. Nettbutikk. Denne funksjonaliteten er ikke implementert.

Resources

Resources gir tilgang til telefoni-relaterte ressurser som SIM-kort og nye telefonnr. Denne funksjonaliteten er ikke implementert.

Cases

Cases (saksbehandling) gir mulighet til å integrere kundens interne saksbehandlingssystem med Phoneros system for saksbehandling. Denne funksjonaliteten er ikke implementert.