Installieren der ELO DATEV Rechnungsdatenservice Schnittstelle

Voraussetzungen

Folgende Voraussetzungen müssen erfüllt sein, um die ecm.online ELO DATEV Rechnungsdatenservice Schnittstelle nutzen zu können.

Folgende ELO Versionen werden unterstützt:

• ELOprofessional / ELOenterprise 10
• ELOprofessional / ELOenterprise 11
• ELOprofessional / ELOenterprise 12
• ELOprofessional / ELOenterprise 20
• ELOprofessional / ELOenterprise 21

Folgende Business-Solution müssen installiert sein:

• common ab Version 1.000.00

 

Achtung beim Updaten:

Wenn unsere DATEV Rechnungsdatenservice Schnittstelle bereits installiert ist und nur eine Updaten durchgeführt werden soll, dürfen Sie NUR das Haupt-eloinst-Paket installieren NICHT das dazugehörige Custom-Paket, ansonsten wird ihre Lizenzdatei überschrieben und Sie müssen diese erneut in den Ordner ziehen.

Installation

Zur Installation unserer DATEV Rechnungsdatenservice Schnittstelle erhalten Sie von uns zwei .eloinst-Pakete und eine Lizenzdatei.  Die Pakete installieren Sie bei Ihren KundInnen im ELO, es sei denn es handelt sich dabei um ein Update, dann bitte den vorherigen Abschnitt beachten. Anschließend laden Sie noch die Lizenzdatei (license.txt) in den Ordner Configuration im Custom-Bereich.

Nun müsste der Ordner datev-connect-online wie folgend aussehen.

 

Nachdem der Java Client einmal neu gestartet wurde, erscheinen die nachfolgenden drei Buttons unter dem Tab Rechnungen.

 

 

Konfiguration

Zusätzlich kann noch eine Konfigurationsdatei hinterlegt werden. Die Konfigurations-Datei muss  datev-connect-online.config heißen, im JSON-Format sein und wie folgt aufgebaut sein:

{
  "apiKey": "APIKEYSTRING",
  "uploadMode": "RECEIPT_UPLOAD",
  "baseUrl": "https://connect.ecm.online",
  "fileNameTemplate": "{{{sord.objKeys.INVOICE_NUMBER}}}-{{{sord.objKeys.VENDOR_NAME}}}"
}

Der Schlüssel apiKey enthält den Lizenzschlüssel. Die beiden Schlüssel uploadMode und baseUrl sind nicht zu konfigurieren.

Ab der Version 1.5.0 (November 2021) kann die Dateibezeichnung der zu übermittelnden PDF-Rechnung konfiguriert werden, sodass diese verschiedene Informationen zu der jeweiligen Rechnung enthält, z.B. wie in der Beispiel-Konfiguration die Rechnungsnummer oder den zugehörigen geschäftlichen Kontakt. Die Bezeichnungen können jedoch nur allgemein für alle zu übermittelnden Rechnungen, nicht für einzelne Rechnungen angepasst werden.

Die Dateibezeichnung wird unter dem Schlüssel fileNameTemplate als ELO Template String konfiguriert. Hierbei ist zu beachten, dass die Dateibezeichnung nicht länger als 252 Zeichen sein darf, ansonsten wird die PDF-Datei wie im Standard invoice.pdf heißen.