Portal Webdienst

Portal

Klicken Sie hier, um die vollständige Vorgangsliste anzuzeigen.

checkPostfach

überprüft ob es neue Daten für die angegebene Anwendung/Erfassungsstelle gibt

Rückgabewerte:
Status + Anzahl der gefundenen Daten
Status:

0-STATUS_OK
1-STATUS_LOGINFEHLER
7-STATUS_DATENBANKFEHLER
10-STATUS_KEINE_ERLAUBNIS_FUER_ANWENDUNG

Test

Klicken Sie auf die Schaltfläche 'Aufrufen', um den Vorgang mit dem HTTP POST-Protokoll zu testen.

SOAP 1.1

Es folgt ein Beispiel für eine SOAP 1.1-Anforderung und -Antwort. Die angezeigten Platzhalter müssen durch tatsächliche Werte ersetzt werden.

POST /portal.asmx HTTP/1.1
Host: securelohn.brz.de
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "BRZPostfachServer/checkPostfach"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="BRZPostfachServer" xmlns:types="BRZPostfachServer/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <tns:checkPostfach>
      <session_id xsi:type="xsd:string">string</session_id>
      <erfassungsstelle xsi:type="xsd:string">string</erfassungsstelle>
      <niederlassung xsi:type="xsd:string">string</niederlassung>
    </tns:checkPostfach>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="BRZPostfachServer" xmlns:types="BRZPostfachServer/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <tns:checkPostfachResponse>
      <checkPostfachResult href="#id1" />
    </tns:checkPostfachResponse>
    <types:CheckPostfachDO id="id1" xsi:type="types:CheckPostfachDO">
      <status xsi:type="xsd:int">int</status>
      <anzahl_neu xsi:type="xsd:int">int</anzahl_neu>
      <anzahl_abgeholt xsi:type="xsd:int">int</anzahl_abgeholt>
    </types:CheckPostfachDO>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

Es folgt ein Beispiel für eine SOAP 1.2-Anforderung und -Antwort. Die angezeigten Platzhalter müssen durch tatsächliche Werte ersetzt werden.

POST /portal.asmx HTTP/1.1
Host: securelohn.brz.de
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://www.w3.org/2003/05/soap-encoding" xmlns:tns="BRZPostfachServer" xmlns:types="BRZPostfachServer/encodedTypes" xmlns:rpc="http://www.w3.org/2003/05/soap-rpc" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body soap12:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
    <tns:checkPostfach>
      <session_id xsi:type="xsd:string">string</session_id>
      <erfassungsstelle xsi:type="xsd:string">string</erfassungsstelle>
      <niederlassung xsi:type="xsd:string">string</niederlassung>
    </tns:checkPostfach>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://www.w3.org/2003/05/soap-encoding" xmlns:tns="BRZPostfachServer" xmlns:types="BRZPostfachServer/encodedTypes" xmlns:rpc="http://www.w3.org/2003/05/soap-rpc" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body soap12:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
    <tns:checkPostfachResponse>
      <rpc:result xmlns="">checkPostfachResult</rpc:result>
      <checkPostfachResult soapenc:id="id0" xsi:type="types:CheckPostfachDO">
        <status xsi:type="xsd:int">int</status>
        <anzahl_neu xsi:type="xsd:int">int</anzahl_neu>
        <anzahl_abgeholt xsi:type="xsd:int">int</anzahl_abgeholt>
      </checkPostfachResult>
    </tns:checkPostfachResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

Folgendes ist eine Beispielanforderung und -antwort für HTTP GET. Die angezeigten Platzhalter müssen durch richtige Werte ersetzt werden.

GET /portal.asmx/checkPostfach?session_id=string&erfassungsstelle=string&niederlassung=string HTTP/1.1
Host: securelohn.brz.de

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<CheckPostfachDO xmlns="BRZPostfachServer">
  <status>int</status>
  <anzahl_neu>int</anzahl_neu>
  <anzahl_abgeholt>int</anzahl_abgeholt>
</CheckPostfachDO>

HTTP POST

Folgendes ist eine Beispielanforderung und -antwort für HTTP POST. Die angezeigten Platzhalter müssen durch richtige Werte ersetzt werden.

POST /portal.asmx/checkPostfach HTTP/1.1
Host: securelohn.brz.de
Content-Type: application/x-www-form-urlencoded
Content-Length: length

session_id=string&erfassungsstelle=string&niederlassung=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<CheckPostfachDO xmlns="BRZPostfachServer">
  <status>int</status>
  <anzahl_neu>int</anzahl_neu>
  <anzahl_abgeholt>int</anzahl_abgeholt>
</CheckPostfachDO>

Parameter	Wert
session_id:
erfassungsstelle:
niederlassung: