Set payment gateway to stripe by default #
When this option is enabled, payment gateway information is sent when creating an invoice from ALIX to Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Set payment gateway to stripe by default configuration.

Add long description to invoice line item description #
When this option is enabled, the long description is displayed on invoice lines in Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Add long description to invoice line item description configuration.

Add SKU to invoice line item description #
When this option is enabled, the SKU is displayed on invoice lines in Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Add SKU to invoice line item description configuration.

Add shipment number to invoice line item description #
When this option is enabled, the shipment number is displayed on invoice lines in Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Add shipment number to invoice line item description configuration.

Create contacts in Zoho Books by default #
When this option is enabled, newly created contacts (customer or vendor) are automatically synced to Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Create contacts in Zoho Books by default configuration.

Books linked to CRM in Zoho #
This configuration tells ALIX whether Zoho Books and Zoho CRM are linked in Zoho. It only applies when the Zoho CRM integration is also active in ALIX, with the Customers module enabled. For more information, see the Zoho CRM integration page.
| State | Behavior |
|---|---|
| Enabled (default) | For a customer linked to a Zoho CRM account, ALIX asks Zoho Books to import the linked Zoho CRM account, so that both records are linked in Zoho. |
| Disabled | ALIX does not make this request: the customer is handled in Zoho Books like a customer without a Zoho CRM account. |
Note: this setting must match the real state of the link between Zoho Books and Zoho CRM in Zoho. Disable it if they are not linked: a mismatch causes synchronization errors.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Turn the Books linked to CRM in Zoho toggle on or off.

Include customer notes when creating invoices in Zoho Books #
When this option is enabled, customer notes present in the sales order are sent to Zoho Books when an invoice is added. They appear in the Notes field.
Configuration #
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Include customer notes when creating invoices in Zoho Books configuration.

Add an invoice #
- In a sales order, select Push to Zoho Books when adding an invoice.

- In the Zoho Books invoice, Customer Notes appear in the Notes field.
Zoho Books contacts synchronization custom field #
When a Zoho Books custom field is selected, only customers and vendors with the value TRUE are created in ALIX when an action occurs in Zoho. Already synced customers and vendors continue to sync even if the custom field is not set to TRUE.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the Zoho Books contacts synchronization custom field configuration.

Default tax on invoice and bill items when they are exempt #
Zoho Books expects to receive a tax on every invoice and bill line, whether the item is taxable or not. For an exempt item line, ALIX sends the tax chosen in this configuration.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the desired tax under the Default tax on invoice and bill items when they are exempt configuration.

Shipment number prefix #
Text automatically added before the shipment number in the invoice line item description.
Note: the Add shipment number to invoice line item description configuration must be enabled.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Enter the desired prefix in the Shipment number prefix configuration.

Contact person synchronization #
This configuration sets which contact persons are synced between ALIX and Zoho Books. The choices are:
| Option | Description |
|---|---|
| Sync all contact persons | Synchronizes all contacts related to the customer/vendor. |
| Sync invoice and main contact persons | Synchronizes only the primary customer/vendor contact as well as the invoice contact for customers. |
| Sync invoice, main and order contact persons | Synchronizes the primary customer/vendor contact, the invoice contact, and the contact directly added to orders for customers. |
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Choose the desired synchronization under the Contact person synchronization configuration.

Map invoice templates #
You can map invoice templates created in Zoho Books. When pushing an invoice from ALIX to Zoho Books, ALIX chooses the template by comparing each mapping row with the invoice:
- Language: must match the customer’s language.
- Country: compared with the country of the sales order billing address. If it is left empty, the row applies to all countries.
- Currency: compared with the sales order currency. If it is left empty, the row applies to all currencies.
If several rows match, ALIX keeps the most specific one: a matching currency takes precedence over a matching country. If no row matches, ALIX does not specify any template to Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Click the + next to Invoice template mapper, then enter the requested information.

Payment account mapper #
You can choose which account to use based on the payment method and currency. This information is sent to Zoho Books when you create an invoice in ALIX.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Click the + next to Payment account mapper, then enter the requested information.

Tax management for bills #
When pushing a bill to Zoho Books, the tax sent is determined based on the information available:
- The vendor’s tax.

- If no tax is set for the chosen vendor, the tax is determined by the shipping address of the purchase order (or the vendor’s address if it is a vendor pickup), based on the configuration of taxes by region in ALIX.

- If no delivery address is provided, no tax is sent.
Sync taxes #
You can sync taxes from Zoho Books to ALIX.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Click the sync icon next to Taxes.

Special character replacement #
Some characters accepted in ALIX (< and >) are rejected by Zoho Books when syncing invoices and bills. ALIX can detect these characters in text fields sent to Zoho Books and replace them according to the configuration defined here, without modifying the original data in ALIX.
If a replacement field is left empty, the character is simply removed before sending.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Enter the desired replacement value (maximum 15 characters) in the following configurations:
- Replacement for < character: text used to replace the < character before sending to Zoho Books.
- Replacement for > character: text used to replace the > character before sending to Zoho Books.

Note: the replacement applies to all text fields on invoices and bills sent to Zoho Books. If the reference number exceeds 100 characters after replacement, it is automatically truncated.
Transfer bill files to Zoho Books #
When the option is enabled, ALIX automatically transfers the files attached to a bill to the corresponding bill in Zoho Books.
The transfer is triggered in the following cases:
- When a bill is created from a purchase order, if the Push to Zoho Books option is checked.
- When a bill is manually synchronized through More actions -> Synchronize.
- When a file is added to a bill that has already been synchronized with Zoho Books.
Note: Zoho Books accepts a maximum of 5 files per bill and 10 MB per file. Files that exceed these limits or whose extension is not supported by Zoho Books are not transferred. A message indicates the result at the end of the transfer: number of files synchronized, number of failures, and total processed.
Note: deleting a file in ALIX does not delete the file in Zoho Books. To remove it from the bill in Zoho Books, delete it directly from Zoho Books.
- In Settings, go to the Integration section, then click Details next to Zoho Books.

- Turn on the Transfer bill files to Zoho Books toggle.




















