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

Zpět na:

• Rozhraní API