Zefix

caution

WARNING
The SOAP/XML Zefix interface has been deactivated. To continue to receive address data, it is necessary to switch to the new address provider (see "Zefix (HTTP)"). The basic configuration is identical, adjustments to the Id and possibly to the Mapping must be made.

Configuration

Zefix (HTTP)

<!-- AddressService -->
<AddressProvider id="E10A8313-A92D-4CB2-A12B-9AEB58F39207" order="1" active="true">
  <!-- serverside Zefix address provider (HTTP) -->
  <AddressProvider id="DC124CDC-C2C0-4379-B9D4-079905E68DEA">
    <!-- User/password for Zefix web service-->
    <ServiceUser>info@oneoffixx.com</ServiceUser>
    <ServicePassword>{password}</ServicePassword>
    <!-- Optional Mapping -->
    <Mapping>
       <Map Source="name" Target="Company_Name" />
       <Map Source="translation" Target="Company_Supplement" />
       <Map SourceExpression="oo('address.street') + ' ' + oo('address.houseNumber')" Target="Company_Street" />
       <Map Source="address.city" Target="Company_City" />
       <Map SourceValue="CH" Target="Company_CountryShortCode" />
       <Map Source="address.swissZipCode" Target="Company_ZipCode" />
       <Map SourceValue="CompanyData" Target="AddressType" />
       <Map SourceValue="false" Target="SalutationView" />
    </Mapping>
  </AddressProvider>
</AddressProvider>

Parameters

• id DC124CDC-C2C0-4379-B9D4-079905E68DEA
• ServiceUser The user with which the provider logs into the Zefix service.
• ServicePassword The password with which the provider logs into the Zefix service: may be encrypted.
• Mapping: optional mapping to customize the filled information, see default contact mapping. Mapped from object CompanyFull. Available properties can be found at https://www.zefix.admin.ch/ZefixPublicREST/swagger-ui/index.html .

Above is an example of mapping the most common parameters. Note that you must map all the desired parameters.

Zefix (Discontinued SOAP/XML option)

caution

WARNING
This interface has been deactivated. Switch to the new address provider.

<!-- AddressService -->
<AddressProvider id="E10A8313-A92D-4CB2-A12B-9AEB58F39207" order="1" active="true">
  <!-- serverside Zefix address provider (Legacy SOAP/XML) -->
  <AddressProvider id="F6CA6CC9-B201-4556-886E-C6AF5F9460E4">
    <!-- User/password for Zefix web service -->
    <ServiceUser>info@oneoffixx.com</ServiceUser>
    <ServicePassword>{password}</ServicePassword>
    <EnableProxyCredentials>true</EnableProxyCredentials>
    <!-- Optional Mapping -->
    <Mapping>
      <Map Source="name" Target="Company_Name" />
      <Map Source="translation[0]" Target="Company_Supplement" />
      <Map SourceExpression="oo('address.addressInformation.street') + ' ' + oo('address.addressInformation.houseNumber')" Target="Company_Street" />
      <Map Source="address.addressInformation.town" Target="Company_City" />
      <Map Source="address.addressInformation.country" Target="Company_Country" />
      <Map Source="address.addressInformation.country" Target="Company_CountryShortCode" />
      <Map Target="Company_ZipCode">
        <Map.SourceExpression>
          <![CDATA[
            function main()
            {
              var index = 0;
              var count = oo('address.addressInformation.ItemsElementName.Length');
              
              for(;index < count; index++)
              {
                if(oo('address.addressInformation.ItemsElementName[' + index + ']') == 'swissZipCode')
                {
                  return oo('address.addressInformation.Items[' + index + ']');
                }
              }
              
              return "";
            }
          ]]>
        </Map.SourceExpression>
      </Map>
    </Mapping>
  </AddressProvider>
</AddressProvider>

Parameters

• id F6CA6CC9-B201-4556-886E-C6AF5F9460E4
• ServiceUser The user with which the provider logs into the Zefix service.
• ServicePassword The password with which the provider logs into the Zefix service: may be encrypted.
• Uri Optional service url. Default: http://www.e-service.admin.ch/ws-zefix-1.6/ZefixService?wsdl
• Mapping: Optinal mapping to customize the filled information. Mapped from the object companyFullInfoType. "Subordinate" properties can be accessed via dot (.). For example: address.addressInformation.street. Similarly, enumeration can be accessed via zero-based indexer. Example: translation[0].Value.