MuleSoft · Web Service Consumer Connector
WSC:SOAP_FAULT with faultcode soap:MustUnderstand
Short answer
A WSC:SOAP_FAULT with the fault code soap:MustUnderstand happens because the connector's security Must Understand field defaults to true and the service does not process that header. Set Must Understand to false.
VerifiedLast verified
01Error text
<faultcode>soap:MustUnderstand</faultcode>02Likely causes
- The Must Understand field in the connector's security configuration defaults to
true. - On a custom HTTP transport, version 2.x of the connector raised
WSC:CANNOT_DISPATCHfor this fault. Version 3.0 raisesWSC:SOAP_FAULT.
03How to fix it
- Set Must Understand to
falsein the Web Service Consumer security configuration. - If the fault response is gzip compressed, catch the error with an error handler and use the Compression module's Decompress operation to read the body.
04Official documentation
→Related errors
- WSC:SOAP_FAULTWSC:SOAP_FAULT means the SOAP service returned a fault, or the response did not match the format in the WSDL. Read the fault text in error.errorMessage.payload.reason and the detail in error.errorMessage.payload.detail.
- WSC:CANNOT_DISPATCHWSC:CANNOT_DISPATCH is raised when the request cannot be dispatched and the HTTP error cannot be turned into a SOAP fault. In version 3.0 that covers one-way operations, WSDL or schema requests, an empty HTTP error body, or an error body over 1048576 bytes.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for MuleSoft work:Open MuleSoft jobsMuleSoft rates and salariesHire a senior MuleSoft developer