Contact

Contacts are used to identify a customer in quotes and orders within the WebConnector. Please also see Customer

Service Endpoint

The base Endpoints are:

InboundCreateContactIISWebService/InboundCreateContactIISWebService
ContactIISWebService/ContactIISWebService
OutboundContactIISWebService/OutboundContactIISWebService

API Methods

Here are the available methods for the Contact Services:

ContactIISWebService

• Create
• Read
• Read Multiple
• Update
• Update Multiple

Sample Create

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
   xmlns:inb="http://tempuri.org/InboundCreateContactIISWebService/" 
   xmlns:x60="urn:microsoft-dynamics-nav/xmlports/x5371217">
   <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
      <wsa:Action>http://tempuri.org/InboundCreateContactIISWebService/InboundCreateContactIISWebService/CreateContact</wsa:Action>
   </soap:Header>
   <soap:Body>
      <inb:CreateContact>
         <inb:inboundCreateContact>
            <x60:Contact>
               <x60:Salutation_Code>M</x60:Salutation_Code>
               <x60:Name>soap-name0001</x60:Name>
               <x60:Name_2>soap-name20001</x60:Name_2>
               <x60:Address>soap-str0001</x60:Address>
               <x60:Address_2>soap-str20001</x60:Address_2>
               <x60:City>Osnabrück</x60:City>
               <x60:Phone_No>+49 541 139590</x60:Phone_No>
               <x60:Country_Region_Code>DE</x60:Country_Region_Code>
               <x60:Fax_No>+49 541 139550</x60:Fax_No>
               <x60:VAT_Registration_No>DE813565185</x60:VAT_Registration_No>
               <x60:Post_Code>49080</x60:Post_Code>
               <x60:E-Mail>soaptest0001-e@tso.de</x60:E-Mail>
               <x60:First_Name>soap-first0001</x60:First_Name>
               <x60:Middle_Name>soap-middle0001</x60:Middle_Name>
               <x60:Surname>soap-sur0001</x60:Surname>
               <x60:Online_Login_ID>soaptest0001@tso.de</x60:Online_Login_ID>
               <x60:Online_Password>soaptest0001</x60:Online_Password>
               <x60:Customer_Template_Code>DE MID</x60:Customer_Template_Code>
               <x60:No/>
            </x60:Contact>            
         </inb:inboundCreateContact>
      </inb:CreateContact>
   </soap:Body>
</soap:Envelope>

Response

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
   <s:Header>
      <a:Action s:mustUnderstand="1">http://tempuri.org/InboundCreateContactIISWebService/InboundCreateContactIISWebService/CreateContactResponse</a:Action>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <CreateContactResponse xmlns="http://tempuri.org/InboundCreateContactIISWebService/">
         <inboundCreateContact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371217">
               <Salutation_Code>M</Salutation_Code>
               <Name>soap-first0001 soap-middle0001 soap-sur0001</Name>
               <Name_2>soap-name20001</Name_2>
               <Address>soap-str0001</Address>
               <Address_2>soap-str20001</Address_2>
               <City>Osnabrück</City>
               <Phone_No>+49 541 139590</Phone_No>
               <Currency_Code/>
               <Language_Code/>
               <Country_Region_Code>DE</Country_Region_Code>
               <Fax_No>+49 541 139550</Fax_No>
               <VAT_Registration_No>DE813565185</VAT_Registration_No>
               <Post_Code>49080</Post_Code>
               <E-Mail>soaptest0001-e@tso.de</E-Mail>
               <First_Name>soap-first0001</First_Name>
               <Middle_Name>soap-middle0001</Middle_Name>
               <Surname>soap-sur0001</Surname>
               <Online_Login_ID>SOAPTEST0001@TSO.DE</Online_Login_ID>
               <Online_Password>soaptest0001</Online_Password>
               <Customer_Template_Code>DE MID</Customer_Template_Code>
               <No>KT000144</No>
            </Contact>
         </inboundCreateContact>
      </CreateContactResponse>
   </s:Body>
</s:Envelope>

Sample Read

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
   xmlns:con="http://tempuri.org/ContactIISWebService/">
   <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing"> 
      <wsa:Action>http://tempuri.org/ContactIISWebService/ContactIISWebService/Read</wsa:Action>
   </soap:Header>
   <soap:Body>
      <con:Read>         
         <con:No>KT000105</con:No>
      </con:Read>
   </soap:Body>
</soap:Envelope>

Response

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
   <s:Header>
      <a:Action s:mustUnderstand="1">http://tempuri.org/ContactIISWebService/ContactIISWebService/ReadResponse</a:Action>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <ReadResponse xmlns="http://tempuri.org/ContactIISWebService/">
         <ReadResult>
            <Key xmlns="urn:microsoft-dynamics-schemas/page/contact">32;uhMAAAJ7/0sAVAAwADAAMAAxADAANQ==6;4300350;</Key>
            <E_Mail xmlns="urn:microsoft-dynamics-schemas/page/contact">technische.betriebe.rotkreuz@cronuscorp.net</E_Mail>
            <Name xmlns="urn:microsoft-dynamics-schemas/page/contact">Technische Betriebe Rotkreuz</Name>
            <Address xmlns="urn:microsoft-dynamics-schemas/page/contact">Seedamm 18</Address>
            <City xmlns="urn:microsoft-dynamics-schemas/page/contact">Rotkreuz</City>
            <Currency_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">CHF</Currency_Code>
            <Language_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">DES</Language_Code>
            <Country_Region_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">CH</Country_Region_Code>
            <Comment xmlns="urn:microsoft-dynamics-schemas/page/contact">false</Comment>
            <VAT_Registration_No xmlns="urn:microsoft-dynamics-schemas/page/contact">CHE-451.456.123MWST</VAT_Registration_No>
            <Post_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">6343</Post_Code>
            <No xmlns="urn:microsoft-dynamics-schemas/page/contact">KT000105</No>
            <Salutation_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">MANDANT</Salutation_Code>
            <Blocked xmlns="urn:microsoft-dynamics-schemas/page/contact">false</Blocked>
         </ReadResult>
      </ReadResponse>
   </s:Body>
</s:Envelope>

Sample Read Multiple

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
   xmlns:con="http://tempuri.org/ContactIISWebService/" 
   xmlns:con1="urn:microsoft-dynamics-schemas/page/contact">
   <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing"> 
      <wsa:Action>http://tempuri.org/ContactIISWebService/ContactIISWebService/ReadMultiple</wsa:Action>
   </soap:Header>
   <soap:Body>
      <con:ReadMultiple>         
         <con:filter>
            <!--Zero or more repetitions:-->
            <con:Contact_Filter>
               <con1:Field>E_Mail</con1:Field>
               <!--Optional:-->
               <con1:Criteria>@*cronuscorp.net</con1:Criteria>
            </con:Contact_Filter>
            <con:Contact_Filter>
               <con1:Field>Name</con1:Field>
               <!--Optional:-->
               <con1:Criteria>@*weiler*</con1:Criteria>
            </con:Contact_Filter>
         </con:filter>         
         <con:bookmarkKey/>
         <con:setSize>0</con:setSize>
      </con:ReadMultiple>
   </soap:Body>
</soap:Envelope>

Response

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
   <s:Header>
      <a:Action s:mustUnderstand="1">http://tempuri.org/ContactIISWebService/ContactIISWebService/ReadMultipleResponse</a:Action>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <ReadMultipleResponse xmlns="http://tempuri.org/ContactIISWebService/">
         <ReadMultipleResult>
            <Contact>
               <Key xmlns="urn:microsoft-dynamics-schemas/page/contact">32;uhMAAAJ7/0sAVAAxADAAMAAxADkAOA==6;4304400;</Key>
               <E_Mail xmlns="urn:microsoft-dynamics-schemas/page/contact">cornelia.weiler@cronuscorp.net</E_Mail>
               <Name xmlns="urn:microsoft-dynamics-schemas/page/contact">Cornelia Weiler</Name>
               <Address xmlns="urn:microsoft-dynamics-schemas/page/contact">Plett Straße 187</Address>
               <City xmlns="urn:microsoft-dynamics-schemas/page/contact">Frankfurt/Main</City>
               <Language_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">DEU</Language_Code>
               <Comment xmlns="urn:microsoft-dynamics-schemas/page/contact">false</Comment>
               <Post_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">60320</Post_Code>
               <No xmlns="urn:microsoft-dynamics-schemas/page/contact">KT100198</No>
               <First_Name xmlns="urn:microsoft-dynamics-schemas/page/contact">Cornelia</First_Name>
               <Surname xmlns="urn:microsoft-dynamics-schemas/page/contact">Weiler</Surname>
               <Salutation_Code xmlns="urn:microsoft-dynamics-schemas/page/contact">W-VERH</Salutation_Code>
               <Blocked xmlns="urn:microsoft-dynamics-schemas/page/contact">false</Blocked>
            </Contact>
         </ReadMultipleResult>
      </ReadMultipleResponse>
   </s:Body>
</s:Envelope>

Sample Outbound Contact

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
  xmlns:out="http://tempuri.org/OutboundContactIISWebService/" 
  xmlns:x53="urn:microsoft-dynamics-nav/xmlports/x5371211">
   <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
      <wsa:Action>http://tempuri.org/OutboundContactIISWebService/OutboundContactIISWebService/GetContactsFromCustomer</wsa:Action>
   </soap:Header>
   <soap:Body>
      <out:GetContactsFromCustomer>
         <!--Optional:-->
         <out:outboundContact>

         </out:outboundContact>
         <!--Optional:-->
         <out:customerNo>10000</out:customerNo>
      </out:GetContactsFromCustomer>
   </soap:Body>
</soap:Envelope>

Response

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
   <s:Header>
      <a:Action s:mustUnderstand="1">http://tempuri.org/OutboundContactIISWebService/OutboundContactIISWebService/GetContactsFromCustomerResponse</a:Action>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <GetContactsFromCustomerResponse xmlns="http://tempuri.org/OutboundContactIISWebService/">
         <outboundContact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371211">
               <No>KT000007</No>
               <Name>Möbel-Meller KG</Name>
               <Type>0</Type>
               <CompanyNo>KT000007</CompanyNo>
            </Contact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371211">
               <No>KT000008</No>
               <Name>Herr Michael Emanuel</Name>
               <Type>1</Type>
               <CompanyNo>KT000007</CompanyNo>
            </Contact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371211">
               <No>KT100140</No>
               <Name>David Hodgson</Name>
               <Type>1</Type>
               <CompanyNo>KT000007</CompanyNo>
            </Contact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371211">
               <No>KT100156</No>
               <Name>John Emory</Name>
               <Type>1</Type>
               <CompanyNo>KT000007</CompanyNo>
            </Contact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371211">
               <No>KT100210</No>
               <Name>Stephanie Bourne</Name>
               <Type>1</Type>
               <CompanyNo>KT000007</CompanyNo>
            </Contact>
            <Contact xmlns="urn:microsoft-dynamics-nav/xmlports/x5371211">
               <No>KT200136</No>
               <Name>Mindy Martin</Name>
               <Type>1</Type>
               <CompanyNo>KT000007</CompanyNo>
            </Contact>
         </outboundContact>
      </GetContactsFromCustomerResponse>
   </s:Body>
</s:Envelope>

Field Information

Contact Field Information

Name	Description	Type	max. Length	Occurance
🔑 No	Specifies the number of the contact.	String	20	1..1
Customer_Template_Code	Specifies a customer template. This is necessary to create a customer in a later process, i.e. sales order. Get a list of codes from the Master Data Service	String	10	0..1
Name	Specifies the contact's name.	String	50	0..1
Name_2	Specifies the contact's add. name information.	String	50	0..1
First_Name	Specifies the contact's first name.	String	30	0..1
Middle_Name	Specifies the contact's middle name.	String	30	0..1
Surname	Specifies the contact's surname.	String	30	0..1
Address	Specifies the contact's address. i.E. 'Hauptstraße 12b'	String	50	1..1
Address_2	Specifies the contact's add. address information.	String	50	1..1
City	Specifies the contact's city.	String	30	1..1
Post_Code	Specifies a code for the post code of the contact's address. Get a list of codes from the Master Data Service	String	10	0..1
Country_Region_Code	Specifies a code for the country/region of the contact's address. Get a list of codes from the Master Data Service	String	10	0..1
Phone_No	Specifies the contact's phone no.	String	30	0..1
Fax_No	Specifies the contact's fax no.	String	80	0..1
E_Mail	Specifies the contact's e-mail address.	String	80	0..1
Currency_Code	Specifies a default currency code for the contact. Get a list of codes from the Master Data Service	String	10	0..1
Language_Code	Specifies a default language code for the contact. Get a list of codes from the Master Data Service	String	10	0..1
Responsibility_Center	Specifies the code for the responsibility center that will administer this contact by default.. Get a list of codes from the Master Data Service	String	10	0..1
Online_Login_ID	Specifies the login ID (i.e. email address) to filter contacts	String	80	0..1
Online_Password	Specifies a password, usually sent by the shop, as a md5 hash	String	32	0..1
Blocked	Specifies whether the contact is blocked.	Boolead		0..1