AFAS connection and integration settings

The password for the AFAS connection. You only need it when your AFAS application uses OAuth as the authentication method. The standard connection with an access token from the App connector does not use this field.

The username for the AFAS connection. You only need it when your AFAS application uses OAuth as the authentication method. The standard connection with an access token from the App connector does not use this field.

A web address for the API connection, entered without https:// and without a trailing /. The standard AFAS connection does not use this field: APIcenter builds the address from your environment number and environment type. You normally do not need to fill it in for AFAS.

The access token of the App connector in AFAS Profit, the main authorisation for the connection. Create it in AFAS Profit under General > Management > App connector: open the APIcenter App connector, add a user token and select a user with the right permissions to fetch and send data through the connectors. Copy only the data part of the token, without XML tags: from <token><version>1</version><data>...</data></token> you paste only the value between <data> and </data>. AFAS shows the token only once, so copy it right away.

Determines how login details are sent to an application that connects with a username and password: in the Authorization header (default) or as Query parameters in the URL. AFAS does not use a username and password, but the access token from your App connector. That is why this setting is set to Token for AFAS, and you do not need to change it.

The number of your AFAS Online environment: your AFAS customer number. APIcenter uses it together with the environment type to reach your AFAS environment. The number is usually visible when you open AFAS Profit.

The type of AFAS environment APIcenter connects to. Choose the type that belongs to your environment number and access token:

• rest: production environment (default)
• resttest: test environment
• restaccept: acceptance environment

The currency APIcenter uses for prices (on products, order lines, price lists and so on) when the data contains no currency. For AFAS this is also the currency given to the product prices APIcenter retrieves from AFAS. Default: EUR.

Determines whether APIcenter updates a debtor that already exists in AFAS as an organisation (organisatie) when a customer or order comes in for it. When on, the details of the organisation, such as address and contact details, are overwritten with the incoming data. When off, the existing organisation stays as it is, and an order is still booked on it. The same applies to existing suppliers in purchase orders. For AFAS this is on by default.

Determines whether APIcenter updates a debtor that already exists in AFAS as a person (persoon), such as a private customer, when a customer or order comes in for it. When off, the existing person stays as it is, and contact person details are not sent for existing debtors either. The same applies to existing suppliers in purchase orders. Off by default.

Determines whether the name of an existing organisation in AFAS is overwritten with the name from the incoming data. Only applies when Update existing companies is on. Turn it off if you maintain company names in AFAS and do not want the spelling from a webshop to replace them. On by default.

Determines whether the name of an existing person in AFAS is overwritten with the name from the incoming data. Only applies when Update existing contacts is on. Off by default, so the names you maintain in AFAS are kept.

Meant to update the link between an existing contact and its company in the receiving application. AFAS does not use this setting, so changing it has no effect for AFAS. Leave it at the default (on).

The country APIcenter uses when a country is needed to retrieve the right data, such as tax rates. For AFAS, APIcenter uses this country to retrieve the VAT rates when it retrieves products and price lists. Options: BE, DE, ES, FR, NL and UK. Default: NL.

Determines how APIcenter finds the AFAS article for each order line. The product code from the order line is compared with:

• SKU (default): the item code (artikelcode) in AFAS.
• Barcode: the barcode of the article.
• EAN, Alternative ID, Product Type or Product Type and SKU: the alternative article ID in AFAS.

AFAS needs existing articles for orders, invoices and quotations, so an order line without a matching article gives an error.

Use this when you keep stock in several warehouses (magazijnen) in AFAS and want to work with stock per location. When on, APIcenter combines the stock per warehouse and article for the warehouses in the warehouse mapping table (Use warehouse mapping table). If the receiving application does not support several locations, the stock is added up. Off by default.

Meant to choose which stock figure is used: Actual (the physical stock), Economic (stock minus reservations plus expected deliveries), Stock minus reservations or Available (default). The AFAS flows do not use this setting at the moment, so changing it has no effect. Leave it at the default.

Turn this on to use a default unit of measurement when no unit is supplied. A unit is required for new articles and refund lines in AFAS, so this is useful when your source does not send units. You enter the unit in Value for the default Unit of measurement. Off by default.