Import bankovních výpisů (SOAP)

Účel článku

Zdokumentování importu bankovních výpisů pomocí web services. Podrobná referenční dokumentace je k dispozici v referenčním popisu rozhraní CIBS WSDL.

Registrované metody

Metoda	Popis
ws_session_login	přihlášení operátora
ws_session_logout	odhlášení operátora
ws_session_set_ct	nastavení lokace
ws_bank_statement_upload	nahrání souboru s bankovním výpisem pro další zpracování

Posloupnost volání metod

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

Práva a nastavení

Název	Typ	Význam
CT	právo	Více info: CT
PAYMENT_LIST_PA_ID	právo	Více info: PAYMENT_LIST_PA_ID
Role automatický import banky	role	Role pro automatický import bankovních výpisů

Příklad v php

<?php

require_once 'libs/nusoap/nusoap.php';

$login='xxx';                           // specialni operator s prislusnymi pravy pro importy vypisu z banky
$password='xxx';
$pay_account_id=xxx;                           // urcuje ID pokladny v CIBSu
$ct=xxx;

$client = new nusoap_client( 'https://test.cibs.cz/ws_cibs.php?wsdl' );          // po uvolneni bude dostupne
$err = $client->getError();
if( $err )
{
  echo '<p><b>Constructor error: ' . $err . '</b></p>';
}

function ws_simple_call( $client, $method, $input )
{
  $res = $client->call( $method, $input );
  if( $client->fault )
  {
    echo "<p><b>$method - fault: ";
    print_r( $res );
    echo '</b></p>';
    $res = false;
  }
  else
  {
    $err = $client->getError();
    if( $err )
    {
      echo "<p><b>$method - error: $err</b></p>";
      $res = false;
    }
    else
    {
      echo "<p><b>$method - result: $res</b></p>";
    }
  }

  return $res;
}

function upload_file( $client, $session, $pa_id, $filename )
{
  $file_md5 = md5_file( $filename );
  $file_content = base64_encode( file_get_contents( $filename ) );
  $r = ws_simple_call( $client, 'ws_bank_statement_upload', array( 'session'=>$session, 'pa_id'=>$pa_id, 'file_name'=>$filename, 'file_content'=>$file_content, 'file_md5'=>$file_md5 ) );
}

$session = ws_simple_call( $client, 'ws_session_login', array( 'login'=>$login, 'password'=>$password ) );
if( $session )
{
  $r = ws_simple_call( $client, 'ws_session_set_ct', array( 'session'=>$session, 'ct'=>$ct ) );
  upload_file( $client, $session, $pay_account_id, 'nazev_souboru' );

  $r = ws_simple_call( $client, 'ws_session_logout', array( 'session'=>$session ) );
}

?>

Zpět na:

• Úhrady produktů a služeb
• Rozhraní API