Schnittstelle: DEBI - Zahlungen Version 2013.00

Dieses Dokument beschreibt die AbaConnect-Schnittstelle Zahlungen der Applikation DEBI .


Allgemeine Informationen

Allgemeine Informationen zur Schnittstelle.

AbaConnect Schnittstellen Information
Applikation:DEBI
Schnittstellen-Name:Zahlungen
ID:Zahlungen ( 100 )
Version:2013.00


Mögliche Export- und Import-Funktionen der Schnittstelle

Export / Import Funktionen
Export:XML
Import:XML


Zusätzliche Informationen zur Schnittstelle

Zusatzinformation
Aenderungen gegenüber Version 2007.10:
Zahlungstext ist von 30 Zeichen auf 80 Zeichen erweitert worden
Aenderungen gegenüber Version 2012.00:
Visum-Verantwortlicher wurde von 4 auf 10 Stellen vergrössert (int -> long)
Höchste Feld Revision für dieser Schnittstelle : 1



Mapping Informationen

Im Folgenden werden die Informationen über das Mapping angezeigt.

Mapping Informationen
Mapping ID:AbaDefault
Mapping Name:Zahlungen
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>DEBI</Application>
      <Id>Zahlungen</Id>
      <MapId>AbaDefault</MapId>
      <Version>2013.00</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>
      <Payment mode='SAVE'>
          <!-- Hier können spezifische Datenfelder für die AbaConnect Schnittstelle definiert werden. -->
      </Payment>
    </Transaction>
  </Task>
</AbaConnectContainer>



Beispiel AbaConnect Command Line

Es folgen Beispiele für die AbaConnect Command Line. Ab ABACUS V2010 wird AbaConnect Command Line mit den Programmen abaconnectexportconsole.exe und abaconnectimportconsole.exe, anstatt abajvm.exe, ausgeführt. Detaillierte Informationen über AbaConnect Command Line sind auf der ABACUS Homepage zu finden.

AbaConnect Command Line
Export :
abaconnectexportconsole.exe "/USRuser" "/PWxxx"  "-aDEBI"  "-version2013.00"  "-M7777"  "-acidZahlungen"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aDEBI"  "-version2013.00"  "-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
PaymentZahlung---Ja
    - PaymentTypeZahlungstypPaymentAbaCon Enum2Ja
    - PaymentCodeZahlungsartPaymentText4Ja
    - CustomerNumberKundennummerPaymentNummer11Ja
    - DocumentNumberBelegnummerPaymentNummer10Ja
    - NumberZahlungspositionPaymentNummer6Ja
    - UniqueReferenceEindeutige ReferenzPaymentText60Nein
    - TextTextPaymentText80Nein
    - PaymentDateZahlungsdatumPaymentDatum-Ja
    - ValueDateValutadatumPaymentDatum-Nein
    - CompanyPaymentCentreNumberFirmenzahlstellennummerPaymentNummer6Nein
    - PaymentCurrencyZahlungswährungPaymentText3Nein
    - PaymentAmountBetrag in ZWPaymentNummer12Nein
    - AmountBetrag in BWPaymentNummer12Nein
    - KeyAmountBetrag in LWPaymentNummer12Ja
    - PaymentDocumentNumberZahlungsbelegnummerPaymentNummer10Nein
    - PaymentReferenceDocumentNumberVerrechnungsbeleg-BelegnummerPaymentNummer10Nein
    - DebitAccountSoll-KontoPaymentNummer11Nein
    - DebitCostCentre1Soll-Kostenstelle1PaymentNummer11Nein
    - DebitCostCentre2Soll-Kostenstelle2PaymentNummer11Nein
    - TaxCodeMwSt.-CodePaymentText3Nein
    - TaxDateValidFromMwSt.-Satz berechnen per DatumPaymentDatum-Nein
    - CreditAccountHaben-KontoPaymentNummer11Nein
    - CreditCostCentre1Haben-Kostenstelle1PaymentNummer11Nein
    - CreditCostCentre2Haben-Kostenstelle2PaymentNummer11Nein
    - DivisionGeschäftsbereichPaymentNummer6Nein
    - BusinessCaseGeschäftsfallPaymentNummer8Nein
    - CostGroupKostengruppePaymentNummer8Nein
    - PersonInChargeVerantwortlicherPaymentNummer10Nein
    - GroupNumber1Bel-Gr. 1PaymentNummer10Nein
    - ReminderAreaMahnbereichPaymentNummer6Nein
    - ReminderProcedureMahnverfahrenPaymentText4Nein
    - GeneralLedgerCodeFIBU-CodePaymentText1Nein
    - ContinueOnErrorAnweisung bei Fehlern in MehrfachverarbeitungPaymentBoolean-Nein
    - ContractualRelationShipNumberIMMO-VertragsverhältnisPaymentNummer12Nein
    - ChargingTypeIMMO-VerrechnungstypPaymentNummer2Nein
    - ClearingTextAuszifferungPaymentText30Nein



Detaillierte Feld-Informationen

Detaillierte Beschreibung der Schnittstellen-Felder.

Zahlungstyp
XML Element Name:PaymentType
Parent Element:Payment
Feld Typ:AbaConnect Enum
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
ZahlungsTyp, via Zahlungstyp wird bestimmt, was für eine Art Zahlung erfasst werden soll.
Zulässige Typen sind:
0 = Zahlung
2 = Vorauszahlungen
3 = Verrechnungen
4 = Minderungen
(Den internen Feld ID für dieses Element ist "Zahlungstyp")

Zahlungsart
XML Element Name:PaymentCode
Parent Element:Payment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Zahlungsart, die Zahlungsart muss bereits vorhanden und aufgrund des Zahlungstyps zulässig sein.
(Den internen Feld ID für dieses Element ist "Zahlungsart")

Kundennummer
XML Element Name:CustomerNumber
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Kundennummer, die Kundennummer muss bereits vorhanden sein
(Den internen Feld ID für dieses Element ist "Kundennummer")

Belegnummer
XML Element Name:DocumentNumber
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Belegnummer, die Belegnummer muss bereits vorhanden sein
Ausnahme: Neuerfassung einer Vorauszahlung, dabei muss sie eindeutig sein, es kann auch 0 mitgegeben werden
(Den internen Feld ID für dieses Element ist "Belegnummer")

Zahlungsposition
XML Element Name:Number
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Zahlungspositionsnummer, muss eindeutig und fortlaufend sein, es kann auch 0 mitgegeben werden
(Den internen Feld ID für dieses Element ist "Zahlungsposition")

Eindeutige Referenz
XML Element Name:UniqueReference
Parent Element:Payment
Feld Typ:Text
Action Typ:nur für Import
Feld Länge:   60Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Eindeutige Referenz, notwendig für Rückmeldungen falls keine fixe Zahlungspositionsnummer mitgegeben wird
(Den internen Feld ID für dieses Element ist "Unique_Referenz")

Text
XML Element Name:Text
Parent Element:Payment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   80Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Bemerkung
(Den internen Feld ID für dieses Element ist "Text")

Zahlungsdatum
XML Element Name:PaymentDate
Parent Element:Payment
Feld Typ:Datum (2000-03-20)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Zahlungsdatum, muss innerhalb eines offenen Geschäftsjahres liegen
(Den internen Feld ID für dieses Element ist "Zahlungsdatum")

Valutadatum
XML Element Name:ValueDate
Parent Element:Payment
Feld Typ:Datum (2000-03-20)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Valutadatum, in DEBI nur infomativer Charakter
(Den internen Feld ID für dieses Element ist "Valutadatum")

Firmenzahlstellennummer
XML Element Name:CompanyPaymentCentreNumber
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Nummer der Firmenzahlstelle, bei Zahlungstyp 'Zahlung' und 'Vorauszahlung' zwingend
(Den internen Feld ID für dieses Element ist "Firmenzahlstelle")

Zahlungswährung
XML Element Name:PaymentCurrency
Parent Element:Payment
Feld Typ:Text
Action Typ:nur für Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Zahlungswährung im weiteren Sinn:
Falls Firmenzahlstelle vorhanden die effektive Firmenzahlstellenwährung, sonst die Belegwährung
(Den internen Feld ID für dieses Element ist "Zahlungswaehrung")

Betrag in ZW
XML Element Name:PaymentAmount
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   2Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Zahlungsbetrag in Zahlungswährung (siehe auch Feld 'Zahlungswährung')
(Den internen Feld ID für dieses Element ist "ZwBtr")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Betrag in BW
XML Element Name:Amount
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   2Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Zahlungsbetrag in Belegwährung
(Den internen Feld ID für dieses Element ist "BwBtr")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Betrag in LW
XML Element Name:KeyAmount
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   2Zwingendes Feld:   JaRevision:   0Ascii ID :   -
Beschreibung:
Zahlungsbetrag in Leitwährung
(Den internen Feld ID für dieses Element ist "LwBtr")
Als Dezimaltrenner muss ein Punkt verwendet werden. Dies gemäss dem XML Standard von W3C.

Zahlungsbelegnummer
XML Element Name:PaymentDocumentNumber
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Zahlungsbeleg-Nummer (zwingend falls in Firmenstammdaten aktiviert)
(Den internen Feld ID für dieses Element ist "Zahlungsbelegnummer")

Verrechnungsbeleg-Belegnummer
XML Element Name:PaymentReferenceDocumentNumber
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Nummer des Verrechnungebelegs, bei Zahlungen vom Typ 'Verrechnung' zwingend
(Den internen Feld ID für dieses Element ist "Verrechnungsbeleg")

Soll-Konto
XML Element Name:DebitAccount
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Sollkonto, falls die Finanzbuchhaltung installiert ist muss das Konto bereits bestehen
(Den internen Feld ID für dieses Element ist "Sollkonto")

Soll-Kostenstelle1
XML Element Name:DebitCostCentre1
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Soll-Kostenstelle 1, falls die Finanzbuchhaltung installiert ist muss die Kostenstelle bereits bestehen
(Den internen Feld ID für dieses Element ist "Sollkst1")

Soll-Kostenstelle2
XML Element Name:DebitCostCentre2
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Soll-Kostenstelle 2, falls die Finanzbuchhaltung installiert ist muss die Kostenstelle bereits bestehen
(Den internen Feld ID für dieses Element ist "Sollkst2")

MwSt.-Code
XML Element Name:TaxCode
Parent Element:Payment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   3Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
MwSt.-Code, zwingend bei Zahlungstyp 'Vorauszahlung' und falls aufgrund der Mandantendefintion und des Zahlungsdatums eine MWST-Pflciht gegeben ist
(Den internen Feld ID für dieses Element ist "MwstCode")

MwSt.-Satz berechnen per Datum
XML Element Name:TaxDateValidFrom
Parent Element:Payment
Feld Typ:Datum (2000-03-20)
Action Typ:Import und Export
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
MwSt.-Gültigkeitsdatum für die Vorauszahlung
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "MwstPer")

Haben-Konto
XML Element Name:CreditAccount
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Habenkonto, falls die Finanzbuchhaltung installiert ist muss das Konto bereits bestehen
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Habenkonto")

Haben-Kostenstelle1
XML Element Name:CreditCostCentre1
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Haben-Kostenstelle 1, falls die Finanzbuchhaltung installiert ist muss die Kostenstelle bereits bestehen
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Habenkst1")

Haben-Kostenstelle2
XML Element Name:CreditCostCentre2
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   11Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Haben-Kostenstelle 2, falls die Finanzbuchhaltung installiert ist muss die Kostenstelle bereits bestehen
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Habenkst2")

Geschäftsbereich
XML Element Name:Division
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Geschäftsbereich, der Geschäftsbereich muss bereits bestehen
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Geschaeftsbereich")

Geschäftsfall
XML Element Name:BusinessCase
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   8Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Geschäftsfall-Nummer
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Geschaeftsfall")

Kostengruppe
XML Element Name:CostGroup
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   8Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Kostengruppe, die Kostengruppe muss bereits vorhanden sein
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Kostengruppe")

Verantwortlicher
XML Element Name:PersonInCharge
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Verantwortlicher, der Verantwortliche muss bereits vorhanden sein
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Verantwortlicher")

Bel-Gr. 1
XML Element Name:GroupNumber1
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   10Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Freie Beleggruppe 1, die freie Beleggruppe muss je nach Defintion im Firmenstamm bereits bestehen
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Beleggruppe1")

Mahnbereich
XML Element Name:ReminderArea
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   6Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Mahnbereich, der Mahnbereich muss bereits vorhanden sein
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Mahnbereich")

Mahnverfahren
XML Element Name:ReminderProcedure
Parent Element:Payment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   4Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Mahnverfahren, das Mahnverfahren muss bereits vorhanden sein
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "Mahnverfahren")

FIBU-Code
XML Element Name:GeneralLedgerCode
Parent Element:Payment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   1Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Fibu-Code
nur bei Zahlungstyp 'Vorauszahlung'
(Den internen Feld ID für dieses Element ist "FibuCode")

Anweisung bei Fehlern in Mehrfachverarbeitung
XML Element Name:ContinueOnError
Parent Element:Payment
Feld Typ:Boolean (true oder false)
Action Typ:nur für Import
Feld Länge:   -Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   0Ascii ID :   -
Beschreibung:
Verarbeitungsanweisung bei Mehrfachverarbeitungen innerhalb einer Transaktion:
Falls "false" wird die Verarbeitung beim ersten Fehler sofort abgebrochen und die restlichen  Verarbeitungen werden nicht mehr validiert.
(Den internen Feld ID für dieses Element ist "ContinueOnError")

IMMO-Vertragsverhältnis
XML Element Name:ContractualRelationShipNumber
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   12Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   -
Beschreibung:

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

IMMO-Verrechnungstyp
XML Element Name:ChargingType
Parent Element:Payment
Feld Typ:Nummer
Action Typ:Import und Export
Feld Länge:   2Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   -
Beschreibung:

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

Auszifferung
XML Element Name:ClearingText
Parent Element:Payment
Feld Typ:Text
Action Typ:Import und Export
Feld Länge:   30Dezimal-Stellen:   0Zwingendes Feld:   NeinRevision:   1Ascii ID :   1
Beschreibung:

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