5.10 updateMobileService

Aktualizace parametrů mobilního čísla. Jedná se o asynchronní operaci, návratovou hodnotu je id žádosti, podle kterého lze sledovat průbeh zpracování pomocí metody getRequestList. Aktualizaci je možné provést běžnou objednávkou, která se provede hned jak je to možné, nebo plánovanou. Objednávka je plánovaná v okamžiku, kdy je nastaveno datum v parametru requiredActivationDate. Datum plánované objednávky musí být min. následující den, ale obvykle je to první den následujícího mesíce. Plánovanou objednávkou lze menit pouze hlasový flat, datový balíček, ceník, denní zahraniční limit a typ platby, při nastavení ostatních parametrů se vrací chyba.

VSTUP:

string customerId – id zákazníka
numberDetail – detail čísla
- int tariffPlanId (nepovinný) – id ceníku
- string number – mobilní číslo
- string iccid (nepovinný) - iccid
- int dataTariffPlan (nepovinný) – 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ý) – datum plánované objednávky
- 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í přesměrovaní 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í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 - Aktualizaci 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:updateMobileService>
      <customerId></customerId>
      <numberDetail>
        
        <tariffPlanId></tariffPlanId>
        <number></number>
        
        <iccid></iccid>
        
        <dataTariffPlan></dataTariffPlan>
        
        <flatTariffPlan></flatTariffPlan>
        
        <internationalLimitDay></internationalLimitDay>
        
        <requiredActivationDate></requiredActivationDate>
        
        <credit></credit>
        
        <monthlyCredit></monthlyCredit>
        
        <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:updateMobileService>
</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:updateMobileServiceResponse>
      <requestId/>
      <result>0</result>
      <resultText></resultText>
    </ns1:updateMobileServiceResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>