WS_VersUnterbrechungGas Webdienst

WS_VersUnterbrechungGas

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

BeginnTransaktion

Mit dieser Methode starten Sie eine Erhebung zur Übertragung von Versorgungsunterbrechungen Gas. Bei gültiger Authentifizierung erhalten Sie eine Transaktionsnummer (BeginnTransAntwort-Objekt) als Rückgabewert. Die Gültigkeitsdauer dieser Transaktionsnummer beträgt 30 Minuten. Alle weiteren Aufrufe des Webservices mit dieser Transaktionsnummer müssen in diesem Zeitraum erfolgen. Der Parameter 'transArt' ist auf 'EchtDaten' zu setzen. Zum Testen des Webservices kann der Parameter 'transArt' auf die jeweilige Testsequenz gesetzt werden. Beim Testen werden nur Beispieldaten zurückgegeben.

Test

Das Testformular ist nur für Anforderungen vom lokalen Computer verfügbar.

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 /WS_VersorgUnterbrGas/WS_VersUnterbrechungGas.asmx HTTP/1.1
Host: app.bundesnetzagentur.de
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://app.bundesnetzagentur.de/WS_VersorgUnterbrGas/BeginnTransaktion"

<?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:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <BeginnTransaktion xmlns="https://app.bundesnetzagentur.de/WS_VersorgUnterbrGas">
      <bNR>int</bNR>
      <kNr>string</kNr>
      <nNr>int</nNr>
      <berichtsJahr>int</berichtsJahr>
      <leermeldung>boolean</leermeldung>
      <paketeGesamt>int</paketeGesamt>
      <anzahlUntGesamt>int</anzahlUntGesamt>
      <anzahlUntInPaket>int</anzahlUntInPaket>
      <transArt>EchtDaten or TestVerweigert or TestGesperrt or TestAusserBetrieb or TestAkzeptiert or TestNichtAkzeptiert or TestFehler</transArt>
    </BeginnTransaktion>
  </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:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <BeginnTransaktionResponse xmlns="https://app.bundesnetzagentur.de/WS_VersorgUnterbrGas">
      <BeginnTransaktionResult>
        <TransNr>string</TransNr>
      </BeginnTransaktionResult>
    </BeginnTransaktionResponse>
  </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 /WS_VersorgUnterbrGas/WS_VersUnterbrechungGas.asmx HTTP/1.1
Host: app.bundesnetzagentur.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:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <BeginnTransaktion xmlns="https://app.bundesnetzagentur.de/WS_VersorgUnterbrGas">
      <bNR>int</bNR>
      <kNr>string</kNr>
      <nNr>int</nNr>
      <berichtsJahr>int</berichtsJahr>
      <leermeldung>boolean</leermeldung>
      <paketeGesamt>int</paketeGesamt>
      <anzahlUntGesamt>int</anzahlUntGesamt>
      <anzahlUntInPaket>int</anzahlUntInPaket>
      <transArt>EchtDaten or TestVerweigert or TestGesperrt or TestAusserBetrieb or TestAkzeptiert or TestNichtAkzeptiert or TestFehler</transArt>
    </BeginnTransaktion>
  </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:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <BeginnTransaktionResponse xmlns="https://app.bundesnetzagentur.de/WS_VersorgUnterbrGas">
      <BeginnTransaktionResult>
        <TransNr>string</TransNr>
      </BeginnTransaktionResult>
    </BeginnTransaktionResponse>
  </soap12:Body>
</soap12:Envelope>