Candis Core Data API
The Candis core data API allows you to send the following types of core data to Candis:
- General ledger account
- Contacts
- Cost centers and cost objects
- Tax codes
- Payment conditions
You cannot only create, but you can also update and archive the types.
Archiving is not the same as deleting. The data will still be shown in Candis, but under a separate tab, and is not available for the user to choose in the approval or processing of invoices.
General ledger account
For the General ledger account, we have the following fields:
- number
- name
Contacts
For Contacts, we have the following fields:
- Accounts payable number
- Contact name
- Vat ID
- Tax number
- IBAN
- Payment condition name
Only the contact name and accounts payable number are mandatory. The rest is optional. Please ensure to send valid data for all optional fields. IBANs VAT IDs that are not correct will lead to an error while uploading that specific contact. The contact will not be shown in Candis.
For email, it is important to send an email. If there is a text, not an email, Candis is going to reject that contact, too.
The payment condition name connects the payment condition to the contact. Therefore, always send the payment condition before the contact. If not, the contact is not rejected, but will not show the payment condition in Candis.
Cost center and cost object
The cost center and cost object consist of the following fields:
- Number
- Name
Tax codes
The tax codes consist of the following fields:
- Number
- Name
Payment condition
The payment condition consists of the following fields:
- Name
- Due date
- Discount rate
- Discount due date
Please make sure to always send the payment condition before the contacts. Contacts are connected to payment conditions and if the payment condition does not exist while the contact is created or updated, the payment condition will not be attached to the contact.
Get import logs
After the data is successfully imported, you will receive an ID. A successful import does not necessarily mean the data is also available for the user. If, for example, an IBAN is rejected, the user can see it in the import history in Candis. Therefore, users can take action in the other system and change the data to a valid IBAN. After that, the data can be sent again.
This endpoint allows you to also get information as to why the core data was imported but not created or updated in Candis.
Updated 2 months ago