Irrespective of the bookkeeping data generation features you apply, your organization usually delivers the relevant invoicing data to an (external) accounting system like DATEV, SAP or Microsoft Dynamics. Invoicing data refers to the actual business transactions that state the realized revenues or charged taxes and their corresponding booking accounts, as represented in booking details or, on a basic level, in invoices. Accounting systems expect specifically formatted CSV files in order to import this data. To support this, JustOn Billing & Invoice Management provides a flexible CSV export mechanism, which allows you to configure and execute invoice exports or booking details exports according to your needs.
Info
If your target accounting system is DATEV, you may consider using DATEV Unternehmen online. JustOn supports the automatic transfer of invoicing data to this platform.
In addition, your business may require to export master data to your accounting system. Master data refers to account-related data like customer name, address, tax ID, debtor/creditor number, etc. Accounting systems usually handle master data separately and can therefore not import it together with invoicing data. For transferring master data, you use JustOn's export mechanism to produce specifically configured CSV files from invoices.
Delivering master data and bookkeeping data to accounting systems
Invoice CSV Export
Your organization's business may require to export invoices or booking details that are to be imported by external accounting systems like DATEV, SAP or Microsoft Dynamics. Usually, these accounting systems expect specifically formatted CSV files in order to import this data, including invoice line items and tax information. To this end, JustOn Billing & Invoice Management provides a flexible CSV export mechanism. It allows you to configure and execute invoice or booking details exports according to your needs.
Info
Be aware that the invoice export is not related to invoice PDF files. To output produced PDF files, use the redistribution function.
You can use JustOn's invoice CSV export to export master data to your accounting system. Master data refers to account-related data like customer name, address, tax ID, debtor/creditor number, etc. Accounting systems usually handle master data separately and can therefore not import it together with invoicing data. For transferring master data, you produce specifically configured CSV files from invoices.
Payment Balance Generation
When exporting invoices, you can select the option Create Payments. Doing so triggers JustOn to create payment balances and to set the originating invoices to Paid or Settled, depending on the invoice class (Invoice or Credit).
Invoice Export History
In addition to the actual export file (CSV or SEPA XML, according to the applied export setting), the export operation produces an Invoice Export History record for each exported invoice. The history holds the following information:
Export time
Effective payment due date (for installment invoices)
File name and link to the exported file
Flag stating whether a payment balance has been created
Flag that controls whether to prevent repeated exports
Flag stating whether an invoice has been exported more than once (forced export)
The Times Exported field on the invoice shows the export count.
Your organization's business may require to export invoices or booking details that are to be imported by external accounting systems like DATEV, SAP or Microsoft Dynamics. Usually, these accounting systems expect specifically formatted CSV files in order to import this data, including invoice line items and tax information. To this end, JustOn Billing & Invoice Management provides a flexible CSV export mechanism. It allows you to configure and execute invoice or booking details exports according to your needs.
Be aware of the following specifics:
You export booking details on a booking period base. You select the booking period whose booking details you want to export and trigger the export.
You can control whether to allow multiple exports. Specifically marking exported booking details excludes them from subsequent export operations.
Your organization's business may require to deliver bookkeeping data to DATEV. Technically, there are two ways to do so:
Automatically transferringledger records for booking details (as created from invoices and invoice line items) and for expenses to DATEV Unternehmen online
Be aware, however, that the way you use may depend on the type of data you transfer to DATEV.
Invoicing data: Invoicing data refers to actual business transactions that state, in particular, realized revenues, charged taxes or incoming payable and their corresponding booking accounts. If your data involves invoicing data only, you can use both the automatic transfer as well as the export.
Master data: You must use an accordingly configured CSV export if you move master data for accounts like, for example, debtor numbers. This especially applies to new customers that are not yet available in DATEV as "allocation targets".
Data Transfer to DATEV
To seamlessly transfer invoice-based bookkeeping data to DATEV, JustOn integrates with JustOn Connector for DATEV. This is an add-on to JustOn that generates DATEV-specific ledger records from booking details (as created from invoices and invoice line items) and from expenses, and transfers them to DATEV Unternehmen online. For details, see JustOn Connector for DATEV DE. Once there, these accounting documents and accounting document items can be used by any DATEV application that accesses the DATEV Cloud.
Directly transferring bookkeeping data to DATEV
The following table shows which data is supported by the DATEV interface Rechnungsdatenservice 1.0 and by the integration with JustOn Billing & Invoice Management.
Type of Data
DATEV Interface
Integration
Accounts receivable Sales invoices
Accounts payable Purchase invoices
Cash ledger cash book
Attachments Document images
Master data
Payment data
In broad strokes, the bookkeeping data transfer work as follows:
JustOn transfers all booking details of a specific booking period as well as expenses that are not yet exported to JustOn Connector for DATEV.
Invoices
For each related invoice, an accounting document record of the type Accounts Receivable Ledger is created. Each booking detail is exported to an accounting document item (1:1 relationship). The two objects are linked with each other. Invoice PDF and e-invoice XML attachments (that is, files with the content version types Invoice PDF and E-Invoice) are copied and attached to the accounting document. The maximum size per file is 3,76 MB.
On successful transfer, the Locked checkbox of the accounting document is selected, and the booking detail is marked as exported. In case of errors, neither an accounting document nor an accounting detail is created for the affected booking details, and an error message is written to the booking detail.
Expenses
For each expense, an accounting document record of the type Accounts Payable Ledger is created. Each expense item is exported to an accounting document item (1:1 relationship). The two objects are linked with each other. Supporting documents and e-invoice XML attachments (that is, files with the content version types E-Invoice and Supporting Document) are copied and attached to the accounting document. The maximum size per file is 3,76 MB. In addition, an individual expense export history record is created for each expense, which is used to store details about the transfer or transfer attempt.
On successful transfer, the Locked checkbox of the accounting document is selected, and the related expense export history is marked as exported. This indicates that the related expense is excluded from further exports to the same destination. In case of errors, neither an accounting document nor an accounting detail is created for the affected expenses, and an error message is written to the expense export history or the affected expense item.
Be aware that attached files larger than 3,76 MB each prevent exporting all booking details of the given invoice.
Info
Be aware that the automatic data transfer to DATEV involves invoicing data only, since the corresponding DATEV interface supports invoice (and cashbook) data only. Invoicing data refers to actual business transactions that state, particularly, realized revenues, charged taxes or incoming payables and their corresponding G/L accounts, and that is represented on booking details created from invoice line items or, respectively, expenses.
Once the data transfer to DATEV is set up, actually transferring the data from JustOn to DATEV Unternehmen online involves the following repetitive tasks:
Be aware that uploading the accounting documents to DATEV may take time. Depending on the amount of data you transfer, the access token may expire. In this case, restart the data transfer.
Transferring bookkeeping data to DATEV
The bookkeeping data transfer writes the data to the following fields.
Invoice data
Accounting Document fields
Field
Data Type
Source Field
Notes
InvoiceId
Text
BookingDetail.InvoiceNo
Document Date
Date
BookingDetail.BookingPeriod
Shows the start date of the booking period
Customer Name
Text
BookingDetail.AccountName
Customer City
Text
BookingDetail.BillingCity
IBAN
Text
BookingDetail.IBAN
SwiftCode
Text
BookingDetail.BIC
VatId
Text
BookingDetail.VATId
ThirdParty
Checkbox
-
Is selected on successful transfer
Locked
Checkbox
-
Is selected on successful transfer
ON_Invoice
Lookup (Invoice)
BookingDetail.Invoice
Links to the related invoice
Accounting Document Item fields
Field
Data Type
Source Field
Notes
Amount
Currency (10,2)
BookingDetail.Amount
AccountNo
Text
BookingDetail.AccountNo
Accounting Date
Date
BookingDetail.BookingDate
Delivery Date
Date
BookingDetail.OriginalBookingDate
Is ignored when empty. Can be overwritten using a custom DeliveryDate field
Tax
Percent (2,2)
BookingDetail.TaxRate
ON_BookingDetail
Lookup (Booking Detail)
-
Links to the related (source) booking detail
Booking Detail fields
Field
Data Type
Notes
Exported
Checkbox
Is selected on successful transfer
Export Destination
Text
Is set to DATEV on successful export
ON_AccountingDetail
Lookup (Accounting Document Item)
Links to the related (target) accounting document item
Last Error
Text
Is set during the transfer
Additional fields
JustOn Billing & Invoice Management can copy additional fields from the booking details to the accounting documents and accounting document items. This is done for all additional fields on the booking detail if a field with the same name exists on the corresponding target.
The following table lists some examples:
Booking Detail
Accounting Document
Accounting Document Item
Notes
BillingCountry__c
BillingCountry__c
BuCode__c
BuCode__c
Holds booking codes to control certain DATEV features, like 40 to switch off the automatic tax calculation in automatic accounts.
ClientId__c
ClientId__c
Holds a client ID in the format ConsultantID-ClientID. Allows the accounting documents to be assigned to a client-specific data transfer. When a data transfer is created, a user can select the client to which they want to transfer the data if there is no predefined client ID.
CostCategoryId__c
CostCategoryId__c
Holds a cost center. Usually, a Booking Detail formula field that refers to Center.
DeliveryDate__c
DeliveryDate__c
Discount__c
Discount__c
DueDate__c
DueDate__c
Holds the due date of an invoice to support "open items" management in DATEV.
The DATEV interface will only accept additional custom fields on the Accounting Document or the Accounting Document Item if they are defined under the document record data file format (see DATEV XML interface online > Format specification > Record data file in the DATEV Developer Portal). Any fields other than those included in the DATEV format will be ignored, even if they have been correctly created and set.
Expense data
Accounting Document fields
Field
Data Type
Source Field
Currency Code
Picklist
Expense.CurrencyIsoCode
Document Date
Date
Expense.ReceiptDate
IBAN
Text
Expense.PayeeIBAN
Invoice Id
Text
Expense.ReceiptNo
Paid At
Date
Expense.PaymentDate
Internal Invoice Id
Text
Expense.Name
Supplier City
Text
Expense.SenderCity
Supplier Name
Text
Expense.PayeeName
SwiftCode
Text
Expense.PayeeBIC
VatId
Text
Expense.SenderTaxId
Accounting Document Item fields
Field
Data Type
Source Field
AccountNo
Text
ExpenseItem.GLAccount
Amount
Currency (10,2)
ExpenseItem.GrossAmount
Tax
Percent (2,2)
ExpenseItem.TaxRate
Additional fields
JustOn Billing & Invoice Management can copy additional fields from the booking details to the accounting documents and accounting document items. This is done for all additional fields on the booking detail if a field with the same name exists on the corresponding target.
Be aware that the DATEV interface does not accept any arbitrary additional fields. For a list of possible fields see Übertragene Belegdaten DE or the Accounting Document or Accounting Document Item object references. The DATEV interface will only accept additional custom fields on the Accounting Document or the Accounting Document Item if they are defined under the document record data file format (see DATEV XML interface online > Format specification > Record data file in the DATEV Developer Portal). Any fields other than those included in the DATEV format will be ignored, even if they have been correctly created and set.
In order to support specific DATEV applications (like, for example, DATEV Mittelstand Faktura mit Rechnungswesen or Kanzlei-Rechnungswesen), JustOn can export invoices and booking details (as created from both invoice line items and payment balances). It writes specifically formatted CSV files, which you can then import in the corresponding applications.
Exporting CSV to be imported by DATEV applications
In order to generate a CSV export that is compliant to the DATEV CSV format for the posting batch (Buchungsstapel), you must
Create a specific JSON export configuration for the CSV file to be produced, and, depending on your requirements, add custom fields to relevant objects and custom settings (see Defining CSV File JSON Configuration)
Automatic accounts (Automatikkonten) in DATEV have a calculation function that automatically determines the tax from the gross amount of the posting. DATEV posts the revenue amount – reduced by the tax – to the automatic account, and the tax amount to the relevant tax account.
To support automatic accounts, you can configure JustOn Billing & Invoice Management to use gross values when creating bookkeeping data. To this end, you enable the global settingEnable Accounting in Gross Values as described in Enabling Gross Value Bookings.
enable the global settingAccounting Gross Taxes on First Month,
enable the automatic tax calculation for the gross booking details – using the custom booking code field BuCode with the relevant booking details (see Additional Fields),
optionally, create the BuCode field as a formula that returns the required value according to your use cases, like, for example, IF(ONB2__IsGross__c, 101, null)