Přejít na konec metadat
Přejít na začátek metadat

Prohlížíte starou verzi této stránky. Zobrazit aktuální verzi.

Porovnat s aktuální Zobrazit historii stránky

« Předchozí Verze 2 Aktuální »

Výpis uskutecnených hovoru podle zadaného filtru. Puvodne funkce VypisHovoruString, VoipexVypisHovoru, VoipexExportHovoru.

 

VSTUP:

  • filtr
    • string number (nepovinný) – hledané císlo
    • int customerId(nepovinný) – id zákazníka
    • string externId (nepovinný) - id z externího systému
    • boolean showVAT (nepovinný) – pridá sloupecek s DPH
    • boolean showUnit (nepovinný) - pridá sloupecek s jednotkami, MB pro data, ks pro SMS
    • boolean showUID (nepovinný) – pridá sloupecek s unikátním ID hovoru (nefunguje kumulovaných výpisu)
    • boolean showFlags (nepovinný) - pridá sloupecek s flagy
    • boolean showCustomerId (nepovinný) - pridá sloupecek s interním id zákazníka
    • boolean showFreeUnits (nepovinný) - pridá sloupecky s poctem volných jednotek spotrebovaných daným hovorem
  • dateTime dateFrom – vypsat od
  • dateTime dateTo – vypsat do
  • int typHistory – typ výpisu:
    • 1 – odchozí hovory
    • 2 – odchozí zdarma
    • 3 – odchozí zdarma na peering partnery
    • 4 – odchozí placené mobil a pevná
    • 5 – príchozí hovory
    • 6 – zmeškané príchozí hovory
    • 7 – všechny hovory (žádný filtr)
    • 8 – odchozí kumulovaný výpis (ala ceník)
    • 9 – odchozí kumulovaný výpis podle státu
    • 10 – príchozí kumulovaný výpis hovoru
    • 13 – odchozí zmeškané
    • 14 – odchozí a príchozí hovory nekumulovaný výpis vcetne nákladových cen (tri poslední sloupce na konci - délka (sek.), cena (hal.), pocet)
    • 15 – podklady k fakturaci všech zákazníku (prepaid a postpaid)
    • 16 – podklady k fakturaci všech zákazníku (prepaid)
    • 17 – podklady k fakturaci všech zákazníku (postpaid)
  • boolean headers - zobrazení hlavicky v CSV

 

VÝSTUP:

  • string history – výpis ve formátu CSV
  • 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.
  • 1037 – nezadaný casový interval, nebo interval starší než 1 rok zpetne
  • 1038 – filtrování dle ID zákazníka zároven se zobrazením ID zákazníka není podporováno

 

FORMÁT CSV:

cislo_zakaznika;cislo_volaneho;zona;datum

+cas;odchozi;uskutecneny;stav;flags;delka;cena;pocet

 

VÝZNAM SLOUPCU V HLAVICCE CSV:

  • císlo zákazníka: je 9-místné (nebo 00421+císlo pro slovenská císla), muže být pri presmerování ve formátu: "<císlo> (<puvodní>)", kde <puvodní> je puvodní císlo volajícího.
  • císlo volaného: je pro císla v rámci CR 9-místné, jinak s prefixem
  • zóna: je textový popis zóny volaného císla
  • datum+cas zacátku hovoru
  • odchozí: Y pokud jde o odchozí hovor, jinak N
  • uskutecnený: Y pokud byl hovor uskutecnen (tzn. nenulová délka)
  • stav: textový popis stavu (Prijato/Zmeškáno/Neprijato/Bez odpovedi/Obsazeno/Zodpovezeno/SMS placena nedorucená/Cekám na potvrzení spojení/ SMS príchozí zdarma)
  • flags: pro vnitrní potrebu
  • délka:délka nebo hodnota platná pro daný CDR záznam(délka hovoru, pocet MB pro data...), jednotky udává následující sloupec jednotka
  • jednotka: jednotky pro hodnoty ze sloupce délka
  • cena: cena v halérích
  • sazba_dph: sazba DPH v %
  • pocet: pro kompatibilitu - zde vždy 1
  • cdr_flags: typ záznamu CDR. Informuje do jaké zóny ceníku byl poplatek ve výpisu zarazen
  • uid: unikátní identifikátor hovoru

 

Typy 15-17 zobrazují

CSV: zakaznik;volajici;zona;casove_pasmo;pocet_hovoru;delka;cena;poznamka

  • zakaznik - název zákazníka
  • volajici - tel císlo zákazníka
  • zona - popis cílové destinace
  • casove_pasmo – identifikace casového pásma dle ceníku
  • pocet_hovoru - pocet hovoru
  • delka – zatím má smysl pouze u hovoru. U SMS, Paušálu apod. bude upravena
  • cena – v Kc. Pocet desetinných míst se bude rozširovat
  • poznamka – napríklad rozsah období, pokud císlo melo v daném období více ceníku

 

FLAGY (CDR_FLAGS):

  • C - hovor
  • S - SMS
  • M - MMS
  • D - data
  • F - poplatek
  • O - ostatní
  • P - premium
  • R - roaming

Flagy se mužou i kombinovat, takže PRS je hovor na prémiovou linku z roamingu.

 

PRÍ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:getCallHistory>
      <filtr>
        <!--Optional:-->
        <number></number>
        <!--Optional:-->
        <customerId></customerId>
        <!--Optional:-->
        <externId></externId>
        <!--Optional:-->
        <showVAT>false</showVAT>
        <!--Optional:-->
        <showUID>false</showUID>
        <!--Optional:-->
        <showFlags>false</showFlags>
        <!--Optional:-->
        <showUnit>false</showUnit>
      </filtr>
      <dateFrom></dateFrom>
      <dateTo></dateTo>
      <typHistory></typHistory>
      <headers></headers>
    </urn:getCallHistory>
  </soapenv:Body>
</soapenv:Envelope>

 

PRÍKLAD XML ODPOVEDI

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"xmlns:ns1="urn:api-ipex:providermanagement">
  <SOAP-ENV:Body>
    <ns1:getCallHistoryResponse>
      <history></history>
      <result>0</result>
      <resultText/>
    </ns1:getCallHistoryResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

 

  • Žádné štítky