globe with meridians Language: Deutsch · English

open book 4.8.1 DATEV: Nuclet interfaces

Nuclet interfaces – part of the DATEV Nuclet documentation (export of CSV files for further processing in DATEV (accounting)).

REFERENCE INTEGRATORS UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X

On this page

Machine-translated – under review

This page was machine-translated from German as a first draft and is currently under review. The authoritative source remains the German original (see the language switch above).

The aim of this step is to connect the business object actually used in the target Nuclet to the Java code of the MT940 Nuclet. To this end, the approach of using Nuclet-independent wrapper classes is followed – instead of the business object classes generated for the business objects.

For the technical background, please also read the article "Interfaces in Java rules".

This integration step can only be carried out once the prerequisites from section 3 are met – i.e. once the corresponding reference objects have been adapted.

When connecting the DATEV Nuclet, only one wrapper class for the actually used reference objects has to be adapted.

Wrapper classFunctionJava packageMethods/constructors to adjust
ReferenceWrapperconnection to the reference objects usedorg.nuclet.datev.wrapper
  • ReferenceWrapper()
  • setDATEVInformationId()
  • setExportDateDATEV()

Table 4.8.1: Overview of Nuclet interfaces

4.8.1.1 ReferenceWrapper

The ReferenceWrapper class serves as the Nuclet interface to the actually used reference business objects.

Reference business objects are those objects that represent a DATEV export (e.g. invoices for an invoice export, customers for a customer export or turnover for a turnover export). Please also note the descriptions in section 3.

The constructor of the class and the following methods must be adjusted:

MethodFunctionAdjustment optional?
ReferenceWrapperAssignment of the actually used business objectsno
setDATEVInformationId()

sets the reference of an object of type "DATEV Information"

no
setExportDateDATEV()sets an export date to mark the object once a DATEV export has taken placeno

Table 4.8.1.1: Adjustments in ReferenceWrapper

Examples are given in comment blocks; these examples must therefore be adapted, during integration, to the actually used currency business object (or its BusinessObject class).

org.nuclet.datev.wrapper.ReferenceWrapper 
package org.nuclet.datev.wrapper;


import java.math.BigDecimal;
import java.util.Date;
import java.util.List;

import org.nuclos.api.businessobject.BusinessObject;
import org.nuclos.api.businessobject.facade.Modifiable;
import org.nuclos.api.businessobject.facade.Stateful;

// @replace!
// import org.nuclet.businessobject.ClientBilling;
// import org.nuclet.businessobject.Client;


/**
 * Wrapper class implementation for DATEV references (client billing, clients, turnover, etc.)
 * 
 * @version 1.0
 * @date 01.02.2014
 * @nuclet org.nuclet.DATEV
 * @nucletversion 2.0.0
 * @sincenucletversion 2.0.0
 * @since 01.02.2014
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class ReferenceWrapper extends AbstractReferenceWrapper
{
 public ReferenceWrapper(final BusinessObject businessObject)
 {
 // @replace!
 //
 // if (businessObject instanceof ClientBilling) {
 // this.businessObject = businessObject;
 // } else if (businessObject instanceof Client) {
 // this.businessObject = businessObject;
 // } 
 }
 
 /**
 * Setzt die Referenz eines Objektes vom Typ "DATEV Information", repräsentiert 
 * durch die Datenbank-ID dieses Objektes
 * 
 * @param lngDATEVInformationId Die Datenbank-ID eines Objektes vom Typ "DATEV Information"
 * 
 */
 public void setDATEVInformationId(final Long lngDATEVInformationId)
 {
 // @replace!
 //
 // if (businessObject instanceof ClientBilling) {
 // ((ClientBilling)this.businessObject).setDATEVInformationId(lngDATEVInformationId);
 // } else if (businessObject instanceof Client) {
 // ((Client)this.businessObject).setDATEVInformationId(lngDATEVInformationId);
 // }
 }
 
 /**
 * Setzt das Export-Datum bei erfolgtem DATEV-Export zur Kennzeichnung eines
 * erfolgten Exportes
 * 
 * @param datExportDateDATEV Ein Export-Datum 
 * 
 */
 public void setExportDateDATEV(final Date datExportDateDATEV)
 {
 // @replace!
 //
 // if (businessObject instanceof ClientBilling) {
 // ((ClientBilling)this.businessObject).setExportDateDATEV(datExportDateDATEV);
 // } else if (businessObject instanceof Client) {
 // ((Client)this.businessObject).setExportDateDATEV(datExportDateDATEV);
 // }
 }
}

Related pages

open book Nuclet: DATEV (available in the trade Nuclet)

DATEV Nuclet data sheet

Open →

open book Interfaces

All integrations

Open →

  • Keine Stichwörter