General Discussion:

If a Distributor is sending a request with invalid parameters, Suppliers should send a response with the specific error response in the below format. See example details below.

Example 1: User sending invalid credentials in the request.

Supplier Response:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.promostandards.org/WSDL/OrderStatusService/1.0.0/">
   <SOAP-ENV:Body>
      <ns1:GetOrderStatusDetailsResponse>
              <ns1:errorMessage>105: Authentication Credentials failed</ns1:errorMessage>
      </ns1:GetOrderStatusDetailsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example 2: User sending incorrect Reference Number in the request. (Query Type 1 or 2)

Supplier Response:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.promostandards.org/WSDL/OrderStatusService/1.0.0/">
   <SOAP-ENV:Body>
      <ns1:GetOrderStatusDetailsResponse>
              <ns1:errorMessage>301: referenceNumber not found</ns1:errorMessage>
      </ns1:GetOrderStatusDetailsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

GetOrderStatusDetailsResponse

...