5.3 createMobileService

Owned by Martin Olexik (Unlicensed)
Last updated: úno 25, 2016
2 min read

Provede aktivaci mobilního čísla s režimem placení typu postpaid a prepaid. Jedná se o asynchronní operaci, návratovou hodnotu je id žádosti, podle kterého lze sledovat průběh zpracování pomocí metody getRequestList.

 

VSTUP:

  • string customerId – id zákazníka
  • numberDetail – detail čísla
    • int tariffPlanId – id ceníku
    • string number – mobilní číslo
    • string iccid – iccid
    • int dataTariffPlan – datový tarif
    • boolean lte – aktivace LTE
    • int flatTariffPlan – flat tarif
    • int internationalLimitDay (nepovinný) – mezinárodní denní limit hovorného.
      Limit je v Kč a hlídá částku provolanou z ČR do zahraničí.
    • date requiredActivationDate (nepovinný) – požadované datum aktivace, momentálně tento parametr není podporován
    • double credit (nepovinný) – hodnota kreditu v Kč, pouze pro prepaid
    • double monthlyCredit (nepovinný) – kredit automaticky nastavovaný v měsíčních intervalech, pouze pro prepaid
    • date creditExpirationDate (nepovinný) - datum expirace kreditu
    • int monthlyLimitNotification (nepovinný) - měsíční limit pro notifikaci postpaid čísel
    • int monthlyLimit (nepovinný) - měsíční limit postpaid čísla
    • string paymentType enum{prepaid, postpaid} – typ placení
  • provisioningAttributes – parametry pro nastavení mobilních služeb
    • string communicationLanguage enum { 'czech', 'english' } - servisní jazyk
    • boolean welcomeRoamingSms – aktivace uvítacích roamingových SMS
    • boolean mms – aktivace MMS
    • string sms enum { 'incoming', 'outgoing', 'allowAll', 'blockAll' } – aktivace SMS,význam hodnot
    • boolean incomingCall – povolení nebo zakázání příchozích hovorů
    • string outgoingCall enum { 'blockAll', 'blockInternational', 'allowAll' } - povolení nebo zakázání odchozích hovorů, význam hodnot
    • string premiumService enum { 'blockAll', 'blockCall', 'blockSms', 'allowAll' } – povolení nebo zakázání prémiových služeb, význam hodnot
    • string roamingCall – aktivace roamingových hovorů, profily se získají pomocí metody getRoamingList
    • boolean callForwarding – povolení presměrování hovoru
    • boolean callHold - povolení pridržení hovoru
    • string clir enum { 'permanent', 'temporaryAllowed', 'temporaryRestricted' } – blokování identifikace volajícího (CLIR), význam hodnot
    • boolean missedCallAlert – 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ít
    • boolean voiceMail – povolení hlasové schránky
    • string voiceMailLanguage enum { 'czech', 'english' } – jazyk hlasové schránky
    • boolean voiceMailSmsNotify – upozornění na nové hlasové zprávy
    • boolean dataFupNotify – upozornění na dosažení FUP limitu
    • boolean dataRoaming – aktivace dat pro roaming
    • string dataRoamingLimit enum {'0', '1225', '3900', '15000' } – limit v Kč pro roamingová data, 0 je pro data bez omezení

 

VÝSTUP:

  • int requestId – id žádosti
  • 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.

 

PŘÍKLAD XML ŽÁDOSTI

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:api-ipex:providermanagement">
  <soapenv:Header>
    <prov:verifyAccess>
      <accessToken></accessToken>
    </prov:verifyAccess>
  </soapenv:Header>
  <soapenv:Body>
    <urn:createMobileService>
      <customerId></customerId>
      <numberDetail>
        <!--Optional:-->
        <tariffPlanId></tariffPlanId>
        <number></number>
        <!--Optional:-->
        <iccid></iccid>
        <!--Optional:-->
        <dataTariffPlan></dataTariffPlan>
        <!--Optional:-->
        <lte></lte>
        <!--Optional:-->
        <flatTariffPlan></flatTariffPlan>
        <!--Optional:-->
        <internationalLimitDay></internationalLimitDay>
        <!--Optional:-->
        <requiredActivationDate></requiredActivationDate>
        <!--Optional:-->
        <credit></credit>
        <!--Optional:-->
        <monthlyCredit></monthlyCredit>
        <!--Optional:-->
        <creditExpirationDate></creditExpirationDate>
        <paymentType></paymentType>
      </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>
    </urn:createMobileService>
  </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:createMobileServiceResponse>
      <requestId/>
      <result>0</result>
      <resultText></resultText>
    </ns1:createMobileServiceResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>