• Prihlásiť / Vytvoriť účet

Vykonávam príkaz..

Stlačte F5 pre obnovenie stránky,
ak vidíte túto správu príliš dlho.

UPOZORNENIE:

Táto funkcia je prístupná len pre prihlásených užívateľov s typom účtu BUSINESS Membership (platená registrácia). Viac o typoch registrácie.
Typ registrácie si môžete zmeniť v priebehu platby v časti "Moja zóna" alebo nás kontaktujte.

Vytvorenie dokumentu prostredníctvom webovej služby SOAP

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

REQUEST - Definíciu vstupných elementov detailne popisuje WSDL súbor, pričom hlavnými elementami sú: RESPONSE - Vrátená odpoveď obsahuje nasledovné parametre:

Príklad kódu v PHP


<?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_LISTU' => '1 / 1',
        
'ODOSIELATEL' => '',
      ),
      
'templates' => 
      array (
        
'itemsharok' => 
        array (
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
=> 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
10 => 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
          
11 => 
          array (
            
'PODACIE_CISLO' => '',
            
'MENO_FIRMA' => '',
            
'ULICA_CISLO' => '',
            
'MOBIL_EMAIL' => '',
            
'PSC_POSTA' => '',
            
'HMOTNOST' => '',
            
'CENA_DOBIERKY' => '',
            
'POISTENIE' => '',
            
'DOPLNKOVE_SLUZBY' => '',
            
'DRUH' => '',
            
'VARIABILNY_SYMBOL' => '',
            
'DRUH_ZASIELKY' => '',
            
'VYPLATNE_EUR' => '',
          ),
        ),
      ),
    );

try{
    
// vytvoríme dokument
    
$client = new SoapClient("https://ipdf.sk/slovenska-posta/podaci-harok-hromadne-odoslanie-zasielok?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;
}
?>

Riešenie potenciálnych problémov

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.


<?php
$client 
= new SoapClient("https://ipdf.sk/slovenska-posta/podaci-harok-hromadne-odoslanie-zasielok?soap");
$response $client->connect(); // Success - you have connected at 22.05.2019 09:03:08 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/slovenska-posta/podaci-harok-hromadne-odoslanie-zasielok?soap"$options);