Výpis uskutecnených hovoru uskutečněných hovorů podle zadaného filtru. Puvodne funkce VypisHovoruString, VoipexVypisHovoru, VoipexExportHovoru.
...
- filtr
- string number (nepovinný) – hledané císločíslo
- int customerId(nepovinný) – id zákazníka
- string externId (nepovinný) - id z externího systému
- boolean showVAT (nepovinný) – pridá sloupecek přidá sloupeček s DPH
- boolean showUnit (nepovinný) - pridá sloupecek přidá sloupeček s jednotkami, MB pro data, ks pro SMS
- boolean showUID (nepovinný) – pridá sloupecek přidá sloupeček s unikátním ID hovoru (nefunguje u kumulovaných výpisuvýpisů)
- boolean showFlags (nepovinný) - pridá sloupecek přidá sloupeček s flagy
- boolean showCustomerId (nepovinný) - pridá sloupecek přidá sloupeček s interním id zákazníka
- boolean showFreeUnits (nepovinný) - pridá sloupecky přidá sloupečky s poctem počtem volných jednotek spotrebovaných spotřebovaný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í řríchozí hovory
- 6 – zmeškané príchozí pří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í příchozí kumulovaný výpis hovoruhovorů
- 13 – odchozí zmeškané
- 14 – odchozí a príchozí příchozí hovory, nekumulovaný výpis vcetne včetně nákladových cen (tri tři poslední sloupce na konci - délka (sek.), cena (hal.), pocetpočet)
- 15 – podklady k fakturaci všech zákazníku zákazníků (prepaid a postpaid)
- 16 – podklady k fakturaci všech zákazníku zákazníků (prepaid)
- 17 – podklady k fakturaci všech zákazníku zákazníků (postpaid)
- boolean headers - zobrazení hlavicky hlavičky v CSV
VÝSTUP:
- string history – výpis ve formátu CSV
- int result - kód chyby
- string resultText - textový popis chyby
...
- 0 - OK
- < 0 – Interní chyba. Popis chyby je v resultText.
- > 0 – Chyba vstupních parametruparametrů. Popis chyby je v resultText.
- 1037 – nezadaný casový časový interval, nebo interval starší než 1 rok zpetnezpětně
- 1038 – filtrování dle ID zákazníka zároven zároveň se zobrazením ID zákazníka není podporováno
...
+cas;odchozi;uskutecneny;stav;flags;delka;cena;pocet
VÝZNAM SLOUPCU SLOUPCŮ V HLAVICCE HLAVIČCE CSV:
- císlo zákazníkacislo zakaznika: je 9-místné (nebo 00421+císlo číslo pro slovenská císlačísla), muže být pri presmerování při přesměrování ve formátu: "<císlo> <číslo> (<puvodní><původní>)", kde <puvodní> <původní> je puvodní císlo původní číslo volajícího.
- císlo volanéhocislo volaneho: je pro císla čísla v rámci CR ČR 9-místné, jinak s prefixem
- zónazona: je textový popis zóny volaného císlačísla
- datum+cas zacátku začátku hovoru
- odchozíodchozi: Y pokud jde o odchozí hovor, jinak N
- uskutecnenýuskutecneny: Y pokud byl hovor uskutecnen uskutečněn (tzn. nenulová délka)
- stav: textový popis stavu (Prijato/Zmeškáno/NeprijatoNepřijato/Bez odpovediodpovědi/Obsazeno/Zodpovezeno/SMS placena nedorucená/Cekám Čekám na potvrzení spojení/ SMS príchozí příchozí zdarma)
- flags: pro vnitrní potrebuvnitřní potřebu
- délkadelka:délka nebo hodnota platná pro daný CDR záznam (délka hovoru, pocet počet MB pro data...), jednotky udává následující sloupec jednotka
- jednotka: jednotky pro hodnoty ze sloupce délka
- cena: cena v haléríchhaléří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 zarazenzařazen
- uid: unikátní identifikátor hovoru
...
- zakaznik - název zákazníka
- volajici - tel císlo . číslo zákazníka
- zona - popis cílové destinace
- casove_pasmo – identifikace casového časového pásma dle ceníku
- pocet_hovoru - pocet hovorupočet hovorů
- delka – zatím má smysl pouze u hovoru. U SMS, Paušálu Paušálů apod. bude upravena
- cena – v KcKč. Pocet Počet desetinných míst se bude rozširovatrozšiřovat
- poznamka – napríklad rozsah období, pokud císlo melo číslo mělo v daném období více ceníkuceníků
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 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: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 PŘÍKLAD XML ODPOVEDIODPOVĚDI
<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>
...