Integration engine

Your ERP or billing system has its own names for invoice fields. Each country has its own rules for what an invoice must contain. The Integration engine sits between the two.

You build an integration: a mapping from your fields to GETS, the Complyance standard invoice format, plus the extra fields a country requires. Once an integration is tested and linked to a source, invoices from that source are converted with it. You do not write conversion code for each country.

Where to find it

Open the Developer portal from the portal switcher at the bottom of the sidebar. Integration engine is the first item in the menu.

The page lists your integrations. If you have none yet, you see Please create your first Integration. Choose New Integration to start.

How an integration is built

Setup is a guided flow that opens with a short overview screen. The bar at the top shows where you are: Configuration, API Keys, Payload, Mapping, Testbed.

1. Configuration. Choose the country you need to be compliant in and, for it, the base document types, modifiers and variants this integration handles. You can add more countries to the same integration later.
2. Manage API Keys. Create the key your system uses to send data. The secret is shown once. Copy it before you close the window.
3. Payload Selection. Choose a payload your system has already sent, or choose Upload JSON, XML, or Excel to add a sample file.
4. Field Mapping. Match your fields to GETS on the Core Mapping, Regional Mapping and Country Mapping tabs. See Map your fields to GETS and Map country fields.
5. Testbed. Run your payload through the mapping and read the validation results. See Test your mapping.

If you go back and change the country or the transaction type, the steps after it start again. The portal warns you before this happens.

What mapping looks like

Mapping is a table. One column lists the GETS fields. Beside each field you pick the matching field from your payload, see its value in your sample, and choose a format for dates, times and amounts. A format says how your system writes the value, such as DD/MM/YYYY for a date.

Each field carries a label:

• M: mandatory. The invoice cannot be sent without it.
• CM: conditionally mandatory. Needed only in some cases.
• Mapped or Pending: whether you have dealt with it yet.

Pending Mandatory above the table counts what still blocks you. Map your fields to GETS walks through an example.

After it is built

Each integration in the list shows how complete its mapping is, how many test cases have passed, which countries it covers, and whether it is Active, Inactive or In Progress.

From the list you can edit the GETS or country mapping, add a country, rename or delete the integration, and choose Manage sources to decide which source systems use it. You can also import a mapping, or transfer one from another workspace. See Manage integrations.

An integration marked Managed by partner was set up for you by your partner. You can view it, but only your partner can change it.