5.4 getMobileService

Owned by Martin Olexik (Unlicensed)
Last updated: bře 30, 2016 by Martin Tomec (Unlicensed)
3 min read

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

 

VSTUP:

  • filter – filtrování podle identifikátoru mobilní služby, jeden z možných musí být zvolen
    • string msisdn (nepovinný) – mobilní číslo
    • string iccid (nepovinný) – iccid
  • string detail, enum { 'basic', 'credit', 'simDetail', 'full' } – typ výpisu detailu čí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 čísla
    • string number - číslo
    • string status (nepovinný), enum { 'reserved', 'active', 'canceled', 'stopped', 'prepared' } – stav čísla, význam hodnot
    • string paymentType (nepovinný) - režim placení
    • string numberType (nepovinný), enum { 'voice', 'fax', 'mobile' } – typ čí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íček
      • boolean lte – LTE
      • int flatTariffPlan – flat balíček
      • string pin1
      • string pin2
      • string puk1
      • string puk1
    • double creditAmount (nepovinný) - kredit
    • date creditExpirationDate (nepovinný) – expirace kreditu
    • string containerHostname (nepovinný) – hostname ústředny
    • antifraud (nepovinný)– nastavení antifraudu
      • profileCurrent (nepovinný)
        • int outgoing (nepovinný) – blokování odchozích hovorů
      • profilePermanent (nepovinný) – stálý profil
        • int outgoing (nepovinný) – blokování odchozích hovorů
      • int internationalLimit (nepovinný) – mezinárodní limit hovorného v Kč
    • currentAvailableUnits – aktuální dostupné jednotky
      • float slot1 – pozice 1
      • float slot2 – pozice 2
      • float slot3 – pozice 3
      • float slot4 – pozice 4
    • date lastBillingChange - datum poslední změny obchodního nastavení
  • provisioningAttributes – parametry nastavených služeb na SIM kartě
    • 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í příchozích hovorů
    • string outgoingCall (nepovinný), enum { 'blockAll', 'blockInternational', 'allowAll' } - povolení nebo zakázání odchozích hovorů
    • string premiumService (nepovinný), enum { 'blockAll', 'blockCall', 'blockSms', 'allowAll' } – povolení nebo zakázání prémiových služeb
    • string roamingCall (nepovinný) – aktivace roamingových hovorů
    • boolean callForwarding (nepovinný) – povolení přesměrování hovorů
    • boolean callHold (nepovinný) - povolení přidržení hovoru
    • string clir (nepovinný), enum { 'permanent', 'temporaryAllowed', 'temporaryRestricted' } – zákaz zobrazení MSISDN
    • boolean missedCallAlert (nepovinný) – aktivace registru zmeškaných hovorů (zasílání SMS o zmeškaných voláních)
    • boolean outsideCallWarning (nepovinný) - aktivace hlásky o volání mimo vlastní síť
    • boolean voiceMail (nepovinný) – povolení hlasové schránky
    • string voiceMailLanguage (nepovinný), enum { 'czech', 'english' } – jazyk hlasové schránky
    • boolean voiceMailSmsNotify (nepovinný) – upozornění na nové hlasové zprávy
    • boolean dataFupNotify (nepovinný) – upozornění na dosažení FUP limitu
    • boolean dataRoaming (nepovinný) – aktivace dat pro roaming
    • string dataRoamingLimit (nepovinný), enum { '1225', '3900', '15000' } – limit v Kč pro roamingová data
    • dateTime portOutDate (nepovinný) – datum a čas naplánovaného odportování čísla k jinému operátorovi
    • string portationNumber - vygenerovaný ČVOP u odportovávaných čísel
    • string internetIP - vnitřní IP adresa čí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štěno
    • 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 nepodařilo provést
  • 1 – Chyba vstupních parametrů. Popis chyby je v resultText.
  • 2 – Nedostupné informace pro zvolenou SIM kartu

 

PŘÍ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>


PŘÍKLAD XML ODPOVĚDI
<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>
          <profileCurrent>
            <outgoing></outgoing>
          </profilCurrent>
          <profilePermanent>
            <outgoing></outgoing>
          </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>