4.2 getFreeUnitsHistory

Souhrný výpis cerpání volných jednotek.

VSTUP:

filter
- array number (nepovinný) – císla, pro která omezit výpis. Bez filtru vypíše volné jednotky pro všechna císla
int year – rok výpisu
int month – mesíc výpisu (1-12)

VÝSTUP:

string history – výpis ve formátu CSV
- array item – jeden záznam pro každé císlo
  - string number – telefonní císlo, pro které platí tato sekce
  - array units – jeden záznam pro každou kategorii volných jednotek
    - string description – popis kategorie (dle aktuálního nastavení v ceníku císla)
    - int available – pocet volných jednotek, které melo císlo na daný mesíc k dispozici
    - int remain – pocet jednotek, které císlu zbyly na konci mesíce
    - int transfer – pocet jednotek, které se prevádí do dalšího mesíce

int result - kód chyby
string resultText - textový popis chyby

CHYBY:

0 - OK
< 0 – Interní chyba. Popis chyby je v resultText.
> 0 – Chyba vstupních parametru. Popis chyby je v resultText.

PRÍKLAD XML ŽÁDOSTI

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:prov="http://
<soapenv:Header>
    <prov:verifyAccess>
    <accessToken></accessToken>
    </prov:verifyAccess>
</soapenv:Header>
<soapenv:Body>
    <urn:getFreeUnitsHistory>
      <filter/>
        <year>2015</year>
        <month>03</month>
    </urn:getFreeUnitsHistory>
</soapenv:Body>
</soapenv:Envelope>

PRÍKLAD XML ODPOVEDI

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:api-
<SOAP-ENV:Body>
    <ns1:getFreeUnitsHistoryResponse>
      <history>
        <item>
          <number>777777777</number>
          <units>
            <description>Volné minuty 1</description>
            <available>40</available>
            <remain>38</remain>
            <transfer>20</transfer>
          </units>
          <units>
            <description>Volné minuty 2</description>
            <available>10</available>
            <remain>2</remain>
            <transfer>2</transfer>
          </units>
          <units>
            <description>Volné SMS</description>
            <available>100</available>
            <remain>100</remain>
            <transfer>50</transfer>
          </units>
        </item>
      </history>
      <result>0</result>
      <resultText/>
    </ns1:getFreeUnitsHistoryResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>