Export seznamu platebních informací o zákazníkovi (SOAP)

Účel článku

Informace k exportu seznamu platebních informací o zákazníkovi pomocí web services. Podrobná referenční dokumentace je k dispozici v referenčním popisu rozhraní MANGO WSDL.

Registrované metody

Seznam registrovaných metod s referenčním popisem je k dispozici na https://is.cibs.cz/ws_cibs.php.
Metoda Popis
ws_session_login přihlášení operátora
ws_session_logout odhlášení operátora
ws_session_set_ct nastavení lokace
ws_user_payment_info získání platebních informací o zákazníkovi

Posloupnost volání metod

Pro tuto funkcionalitu je nutné se nejprve přihlásit do  MANGO  (ws_session_login) a nastavit číslo lokace (ws_session_set_ct). Poté je teprve možné zavolat příslušnou metodu (ws_user_payment_info). Po zpracování výsledků je třeba provést odhlášení operátora (ws_session_logout).

Čas generování exportního souboru je závislý na počtu záznamů v databázi. Z toho důvodu je potřeba v klientu nastavit dostatečný timeout.

Získání platebních informací lze pouze pro jednoho známého zákazníka (vstupní parametr wsdl) spadající do lokace dle loginu a hesla operátora uvedeného ve wsdl (seznam práv viž níže).

Lze získat následující informace:
  • saldo - celkové saldo zákazníka (kopíruje stejný záznam z karty zákazníka)
  • saldo_after_maturity - celkové saldo pro zákazníka po splatnosti (kopíruje stejný záznam z karty zákazníka)
Následující informace odpovídají modulu Pohledávky a koncovým stránkám zákazníka . Započítávají se pouze neuhrazené předpisy. Pokud by byl přeplatek, případně byla hodnota předpisu záporná, předpis se do zpracování nezahrne.
  • debt - celková neuhrazená pohledávka za zákazníkem (rozdíl oproti saldu je min. ten, že nejde do mínusu)
  • debt_after_maturity - celková neuhrazená pohledávka za zákazníkem po splatnosti (rozdíl oproti saldu je min. ten, že nejde do mínusu)
  • day_after_maturity - pokud je pohledávka po splatnosti, tak počet dnů po splatnosti u nejstarší pohledávky
  • podřízený seznam předpisů po splatnosti obsahuje:
    • sa_id - ID aktivované služby
    • sa_name - název služby (s ohledem na případný EU název služby)
    • period - informace o billovaném období
    • price - celková předepsaná částka za službu a období
    • debt - neuhrazená částka za službu a období po splatnosti (zde nemůže být 0, v seznamu mají být jen předpisy po splatnosti)
    • day - počet dnů po splatnosti

Příklad výsledného XML:
<?xml version="1.0" encoding="UTF-8"?>
<customer_info xmlns="https://is.cibs.cz/specific/xsd/customers_payment_info.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://is.cibs.cz/specific/xsd/customers_services.xsd https://is.cibs.cz/specific/xsd/customers_payment_info.xsd">
  <customer xmlns="" user_id="265737" saldo="-1092.00" saldo_after_maturity="-1092.00" debt="1428.0000" debt_after_maturity="1092.0000" day_after_maturity="95">
    <customer_detail sa_id="310526" sa_name="OPTIKA 10" period="01.03.2013 - 31.03.2013" price="357.0000" debt="21.0000" day="95"/>
    <customer_detail sa_id="310526" sa_name="OPTIKA 10" period="01.04.2013 - 30.04.2013" price="357.0000" debt="357.0000" day="64"/>
    <customer_detail sa_id="310526" sa_name="OPTIKA 10" period="01.05.2013 - 31.05.2013" price="357.0000" debt="357.0000" day="34"/>
    <customer_detail sa_id="310526" sa_name="OPTIKA 10" period="01.06.2013 - 30.06.2013" price="357.0000" debt="357.0000" day="4"/>
  </customer>
</customer_info>

Práva a nastavení

Název Účel Popis Hodnoty
USER_LIST.EXPORT nastavení operátora povoluje operátorovi provádět export seznamu zákazníků, jejich aktivních služeb a platebních informací 1
CT nastavení operátora právo zpřístupňuje lokaci id lokace

arrowbleft Zpět na:
Topic revision: r4 - 04 Sep 2019, UnknownUser
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback