Schnittstelle: EPAY - EFT-Transaction Version 2023.10

Dieses Dokument beschreibt die AbaConnect-Schnittstelle EFT-Transaction der Applikation EPAY .


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:EPAY
Schnittstellen-Name:EFT-Transaktion
ID:EFT-Transaction ( PaymentTransaction )
Version:2023.10
Status:Productiv


Mögliche Export- und Import-Funktionen der Schnittstelle

Export / Import Funktionen
Export:XML
Import:XML


Zusätzliche Informationen zur Schnittstelle

Zusatzinformation

                                  Höchste Feld Revision für dieser Schnittstelle : 0



Mapping Informationen

Im Folgenden werden die Informationen über das Mapping angezeigt.

Mapping Informationen
Mapping ID:AbaDefault
Mapping Name:EFT-Transaktion
Beschreibung:

                



Beispiel AbaConnect XML-Struktur

Es folgt ein Beispiel einer XML Header-Struktur. Diese Information kann man auch in einer AbaConnect XML-Exportdatei anschauen, die über die Abacus AbaConnect Maske exportiert wurde.

AbaConnect XML-Struktur
<?xml version='1.0' encoding='UTF-8'?>
<AbaConnectContainer>
  <TaskCount>1</TaskCount>
  <Task>
    <Parameter>
      <Application>EPAY</Application>
      <Id>EFT-Transaction</Id>
      <MapId>AbaDefault</MapId>
      <Version>2023.10</Version>
      <!-- Achtung : Die Mandantennummer ist optional und bedeutet, dass die Daten nur in den definierten Mandanten importiert werden können -->
      <!-- Die Option Mandant hat nur beim Datenimport einen Einfluss. Dies kann in den AbaConnect Export-Einstellungen konfiguriert werden. -->
      <!-- Die Mandantennummer wird standardmässig nicht in die Export-Datei geschrieben -->
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <PtDetail mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </PtDetail>
    </Transaction>
  </Task>
</AbaConnectContainer>



Beispiel AbaConnect Command Line

Es folgen Beispiele für die AbaConnect Command Line. AbaConnect Command Line wird mit den Programmen abaconnectexportconsole.exe und abaconnectimportconsole.exe ausgeführt. Die AbaConnect Command Line muss direkt auf dem Abacus Server ausgeführt werden. Detaillierte Informationen über AbaConnect Command Line sind auf der Abacus Homepage zu finden. Die folgenden Beispiele dienen als Ausgangspunkt für die Erstellung einer einfachen Command Line.

AbaConnect Command Line
Export :
abaconnectexportconsole.exe "/USRuser" "/PWxxx"  "-aEPAY"  "-version2023.10"  "-M7777"  "-acidEFT-Transaction"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aEPAY"  "-version2023.10"  "-M7777"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-importfileX:\data.xml"

N.B. : Beim Import von XML-Daten muss die Schnittstellen-ID und das Mapping auf der Command Line nicht angegeben werden. Diese Information ist in der XML Import-Datei enthalten.



Mapping Felder / Struktur

Die folgende Tabelle zeigt die Daten des Mappings in vereinfachter Form an.
Das XML-Element und der Parent-Name werden immer in Englisch geschrieben. Mit einem Mausklick auf eine Zeile werden zusätzliche Informationen angezeigt.

XML Element Name Feld Name Parent Name Typ Feld Länge Zwingend
+ PtDetailDetail (Transaktion)---Ja
    + PtEntryBuchungPtDetail--Ja
        - EntryIdBuchungs IdentifikationPtEntryNummer10Ja
        - DetailTypeArtPtEntryNummer4Ja
        - CurrencyWährungPtEntryText3Nein
        - AmountBetragPtEntryNummer14Nein
        - FibuJournalIdReferenz zu FIBU-JournalPtEntryText3Nein
        - FibuReferenceReferenz zu FibubuchungPtEntryGUID36Nein
    - DirectionRichtungPtDetailText2Ja
    - FileIdDatei IdentifikationPtDetailNummer10Ja
    - TransferIdÜbertragungs IdentifikationPtDetailNummer10Ja
    - GroupIdGruppen IdentifikationPtDetailNummer10Ja
    - DetailIdDetail IdentifikationPtDetailNummer10Ja
    - StatusStatusPtDetailText1Nein
    - BookingDoneVerbuchtPtDetailBoolean-Nein
    - TerminalIdTerminal-IDPtDetailText50Nein
    - BrandIdBrand-IDPtDetailText40Nein
    - AcquirerNameBezeichnung AcquirerPtDetailText40Nein
    - ValueDateBelastungsdatumPtDetailDatum-Nein
    - TransactionDateTimeTransaktionszeitpunktPtDetailDatum/Zeit-Nein
    - TransactionIdTransaktions-IDPtDetailText50Nein
    - TransactionTextTransaktions TextPtDetailText50Nein
    - CurrencyWährungPtDetailText3Nein
    - GrossAmountBruttoPtDetailNummer14Nein
    - NetAmountNettoPtDetailNummer14Nein
    - TipAmountTrinkgeldPtDetailNummer14Nein
    - FeeAmountKommissionPtDetailNummer14Nein
    - CardNumberFragmentFragment der KreditkartennummerPtDetailText40Nein
    - CardHolderNameName KreditkartenbesitzerPtDetailText50Nein
    - OriginalCurrencyOriginalwährungPtDetailText3Nein
    - OriginalAmountBetrag in OriginalwährungPtDetailNummer14Nein
    - ExchangeRateKursPtDetailNummer14Nein
    - OrderNumberPtDetailNummer10Nein
    - OrderSubNumberPtDetailNummer2Nein
    - SourceReferenceSourcereferenzPtDetailGUID36Nein
    - SourceDatenherkunftPtDetailText20Nein
    - PaymentIdAuszahlungs-IDPtDetailText50Nein
    - PaymentStateZahlungsstatusPtDetailNummer2Nein
    - MerchantIdHändler-IDPtDetailText20Nein
    - MerchantNameHändlernamePtDetailText50Nein
    - MerchantCategoryKategoriePtDetailText50Nein
    - MerchantCategoryCodeKategoriecodePtDetailText20Nein
    - MerchantMailE-MailPtDetailText65Nein
    - MerchantLine1ZusatzPtDetailText50Nein
    - MerchantCityOrtPtDetailText50Nein
    - MerchantPostCodePlzPtDetailText15Nein
    - MerchantCountryLandPtDetailText4Nein
    - MatchingTypePtDetailNummer2Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Buchung
XML Element Name:PtEntry
Parent Element:PtDetail
Feld Typ:ID
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   1
Beschreibung:

                

Buchungs Identifikation
XML Element Name:EntryId
Parent Element:PtEntry
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   6
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "EntryId")
                    

Art
XML Element Name:DetailType
Parent Element:PtEntry
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   7
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "DetailType")
                    

Währung
XML Element Name:Currency
Parent Element:PtEntry
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   8
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "Currency")
                    

Betrag
XML Element Name:Amount
Parent Element:PtEntry
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   9
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "Amount")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Referenz zu FIBU-Journal
XML Element Name:FibuJournalId
Parent Element:PtEntry
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   10
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "FibuJournalId")
                    

Referenz zu Fibubuchung
XML Element Name:FibuReference
Parent Element:PtEntry
Feld Typ:GUID
Action Typ:Import und Export
Feld Länge:   36Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   11
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "FibuReference")
                    

Richtung
XML Element Name:Direction
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   2
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "Direction")
                    

Datei Identifikation
XML Element Name:FileId
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   3
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "FileId")
                    

Übertragungs Identifikation
XML Element Name:TransferId
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   4
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "TransferId")
                    

Gruppen Identifikation
XML Element Name:GroupId
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   5
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "GroupId")
                    

Detail Identifikation
XML Element Name:DetailId
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   6
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "DetailId")
                    

Status
XML Element Name:Status
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   1Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   7
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "Status")
                    

Verbucht
XML Element Name:BookingDone
Parent Element:PtDetail
Feld Typ:Boolean (true oder false)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   8
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "BookingDone")
                    

Terminal-ID
XML Element Name:TerminalId
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   9
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "TerminalId")
                    

Brand-ID
XML Element Name:BrandId
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   40Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   10
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "BrandId")
                    

Bezeichnung Acquirer
XML Element Name:AcquirerName
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   40Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   11
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "AcquirerName")
                    

Belastungsdatum
XML Element Name:ValueDate
Parent Element:PtDetail
Feld Typ:Datum (2000-03-20)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   12
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "ValueDate")
                    

Transaktionszeitpunkt
XML Element Name:TransactionDateTime
Parent Element:PtDetail
Feld Typ:Datum/Zeit (2006-08-08T10:16:54.509+02:00)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   13
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "TransactionDateTime")
                    

Transaktions-ID
XML Element Name:TransactionId
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   14
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "TransactionId")
                    

Transaktions Text
XML Element Name:TransactionText
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   15
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "TransactionText")
                    

Währung
XML Element Name:Currency
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   16
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "Currency")
                    

Brutto
XML Element Name:GrossAmount
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   17
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "GrossAmount")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Netto
XML Element Name:NetAmount
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   18
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "NetAmount")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Trinkgeld
XML Element Name:TipAmount
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   19
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "TipAmount")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Kommission
XML Element Name:FeeAmount
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   20
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "FeeAmount")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Fragment der Kreditkartennummer
XML Element Name:CardNumberFragment
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   40Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   21
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "CardNumberFragment")
                    

Name Kreditkartenbesitzer
XML Element Name:CardHolderName
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   22
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "CardHolderName")
                    

Originalwährung
XML Element Name:OriginalCurrency
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   23
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "OriginalCurrency")
                    

Betrag in Originalwährung
XML Element Name:OriginalAmount
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   24
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "OriginalAmount")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Kurs
XML Element Name:ExchangeRate
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   14Dezimal-Stellen:   8Zwingendes Feld:   NeinRevision:   0Ascii ID :   25
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "ExchangeRate")
                    
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

XML Element Name:OrderNumber
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   26
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "OrderNumber")
                    

XML Element Name:OrderSubNumber
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   27
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "OrderSubNumber")
                    

Sourcereferenz
XML Element Name:SourceReference
Parent Element:PtDetail
Feld Typ:GUID
Action Typ:Import und Export
Feld Länge:   36Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   28
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "SourceReference")
                    

Datenherkunft
XML Element Name:Source
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   20Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   29
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "Source")
                    

Auszahlungs-ID
XML Element Name:PaymentId
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   30
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "PaymentId")
                    

Zahlungsstatus
XML Element Name:PaymentState
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   31
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "PaymentState")
                    

Händler-ID
XML Element Name:MerchantId
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   20Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   32
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantId")
                    

Händlername
XML Element Name:MerchantName
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   33
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantName")
                    

Kategorie
XML Element Name:MerchantCategory
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   34
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantCategory")
                    

Kategoriecode
XML Element Name:MerchantCategoryCode
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   20Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   35
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantCategoryCode")
                    

E-Mail
XML Element Name:MerchantMail
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   65Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   36
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantMail")
                    

Zusatz
XML Element Name:MerchantLine1
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   37
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantLine1")
                    

Ort
XML Element Name:MerchantCity
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   50Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   38
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantCity")
                    

Plz
XML Element Name:MerchantPostCode
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   15Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   39
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantPostCode")
                    

Land
XML Element Name:MerchantCountry
Parent Element:PtDetail
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   40
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MerchantCountry")
                    

XML Element Name:MatchingType
Parent Element:PtDetail
Feld Typ:Nummer
Action Typ:nur für Import
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   41
Beschreibung:

                                (Den internen Feld ID für dieses Element ist "MatchingType")