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: Előlegbekérő (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/Adatexport">

 <soapenv:Header>

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

<UsernameToken>

ú<Username>gipsz1</Username>

<Password>jakab1</Password>

</UsernameToken>

</Security>

</soapenv:Header>

<soapenv:Body>

<adat:ElolegBPDFKep>

<adat:szamlaszam>2022-TM/000010</adat:szamlaszam>

</adat:ElolegBPDFKep>

</soapenv:Body>

</soapenv:Envelope>

Válasz minta XML

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

  <soap:Body>

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

        <ElolegBPDFKepResponse>

           <ElolegB>

              <szamlaszam>2022-TM/000010</szamlaszam>

              <dokumentum>JVBER...</dokumentum>

              <success>1</success>

           </ElolegB>

        </ElolegBPDFKepResponse>

     </ElolegBPDFKepResponse>

  </soap:Body>

</soap:Envelope>

Válasz minta XML - hiba esetén

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

  <soap:Body>

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

        <ElolegBPDFKepResponse>

           <ElolegB>

              <szamlaszam>2022-TM/000010</szamlaszam>

              <success>0</success>

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

         </ElolegB>

        </ElolegBPDFKepResponse>

     </ElolegBPDFKepResponse>

  </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ő!