joonis Logo

Dokumentation fintech.datev

DATEV module of the Python FinTech package.

This module defines functions and classes to create DATEV data exchange files (Postversanddateien).

class fintech.datev.DatevKNE(adviserid, advisername, clientid, dfv='', kne=4, mediumid=1, password='')

The DatevKNE class (Postversanddateien)

Initializes the DatevKNE instance.

Parameters:
  • adviserid – DATEV number of the accountant (Beraternummer). A numeric value up to 7 digits.
  • advisername – DATEV name of the accountant (Beratername). An alpha-numeric value up to 9 characters.
  • clientid – DATEV number of the client (Mandantennummer). A numeric value up to 5 digits.
  • dfv – The DFV label (DFV-Kennzeichen). Usually the initials of the client name (2 characters).
  • kne – Length of G/L account numbers (Sachkonten). Therefore subledger account numbers (Personenkonten) are one digit longer. It must be a value between 4 (default) and 8.
  • mediumid – The medium id up to 3 digits.
  • password – The password registered at DATEV, usually unused.
add(inputinfo='', accountingno=None, **data)

Adds a new accounting entry.

Each entry is added to a DATEV data file, grouped by a combination of inputinfo, accountingno, year of booking date and entry type.

Parameters:
  • inputinfo – Some information string about the passed entry. For each different value of inputinfo a new file is generated. It can be an alpha-numeric value up to 16 characters (optional).
  • accountingno – The accounting number (Abrechnungsnummer) this entry is assigned to. For accounting records it can be an integer between 1 and 69 (default is 1), for debtor and creditor core data it is set to 189.

Fields for accounting entries:

Parameters:
  • debitaccount – The debit account (Sollkonto) mandatory
  • creditaccount – The credit account (Gegen-/Habenkonto) mandatory
  • amount – The posting amount mandatory
  • date – The booking date. Must be a date object or an ISO8601 formatted string. mandatory
  • voucherfield1 – Usually the invoice number (Belegfeld1) [12]
  • voucherfield2 – The due date in form of DDMMYY or the payment term id, mostly unused (Belegfeld2) [12]
  • postingtext – The posting text. Usually the debtor/creditor name (Buchungstext) [30]
  • accountingkey

    DATEV accounting key consisting of adjustment key and tax key.

    Adjustment keys (Berichtigungsschlüssel):

    • 1: Steuerschlüssel bei Buchungen mit EU-Tatbestand
    • 2: Generalumkehr
    • 3: Generalumkehr bei aufzuteilender Vorsteuer
    • 4: Aufhebung der Automatik
    • 5: Individueller Umsatzsteuerschlüssel
    • 6: Generalumkehr bei Buchungen mit EU-Tatbestand
    • 7: Generalumkehr bei individuellem Umsatzsteuerschlüssel
    • 8: Generalumkehr bei Aufhebung der Automatik
    • 9: Aufzuteilende Vorsteuer

    Tax keys (Steuerschlüssel):

    • 1: Umsatzsteuerfrei (mit Vorsteuerabzug)
    • 2: Umsatzsteuer 7%
    • 3: Umsatzsteuer 19%
    • 4: n/a
    • 5: Umsatzsteuer 16%
    • 6: n/a
    • 7: Vorsteuer 16%
    • 8: Vorsteuer 7%
    • 9: Vorsteuer 19%
  • discount – Discount for early payment (Skonto)
  • costcenter1 – Cost center 1 (Kostenstelle 1) [8]
  • costcenter2 – Cost center 2 (Kostenstelle 2) [8]
  • vatid – The VAT-ID (USt-ID) [15]
  • eutaxrate – The EU tax rate (EU-Steuersatz)
  • currency – Currency, default is EUR (Währung) [4]
  • exchangerate – Currency exchange rate (Währungskurs)

Fields for debtor and creditor core data:

Parameters:
  • account – Account number mandatory
  • name1 – Name1 [20] mandatory
  • name2 – Name2 [20]
  • customerid – The customer id [15]
  • title

    Title [1]

    • 1: Herrn/Frau/Frl./Firma
    • 2: Herrn
    • 3: Frau
    • 4: Frl.
    • 5: Firma
    • 6: Eheleute
    • 7: Herrn und Frau
  • street – Street [36]
  • postbox – Post office box [10]
  • postcode – Postal code [10]
  • city – City [30]
  • country – Country code, ISO-3166 [2]
  • phone – Phone [20]
  • fax – Fax [20]
  • email – Email [60]
  • vatid – VAT-ID [15]
  • bankname – Bank name [27]
  • bankaccount – Bank account number [10]
  • bankcode – Bank code [8]
  • iban – IBAN [34]
  • bic – BIC [11]
adviserid

Datev adviser number (read-only)

advisername

Datev adviser name (read-only)

as_dict()

Generates the DATEV files and returns them as a dictionary.

The keys represent the file names and the values the corresponding file data.

clientid

Datev client number (read-only)

dfv

Datev DFV label (read-only)

kne

Length of accounting numbers (read-only)

mediumid

Data medium id (read-only)

password

Datev password (read-only)

save(path)

Generates and saves all DATEV files.

Parameters:path – If path ends with the extension .zip, all files are stored in this archive. Otherwise the files are saved in a folder.

Kann ich
  Ihnen helfen?


Schreiben Sie mir
doch einfach unter
giraffe@joonis.de