The Candis Export API allows you to retrieve approved invoice data from Candis for processing in your accounting or ERP system. The following endpoints are available:

1. Create an Export
2. Get a List of Exports
3. Get an Export
4. Get a List of Export Postings
5. Download PDF File by ID

Create an Export

This endpoint initiates the creation of an export containing all approved invoices in Candis. The export represents a permanent snapshot of the data.

Once exported:

• The document can no longer be deleted or sent back for approval.
• Details such as the accounts payable number or general ledger account can no longer be modified.
• An export ID is generated, which is required for subsequent endpoints.

Supported entityType values:

• DOCUMENT (default)
• CARD_TRANSACTION
• REIMBURSEMENT_ITEM

By default, only invoices of type DOCUMENT are included unless CARD_TRANSACTION is explicitly specified.

Get a list Exports

Returns a list of all export records along with their export IDs.

Use cases:

• Identify duplicate exports
• Verify that all exports have been processed

Get an Export

Retrieves the status of a specific export using its export ID.

Export statuses:

• EXPORTING → Export is in progress
• EXPORTED → Export is complete

Note: You should poll this endpoint at regular intervals to avoid unnecessary delays in the export process.

Get a list of Export Postings

Once the export status is EXPORTED, you can retrieve the related postings (line items) using this endpoint.

Supported entityType values:

DOCUMENT
Used for invoice-based entries.

Subtypes:

• Incoming Invoice (Rechnungseingang)
• Outgoing Invoice (Rechnungsausgang)
• Invoice Correction (Rechnungskorrektur)

These are the most commonly used documents for standard accounts payable/receivable processing.

Note: Depending on the language selected by the customer, either the German or English names will appear in the export.

CARD_TRANSACTION
Used for exports related to credit card usage and settlements.

Subtypes:

• DOCUMENT – Represents the original invoice related to the card payment
• CARD_TRANSACTION – The actual credit card transaction record
• CARD_SETTLEMENT – The settlement/clearing of the card balance

These allow the correct reconstruction of payment flows via credit cards.

REIMBURSEMENT_ITEM
Used for employee expense reimbursements.

Subtypes:

• GENERAL_EXPENSE – Regular expense items (e.g. office supplies, parking fees)
• HOSPITALITY_EXPENSE – Expenses for meals, client events, etc.
• PER_DIEM – Daily allowances (e.g. travel per diems)
• MILEAGE – Kilometers driven using a private vehicle for work purposes

Specifics for CARD_TRANSACTION:

When the export includes CARD_TRANSACTION data, the posting structure extends the DOCUMENT format with the following additional objects:

• creditCardSettings
  • bookingAccount
  • transitAccount
• payment
  • method
  • paidAt

Posting Logic for Credit Card Transactions
In your ERP system, an additional posting must be created using the following changes:

1. Replace invoiceDate with paidAt
2. Replace generalLedgerAccount with bookingAccount
3. The invoice posting increases the liability (payable) to the vendor.
   The credit card transaction reduces the same payable by the same amount.

This structure allows you to correctly reflect the financial transaction flow in your ERP.

Download PDF file by ID

Use this endpoint to retrieve PDF document images associated with an export.

Supported file types:

• Main document → INVOICE, XRECHNUNG
• Attachments → ATTACHMENT
• Summary document → AUDIT_TRAIL (Approval trail)