Create an integration
Set up a mapping for the country and invoice type you need, starting from a sample of your system's data. You need Developer portal access and a representative sandbox payload.
Start a new integration
Open Developer portal → Integration engine, check the workspace and environment, then choose New Integration. If the list is empty, choose Create new integration. Read Getting Started and continue.
Select the country and transaction type
At Select a country, choose the country where you will issue the invoice. At Select Transaction Type, choose the type of document represented by your sample. Check both choices before continuing: changing the country or transaction type later restarts the steps that depend on them, after a warning.
Prepare access and select a payload
At Manage API keys, create a sandbox key if your backend needs one and copy the secret when shown. See Create an API key for permissions, expiry and safe storage.
At Select Payload, choose a sample sent by your system or upload a JSON or Excel sample. Choose one that includes the invoice fields and line items you intend to map. At Mapping Preview, inspect the fields found in the sample. If fields you need are missing, use a different sample before proceeding.
You now have the country, transaction type and sample selected for this integration. Complete GETS Field Mapping, then Country Field Mapping, and finally Test Mapping before using the source for invoicing. A new integration is not a passed test or a production-ready invoice route.
If something goes wrong
No sample is available: check the workspace and environment, then upload a representative sample at Select Payload.
The preview does not show an expected field: check the sample’s structure and choose or upload a payload that contains that field. Do not guess its mapping from a different invoice.
You cannot continue after changing country or type: review the warning and repeat the dependent steps with a sample suitable for the new selection.
Next, map your fields to GETS.
Last updated