Articles in this section

Sending SOAP Messages to Unimarket

Justin Gillion
  • Updated

Overview

SOAP is a protocol specification for exchanging structured information (XML) in the implementation of Web Services. Clients using this protocol will usually use the Unimarket wsdl to generate the required code on their chosen platform.

Basic getting started guide

  • Contact Unimarket to provide you with the authentication details required (tenant identifier, integration username and shared secret).
  • Download the Unimarket wsdl (see Webservice Integration Documentation) and identify the operation for sending the chosen request element to Unimarket.
  • Download the Unimarket xml schema (see Webservice Integration Documentation) and identify the top-level request element to send to Unimarket.
  • Create a request message that conforms to the xml schema.
  • Send a valid SOAP message containing the request message and the authentication header element to one of the following two applicable urls.
  1. Supplier
  2. Commmunity
Tip: Use the free soapUI client to test sending messages to Unimarket.

 

Example SOAP message

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header>
        <header xmlns="http://www.unimarket.com/schema/unimarket-ws">
            <authentication>
                <!-- Unique identifier of the Unimarket tenant (community or supplier) -->
                <tenant-ref domain="UNIMARKET_ID_DOMAIN" identity="782965bc-f39b-4589-8949-5530e6d1b287"/>
                <sender>
                    <!-- Unique identifier of the Unimarket integration user -->
                    <user-ref identity="AACCUMKT" domain="UNIMARKET_USERNAME_DOMAIN"/>
                    <!-- Password used to authenticate the request -->
                    <shared-secret>shared secret</shared-secret>
                </sender>
            </authentication>
        </header>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <update-account-code-format-request xmlns="http://www.unimarket.com/schema/unimarket-ws">
            <account-code-format code="PROJECT_A">
                <account-code-format-part code="part-a" required="true">
                    <regular-expression-part max-length="1">
                        <expression>.*</expression>
                    </regular-expression-part>
                </account-code-format-part>
        </update-account-code-format-request>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Related articles