About Debtor Management Ideal

General information about Debtor Management Ideal

offers together with a partner/third party service provider a complete debtor management system to merchants. Via merchants can maintain debtor accounts and provide information about payment status of all payment methods to the service provider to ensure account checking and traceability.

Logo

Info

The offers individually scalable solutions for financial and debtor accountings – including the downstream processes such as logistics, dunnings or debt collection.

Type

Debtors Management

Further information can be found on the webpage of Ideal Debtor Management (https://www.ideal-fullservice.de/ideal-accounting.html).

Process flow chart

Ideal debtor management process flow

interface

Create debtors

To create a debtor via a Server-to-Server connection, please use the following URL:

debtor.aspx

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	Abbreviation of the action to be done: <MD> for ManageDebtor	Abkürzung der auszuführenden Aktion: <MD> für ManageDebtor
			Master data	Stammdaten
Salutation	ans..9	O	Salutation	Anrede
FirstName	ans..50	M	First name of the custumer	Vorname des Kunden
LastName	ans..50	M	Last name of the custumer	Nachname des Kunden
AddrStreet	ans..45	M	Street name	Straßenname
AddrStreetNr	ans..5	O	Street number	Hausnummer
AddrAddition	ans..50	O	Address c/o	Adresszusatz
AddrZip	ans..10	O	Postcode	Postleitzahl
AddrCity	ans..45	O	City	Ort
AddrCountryCode	a2	O	Two characters country code according to ISO 3166	Ländercode zweistellig gemäß ISO 3166
TaxID	ans1	M	value added tax key / tax area	USt.-Schlüssel/Steuergebiet
DebitorID	ans..10	M	debtor number	Debitorennummer
Custgroup	ans..4	O	Customer group	Kundengruppe
AccOwner	ans..30	O	Account holder	Kontoinhaber
AccBank	ans..40	O	Name of the bank	Name der Bank
BIC	ans..11	O	BIC	BIC
IBAN	ans..34	O	IBAN	IBAN
Email	ans..50	O	E-mail address	E-Mail-Adresse
Phone	ans..20	O	Telephone number	Telefonnummer
CustomerID	n..10	M	Customer number	Kundennummer

Parameters for creating debtors

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Response parameters for creating debtors

Create transaction

With reference to already created debtors you can create transactions and prepayments and reverse them if necessary.

To create a transaction, please use the following URL:

debtor.aspx

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Reference to payment, e.g. invoice number, can be same as document number (OP-number)	Referenz zur Zahlung, z.B. Rechnungsnummer, kann mit Belegnummer identisch sein (OP-Nummer)

Key	Format	CND	Description	Beschreibung
AmountClass	ans..1024	M	Assignment of net amounts (max. 11 digits in smallest currency unit) of a tax code (3 digits) to proceed codes (max. 10 digits) separated by “;”. Further assignments are separated by “+”. Example: 4500000000;2235;101+4400000000;1595;002 Proceed code 4500000000; Amount 22,35€; tax code 101	Zuordnung der Nettobeträge (maximal 11stellig in kleinster Währungseinheit) eines Steuercodes (3stellig) zu den Erlöscodes (maximal 10stellig) mit „;“ als Trennzeichen. Weitere Zuordnungen werden mit „+“ getrennt. Beispiel: 4500000000;2235;101+4400000000;1595;002 Erlöscode 4500000000; Betrag 22,35€; Steuercode 101
EventToken	a2	M	Abbreviation of the action to be done: <OC> for Open Position Create	Abkürzung der auszuführenden Aktion: <OC> für Open Position Create
PayType	ans..3	M	<CC>= credit card <EDD>= direct debit (ELV) <SO>= directEbanking <PP>= PayPal <GP>= Giropay <PD>= PayDirekt <SK>= cheque <BP>= BillPay <COD>= cash on delivery <RG>= Invoice <PRP>= Prepayment	<CC>= Kreditkarte <EDD>= Lastschrift (ELV) <SO>= Sofortüberweisung <PP>= PayPal <GP>= Giropay <PD>= PayDirekt <SK>= Scheck <BP>= BillPay <COD>= Nachnahme (cash on delivery) <RG>= Rechnung <PRP>= Vorkasse
DebitorID	ans..10	M	debtor number	Debitorennummer
CustomerID	n..10	M	Customer number	Kundennummer
ShopID	ans..4	M	accounting area, e.g. 01 for shop A – will be assigned for each client	Buchungskreis, z.B. 01 für Shop-A – wird je Mandant festgelegt
PayTerm	ans..3	O	payment term	Zahlungsbedingung
InvoiceDate	n6	O	Invoice date in the format DDMMYY: OP_Valuta date, if invoice is due at a later time	Rechnungsdatum m Format DDMMYY: OP_Valutadatum, wenn Fälligkeit zu einem späteren Zeitpunkt beginnt
NetAmount	n..11	M	Net amount in own currency	Nettobetrag in Eigenwährung
TaxCode1	n..3	M	Tax code 1: 101 for 19% domestic tax	Steuercode-1: 101 für 19% Steuern Inland
NetAmount1	n..11	M	Net amount for tax code 1	Nettobetrag vom Steuercode-1
TaxAmount1	n..11	M	Tax amount for tax code 1	Steuerbetrag vom Steuercode-1
TaxCode2	n..3	M	Tax code 2: 002 for 7% domestic tax	Steuercode-2: 002 für 7% Steuern Inland
NetAmount2	n..11	M	Net amount for tax code 2	Nettobetrag vom Steuercode-2
TaxAmount2	n..11	M	Tax amount for tax code 2	Steuerbetrag vom Steuercode-2
TaxCode3	n..3	M	Tax code 3: 000 for 0% domestic tax	Steuercode-3: 000 für 0% Steuern Inland
NetAmount3	n..11	M	Net amount for tax code 3	Nettobetrag vom Steuercode-3
TaxAmount3	n..11	M	Tax amount for tax code 3	Steuerbetrag vom Steuercode-3

Parameters for creating transactions

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Response parameters for creating transactions

Create payment with prepayment

To create a prepayment, please use the following URL:

debtor.aspx

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Reference to payment, e.g. invoice number, can be same as document number (OP-number)	Referenz zur Zahlung, z.B. Rechnungsnummer, kann mit Belegnummer identisch sein (OP-Nummer)

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	Abbreviation of the action to be done: <AN> for creation <ST> for reversal <ZE> for paid <UP> for Update Data Record	Abkürzung der auszuführenden Aktion: <AN> für Anlage <ST> für Storno <ZE> für Bezahlt <UP> für Update Datensatz
CustomerID	n..10	M	Customer number	Kundennummer
ShopID	ans..4	O	accounting area, e.g. 01 for shop A – will be assigned for each client	Buchungskreis, z.B. 01 für Shop-A – wird je Mandant festgelegt
ShoppingBasketID	n..18	M	ID of shopping cart	ID des Warenkorbs
CreationDate	dttm8	M	Creation date of shopping cart in the format YYYYMMDD	Erstelldatum des Warenkorbs im Format JJJJMMTT
DueDate	dttm8	M	Expiration date in the format YYYYMMDD	Ablaufdatum im Format JJJJMMTT
PayType	ans..3	M	<PRP> = prepayment	<PRP>= Vorkasse

Parameters for creating prepayments

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Response parameters for creating prepayments

Reverse transaction

To reverse a transaction, please use the following URL:

debtor.aspx

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	Abbreviation of the action to be done: <OS> for Open Position Storno	Abkürzung der auszuführenden Aktion: <OS> für Open Position Storno

Parameters for reversal of transactions

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Response parameters for reversal of transactions

Credit transaction

To credit a transaction, please use the following URL:

debtor.aspx

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Reference to payment, e.g. invoice number, can be same as document number (OP-number)	Referenz zur Zahlung, z.B. Rechnungsnummer, kann mit Belegnummer identisch sein (OP-Nummer)

Key	Format	CND	Description	Beschreibung
AmountClass	ans..1024	M	Assignment of net amounts (max. 11 digits in smallest currency unit) of a tax code (3 digits) to proceed codes (max. 10 digits) separated by “;”. Further assignments are separated by “+”. Example: 4500000000;2235;101+4400000000;1595;002 Proceed code 4500000000; Amount 22,35€; tax code 101	Zuordnung der Nettobeträge (maximal 11stellig in kleinster Währungseinheit) eines Steuercodes (3stellig) zu den Erlöscodes (maximal 10stellig) mit „;“ als Trennzeichen. Weitere Zuordnungen werden mit „+“ getrennt. Beispiel: 4500000000;2235;101+4400000000;1595;002 Erlöscode 4500000000; Betrag 22,35€; Steuercode 101
EventToken	a2	M	Abbreviation of the action to be done: <CR> for Credit	Abkürzung der auszuführenden Aktion: <CR> für Credit (Gutschrift)
PayType	ans..3	M	<CC>= credit card <EDD>= direct debit (ELV) <SO>= directEbanking <PP>= PayPal <GP>= Giropay <PD>= PayDirekt <SK>= cheque <BP>= BillPay <COD>= cash on delivery <RG>= Invoice <PRP>= Prepayment	<CC>= Kreditkarte <EDD>= Lastschrift (ELV) <SO>= Sofortüberweisung <PP>= PayPal <GP>= Giropay <PD>= PayDirekt <SK>= Scheck <BP>= BillPay <COD>= Nachnahme (cash on delivery) <RG>= Rechnung <PRP>= Vorkasse
DebitorID	ans..10	M	debtor number	Debitorennummer
CustomerID	n..10	M	Customer number	Kundennummer
ShopID	ans..4	M	accounting area, e.g. 01 for shop A – will be assigned for each client	Buchungskreis, z.B. 01 für Shop-A – wird je Mandant festgelegt
PayTerm	ans..3	O	payment term	Zahlungsbedingung
InvoiceDate	n6	O	Invoice date in the format DDMMYY: OP_Valuta date, if invoice is due at a later time	Rechnungsdatum m Format DDMMYY: OP_Valutadatum, wenn Fälligkeit zu einem späteren Zeitpunkt beginnt
NetAmount	n..11	M	Net amount in own currency	Nettobetrag in Eigenwährung
TaxCode1	n..3	M	Tax code 1: 101 for 19% domestic tax	Steuercode-1: 101 für 19% Steuern Inland
NetAmount1	n..11	M	Net amount for tax code 1	Nettobetrag vom Steuercode-1
TaxAmount1	n..11	M	Tax amount for tax code 1	Steuerbetrag vom Steuercode-1
TaxCode2	n..3	M	Tax code 2: 002 for 7% domestic tax	Steuercode-2: 002 für 7% Steuern Inland
NetAmount2	n..11	M	Net amount for tax code 2	Nettobetrag vom Steuercode-2
TaxAmount2	n..11	M	Tax amount for tax code 2	Steuerbetrag vom Steuercode-2
TaxCode3	n..3	M	Tax code 3: 000 for 0% domestic tax	Steuercode-3: 000 für 0% Steuern Inland
NetAmount3	n..11	M	Net amount for tax code 3	Nettobetrag vom Steuercode-3
TaxAmount3	n..11	M	Tax amount for tax code 3	Steuerbetrag vom Steuercode-3

Parameters for credit of transactions

Key	Format	CND	Description	Beschreibung
TransID	ans..20	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Response parameters for credit of transactions