5.6 portInMobileService

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

Zažádá se o aktivaci čísla přenášeného od jiného operátora. 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
  • int containerId – id ústředny
  • portDetail – detail portace
    • long portationNumber – číslo portace (CVOP) 14 místné číslo
  • numberDetail – detail čísla
    • int tariffPlanId – id ceníku
    • string number – mobilní číslo
    • string iccid – iccid
    • int dataTariffPlan – datový 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 portace, možná data lze získat pomocí metody validatePortationCodeCvop
    • 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
  • 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í přesměrování hovorů
    • boolean callHold - povolení přidržení hovoru
    • string clir enum { 'permanent', 'temporaryAllowed', 'temporaryRestricted' } – blokování identifikace volajícího, 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íť
    • 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 - Portaci 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:prov="http://www.ipex/ProviderManagement.xsd1" xmlns:urn="urn:apiipex:providermanagement">
  <soapenv:Header>
    <prov:verifyAccess>
      <accessToken></accessToken>
    </prov:verifyAccess>
  </soapenv:Header>
  <soapenv:Body>
    <urn:portInMobileService>
      <customerId></customerId>
      <containerId></containerId>
      <portDetail>
        <portationNumber></portationNumber>
      </portDetail>
      <numberDetail>
        <!--Optional:-->
        <tariffPlanId></tariffPlanId>
        <number></number>
        <!--Optional:-->
        <iccid></iccid>
        <!--Optional:-->
        <dataTariffPlan></dataTariffPlan>
        <!--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:portInMobileService>
  </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:portInMobileServiceResponse>
      <requestId></requestId>
      <result>0</result>
      <resultText></resultText>
    </ns1:portInMobileServiceResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>