5.4 getMobileService

Výpis detailu mobilní služby. Dostupný je detail císla, kredit, služby nastavené na SIM karte a stav FUP u dat.

VSTUP:

• filter – filtorvaní podle identifikátoru mobilní služby, jeden z možných musí být zvolen
  • string msisdn (nepovinný) – mobilní císlo
  • string iccid (nepovinný) – iccid
• string detail, enum { 'basic', 'credit', 'simDetail', 'full' } – typ výpisu detailu císla (basic: základní výpis, credit: základní výpis a informace o kreditu, simDetail: základní výpis a detail SIM karty, full: kompletní výpis)

VÝSTUP:

• numberDetail – detail císla
  • string number - císlo
  • string status (nepovinný), enum { 'reserved', 'active', 'canceled', 'stopped', 'prepared' } – stav císla, význam hodnot
  • string paymentType (nepovinný) - režim placení
  • string numberType (nepovinný), enum { 'voice', 'fax', 'mobile' } – typ císla
  • int tariffPlanId (nepovinný) – id ceníku
  • date createDate (nepovinný) – datum aktivace
  • int customerId (nepovinný) – id zákazníka
  • string customerName (nepovinný) – jméno zákazníka
  • int containerId (nepovinný) – id ústredny
  • mobile (nepovinný)
    • string iccid - ICCID
    • int dataTariffPlan – datový balícek
    • boolean lte – LTE
    • int flatTariffPlan – flat balícek
    • string pin1
    • string pin2
    • string puk1
    • string puk1
  • double creditAmount (nepovinný) - kredit
  • date creditExpirationDate (nepovinný) – expirace kreditu
  • string containerHostname (nepovinný) – hostname ústredny
  • antifraud (nepovinný)– nastavení antifraudu
    • profilCurrent (nepovinný)
      • int outgoing (nepovinný) – blokování odchozích hovoru
      • int incoming (nepovinný) – blokování príchozích hovoru
    • profilPermanent (nepovinný) – stálý profil
      • int outgoing (nepovinný) – blokování odchozích hovoru
      • int incoming (nepovinný) – blokování príchozích hovoru
    • int internationalLimit (nepovinný) – mezinárodní limit hovorného v Kc
  • currentAvailableUnits – aktuální dostupné jednotky význam
    • float slot1 – pozice 1
    • float slot2 – pozice 2
    • float slot3 – pozice 3
    • float slot4 – pozice 4
  • date lastBillingChange - datum poslední zmeny obchodního nastavení
• provisioningAttributes – parametry nastavených služeb na SIM karte
  • string communicationLanguage (nepovinný), enum { 'czech', 'english' } - servisní jazyk
  • boolean welcomeRoamingSms (nepovinný) – aktivace uvítacích roamingových SMS
  • boolean mms (nepovinný) – aktivace MMS
  • string sms (nepovinný), enum { 'incoming', 'outgoing', 'allowAll', 'blockAll' } – aktivace SMS
  • boolean incomingCall (nepovinný) – povolení nebo zakázání príchozích hovoru
  • string outgoingCall (nepovinný), enum { 'blockAll', 'blockInternational', 'allowAll' } - povolení nebo zakázání odchozích hovoru
  • string premiumService (nepovinný), enum { 'blockAll', 'blockCall', 'blockSms', 'allowAll' } – povolení nebo zakázání prémiových služeb
  • string roamingCall (nepovinný) – aktivace roamingových hovoru
  • boolean callForwarding (nepovinný) – povolení presmerovaní hovoru
  • boolean callHold (nepovinný) - povolení pridržení hovoru
  • string clir (nepovinný), enum { 'permanent', 'temporaryAllowed', 'temporaryRestricted' } – zákaz zobrazení MSISDN
  • boolean missedCallAlert (nepovinný) – aktivace registru zmeškaných hovoru (zasílání SMS o zmeškaných voláních)
  • boolean outsideCallWarning (nepovinný) - aktivace hlásky o volání mimo vlastní sít
  • boolean voiceMail (nepovinný) – povolení hlasové schránky
  • string voiceMailLanguage (nepovinný), enum { 'czech', 'english' } – jazyk hlasové schránky
  • boolean voiceMailSmsNotify (nepovinný) – upozornení na nové hlasové zprávy
  • boolean dataFupNotify (nepovinný) – upozornení na dosažení FPU limitu
  • boolean dataRoaming (nepovinný) – aktivace dat pro roamingu string dataRoamingLimit (nepovinný), enum { '1225', '3900', '15000' } – limit v Kc pro roamingová data
  • dateTime portOutDate (nepovinný) – datum a cas naplánovaného odportování císla k jinému operátorovi
  • string portationNumber - vygenerovaný CVOP u odportovávaných císel
  • string internetIP - vnitrní IP adresa císla v síti T-Mobile fup – informace o FUP
• fup – informace o FUP
  
  • boolean state (nepovinný) – informuje o tom, jestli je FUP (omezení dat) spušteno
  • int dataRemainsKB (nepovinný) – zbývající data v KB
  • int dataLimitMB (nepovinný) – limit v MB pro FUP
  • dateTime activationDate (nepovinný) – datum od kterého se kontroluje dosažení limitu FUP
• int result - kód chyby
• string resultText - textový popis chyby

CHYBY:

• 0 – OK
• -1 – Aktivaci se nepodarilo provést
• 1 – Chyba vstupních parametru. Popis chyby je v resultText.
• 2 – Nedostupné informace pro zvolenou SIM kartu

PRÍKLAD XML ŽÁDOSTI
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:prov="http://www.ipex/ProviderManagement.xsd1" xmlns:urn="urn:apiipex:providermanagement">
  <soapenv:Header>
    <prov:verifyAccess>
      <accessToken></accessToken>
    </prov:verifyAccess>
  </soapenv:Header>
  <soapenv:Body>
    <urn:getMobileService>
      <filter>
        <!--Optional:-->
        <msisdn></msisdn>
        <!--Optional:-->
        <iccid></iccid>
      </filter>
      <detail></detail>
    </urn:getMobileService>
  </soapenv:Body>
</soapenv:Envelope>

PRÍKLAD XML ODPOVEDI
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"xmlns:ns1="urn:api-ipex:providermanagement">
  <SOAP-ENV:Body>
    <ns1:getMobileServiceResponse>
      <numberDetail>
        <number></number>
        <status></status>
        <paymentType></paymentType>
        <numberType></numberType>
        <tariffPlanId></tariffPlanId>
        <createDate></createDate>
        <customerId></customerId>
        <customerName></customerName>
        <containerId></containerId>
        <mobile>
          <iccid></iccid>
          <dataTariffPlan></dataTariffPlan>
          <lte></lte>
          <flatTariffPlan></flatTariffPlan>
          <pin1></pin1>
          <pin2></pin2>
          <puk1></puk1>
          <puk2></puk2>
        </mobile>
        <creditAmount></creditAmount>
        <antifraud>
          <profilCurrent>
            <outgoing></outgoing>
          </profilCurrent>
          <profilPermanent>
            <outgoing></outgoing>
            <incoming></incoming>
          </profilPermanent>
        </antifraud>
        <currentAvailableUnits>
          <slot1></slot1>
          <slot2></slot2>
          <slot3></slot3>
          <slot4></slot4>
        </currentAvailableUnits>
      </numberDetail>
      <provisioningAttributes>
        <communicationLanguage></communicationLanguage>
        <welcomeRoamingSms></welcomeRoamingSms>
        <mms></mms>
        <sms></sms>
        <incomingCall></incomingCall>
        <outgoingCall></outgoingCall>
        <premiumService></premiumService>
        <roamingCall></roamingCall>
        <callForwarding></callForwarding>
        <callHold></callHold>
        <clir></clir>
        <missedCallAlert></missedCallAlert>
        <voiceMail></voiceMail>
        <voiceMailLanguage></voiceMailLanguage>
        <voiceMailSmsNotify></voiceMailSmsNotify>
        <dataFupNotify></dataFupNotify>
        <dataRoaming></dataRoaming>
        <dataRoamingLimit></dataRoamingLimit>
      </provisioningAttributes>
      <fup>
        <state></state>
        <dataRemainsKB></dataRemainsKB>
        <dataLimitMB></dataLimitMB>
      </fup>
      <result>0</result>
      <resultText/>
    </ns1:getMobileServiceResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>