Darčeková poukážka - vzor na pobyt

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/certifikaty-poukazky/darcekova-poukazka-vzor-pobyt?wsdl
• Endpoint / Služba: https://ipdf.sk/certifikaty-poukazky/darcekova-poukazka-vzor-pobyt?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 (
        'CISLO_POUKAZKY' => '0123456-ABCD/XXX',
        'CISLO_POUKAZKY_TITLE' => 'Číslo poukážky:',
        'KDE_UPLATNIT_POPIS' => 'Hotel Biely Lev***, Strážovská cesta 1201, 957 01 Nitra
    tel. 00421 (0)903 123456, 038 1122335
    email: recepcia@biely-lev.sk
    http://www.biely-lev.sk',
        'KDE_UPLATNIT_TITLE' => 'Kde poukážku uplatniť:',
        'NAZOV' => 'POUKÁŽKA',
        'PLATNOST_POUKAZKY' => 'Platnosť poukážky:',
        'PLATNOST_POUKAZKY_OD_DO' => 'Od 01.06.2015 do 14.06.2015',
        'POKYNY' => 'Poukážka nie je vymeniteľná za peniaze a dá sa použiť iba raz. Je potrebná rezervácia VOPRED na tel. č.: +421 (0)903 123456 alebo na e-maile recepcia@biely-lev.sk. Pri objednávaní zadajte číslo kupónu. Kupón platí cez týždeň aj cez víkend. Je možné kombinovať viac kupónov a predĺžiť si pobyt. V cene nie je kúpeľný poplatok 2 EUR /deň (platí sa priamo na mieste). Deti do 3 rokov bez nároku na lôžko a stravu zadarmo. Pobyt pre 2 osoby na 5 nocí zahŕňa: ubytovanie s polpenziou, bazén a sauna neobmedzene, parkovanie.',
        'UCEL_POUKAZKY' => 'Wellness pobyt pre dve osoby na 2 noci',
      ),
    );

try{
    // vytvoríme dokument
    $client = new SoapClient("https://ipdf.sk/certifikaty-poukazky/darcekova-poukazka-vzor-pobyt?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/certifikaty-poukazky/darcekova-poukazka-vzor-pobyt?soap");
$response = $client->connect(); // Success - you have connected at 25.04.2024 13:50:24 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/certifikaty-poukazky/darcekova-poukazka-vzor-pobyt?soap", $options);