SOAP Faults

SOAP 1.1 Fault Document

The SOAP 1.1 Fault is a standard SOAP 1.1 SOAP Fault as described in the W3C SOAP Specification

A SOAP 1.1 document consists of the following XML elements:

<faultcode> – A code identifying the fault. See SOAP 1.1 Fault Codes
<faultstring> – A human readable explanation of the fault
<faultactor> – Information on who caused the fault to happen
<detail> – Holds application specific error information

SOAP 1.1 Fault Example

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

 <soap:Body>

  <soap:Fault>

   <faultcode>soap:Server</faultcode>

   <faultstring>Insufficient funds</faultstring>

   <detail>

    <x:TransferError xmlns:x="urn:examples-org:banking">

     <sourceAccount>22-342439</sourceAccount>

     <transferAmount>100.00</transferAmount>

     <currentBalance>89.23</currentBalance>

    </x:TransferError>

   </detail>

  </x:TransferFunds>

 </soap:Body>

</soap:Envelope>

SOAP 1.1 Fault Codes

Error	Description
VersionMismatch	Found an invalid namespace for the SOAP Envelope element
MustUnderstand	An immediate child element of the Header element, with the mustUnderstand attribute set to "1", was not understood
Client	The message was incorrectly formed, contained incorrect information or there was an error communicating with the server.
Server	There was a problem with the server so the message could not proceed

SOAP 1.2 Fault Document

The SOAP 1.2 Fault is a standard SOAP 1.2 SOAP Fault as described in the W3C SOAP Version 1.2 Part 1

A SOAP 1.2 document consists of the following XML elements

<code><value> – A code identifying the fault. See SOAP 1.2 Fault Codes
<code><subcode><value> – A human readable explanation of the fault
<reason><text> – Information on who caused the fault to happen
<detail> – Holds application specific error information

SOAP 1.2 Fault Example

<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:m="http://www.example.org/timeouts" xmlns:xml="http://www.w3.org/XML/1998/namespace">

 <env:Body>

  <env:Fault>

   <env:Code>

     <env:Value>env:Sender</env:Value>

     <env:Subcode>

      <env:Value>m:MessageTimeout</env:Value>

     </env:Subcode>

   </env:Code>

   <env:Reason>

     <env:Text xml:lang="en">Sender Timeout</env:Text>

   </env:Reason>

   <env:Detail>

     <m:MaxTime>P5M</m:MaxTime>

   </env:Detail>

  </env:Fault>

 </env:Body>

</env:Envelope>

SOAP 1.2 Fault Codes

Error	Description
VersionMismatch	Found an invalid namespace for the SOAP Envelope element
MustUnderstand	An immediate child element of the Header element, with the mustUnderstand attribute set to "1", was not understood
Sender	The message was incorrectly formed, contained incorrect information or there was an error communicating with the server.
Receiver	There was a problem with the server so the message could not proceed
DataEncodingUnknown	Data encoding is unknown or unsupported.