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

MuleSoft error
<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_DISPATCH for this fault. Version 3.0 raises WSC:SOAP_FAULT.

03How to fix it

  1. Set Must Understand to false in the Web Service Consumer security configuration.
  2. 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

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

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.