> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started with ERP development

> Getting started with ERP development

<Tip>
  We recommend that connector developers use the connector web-service host, but it's not a requirement.

  If you choose to go with your own web-service host, you are not required to use the `IErpConnector` interface. `IErpConnector` is the communication interface between the connector host supplied by SuperOffice and its hosted connectors.
</Tip>

## Using your own connector host

Reasons for not using it may include needing to host a Sync Connector in an environment not compatible with a .Net web service, or simply preferring to work in a non-.Net programming environment such as Java.

If you choose to not use the connector host, you will need to expose a slightly different interface than `IErpConnector`. There is a web-service version of it named `IErpConnectorWS`, which contains all contracts used for communication between SuperOffice and a connector web service, and this is what you'll need to expose through your connector service. Similarly, there are web service versions of all related classes and interfaces, such as `ErpActorWS`, `FieldMetadataInfoWS`, and so on.

All these classes are defined in *SuperOffice.Plugins.dll*, so if you are writing your custom host in .Net you can still take advantage of SuperOffice's implementations.

All that the SuperOffice clients care about is that it implements the `IErpConnectorWS` SOAP interface (and its related contracts, classes, etc) and makes it accessible through a SOAP web service.

## Directly loading connector implementations for debugging

If you choose to use the SuperOffice-provided connector host, then your connector implementation will implement the `IErpConnector` interface. In this case, it is also possible to directly load the implementation into your SuperOffice website, instead of running a separate site for the connector host.

This can make certain kinds of debugging easier and saves the setup of a site, though it also means that each rebuild of the connector assembly causes the SuperOffice website to recycle, which can take a lot of time.

<Note>
  In most cases, **using the connector host with a separate Application Pool is the recommended and most realistic configuration**.
</Note>

To utilize direct-loading, you need to

* Include your connector assembly in the [DynamicLoad section][6] in *web.config*

* Instead of a site URL for the connector, use `plugin://<connectorname>`, where `<connectorname>` represents the name given in the `ErpConnector` attribute on the implementing class.

![Edit sync connector -screenshot][img1]

The plugin loader used by the connector host is part of the *SuperOffice.Plugins.DLL* assembly that is also present in the normal website, and the same loading code is run.

Having the connector loaded directly can make debugging simpler since there are fewer moving parts.

If you attempt to use this connection from the windows client you will get an error. The windows client and the Travel Gateway both require that you use a URL to connect to the sync service.

## Set up sync

Because every ERP system and every customer operate slightly (and sometimes very) differently, the field mapping must be configurable.

Each connection will have to be able to inform ERP Sync about which actor types it supports (for example, customer and supplier, but not person and project). Once this information is retrieved, ERP Sync can ask the connection for a collection of what fields are available for each actor type (using the same `FieldMetaDataInfo` class as for the connection details).

* [Configure sync connection][1]
* [Show fields in GUI and search][2]
* [Set up mapping of ERP fields][3]
* [Set up default values][4]
* [Rank fields][5]

[1]: ./setup-connection

[2]: ./client-gui

[3]: ./setup-mapping

[4]: ./setup-defaults

[5]: ./ranking-fields

[6]: ../../config/factory

[img1]: /media/loc/en/api/plugins/sync-connector-plugin.png


## Related topics

- [Introduction to online development](/en/api/overview/develop-apps-or-integrations.md)
- [Getting started](/en/database/getting-started/index.md)
- [Getting started with CRMScript](/en/automation/crmscript/overview/getting-started.md)
- [Application environments](/en/developer-portal/getting-started/app-envir.md)
- [Getting started (self-service)](/integrations/g-suite/getting-started.md)
- [SuperOffice API Overview](/en/api/overview/index.md)