Create Customer Request

Description: with this call, a new HUB customer can be created for the Center. This call can be used only for MBE Auction House purposes

Parameters:

1. CustomerSource: must always be of type Auction House (AH). The API returns an error if the customerSource is different from AH
2. CustomerType: the API returns an error if the customerType is different from HABITUAL, PROSPECT, OCCASIONAL, SUPPLIER
3. B2B: can be true or false. If TRUE, it will also be mandatory to define a VAT number, otherwise an error is returned.
  In particular:
  - Fiscal Code and Vat Number validation only if country is IT;
  - Vat Number validation for country FR;
  - No validation for other countries (possibility of not passing Fiscal Code if B2B is false);
  - Look-up and validation:
  - - 1. The customer look-up is already done at the API level;
        If the customer is of type AH, and the VAT Number/Fiscal Code are already existing for 1 customer, data will be updated
        If I have a AH customer without Fiscal Code and Vat Number, the lookup is done by businessName;
        If the search query for an AH customer finds more than 1 customer with the same Fiscal Code / Vat number, a new customer will be created (no update);
4. GDPR flags: they will be automatically set on the HUB by associating them with the latest version available, and with the date of the day on which the client is created;
  - PrivacyPolicyAcknowledgement may have values EMPTY or TRUE, but must necessarily always be set to TRUE;
  - ConsentMktCenter, ConsentMktCorporate, ConsentProfiling, ConsentThirdParty can have values EMPTY, TRUE and FALSE;

Request Sample

<soapenv:Header/>

<soapenv:Body>

<ws:CreateCustomerRequest>

<RequestContainer>

<System>IT</System>

<Credentials>

<Username></Username>

<Passphrase></Passphrase>

</Credentials>

<InternalReferenceID>DDSDA</InternalReferenceID>

<Customer>

<CustomerSource>AH</CustomerSource>

<CustomerType>HABITUAL</CustomerType>

<B2B>true</B2B>

<TradingName>Customer</TradingName>

<VatNumber>73002480447</VatNumber>

<FirstName>Test</FirstName>

<LastName>Test</LastName>

<Address1>Via XXX</Address1>

<ZipCode>12345</ZipCode>

<City>Milano</City>

<Province>MI</Province>

<Country>IT</Country>

<Reference>XXX</Reference>

<Phone>93858374</Phone>

<Email>mbe@test.it</Email>

<Fax>?</Fax>

</Customer>

<PrivacyPolicyAcknowledgement>true</PrivacyPolicyAcknowledgement>

<ConsentMktCenter>true</ConsentMktCenter>

<ConsentMktCorporate>true</ConsentMktCorporate>

<ConsentProfiling>true</ConsentProfiling>

<ConsentThirdParty>true</ConsentThirdParty>

</RequestContainer>

</ws:CreateCustomerRequest>

</soapenv:Body>

</soapenv:Envelope>

Response Sample for new customer

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns3:CreateCustomerRequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">

<RequestContainer>

<InternalReferenceID>DDSDA</InternalReferenceID>

<Status>OK</Status>

<CustomerMBEID>0000062132</CustomerMBEID>

<CustomerStatus>CREATED</CustomerStatus>

<AdditionalInformation>Using last privacy policy version: 4 for country IT</AdditionalInformation>

<AdditionalInformation>Fiscal code is absent</AdditionalInformation>

</RequestContainer>

</ns3:CreateCustomerRequestResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Response Sample for existing customer update

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns3:CreateCustomerRequestResponse xmlns:ns3="http://www.onlinembe.eu/ws/">

<RequestContainer>

<InternalReferenceID>?</InternalReferenceID>

<Status>OK</Status>

<CustomerMBEID>0000062099</CustomerMBEID>

<CustomerStatus>UPDATED</CustomerStatus>

<AdditionalInformation>Fiscal code already associated to a customer</AdditionalInformation>

</RequestContainer>

</ns3:CreateCustomerRequestResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Page updated

Report abuse