Interface: DEBI - Payments Version 2011.00

This documentation describes the AbaConnect Interface Payments for the DEBI Application.


General Information

General information about the AbaConnect interface.

AbaConnect Interface Information
Application :DEBI
Interface Name :Payments
ID :Zahlungen ( 100 )
Version :2011.00
Status:Productive


Displays the possible import and export features for this interface.

Export / Import Modus
Export :XML
Import :XML


Displays additional information for this interface.

Additional Information
Modifications compared to version 2007.10
Payment text has been expanded from 30 to 80 characters.
Highest field Revision for this interface : 0



Mapping Information

The following displays the Mapping details for this interface.

Mapping Information
Mapping ID :AbaZahlungen
Mapping Name :Payments
Description :

                



Example AbaConnect XML Structure

The following is an example of an XML Header structure. This information is also visible in an AbaConnect XML Export file, that has been exported via the Abacus AbaConnect User Interface.

AbaConnect XML Struktur
<?xml version='1.0' encoding='UTF-8'?>
<AbaConnectContainer>
  <TaskCount>1</TaskCount>
  <Task>
    <Parameter>
      <Application>DEBI</Application>
      <Id>Zahlungen</Id>
      <MapId>AbaZahlungen</MapId>
      <Version>2011.00</Version>
      <!-- Attention : The client number (Mandant) is optional and implies that the data can only be imported into specified client (Mandant) -->
      <!-- The Client Option (Mandant) only has an influence when importing data. It can be configured in the AbaConnect Export Settings. -->
      <!-- By default, the client number (Mandant) is not written to the export file -->
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <Payment mode='SAVE'>
          <!-- The specific data fields for the AbaConnect interface are included here. -->
      </Payment>
    </Transaction>
  </Task>
</AbaConnectContainer>



Example AbaConnect Command Line

The following includes examples of AbaConnect Command Line. The AbaConnect Command Line is executed with the abaconnectexportconsole.exe and abaconnectimportconsole.exe programmes. The AbaConnect Command Line must be run direct on the Abacus server. More detailed information about AbaConnect Command Line is available on the Abacus Homepage. The following examples serve as starting point for creating a simple command line.

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

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aDEBI"  "-version2011.00"  "-M7777"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-importfileX:\data.xml"

N.B. : For importing XML data, it is not necessary to specify the Interface ID and Mapping on the Command Line. This information is contained in the XML Import file.



Mapping Structure

The following displays a simplified mapping structure for this interface.
The XML-Element and Parent-Name are always in english. Click on the row to display additional information.

XML Element Name Field Name Parent Name Type Length Mandatory
PaymentPayment---Yes
    - PaymentTypePayment typePaymentAbaCon Enum2Yes
    - PaymentCodePayment codePaymentText4Yes
    - CustomerNumberCustomer numberPaymentNumber11Yes
    - DocumentNumberDocument numberPaymentNumber10Yes
    - NumberPayment itemPaymentNumber6Yes
    - UniqueReferenceUnique referencePaymentText60No
    - TextTextPaymentText80No
    - PaymentDatePayment datePaymentDate-Yes
    - ValueDateValue datePaymentDate-No
    - CompanyPaymentCentreNumberCompany payment centre numberPaymentNumber6No
    - PaymentCurrencyPayment currencyPaymentText3No
    - PaymentAmountAmount in PCPaymentNumber12No
    - AmountAmount in DCPaymentNumber12No
    - KeyAmountAmount in KCPaymentNumber12Yes
    - PaymentDocumentNumberPayment document numberPaymentNumber6No
    - PaymentReferenceDocumentNumberOffsetting document document numberPaymentNumber10No
    - DebitAccountDebit accountPaymentNumber11No
    - DebitCostCentre1Debit cost centre1PaymentNumber11No
    - DebitCostCentre2Debit cost centre2PaymentNumber11No
    - TaxCodeVAT codePaymentText3No
    - TaxDateValidFromCalculate VAT rate as at datePaymentDate-No
    - CreditAccountCredit accountPaymentNumber11No
    - CreditCostCentre1Credit cost centre1PaymentNumber11No
    - CreditCostCentre2Credit cost centre2PaymentNumber11No
    - DivisionBusiness areaPaymentNumber6No
    - BusinessCaseBusiness casePaymentNumber8No
    - CostGroupCost groupPaymentNumber8No
    - PersonInChargeResponsible personPaymentNumber4No
    - GroupNumber1Doc. gr. 1PaymentNumber10No
    - ReminderAreaReminder areaPaymentNumber6No
    - ReminderProcedureReminder procedurePaymentText4No
    - GeneralLedgerCodeG/L codePaymentText1No
    - ContinueOnErrorInstruction for errors in multiple processingPaymentBoolean-No



Field Information

The following is a detailed description of the fields used in this interface.

Payment type
XML Element Name:PaymentType
Parent Element:Payment
Field Type:AbaConnect Enum
Action Type:Import und Export
Field Length:   2Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Payment type; the payment type determines which type of payment should be entered. The following types are allowed: 0 = Payment 2 = Advance payments 3 = Offsettings (settlements) 4 = Reductions
(The internal field ID for this element is "Zahlungstyp")

Payment code
XML Element Name:PaymentCode
Parent Element:Payment
Field Type:Text
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Payment code; the payment code must already exist and be allowed on the basis of the payment type.
(The internal field ID for this element is "Zahlungsart")

Customer number
XML Element Name:CustomerNumber
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Customer number; the customer number must already exist
(The internal field ID for this element is "Kundennummer")

Document number
XML Element Name:DocumentNumber
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   10Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Document number; the document number must already exist, exception: New entry of an advance payment. It must be unique, and it is possible to enter 0
(The internal field ID for this element is "Belegnummer")

Payment item
XML Element Name:Number
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Payment item number, must be unique and sequential, it is also possible to enter 0
(The internal field ID for this element is "Zahlungsposition")

Unique reference
XML Element Name:UniqueReference
Parent Element:Payment
Field Type:Text
Action Type:Import only
Field Length:   60Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Unique reference, required for replies if no fixed payment item number is specified
(The internal field ID for this element is "Unique_Referenz")

Text
XML Element Name:Text
Parent Element:Payment
Field Type:Text
Action Type:Import und Export
Field Length:   80Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Remark
(The internal field ID for this element is "Text")

Payment date
XML Element Name:PaymentDate
Parent Element:Payment
Field Type:Datum (2000-03-20)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Payment date, must lie within an open financial year
(The internal field ID for this element is "Zahlungsdatum")

Value date
XML Element Name:ValueDate
Parent Element:Payment
Field Type:Datum (2000-03-20)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Value date, of informative character only in A/R
(The internal field ID for this element is "Valutadatum")

Company payment centre number
XML Element Name:CompanyPaymentCentreNumber
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Number of the company payment centre, mandatory for payment type 'Payment' and 'Advance payment'
(The internal field ID for this element is "Firmenzahlstelle")

Payment currency
XML Element Name:PaymentCurrency
Parent Element:Payment
Field Type:Text
Action Type:Export only
Field Length:   3Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Payment currency in a broader sense: If there is a company payment centre, it is the actual company payment centre currency, otherwise the document currency
(The internal field ID for this element is "Zahlungswaehrung")

Amount in PC
XML Element Name:PaymentAmount
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   12Decimal Places:   2Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Payment amount in payment currency (see also field 'Payment currency')
(The internal field ID for this element is "ZwBtr")
The decimal separator for numbers must be represented with a point, as defined by the XML standards from W3C.

Amount in DC
XML Element Name:Amount
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   12Decimal Places:   2Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Payment amount in document currency
(The internal field ID for this element is "BwBtr")
The decimal separator for numbers must be represented with a point, as defined by the XML standards from W3C.

Amount in KC
XML Element Name:KeyAmount
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   12Decimal Places:   2Mandatory Field:   YesRevision:   0Ascii ID :   -
Description:
Payment amount in key currency
(The internal field ID for this element is "LwBtr")
The decimal separator for numbers must be represented with a point, as defined by the XML standards from W3C.

Payment document number
XML Element Name:PaymentDocumentNumber
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Payment document number (mandatory if activated in company master data)
(The internal field ID for this element is "Zahlungsbelegnummer")

Offsetting document document number
XML Element Name:PaymentReferenceDocumentNumber
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   10Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Number of the offsetting documents, mandatory for payments of type 'Offsetting' (settlement)
(The internal field ID for this element is "Verrechnungsbeleg")

Debit account
XML Element Name:DebitAccount
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Debit account; if the General Ledger is installed, the account must already exist
(The internal field ID for this element is "Sollkonto")

Debit cost centre1
XML Element Name:DebitCostCentre1
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Debit cost centre 1; if the General Ledger is installed, the cost centre must already exist
(The internal field ID for this element is "Sollkst1")

Debit cost centre2
XML Element Name:DebitCostCentre2
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Debit cost centre 2; if the General Ledger is installed, the cost centre must already exist
(The internal field ID for this element is "Sollkst2")

VAT code
XML Element Name:TaxCode
Parent Element:Payment
Field Type:Text
Action Type:Import und Export
Field Length:   3Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
VAT code; mandatory with payment type 'Advance payment' if there is a VAT liability on the basis of the client definition and the payment date
(The internal field ID for this element is "MwstCode")

Calculate VAT rate as at date
XML Element Name:TaxDateValidFrom
Parent Element:Payment
Field Type:Datum (2000-03-20)
Action Type:Import und Export
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
VAT validity date for the advance payment, only for payment type 'Advance payment'
(The internal field ID for this element is "MwstPer")

Credit account
XML Element Name:CreditAccount
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Credit account; if the General Ledger is installed, the account must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Habenkonto")

Credit cost centre1
XML Element Name:CreditCostCentre1
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Credit cost centre 1; if the General Ledger is installed, the cost centre must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Habenkst1")

Credit cost centre2
XML Element Name:CreditCostCentre2
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   11Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Credit cost centre 2; if the General Ledger is installed, the cost centre must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Habenkst2")

Business area
XML Element Name:Division
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Business area; the business area must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Geschaeftsbereich")

Business case
XML Element Name:BusinessCase
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   8Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Business case number only with payment type 'Advance payment'
(The internal field ID for this element is "Geschaeftsfall")

Cost group
XML Element Name:CostGroup
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   8Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
The cost group must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Kostengruppe")

Responsible person
XML Element Name:PersonInCharge
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Responsible person; the responsible person must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Verantwortlicher")

Doc. gr. 1
XML Element Name:GroupNumber1
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   10Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Free document group 1; the free document group must already exist in the company base, depending on the definition, only with payment type 'Advance payment'
(The internal field ID for this element is "Beleggruppe1")

Reminder area
XML Element Name:ReminderArea
Parent Element:Payment
Field Type:Nummer
Action Type:Import und Export
Field Length:   6Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Reminder area; the reminder area must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Mahnbereich")

Reminder procedure
XML Element Name:ReminderProcedure
Parent Element:Payment
Field Type:Text
Action Type:Import und Export
Field Length:   4Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Reminder procedure; the reminder procedure must already exist, only with payment type 'Advance payment'
(The internal field ID for this element is "Mahnverfahren")

G/L code
XML Element Name:GeneralLedgerCode
Parent Element:Payment
Field Type:Text
Action Type:Import und Export
Field Length:   1Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
G/L code only with payment type 'Advance payment'
(The internal field ID for this element is "FibuCode")

Instruction for errors in multiple processing
XML Element Name:ContinueOnError
Parent Element:Payment
Field Type:Boolean (true oder false)
Action Type:Import only
Field Length:   -Decimal Places:   0Mandatory Field:   NoRevision:   0Ascii ID :   -
Description:
Processing instruction for multiple processings within a transaction: if "false", the processing is aborted immediately at the first error and the remaining processings no longer validated.
(The internal field ID for this element is "ContinueOnError")