sERPa súgó

Az interface célja

SOAP-on keresztül már elkészült PDF lekérdezése, a válaszban visszaadásra kerül egy Base64 kódolt PDF fájl és a bizonylatszám. Többször is meghívható az eljárás.

A PDF generálását egy külön automatikus üzenetben: Vevőszámla (Vevő) - PDF számlakép elkészítése,  kell előre legenerálni, mert ez az interface csak a lekérdezését végzi. (indok: a számlából PDF készítés nem pár másodperc, viszont a már előre elkészített PDF lekérdezése gyorsan történik, mint az elkészítés és lekérdezés)

Adatcsere iránya

WEB > sERPa

Adatcsere kezdeményezője

WEB

Adatcsere gyakorisága

Egyedi

Adatcsere módja

SOAP, XML

 

Minta XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adat="http://www.serpa.hu/webservice/Adatimport">

  <soapenv:Header>

     <Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">

        <UsernameToken>

           <Username>gipsz</Username>

           <Password>jakab</Password>

        </UsernameToken>

     </Security>

  </soapenv:Header>

  <soapenv:Body>

     <adat:VevoSzPDFKep>

        <adat:szamlaszam>2016-Zs01/000005</adat:szamlaszam>

     </adat:VevoSzPDFKep>

  </soapenv:Body>

</soapenv:Envelope>

Válasz minta XML

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soap:Body>

     <VevoSzPDFKepResponse xmlns="http://www.serpa.hu/webservice/Adatexport">

        <VevoSzPDFKepResponse>

           <VevoSz>

              <szamlaszam>2016-Zs01/000005</szamlaszam>

              <dokumentum>JVBER...</dokumentum>

              <success>1</success>

           </VevoSz>

        </VevoSzPDFKepResponse>

     </VevoSzPDFKepResponse>

  </soap:Body>

</soap:Envelope>

Válasz minta XML - hiba esetén

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soap:Body>

     <VevoSzPDFKepResponse xmlns="http://www.serpa.hu/webservice/Adatexport">

        <VevoSzPDFKepResponse>

           <VevoSz>

              <szamlaszam>2016-Zsx1/000005</szamlaszam>

              <success>0</success>

              <errorMessage Code="50715">Nem létező bizonylat!</errorMessage>

           </VevoSz>

        </VevoSzPDFKepResponse>

     </VevoSzPDFKepResponse>

  </soap:Body>

</soap:Envelope>

Mezők megfeleltetése

 

 

Algoritmus

Számla PDF visszaadása, ahol a szamlaAzonosito-ba a sERPa-s bizonylatszám van megadva.

Eredményhalmaz

 

Ellenőrzés

Lehetséges hibaüzenetek:

Nem létező bizonylat!

A PDF számlakép nem elérhető!