Zmluva o nájme dopravného prostriedku

Vytvorenie dokumentu prostredníctvom volania SOAP webovej služby je možné volaním SOAP požiadavky s URL parametrom "soap" (GET).

• WSDL: https://ipdf.sk/obcianske-pravo/zmluva-o-najme-dopravneho-prostriedku?wsdl
• Endpoint / Služba: https://ipdf.sk/obcianske-pravo/zmluva-o-najme-dopravneho-prostriedku?soap

REQUEST - Definíciu vstupných elementov detailne popisuje WSDL súbor, pričom hlavnými elementami sú:

• key - povinný atribút, autentifikačný kľúč pridelený užívateľovi
• data - povinný atribút, dátová štruktúra (pole alebo objekt) obsahujúca atribúty dokumentu - viď príklad nižšie

RESPONSE - Vrátená odpoveď obsahuje nasledovné parametre:

• success - 0, 1, kde 1 = úspech
• info - popis chýb v prípade neúspechu, resp. alebo informáciu o vytvorenom súbore v prípade úspechu
• file_name - názov vytvoreného tlačiva vo Vašom archíve dokumentov
• download_link - linka pre stiahnutie dokumentu platná 24 hodín od okamihu vytvorenia dokumentu
• file_content - base64 encoded obsah vytvoreného PDF súboru

<?php
// Odoslanie požiadavky
// ====================

// povinný autentifikačný API kľúč, nastavíte si ho v zóne "Moje dokumenty -> Nastavenia"
$api_key = "uARM_PSxvI*********************************";

// hodnoty atribútov v dokumente
$data = array (
      'fields' => 
      array (
        'DEN_SPLATNOSTI_V_MESIACI' => '5',
        'PAR_ZABEZPECENIE_OPRAVY' => 'Zmluvné strany sa dohodli na tom, že v prípade poškodenia vozidla bez zavinenia nájomcu alebo osôb, ktorým nájomca umožnil prístup k vozidlu, prenajímateľ zabezpečí opravu vozidla do 72 hodín od jeho prevzatia na opravu. V prípade opravy, ktorá si vyžiada dobu dlhšiu ako 72 hodín, prenajímateľ sa zaväzuje 72 hodín od prevzatia vozidla na opravu, poskytnúť nájomcovi náhradné vozidlo na dobu do ukončenia opravy. Ak prenajímateľ nájomcovi náhradné vozidlo neposkytne, nájomca nie je povinný platiť nájomné za čas, v ktorom nemohol vozidlo užívať pre jeho nespôsobilosť alebo potrebu opravy s výnimkou prvých 72 hodín.',
        'PRENAJIMATEL_MENO' => '',
        'VYPOVEDNA_LEHOTA' => '30',
      ),
    );

try{
    // vytvoríme dokument
    $client = new SoapClient("https://ipdf.sk/obcianske-pravo/zmluva-o-najme-dopravneho-prostriedku?soap");
    $response = $client->generate($api_key, $data, $action);
}catch(SoapFault $e){
    echo "Chyba pri vytváraní dokumentu: ".$e->getMessage();
}

// Spracovanie odpovede
// ====================

if($response->success == "1"){
    echo "Úspech - dokument bol vytvorený. Linka pre stiahnutie dokumentu: ".$response->download_link;
    // súbor si môžete uložiť na lokálny disk
    file_put_contents("/path/to/save.pdf", base64_decode($response->file_content));
}else{
    echo "Dokument sa nepodarilo vytvoriť. Popis chyby: ".$response->info;
}
?>

1. Metóda soapClient->connect()

Pre uľahčenie implementácie je možné využiť podpornú metódu connect().
Metóda nevyžaduje autentifikáciu ani žiadne vstupné parametre a vráti správu obsahujúcu aktuálny čas servera.  Spustiť

<?php
$client = new SoapClient("https://ipdf.sk/obcianske-pravo/zmluva-o-najme-dopravneho-prostriedku?soap");
$response = $client->connect(); // Success - you have connected at 20.04.2024 15:51:54 to SoapServer at ipdf.sk ...

2. Alternatívny zápis pre inicializáciu SoapClient objektu:

<?php
// odkomentujte počas vývoja potrebné nastavenia
$context = stream_context_create(array(
    "ssl" => array(
        // "verify_peer" => false,
        // "allow_self_signed" => true,
    ),
    "http" => array(
        // "curl_verify_ssl_peer" => false,
        // "curl_verify_ssl_host" => false,
    ),
));

$options = array(
    "stream_context" => $context,
    "features" => SOAP_SINGLE_ELEMENT_ARRAYS,
    // "cache_wsdl" => WSDL_CACHE_NONE,
    // "trace" => true,
    // "exceptions" => true,
);

$client = new SoapClient("https://ipdf.sk/obcianske-pravo/zmluva-o-najme-dopravneho-prostriedku?soap", $options);