VI&VA-Interface
Introduction Content Content 1. Introduction 3 2. History 3 3. VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 3 4. VI&VA-Interface for CodX PostOffice V2013.11 13 5. VI&VA-Interface for CodX PostOffice V2014 and higher 24 6. Contact 33 Document no: D#39832 Version: 4/16/2014 2
VI&VA-Interface VI&VA-Interface Introduction 1. Introduction This document describes the implementation of the VI&VA interface. The implementation depends on the version of CodX PostOffice. 2. History Version Date Changes 1.0 16.1.2014 Initial edition 1.1 27.1.2014 Unsupported fields in SEPA mandate export in V2013.06 and V2013.09 removed. 1.2 14.4.2014 Changes in pdf file name 3. VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 3.1. Standard SEPA mandate import/export 3.1.1. Technology This section gives an overview how this interface is available. Module MS Access Import/Export Server 3.1.2. Basis for the Data Transfer The individual pieces of data are exchanged using semicolon-separated value (csv) files. 3.1.2.1. General rules for CSV files The file based data transfer takes place per the following rules: Record separator: CR/LF Field separator: Semicolon (;) Character set: as defined in transformation rule (default is UTF-8) Header: Export with header; Import without header 3.1.3. Field Types s: Date: Time: Date / : Money: In quotes ("). If the string contains quotes, these must be entered twice ("").Multiple fields within one text field (e.g. address) are to be separated by \n In parentheses the maximum allowed amount of characters is provided. Without quotes ("). Format is YYYY.MM.DD Year.Month.Day Without quotes ("). Format is HH:MM:SS Hours:Minutes:Seconds Without quotes ("). Format is YYYY.MM.DD HH:MM:SS Year.Month.Day Hours:Minutes:Seconds Without quotes ("). Format XX.XXXX. Period is used as decimal separator. Always 4 decimal places 3
VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 VI&VA-Interface Float: Integer: Without quotes ("). Format XX.XXX. Period is used as decimal separator. thousands separator. Decimal places variable. Without quotes ("). Format XXXXXXX. Only the numbers 0 through 9 are permitted. 3.1.4. File Names Any file name can be used, but the extension must be.csv. The desired file names can be defined in the job engine. For the import, there is a single attribute for the file path and name. For the export, there are two attributes. One for the path and one for the file name. The file name is packed into a query (DataSQL) and may be changed there. But if you do so, please make sure, you do not change the sense of the query. If you are unsure, please contact our Support. 3.1.5. Interface Description With the KV module, CodX PostOffice offers the option of editing and generating mandate. This document describes the standard CodX PostOffice interfaces. In case the mandates are administered in the financial accounting, the can be imported into CodX PostOffice. If they are administered in CodX PostOffice, they can be exported for the financial accounting. 3.1.6. Import The following rules apply for the import: Only data that has been imported or are marked as imported or undefined will be overwritten or deleted SEPAMandatereference is the unique key for the import. Using this identifier, existing information will be updated. Per day and customer, only one mandate is allowed. In case of missing or invalid information for a MUST attribute (i.e. SEPAType, Status), the according data record will not be imported. The same will happen, if none of the following attributes is given: CustomerUPOC, CustomerNr or CustomerExtNr. In case of missing information in the parameter PretificationDeadline, this will not be updated or if it is a new data record set to the default value (14). This value must not be higher than 14 days. At the end of the import, only those mandates will be deleted, that are marked as imported but have not been updated/imported again. The state may be set to any valid value. LastUsed Date will only be updated if it is younger. DtMandateStart will be updated in any case. The setting SEPA (in the "Invoice Definitions" tab of KV) are also updated for customers with imported SEPA mandates. 3.1.6.1. Parameter for SEPA mandate Import. Column Field name Type Content / comment Must 1 1 A SEPAMandatereference Mandate reference (unique key) 2 B CreditorID Creditor ID 1 This column indicates which data is definitely present in CodX PostOffice. If more than this data must be acquired in CodX PostOffice, the customer must be trained to do so. 4
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09. Column Field name Type Content / comment Must 1 3 C CreditorName1 Creditor Name1 4 D CreditorName2 Creditor Name2 5 E CreditorStreet Creditor Street 6 F CreditorPostCode Creditor Postcode 7 G CreditorCity Creditor City 8 H CreditorCountry Creditor Country 9 I SEPAType SEPA Type: -CORE -B2B (business) -(COR1 in the future) 10 J DebitorName1 Debitor Name1 11 K DebitorName2 Debitor Name2 12 L DebitorStreet Debitor Street 13 M DebitorPostcode Debitor Postcode 14 N DebitorCity Debitor City 15 O DebitorCountry Debitor Country 16 P DebitorBankName Debitor Bank Name 17 Q DebitorBIC Debitor BIC 18 R DebitorIBAN Debitor IBAN 19 S MandateStart Date Valid From (signed on) 20 T MandateEnd Date Valid until 21 U PretificationDeadline Integer The prenotification must been sent to the debitor X days before the due date (Default: 14days) 22 V Status Integer The mandate can have 3 status: 0: the mandate is not active 1: the mandate is new and not yet used (like FRST) 2: the mandate was already used (like RCUR) 23 W CustomerUPOC Customer UPOC X 5
VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 VI&VA-Interface. Column Field name Type Content / comment Must 1 24 X CustomerNr Customer number X 25 Y CustomerExtNr Customer external number X 26 Z LastUsed Date / Last Due Date Time 27 AA Comment Comment X: The customer may be defined by the Customer UPOC, customer number or customer external number. One of these values must be given Example 4700000230;DE99ZZZ05678901234;Muster GMBH;;Rosenweg 2;00000;Irgendwo;Deutschland;CORE;Firma XY;;Hauptstr. 6;00000;Irgendwo;Deutschland;BANK OF ;12345678;DE82539098584567987400; 2013.01.16;9999.01.01;14;2;;1067;;2013.01.15 15:35:22;Bemerkung Errors occur during the import in the userlog. Possible Error during SEPA-Mandate import: Description Record with the same SEPA-mandate reference is already exists in the file Customer data are empty! (Nr, UPOC & ExtNr) Customer not found! (not existing or not unique) The customer is not active (validity date)! Empty or invalid attribute exists! (Certain attributes must be available; see AdminDok) The SEPA Mandatereference is already exists for a SEPA mandate that was not imported! The SEPA Mandatereference has already used for another customer! There already exists a SEPA mandate for the customer and day! The SEPA-Mandatereference is not an UPOC of type customer document (47)! 3.1.7. Export All mandates that are documented in CodX PostOffice will be exported. 3.1.7.1. Parameter for SEPA mandate Export. Column Field name Type Content / comment 1 A SEPAMandatereference Mandate reference (unique key) 2 B CreditorID Creditor ID 3 C CreditorName1 Creditor Name1 4 D CreditorName2 Creditor Name2 5 E CreditorStreet Creditor Street 6 F CreditorPostCode Creditor Postcode 7 G CreditorCity Creditor City 6
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09. Column Field name Type Content / comment 8 H CreditorCountry Creditor Country 9 I SEPAType SEPA Type: -CORE -B2B (business) -(COR1 in the future) 10 J DebitorName1 Debitor Name1 11 K DebitorName2 Debitor Name2 12 L DebitorStreet Debitor Street 13 M DebitorPostcode Debitor Postcode 14 N DebitorCity Debitor City 15 O DebitorCountry Debitor Country 16 P DebitorBankName Debitor Bank Name 17 Q DebitorBIC Debitor BIC 18 R DebitorIBAN Debitor IBAN 19 S MandateStart Date Valid From (signed on) 20 T MandateEnd Date Valid until 21 U PretificationDeadline Integer The prenotification must been sent to the debitor X days before the due date (Default: 14days) 22 V Status Integer The mandate can have 3 status: 0: the mandate is not active 1: the mandate is new and not yet used (like FRST) 2: the mandate was already used (like RCUR) 23 W CustomerUPOC Customer UPOC 24 X CustomerNr Customer number 25 Y CustomerExtNr Customer external number 26 Z CustomerDebitor Customer debitor number 27 AA LastUsed Date / Last Due Date Time 28 AB Comment Comment 7
VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 VI&VA-Interface 3.2. Standard Financial Accounting 3.2.1. Technology This section gives an overview how this interface is available. Module MS Access Import/Export Server 3.2.2. Basis for the Data Transfer The individual pieces of data are exchanged using semicolon-separated value (csv) files. 3.2.2.1. General rules for CSV files The file based data transfer takes place per the following rules: Record separator: CR/LF Field separator: Semicolon (;) Character set: as defined in transformation rule (default is UTF-8) Header: With header 3.2.3. Field Types s: Date: Time: Date / : Money: Float: Integer: In quotes ("). If the string contains quotes, these must be entered twice ("").Multiple fields within one text field (e.g. address) are to be separated by \n In parentheses the maximum allowed amount of characters is provided. Without quotes ("). Format is YYYY.MM.DD Year.Month.Day Without quotes ("). Format is HH:MM:SS Hours:Minutes:Seconds Without quotes ("). Format is YYYY.MM.DD HH:MM:SS Year.Month.Day Hours:Minutes:Seconds Without quotes ("). Format XX.XXXX. Period is used as decimal separator. Always 4 decimal places Without quotes ("). Format XX.XXX. Period is used as decimal separator. thousands separator. Decimal places variable. Without quotes ("). Format XXXXXXX. Only the numbers 0 through 9 are permitted. 3.2.4. File Names Any file name can be used, but the extension must be.csv. The desired file name can be defined in the job engine. For the export, there are two attributes. One for the path and one for the file name. The file name is packed into a query (DataSQL) and may be changed there. But if you do so, please make sure, you do not change the sense of the query. If you are unsure, please contact our Support. 3.2.5. Interface Description All invoices that are terminated but not yet exported will be exported. Afterwards they will be marked as exported. The export will contain all of the parameters listed below. 3.2.6. Parameter for FIBU Export. Col. Field name Field name (DE) Type Content / comment 1 A InvoiceID RechnungID Integer PostOffice internal invoice ID 8
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09. Col. Field name Field name (DE) Type Content / comment 2 B Invoice RechnungNr Invoice number 3 C Type RechnungTyp Integer Type of invoice: 0: Invoice 1: Cancellation 2: Credit note 4 D Date RechnungDatum Date / Date the invoice was generated by the invoice run in PostOffice 5 E FromDate RechnungVon Date / Start date of the settlement period 6 F ToDate RechnungBis Date / End date of the settlement period 7 G SumBeforeDiscount RechnungBetrag- VorRabatt Money Unrounded total amount before reductions from discounts 8 H SumBefore- DiscountRound RechnungBetrag- VorRabattRound Money Rounded total amount before reductions from discounts 9 I SumBefore- DiscountDiff RechnungBetrag- VorRabattDiff Money Rounding difference of the amount before discount 10 J TotalDiscountPercent RechnungGesamt- RabattProzent Decimal Percentage rate of the total discount 11 K TotalDiscount- Amount RechnungGesamt- RabattBetrag Money Unrounded amount of the total discount 12 L TotalDiscount- AmountRound RechnungGesamt- RabattBetragRound Money Rounded amount of the total discount 13 M TotalDiscount- AmountDiff RechnungGesamt- RabattBetragDiff Money Rounding difference of the discount amount 14 N TotalVATAmount RechnungTotal- MwstBetrag Money Unrounded total amount of all VAT rates 15 O TotalVATAmount- Round RechnungTotal- MwstBetragRound Money Rounded total amount of all VAT rates 16 P TotalVATAmountDiff RechnungTotal- MwstBetragDiff Money Rounding difference of the total amount of all VAT rates 17 Q EndSum RechnungEndBetrag Money Unrounded total amount 18 R EndSumRound RechnungEnd- Money Rounded total amount BetragRound 19 S EndSumDiff RechnungEndBetrag- Diff Money Rounding difference of the total amount 20 T PaymentPeriodNet RechnungZahlungsfristNetto Integer Payment period for net amount in days 21 U PaymentPeriod- Allowance1 RechnungZahlungsfristSkonto1 Integer Payment period for Allowance1 in days 22 V PaymentPeriod- RechnungSatzSkonto1 Decimal Allowance1 percentage rate PercentAllowance1 23 W SumAllowance1 RechnungBetrag- Money Unrounded Allowance1 amount Skonto1 24 X SumAllowance1- RechnungBetrag- Money Rounded Allowance1 amount Round Skonto1Round 25 Y SumAllowance1Diff RechnungBetrag- Skonto1Diff Money Invoice difference of the Allowance1 amount 26 Z PaymentPeriod- Allowance2 RechnungZahlungsfristSkonto2 Integer Payment period for Allowance2 in days 27 AA PaymentPeriod- RechnungSatzSkonto2 Decimal Allowance2 percentage rate PercentAllowance2 28 AB SumAllowance2 RechnungBetrag- Money Unrounded Allowance2 amount 9
VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment Skonto2 29 AC SumAllowance2- RechnungBetrag- Money Rounded Allowance2 amount Round Skonto2Round 30 AD SumAllowance2Diff RechnungBetrag- Skonto2Diff Money Invoice difference of the Allowance2 amount 31 AE VATRate MwstSatz Decimal VAT percentage rate 32 AF VATName MwstBez Name of the VAT 33 AG VATAccount MwstKontoNr VAT account number 34 AH VATTaxKey MwstSteuerschluessel VAT tax key 35 AI VATNetSum MwstNettoSumme Money Sum of the net amounts of articles for a VAT rate (field name VATrate) 36 AJ VATAmount MwstBetrag Money Unrounded VAT amount for a VAT rate (field name VATrate) 37 AK VATAmountRound MwstBetragRound Money Rounded VAT amount for a VAT rate (field name VATrate) 38 AL VATAmountDiff MwstBetragDiff Money Rounding difference of the VAT amount for a VAT rate (field name VATrate) 39 AM Customer KundeNr 40 AN CustomerExt KundeExtNr 41 AO CustomerUPOC KundeUPOC 42 AP CustomerName KundenName (762) Customer number (for customer data, see Customer export, Customer no.) External Customer number UPOC of the customer Name of the customer (Name1 + Name2 + Name3) 43 AQ VATExempt MWStBefreit Integer Flag for VAT-exempt companies 0 = t VAT-exempt 1 = VAT-exempt 44 AR CustomerDebitor KundeDebitorenNr Debitor number of the customer 45 AS BillingType BillingType Integer Invoice is paid with 0: With Bill 1: With LSV (direct debit) 2: With SEPA 46 AT SEPAMandate- Reference SEPAMandate- Reference 47 AU DebitorAddress DebitorAddress 48 AV DebitorBankName DebitorBankName 49 AW DebitorBIC DebitorBIC 50 AX DebitorBank- Account DebitorBankKontoNr Unique SEPA mandate reference which is communicated to the debitor Address of the debitor Name of the customer s bank Bank Identifiaction Code for SEPA or Routing number of the customers bank for LSV Bank account number of the customer IBAN for SEPA or account number for LSV 10
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09. Col. Field name Field name (DE) Type Content / comment 51 AY CreditorID CreditorID Creditor identification 52 AZ Creditor CreditorAddress Address of the creditor 53 BA DueDate DueDate Date / Due date of the invoice 54 BB SEPATransaction- CutOffTime SEPATransaction- CutOffTime Date / SEPA transaction cut-off It is calculated by DueDate (Attribut 53) CutOffTime (depending on SEPAType, Attribut 9 in SEPA mandate Import/Export). Only working days are taken into account 55 BC SEPAPretification- Date SEPAPretification- Date Date / 56 BD SEPAType SEPAType 57 BE SEPASequenceType SEPASequenceType 58 BF SEPAComment SEPAComment 59 BG MandateStart MandateStart Date / 60 BH StatisticFactor RechnungStatistik- Integer Faktor 61 BI OrgInvoice OriginalRechnung- Nummer 62 BJ FAInvoiceMandantID FARechnungsmandantID 63 BK FAInvoiceMandant- FARech- Name nungsmandantbez- eichnung Integer 64 BL OrderDate Auftragsdatum Date / 65 BM CostCenter KostenstelleNr 66 BN CostCenterExt KostenstelleExtNr 67 BO CostCenterUPOC KostenstelleUPOC 68 BP CostCenterAddress KostenstelleAdresse 69 BQ ServiceName Leistungsbezeichnung 70 BR ServiceUPOC LeistungUPOC Date until the bill is send to the customer CORE, B2B, (in the future COR1) FRST (First bill), RCUR (following bill), FNAL (last bill) Comment of SEPA mandate Mandate is valid since (signed on date) Factor for the calculation of statistics: For invoice: +1 For canceled invoice: -1 For credit note: -1 For canceled credit note: +1 Invoice number of the original invoice for cancellations and invoice copies. The value 0 is passed for the other invoice types. InternalKey for filtering the bill Date of the order Number of the cost center External number of the cost center UPOC of the cost center Address of the cost center Name of the service as it stands in the invoice line. This can be modified from the OriginalLeistungsbezeichung by the user UPOC of the service 11
VI&VA-Interface for CodX PostOffice V2013.06 and V2013.09 VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment 71 BS ArticleName Artikelbezeichnung Name of the article as it stands in the invoice line. This can be modified from the OriginalArtikelbezeichnung by the user 72 BT ArticleShortName ArtikelKurzbezeichung Short name of the article 73 BU Article Artikelnummer Article number 74 BV ArticleUPOC ArtikelUPOC UPOC of the article 75 BW ArticlePrice ArtikelPreis Money Price of an article 76 BX CostUnit KostenträgerNummer Number of the cost unit 77 BY CostUnitName Kostenträger- Bezeichnung Name of the cost unit 78 BZ CostUnitRemark KostenträgerBemerkung 12 Comment on the cost unit 79 CA ProductCategory Warengruppe Name of the product category 80 CB Quantity Menge Decimal Article quantity of this invoice line 81 CC Unit Unit Unit 82 CD PositionDiscount Postitionsrabatt Decimal Discount to this line in % 83 CE PositionRemark Postitionsbemerkung Comment on this line (1024) 84 CF PositionSumNet PositionsSummeNetto Money Unrounded sum of s minus discount (Quantity * ArticlePrice * (100 - PositionDiscount) / 100) 85 CG PositionSumNet- Round PositionsSumme- NettoRound Money Rounded sum of s minus discount (Quantity * ArticlePrice * (100 - PositionDiscount) / 100) Rounding difference of the sum of s 86 CH PositionSumNetDiff PositionsSumme- Money NettoDiff 87 CI VATPositionAmount MwstPositionsBetrag Money Unrounded amount of the VAT for 88 CJ VATPositionAmount- Round MwstPositions- BetragRound Money Rounded amount of the VAT for 89 CK VATPositionAmount- Diff MwstPositions- BetragDiff Money Rounding difference of the amount of the VAT for 90 CL PositionAmount- Allowance1 Skonto1 Money Unrounded Allowance1 amount for 91 CM PositionAmount- Allowance1Round Skonto1Round Money Rounded Allowance1 amount for 92 CN PositionAmount- Allowance1Diff Skonto1Diff Money Invoice difference of the Allowance1 amount for 93 CO PositionAmount- Allowance2 Skonto2 Money Unrounded Allowance2 amount for 94 CP PositionAmount- Allowance2Round Skonto2Round Money Rounded Allowance2 amount for 95 CQ PositionAmount- Allowance2Diff Skonto2Diff Money Invoice difference of the Allowance2 amount for 96 CR RoundingDifference Rundungsdifferenz Money Rounding difference between the final total of the invoice and the
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.11. Col. Field name Field name (DE) Type Content / comment sum of the individual lines 3.2.7. Export of PDF The PDF is also exported. The path is defined in the parameter ExportPfadPDF. To deactivate this function set the parameter Aktiv to 0 in transformation rule (Tag FileExport). When you leave the parameter blank without deactivation the PDFs are saved in the installation path of CodX PostOffice. The file name: [IN- DEX]_[QUELLBUCHUNGSKREIS]_[ARCHIV]_[RECHNUNGSART]_[MANDANT]_[BUCHUNGSKREIS]_[VIVA ]_[JAHRAUSRECHNUNGSDATUM]_[RECHNUNGSNUMMER]_[RECHNUNGSDATUM]_[DEBITORENNR]_[ GPNR].pdf e.g. Index1_VGM0167_AD_RA_001_0167_05_2014_0000730004_23012014_1009632_001.pdf INDEX: Constant: index1 QUELLBUCHUNGSKREIS: Value of the CustField strvivaquellbuchungskreis. ARCHIV: Constant: AD RECHNUNGSART: Constant: RA MANDANT: Value of the CustField strvivamandant. BUCHUNGSKREIS: Value of the CustField strvivabuchungskreis. VIVA: Value of the CustField strvivakennzeichen (default is 05 ). JAHRAUSRECHNUNGSDATUM: The year exeprted from date of the invoice. RECHNUNGSNUMMER: The number of the invoice. RECHNUNGSDATUM: The date of the invoice. Format: DDMMYYYY DEBITORENNR: The first 7 characters of the customer debitor number. GPNR: The last 3 characters of the customer debitor number. The CustFields are in table id (entity) 1033. 4. VI&VA-Interface for CodX PostOffice V2013.11 4.1. Standard SEPA mandate import/export 4.1.1. Technology This section gives an overview how this interface is available. Module MS Access Import/Export Server 4.1.2. Basis for the Data Transfer The individual pieces of data are exchanged using semicolon-separated value (csv) files. 4.1.2.1. General rules for CSV files The file based data transfer takes place per the following rules: Record separator: CR/LF Field separator: Semicolon (;) Character set: as defined in transformation rule (default is UTF-8) Header: Export with header; Import without header 13
VI&VA-Interface for CodX PostOffice V2013.11 VI&VA-Interface 4.1.3. Field Types s: Date: Time: Date / : Money: Float: Integer: In quotes ("). If the string contains quotes, these must be entered twice ("").Multiple fields within one text field (e.g. address) are to be separated by \n In parentheses the maximum allowed amount of characters is provided. Without quotes ("). Format is YYYY.MM.DD Year.Month.Day Without quotes ("). Format is HH:MM:SS Hours:Minutes:Seconds Without quotes ("). Format is YYYY.MM.DD HH:MM:SS Year.Month.Day Hours:Minutes:Seconds Without quotes ("). Format XX.XXXX. Period is used as decimal separator. Always 4 decimal places Without quotes ("). Format XX.XXX. Period is used as decimal separator. thousands separator. Decimal places variable. Without quotes ("). Format XXXXXXX. Only the numbers 0 through 9 are permitted. 4.1.4. File Names Any file name can be used, but the extension must be.csv. The desired file names can be defined in the job engine. For the import, there is a single attribute for the file path and name. For the export, there are two attributes. One for the path and one for the file name. The file name is packed into a query (DataSQL) and may be changed there. But if you do so, please make sure, you do not change the sense of the query. If you are unsure, please contact our Support. 4.1.5. Interface Description With the KV module, CodX PostOffice offers the option of editing and generating mandate. This document describes the standard CodX PostOffice interfaces. In case the mandates are administered in the financial accounting, the can be imported into CodX PostOffice. If they are administered in CodX PostOffice, they can be exported for the financial accounting. 4.1.6. Import The following rules apply for the import: Only data that has been imported or are marked as imported or undefined will be overwritten or deleted SEPAMandatereference is the unique key for the import. Using this identifier, existing information will be updated. Per day and customer, only one mandate is allowed. In case of missing or invalid information for a MUST attribute (i.e. SEPAType, Status), the according data record will not be imported. The same will happen, if none of the following attributes is given: CustomerUPOC, CustomerNr or CustomerExtNr. In case of missing information in the parameter PretificationDeadline, this will not be updated or if it is a new data record set to the default value (14). This value must not be higher than 14 days. At the end of the import, only those mandates will be deleted, that are marked as imported but have not been updated/imported again. The state may be set to any valid value. LastUsed Date will only be updated if it is younger. 14
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.11 DtMandateStart will be updated in any case. The setting SEPA (in the "Invoice Definitions" tab of KV) are also updated for customers with imported SEPA mandates. 4.1.6.1. Parameter for SEPA mandate Import. Column Field name Type Content / comment Must 2 1 A SEPAMandatereference Mandate reference (unique key) 2 B CreditorID Creditor ID 3 C CreditorName1 Creditor Name1 4 D CreditorName2 Creditor Name2 5 E CreditorStreet Creditor Street 6 F CreditorPostCode Creditor Postcode 7 G CreditorCity Creditor City 8 H CreditorCountry Creditor Country 9 I SEPAType SEPA Type: -CORE -B2B (business) -(COR1 in the future) 10 J DebitorName1 Debitor Name1 11 K DebitorName2 Debitor Name2 12 L DebitorStreet Debitor Street 13 M DebitorPostcode Debitor Postcode 14 N DebitorCity Debitor City 15 O DebitorCountry Debitor Country 16 P DebitorBankName Debitor Bank Name 17 Q DebitorBIC Debitor BIC 18 R DebitorIBAN Debitor IBAN 19 S MandateStart Date Valid From (signed on) 20 T MandateEnd Date Valid until 2 This column indicates which data is definitely present in CodX PostOffice. If more than this data must be acquired in CodX PostOffice, the customer must be trained to do so. 15
VI&VA-Interface for CodX PostOffice V2013.11 VI&VA-Interface. Column Field name Type Content / comment Must 2 21 U PretificationDeadline Integer The prenotification must been sent to the debitor X days before the due date (Default: 14days) 22 V Status Integer The mandate can have 3 status: 0: the mandate is not active 1: the mandate is new and not yet used (like FRST) 2: the mandate was already used (like RCUR) 23 W CustomerUPOC Customer UPOC X 24 X CustomerNr Customer number X 25 Y CustomerExtNr Customer external number X 26 Z LastUsed Date / Last Due Date Time 27 AA Comment Comment 28 AB Signing Date Date Contract was signed on Export: 1.1.9999 by for no signing date Import: if empty the date 1.1.9999 will be set 29 AC SignatoryName1 Contract has been signed by: Signatory Name1 30 AD SignatoryName2 Signatory Name2 31 AE SignatoryStreet Signatory Street 32 AF SignatoryPostcode Signatory Postcode 33 AG SignatoryCity Signatory City 34 AH SignatoryCountry Signatory Country X: The customer may be defined by the Customer UPOC, customer number or customer external number. One of these values must be given Example 4700000230;DE99ZZZ05678901234;Muster GMBH;;Rosenweg 2;00000;Irgendwo;Deutschland;CORE;Firma XY;;Hauptstr. 6;00000;Irgendwo;Deutschland;BANK OF ;12345678;DE82539098584567987400; 2013.01.16;9999.01.01;14;2;;1067;;2013.01.15 15:35:22;Bemerkung;;"";"";"";"";"";"" Errors occur during the import in the userlog. Possible Error during SEPA-Mandate import: Description 16
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.11 Description Record with the same SEPA-mandate reference is already exists in the file Customer data are empty! (Nr, UPOC & ExtNr) Customer not found! (not existing or not unique) The customer is not active (validity date)! Empty or invalid attribute exists! (Certain attributes must be available; see AdminDok) The SEPA Mandatereference is already exists for a SEPA mandate that was not imported! The SEPA Mandatereference has already used for another customer! There already exists a SEPA mandate for the customer and day! The SEPA-Mandatereference is not an UPOC of type customer document (47)! 4.1.7. Export All mandates that are documented in CodX PostOffice will be exported. 4.1.7.1. Parameter for SEPA mandate Export. Column Field name Type Content / comment 1 A SEPAMandatereference Mandate reference (unique key) 2 B CreditorID Creditor ID 3 C CreditorName1 Creditor Name1 4 D CreditorName2 Creditor Name2 5 E CreditorStreet Creditor Street 6 F CreditorPostCode Creditor Postcode 7 G CreditorCity Creditor City 8 H CreditorCountry Creditor Country 9 I SEPAType SEPA Type: -CORE -B2B (business) -(COR1 in the future) 10 J DebitorName1 Debitor Name1 11 K DebitorName2 Debitor Name2 12 L DebitorStreet Debitor Street 13 M DebitorPostcode Debitor Postcode 14 N DebitorCity Debitor City 15 O DebitorCountry Debitor Country 16 P DebitorBankName Debitor Bank Name 17
VI&VA-Interface for CodX PostOffice V2013.11 VI&VA-Interface. Column Field name Type Content / comment 17 Q DebitorBIC Debitor BIC 18 R DebitorIBAN Debitor IBAN 19 S MandateStart Date Valid From (signed on) 20 T MandateEnd Date Valid until 21 U PretificationDeadline Integer The prenotification must been sent to the debitor X days before the due date (Default: 14days) 22 V Status Integer The mandate can have 3 status: 0: the mandate is not active 1: the mandate is new and not yet used (like FRST) 2: the mandate was already used (like RCUR) 23 W CustomerUPOC Customer UPOC 24 X CustomerNr Customer number 25 Y CustomerExtNr Customer external number 26 Z CustomerDebitor Customer debitor number 27 AA LastUsed Date / Last Due Date Time 28 AB Comment Comment 29 AC Signing Date Date Contract was signed on Export: 1.1.9999 by for no signing date Import: if empty the date 1.1.9999 will be set 30 AD SignatoryName1 Contract has been signed by: Signatory Name1 31 AE SignatoryName2 Signatory Name2 32 AF SignatoryStreet Signatory Street 33 AG SignatoryPostcode Signatory Postcode 34 AH SignatoryCity Signatory City 35 AI SignatoryCountry Signatory Country 18
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.11 4.2. Standard Financial Accounting 4.2.1. Technology This section gives an overview how this interface is available. Module MS Access Import/Export Server 4.2.2. Basis for the Data Transfer The individual pieces of data are exchanged using semicolon-separated value (csv) files. 4.2.2.1. General rules for CSV files The file based data transfer takes place per the following rules: Record separator: CR/LF Field separator: Semicolon (;) Character set: as defined in transformation rule (default is UTF-8) Header: With header 4.2.3. Field Types s: Date: Time: Date / : Money: Float: Integer: In quotes ("). If the string contains quotes, these must be entered twice ("").Multiple fields within one text field (e.g. address) are to be separated by \n In parentheses the maximum allowed amount of characters is provided. Without quotes ("). Format is YYYY.MM.DD Year.Month.Day Without quotes ("). Format is HH:MM:SS Hours:Minutes:Seconds Without quotes ("). Format is YYYY.MM.DD HH:MM:SS Year.Month.Day Hours:Minutes:Seconds Without quotes ("). Format XX.XXXX. Period is used as decimal separator. Always 4 decimal places Without quotes ("). Format XX.XXX. Period is used as decimal separator. thousands separator. Decimal places variable. Without quotes ("). Format XXXXXXX. Only the numbers 0 through 9 are permitted. 4.2.4. File Names Any file name can be used, but the extension must be.csv. The desired file name can be defined in the job engine. For the export, there are two attributes. One for the path and one for the file name. The file name is packed into a query (DataSQL) and may be changed there. But if you do so, please make sure, you do not change the sense of the query. If you are unsure, please contact our Support. 4.2.5. Interface Description All invoices that are terminated but not yet exported will be exported. Afterwards they will be marked as exported. The export will contain all of the parameters listed below. 4.2.6. Parameter for FIBU Export. Col. Field name Field name (DE) Type Content / comment 1 A InvoiceID RechnungID Integer PostOffice internal invoice ID 19
VI&VA-Interface for CodX PostOffice V2013.11 VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment 2 B Invoice RechnungNr Invoice number 3 C Type RechnungTyp Integer Type of invoice: 0: Invoice 1: Cancellation 2: Credit note 4 D Date RechnungDatum Date / Date the invoice was generated by the invoice run in PostOffice 5 E FromDate RechnungVon Date / Start date of the settlement period 6 F ToDate RechnungBis Date / End date of the settlement period 7 G SumBeforeDiscount RechnungBetrag- VorRabatt Money Unrounded total amount before reductions from discounts 8 H SumBefore- DiscountRound RechnungBetrag- VorRabattRound Money Rounded total amount before reductions from discounts 9 I SumBefore- DiscountDiff RechnungBetrag- VorRabattDiff Money Rounding difference of the amount before discount 10 J TotalDiscountPercent RechnungGesamt- RabattProzent Decimal Percentage rate of the total discount 11 K TotalDiscount- Amount RechnungGesamt- RabattBetrag Money Unrounded amount of the total discount 12 L TotalDiscount- AmountRound RechnungGesamt- RabattBetragRound Money Rounded amount of the total discount 13 M TotalDiscount- AmountDiff RechnungGesamt- RabattBetragDiff Money Rounding difference of the discount amount 14 N TotalVATAmount RechnungTotal- MwstBetrag Money Unrounded total amount of all VAT rates 15 O TotalVATAmount- Round RechnungTotal- MwstBetragRound Money Rounded total amount of all VAT rates 16 P TotalVATAmountDiff RechnungTotal- MwstBetragDiff Money Rounding difference of the total amount of all VAT rates 17 Q EndSum RechnungEndBetrag Money Unrounded total amount 18 R EndSumRound RechnungEnd- Money Rounded total amount BetragRound 19 S EndSumDiff RechnungEndBetrag- Diff Money Rounding difference of the total amount 20 T PaymentPeriodNet RechnungZahlungsfristNetto Integer Payment period for net amount in days 21 U PaymentPeriod- Allowance1 RechnungZahlungsfristSkonto1 Integer Payment period for Allowance1 in days 22 V PaymentPeriod- RechnungSatzSkonto1 Decimal Allowance1 percentage rate PercentAllowance1 23 W SumAllowance1 RechnungBetrag- Money Unrounded Allowance1 amount Skonto1 24 X SumAllowance1- RechnungBetrag- Money Rounded Allowance1 amount Round Skonto1Round 25 Y SumAllowance1Diff RechnungBetrag- Skonto1Diff Money Invoice difference of the Allowance1 amount 26 Z PaymentPeriod- Allowance2 RechnungZahlungsfristSkonto2 Integer Payment period for Allowance2 in days 27 AA PaymentPeriod- RechnungSatzSkonto2 Decimal Allowance2 percentage rate PercentAllowance2 28 AB SumAllowance2 RechnungBetrag- Money Unrounded Allowance2 amount 20
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.11. Col. Field name Field name (DE) Type Content / comment Skonto2 29 AC SumAllowance2- RechnungBetrag- Money Rounded Allowance2 amount Round Skonto2Round 30 AD SumAllowance2Diff RechnungBetrag- Skonto2Diff Money Invoice difference of the Allowance2 amount 31 AE VATRate MwstSatz Decimal VAT percentage rate 32 AF VATName MwstBez Name of the VAT 33 AG VATAccount MwstKontoNr VAT account number 34 AH VATTaxKey MwstSteuerschluessel VAT tax key 35 AI VATNetSum MwstNettoSumme Money Sum of the net amounts of articles for a VAT rate (field name VATrate) 36 AJ VATAmount MwstBetrag Money Unrounded VAT amount for a VAT rate (field name VATrate) 37 AK VATAmountRound MwstBetragRound Money Rounded VAT amount for a VAT rate (field name VATrate) 38 AL VATAmountDiff MwstBetragDiff Money Rounding difference of the VAT amount for a VAT rate (field name VATrate) 39 AM Customer KundeNr 40 AN CustomerExt KundeExtNr 41 AO CustomerUPOC KundeUPOC 42 AP CustomerName KundenName (762) Customer number (for customer data, see Customer export, Customer no.) External Customer number UPOC of the customer Name of the customer (Name1 + Name2 + Name3) 43 AQ VATExempt MWStBefreit Integer Flag for VAT-exempt companies 0 = t VAT-exempt 1 = VAT-exempt 44 AR CustomerDebitor KundeDebitorenNr Debitor number of the customer 45 AS BillingType BillingType Integer Invoice is paid with 0: With Bill 1: With LSV (direct debit) 2: With SEPA 46 AT SEPAMandate- Reference SEPAMandate- Reference 47 AU DebitorAddress DebitorAddress 48 AV DebitorBankName DebitorBankName 49 AW DebitorBIC DebitorBIC 50 AX DebitorBank- Account DebitorBankKontoNr Unique SEPA mandate reference which is communicated to the debitor Address of the debitor Name of the customer s bank Bank Identifiaction Code for SEPA or Routing number of the customers bank for LSV Bank account number of the customer IBAN for SEPA or account number for LSV 21
VI&VA-Interface for CodX PostOffice V2013.11 VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment 51 AY CreditorID CreditorID Creditor identification 52 AZ Creditor CreditorAddress Address of the creditor 53 BA DueDate DueDate Date / Due date of the invoice 54 BB SEPATransaction- CutOffTime SEPATransaction- CutOffTime Date / SEPA transaction cut-off It is calculated by DueDate (Attribut 53) CutOffTime (depending on SEPAType, Attribut 9 in SEPA mandate Import/Export). Only working days are taken into account 55 BC SEPAPretification- Date SEPAPretification- Date Date / 56 BD SEPAType SEPAType 57 BE SEPASequenceType SEPASequenceType 58 BF SEPAComment SEPAComment 59 BG MandateStart MandateStart Date / 60 BH StatisticFactor RechnungStatistik- Integer Faktor 61 BI OrgInvoice OriginalRechnung- Nummer 62 BJ FAInvoiceMandantID FARechnungsmandantID 63 BK FAInvoiceMandant- FARech- Name nungsmandantbez- eichnung Integer 64 BL OrderDate Auftragsdatum Date / 65 BM CostCenter KostenstelleNr 66 BN CostCenterExt KostenstelleExtNr 67 BO CostCenterUPOC KostenstelleUPOC 68 BP CostCenterAddress KostenstelleAdresse 69 BQ ServiceName Leistungsbezeichnung 70 BR ServiceUPOC LeistungUPOC Date until the bill is send to the customer CORE, B2B, (in the future COR1) FRST (First bill), RCUR (following bill), FNAL (last bill) Comment of SEPA mandate Mandate is valid since (signed on date) Factor for the calculation of statistics: For invoice: +1 For canceled invoice: -1 For credit note: -1 For canceled credit note: +1 Invoice number of the original invoice for cancellations and invoice copies. The value 0 is passed for the other invoice types. InternalKey for filtering the bill Date of the order Number of the cost center External number of the cost center UPOC of the cost center Address of the cost center Name of the service as it stands in the invoice line. This can be modified from the OriginalLeistungsbezeichung by the user UPOC of the service 22
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2013.11. Col. Field name Field name (DE) Type Content / comment 71 BS ArticleName Artikelbezeichnung Name of the article as it stands in the invoice line. This can be modified from the OriginalArtikelbezeichnung by the user 72 BT ArticleShortName ArtikelKurzbezeichung Short name of the article 73 BU Article Artikelnummer Article number 74 BV ArticleUPOC ArtikelUPOC UPOC of the article 75 BW ArticlePrice ArtikelPreis Money Price of an article 76 BX CostUnit KostenträgerNummer Number of the cost unit 77 BY CostUnitName Kostenträger- Bezeichnung Name of the cost unit 78 BZ CostUnitRemark KostenträgerBemerkung Comment on the cost unit 79 CA ProductCategory Warengruppe Name of the product category 80 CB Quantity Menge Decimal Article quantity of this invoice line 81 CC Unit Unit Unit 82 CD PositionDiscount Postitionsrabatt Decimal Discount to this line in % 83 CE PositionRemark Postitionsbemerkung Comment on this line (1024) 84 CF PositionSumNet PositionsSummeNetto Money Unrounded sum of s minus discount (Quantity * ArticlePrice * (100 - PositionDiscount) / 100) 85 CG PositionSumNet- Round PositionsSumme- NettoRound Money Rounded sum of s minus discount (Quantity * ArticlePrice * (100 - PositionDiscount) / 100) Rounding difference of the sum of s 86 CH PositionSumNetDiff PositionsSumme- Money NettoDiff 87 CI VATPositionAmount MwstPositionsBetrag Money Unrounded amount of the VAT for 88 CJ VATPositionAmount- Round MwstPositions- BetragRound Money Rounded amount of the VAT for 89 CK VATPositionAmount- Diff MwstPositions- BetragDiff Money Rounding difference of the amount of the VAT for 90 CL PositionAmount- Allowance1 Skonto1 Money Unrounded Allowance1 amount for 91 CM PositionAmount- Allowance1Round Skonto1Round Money Rounded Allowance1 amount for 92 CN PositionAmount- Allowance1Diff Skonto1Diff Money Invoice difference of the Allowance1 amount for 93 CO PositionAmount- Allowance2 Skonto2 Money Unrounded Allowance2 amount for 94 CP PositionAmount- Allowance2Round Skonto2Round Money Rounded Allowance2 amount for 95 CQ PositionAmount- Allowance2Diff Skonto2Diff Money Invoice difference of the Allowance2 amount for 96 CR RoundingDifference Rundungsdifferenz Money Rounding difference between the final total of the invoice and the 23
VI&VA-Interface for CodX PostOffice V2014 and higher VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment sum of the individual lines 4.2.7. Export of PDF The PDF is also exported. The path is defined in the parameter ExportPfadPDF. To deactivate this function set the parameter Aktiv to 0 in transformation rule (Tag FileExport). When you leave the parameter blank without deactivation the PDFs are saved in the installation path of CodX PostOffice. The file name: [IN- DEX]_[QUELLBUCHUNGSKREIS]_[ARCHIV]_[RECHNUNGSART]_[MANDANT]_[BUCHUNGSKREIS]_[VIVA ]_[JAHRAUSRECHNUNGSDATUM]_[RECHNUNGSNUMMER]_[RECHNUNGSDATUM]_[DEBITORENNR]_[ GPNR].pdf e.g. Index1_VGM0167_AD_RA_001_0167_05_2014_0000730004_23012014_1009632_001.pdf INDEX: Constant: index1 QUELLBUCHUNGSKREIS: Value of the CustField strvivaquellbuchungskreis. ARCHIV: Constant: AD RECHNUNGSART: Constant: RA MANDANT: Value of the CustField strvivamandant. BUCHUNGSKREIS: Value of the CustField strvivabuchungskreis. VIVA: Value of the CustField strvivakennzeichen (default is 05 ). JAHRAUSRECHNUNGSDATUM: The year exeprted from date of the invoice. RECHNUNGSNUMMER: The number of the invoice. RECHNUNGSDATUM: The date of the invoice. Format: DDMMYYYY DEBITORENNR: The first 7 characters of the customer debitor number. GPNR: The last 3 characters of the customer debitor number. The CustFields are in table id (entity) 1033. 5. VI&VA-Interface for CodX PostOffice V2014 and higher 5.1. Standard SEPA mandate import/export 5.1.1. Technology This section gives an overview how this interface is available. Module MS Access Import/Export Server 5.1.2. Basis for the Data Transfer The individual pieces of data are exchanged using semicolon-separated value (csv) files. 5.1.2.1. General rules for CSV files The file based data transfer takes place per the following rules: Record separator: CR/LF Field separator: Semicolon (;) Character set: as defined in transformation rule (default is UTF-8) Header: Export with header; Import without header 5.1.3. Field Types s: In quotes ("). If the string contains quotes, these must be entered twice ("").Multiple fields within one text field (e.g. address) are to be separat- 24
VI&VA-Interface Date: Time: Date / : Money: Float: Integer: VI&VA-Interface for CodX PostOffice V2014 and higher ed by \n In parentheses the maximum allowed amount of characters is provided. Without quotes ("). Format is YYYY.MM.DD Year.Month.Day Without quotes ("). Format is HH:MM:SS Hours:Minutes:Seconds Without quotes ("). Format is YYYY.MM.DD HH:MM:SS Year.Month.Day Hours:Minutes:Seconds Without quotes ("). Format XX.XXXX. Period is used as decimal separator. Always 4 decimal places Without quotes ("). Format XX.XXX. Period is used as decimal separator. thousands separator. Decimal places variable. Without quotes ("). Format XXXXXXX. Only the numbers 0 through 9 are permitted. 5.1.4. File Names Any file name can be used, but the extension must be.csv. The desired file names can be defined in the job engine. For the import, there is a single attribute for the file path and name. For the export, there are two attributes. One for the path and one for the file name. The file name is packed into a query (DataSQL) and may be changed there. But if you do so, please make sure, you do not change the sense of the query. If you are unsure, please contact our Support. 5.1.5. Interface Description With the KV module, CodX PostOffice offers the option of editing and generating mandate. This document describes the standard CodX PostOffice interfaces. In case the mandates are administered in the financial accounting, the can be imported into CodX PostOffice. If they are administered in CodX PostOffice, they can be exported for the financial accounting. 5.1.6. Import The following rules apply for the import: Only data that has been imported or are marked as imported or undefined will be overwritten or deleted SEPAMandatereference is the unique key for the import. Using this identifier, existing information will be updated. Per day and customer, only one mandate is allowed. In case of missing or invalid information for a MUST attribute (i.e. SEPAType, Status), the according data record will not be imported. The same will happen, if none of the following attributes is given: CustomerUPOC, CustomerNr or CustomerExtNr. In case of missing information in the parameter PretificationDeadline, this will not be updated or if it is a new data record set to the default value (14). This value must not be higher than 14 days. At the end of the import, only those mandates will be deleted, that are marked as imported but have not been updated/imported again. The state may be set to any valid value. LastUsed Date will only be updated if it is younger. DtMandateStart will be updated in any case. The setting SEPA (in the "Invoice Definitions" tab of KV) are also updated for customers with imported SEPA mandates. 25
VI&VA-Interface for CodX PostOffice V2014 and higher VI&VA-Interface 5.1.7. Export All mandates that are documented in CodX PostOffice will be exported. 5.1.8. Parameter for SEPA mandate Import/Export. Column Field name Type Content / comment Must 3 1 A SEPAMandatereference Mandate reference (unique key) 2 B CreditorID Creditor ID 3 C CreditorName1 Creditor Name1 4 D CreditorName2 Creditor Name2 5 E CreditorStreet Creditor Street 6 F CreditorPostCode Creditor Postcode 7 G CreditorCity Creditor City 8 H CreditorCountry Creditor Country 9 I SEPAType SEPA Type: -CORE -B2B (business) -(COR1 in the future) 10 J DebitorName1 Debitor Name1 11 K DebitorName2 Debitor Name2 12 L DebitorStreet Debitor Street 13 M DebitorPostcode Debitor Postcode 14 N DebitorCity Debitor City 15 O DebitorCountry Debitor Country 16 P DebitorBankName Debitor Bank Name 17 Q DebitorBIC Debitor BIC 18 R DebitorIBAN Debitor IBAN 19 S MandateStart Date Valid From (signed on) 20 T MandateEnd Date Valid until 21 U Pretifica- Integer The prenotification must been sent 3 This column indicates which data is definitely present in PostOffice. If more than this data must be acquired in PostOffice, the customer must be trained to do so. 26
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2014 and higher. Column Field name Type Content / comment Must 3 tiondeadline to the debitor X days before the due date (Default: 14days) 22 V Status Integer The mandate can have 3 status: 0: the mandate is not active 1: the mandate is new and not yet used (like FRST) 2: the mandate was already used (like RCUR) 23 W CustomerUPOC Customer UPOC X 24 X CustomerNr Customer number X 25 Y CustomerExtNr Customer external number X 26 Z CustomerDebitor Customer debitor number X 27 AA LastUsed Date / Last Due Date Time 28 AB Comment Comment 29 AC Signing Date Date Contract was signed on Export: 1.1.9999 by for no signing date Import: if empty the date 1.1.9999 will be set 30 AD SignatoryName1 Contract has been signed by: Signatory Name1 31 AE SignatoryName2 Signatory Name2 32 AF SignatoryStreet Signatory Street 33 AG SignatoryPostcode Signatory Postcode 34 AH SignatoryCity Signatory City 35 AI SignatoryCountry Signatory Country X: The customer may be defined by the Customer UPOC, customer number, customer external number or customer debitor number. One of these values must be given and it must be unique. Example 4700000230;DE99ZZZ05678901234;Muster GMBH;;Rosenweg 2;00000;Irgendwo;Deutschland;CORE;Firma XY;;Hauptstr. 6;00000;Irgendwo;Deutschland;BANK OF ;12345678;DE82539098584567987400; 2013.01.16;9999.01.01;14;2;;1067;;2013.01.15 15:35:22;Bemerkung;;"";"";"";"";"";"" Errors occur during the import in the userlog. Possible Error during SEPA-Mandate import: 27
VI&VA-Interface for CodX PostOffice V2014 and higher VI&VA-Interface Description Record with the same SEPA-mandate reference is already exists in the file Customer data are empty! (Nr, UPOC & ExtNr) Customer not found! (not existing or not unique) The customer is not active (validity date)! Empty or invalid attribute exists! (Certain attributes must be available; see AdminDok) The SEPA Mandatereference is already exists for a SEPA mandate that was not imported! The SEPA Mandatereference has already used for another customer! There already exists a SEPA mandate for the customer and day! The SEPA-Mandatereference is not an UPOC of type customer document (47)! 5.2. Standard Financial Accounting 5.2.1. Technology This section gives an overview how this interface is available. Module MS Access Import/Export Server 5.2.2. Basis for the Data Transfer The individual pieces of data are exchanged using semicolon-separated value (csv) files. 5.2.2.1. General rules for CSV files The file based data transfer takes place per the following rules: Record separator: CR/LF Field separator: Semicolon (;) Character set: as defined in transformation rule (default is UTF-8) Header: With header 5.2.3. Field Types s: Date: Time: Date / : Money: Float: Integer: In quotes ("). If the string contains quotes, these must be entered twice ("").Multiple fields within one text field (e.g. address) are to be separated by \n In parentheses the maximum allowed amount of characters is provided. Without quotes ("). Format is YYYY.MM.DD Year.Month.Day Without quotes ("). Format is HH:MM:SS Hours:Minutes:Seconds Without quotes ("). Format is YYYY.MM.DD HH:MM:SS Year.Month.Day Hours:Minutes:Seconds Without quotes ("). Format XX.XXXX. Period is used as decimal separator. Always 4 decimal places Without quotes ("). Format XX.XXX. Period is used as decimal separator. thousands separator. Decimal places variable. Without quotes ("). Format XXXXXXX. Only the numbers 0 through 9 are permitted. 5.2.4. File Names Any file name can be used, but the extension must be.csv. The desired file name can be defined in the job engine. For the export, there are two attributes. One for the path and one for the file name. The file name is packed into a query (DataSQL) and may be changed there. But if you do so, please 28
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2014 and higher make sure, you do not change the sense of the query. If you are unsure, please contact our Support. 5.2.5. Interface Description All invoices that are terminated but not yet exported will be exported. Afterwards they will be marked as exported. The export will contain all of the parameters listed below. 5.2.6. Parameter for FIBU Export. Col. Field name Field name (DE) Type Content / comment 1 A InvoiceID RechnungID Integer PostOffice internal invoice ID 2 B Invoice RechnungNr Invoice number 3 C Type RechnungTyp Integer Type of invoice: 0: Invoice 1: Cancellation 2: Credit note 4 D Date RechnungDatum Date / Date the invoice was generated by the invoice run in PostOffice 5 E FromDate RechnungVon Date / Start date of the settlement period 6 F ToDate RechnungBis Date / End date of the settlement period 7 G SumBeforeDiscount RechnungBetrag- VorRabatt Money Unrounded total amount before reductions from discounts 8 H SumBefore- DiscountRound RechnungBetrag- VorRabattRound Money Rounded total amount before reductions from discounts 9 I SumBefore- DiscountDiff RechnungBetrag- VorRabattDiff Money Rounding difference of the amount before discount 10 J TotalDiscountPercent RechnungGesamt- RabattProzent Decimal Percentage rate of the total discount 11 K TotalDiscount- Amount RechnungGesamt- RabattBetrag Money Unrounded amount of the total discount 12 L TotalDiscount- AmountRound RechnungGesamt- RabattBetragRound Money Rounded amount of the total discount 13 M TotalDiscount- AmountDiff RechnungGesamt- RabattBetragDiff Money Rounding difference of the discount amount 14 N TotalVATAmount RechnungTotal- MwstBetrag Money Unrounded total amount of all VAT rates 15 O TotalVATAmount- Round RechnungTotal- MwstBetragRound Money Rounded total amount of all VAT rates 16 P TotalVATAmountDiff RechnungTotal- MwstBetragDiff Money Rounding difference of the total amount of all VAT rates 17 Q EndSum RechnungEndBetrag Money Unrounded total amount 18 R EndSumRound RechnungEnd- Money Rounded total amount BetragRound 19 S EndSumDiff RechnungEndBetrag- Diff Money Rounding difference of the total amount 20 T PaymentPeriodNet RechnungZahlungsfristNetto Integer Payment period for net amount in days 21 U PaymentPeriod- Allowance1 RechnungZahlungsfristSkonto1 Integer Payment period for Allowance1 in days 22 V PaymentPeriod- PercentAllowance1 RechnungSatzSkonto1 Decimal Allowance1 percentage rate 29
VI&VA-Interface for CodX PostOffice V2014 and higher VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment 23 W SumAllowance1 RechnungBetrag- Money Unrounded Allowance1 amount Skonto1 24 X SumAllowance1- RechnungBetrag- Money Rounded Allowance1 amount Round Skonto1Round 25 Y SumAllowance1Diff RechnungBetrag- Skonto1Diff Money Invoice difference of the Allowance1 amount 26 Z PaymentPeriod- Allowance2 RechnungZahlungsfristSkonto2 Integer Payment period for Allowance2 in days 27 AA PaymentPeriod- RechnungSatzSkonto2 Decimal Allowance2 percentage rate PercentAllowance2 28 AB SumAllowance2 RechnungBetrag- Skonto2 Money Unrounded Allowance2 amount 29 AC SumAllowance2- Round RechnungBetrag- Skonto2Round Money Rounded Allowance2 amount 30 AD SumAllowance2Diff RechnungBetrag- Skonto2Diff Money Invoice difference of the Allowance2 amount 31 AE VATRate MwstSatz Decimal VAT percentage rate 32 AF VATName MwstBez Name of the VAT 33 AG VATAccount MwstKontoNr VAT account number 34 AH VATTaxKey MwstSteuerschluessel VAT tax key 35 AI VATNetSum MwstNettoSumme Money Sum of the net amounts of articles for a VAT rate (field name VATrate) 36 AJ VATAmount MwstBetrag Money Unrounded VAT amount for a VAT rate (field name VATrate) 37 AK VATAmountRound MwstBetragRound Money Rounded VAT amount for a VAT rate (field name VATrate) 38 AL VATAmountDiff MwstBetragDiff Money Rounding difference of the VAT amount for a VAT rate (field name VATrate) 39 AM Customer KundeNr 40 AN CustomerExt KundeExtNr 41 AO CustomerUPOC KundeUPOC 42 AP CustomerName KundenName (762) Customer number (for customer data, see Customer export, Customer no.) External Customer number UPOC of the customer Name of the customer (Name1 + Name2 + Name3) 43 AQ VATExempt MWStBefreit Integer Flag for VAT-exempt companies 0 = t VAT-exempt 1 = VAT-exempt 44 AR CustomerDebitor KundeDebitorenNr Debitor number of the customer 45 AS BillingType BillingType Integer Invoice is paid with 0: With Bill 1: With LSV (direct debit) 2: With SEPA 46 AT SEPAMandate- Reference SEPAMandate- Reference Unique SEPA mandate reference which is communicated to the debitor 47 AU DebitorAddress DebitorAddress Address of the debitor 30
VI&VA-Interface VI&VA-Interface for CodX PostOffice V2014 and higher. Col. Field name Field name (DE) Type Content / comment 48 AV DebitorBankName DebitorBankName Name of the customer s bank 49 AW DebitorBIC DebitorBIC Bank Identifiaction Code for SEPA or Routing number of the customers bank for LSV 50 AX DebitorBank- Account DebitorBankKontoNr 51 AY CreditorID CreditorID 52 AZ Creditor CreditorAddress 53 BA DueDate DueDate Date / 54 BB SEPATransaction- CutOffTime 55 BC SEPAPretification- Date SEPATransaction- CutOffTime SEPAPretification- Date Date / Date / 56 BD SEPAType SEPAType 57 BE SEPASequenceType SEPASequenceType 58 BF SEPAComment SEPAComment 59 BG MandateStart MandateStart Date / 60 BH StatisticFactor RechnungStatistik- Integer Faktor 61 BI OrgInvoice OriginalRechnung- Nummer 62 BJ FAInvoiceMandantID FARechnungsmandantID 63 BK FAInvoiceMandant- FARech- Name nungsmandantbez- eichnung Integer Bank account number of the customer IBAN for SEPA or account number for LSV Creditor identification Address of the creditor Due date of the invoice SEPA transaction cut-off It is calculated by DueDate (Attribut 53) CutOffTime (depending on SEPAType, Attribut 9 in SEPA mandate Import/Export). Only working days are taken into account Date until the bill is send to the customer CORE, B2B, (in the future COR1) FRST (First bill), RCUR (following bill), FNAL (last bill) Comment of SEPA mandate Mandate is valid since (signed on date) Factor for the calculation of statistics: For invoice: +1 For canceled invoice: -1 For credit note: -1 For canceled credit note: +1 Invoice number of the original invoice for cancellations and invoice copies. The value 0 is passed for the other invoice types. InternalKey for filtering the bill 64 BL OrderDate Auftragsdatum Date / Date of the order 65 BM CostCenter KostenstelleNr Number of the cost center 66 BN CostCenterExt KostenstelleExtNr External number of the cost center 31
VI&VA-Interface for CodX PostOffice V2014 and higher VI&VA-Interface. Col. Field name Field name (DE) Type Content / comment 67 BO CostCenterUPOC KostenstelleUPOC UPOC of the cost center 68 BP CostCenterAddress KostenstelleAdresse Address of the cost center 69 BQ ServiceName Leistungsbezeichnung Name of the service as it stands in the invoice line. This can be modified from the OriginalLeistungsbezeichung by the user 70 BR ServiceUPOC LeistungUPOC UPOC of the service 71 BS ArticleName Artikelbezeichnung 72 BT ArticleShortName ArtikelKurzbezeichung 73 BU Article Artikelnummer 74 BV ArticleUPOC ArtikelUPOC Name of the article as it stands in the invoice line. This can be modified from the OriginalArtikelbezeichnung by the user Short name of the article Article number UPOC of the article 75 BW ArticlePrice ArtikelPreis Money Price of an article 76 BX CostUnit KostenträgerNummer Number of the cost unit 77 BY CostUnitName Kostenträger- Name of the cost unit Bezeichnung 78 BZ CostUnitRemark KostenträgerBemerkung Comment on the cost unit 79 CA ProductCategory Warengruppe Name of the product category 80 CB Quantity Menge Decimal Article quantity of this invoice line 81 CC Unit Unit Unit 82 CD PositionDiscount Postitionsrabatt Decimal Discount to this line in % 83 CE PositionRemark Postitionsbemerkung Comment on this line (1024) 84 CF PositionSumNet PositionsSummeNetto Money Unrounded sum of s minus discount (Quantity * ArticlePrice * (100 - PositionDiscount) / 100) 85 CG PositionSumNet- Round PositionsSumme- NettoRound Money Rounded sum of s minus discount (Quantity * ArticlePrice * (100 - PositionDiscount) / 100) Rounding difference of the sum of s 86 CH PositionSumNetDiff PositionsSumme- Money NettoDiff 87 CI VATPositionAmount MwstPositionsBetrag Money Unrounded amount of the VAT for 88 CJ VATPositionAmount- Round 89 CK VATPositionAmount- Diff 90 CL PositionAmount- Allowance1 MwstPositions- BetragRound MwstPositions- BetragDiff Skonto1 Money Money Money Rounded amount of the VAT for Rounding difference of the amount of the VAT for Unrounded Allowance1 amount for 32
VI&VA-Interface Contact. Col. Field name Field name (DE) Type Content / comment 91 CM PositionAmount- Allowance1Round Skonto1Round Money Rounded Allowance1 amount for 92 CN PositionAmount- Allowance1Diff Skonto1Diff Money Invoice difference of the Allowance1 amount for 93 CO PositionAmount- Allowance2 Skonto2 Money Unrounded Allowance2 amount for 94 CP PositionAmount- Allowance2Round Skonto2Round Money Rounded Allowance2 amount for 95 CQ PositionAmount- Allowance2Diff Skonto2Diff Money Invoice difference of the Allowance2 amount for 96 CR RoundingDifference Rundungsdifferenz Money Rounding difference between the final total of the invoice and the sum of the individual lines 5.2.7. Export of PDF The PDF is also exported. The path is defined in the parameter ExportPfadPDF. To deactivate this function set the parameter Aktiv to 0 in transformation rule (Tag FileExport). When you leave the parameter blank without deactivation the PDFs are saved in the installation path of CodX PostOffice. The file name: [IN- DEX]_[QUELLBUCHUNGSKREIS]_[ARCHIV]_[RECHNUNGSART]_[MANDANT]_[BUCHUNGSKREIS]_[VIVA ]_[JAHRAUSRECHNUNGSDATUM]_[RECHNUNGSNUMMER]_[RECHNUNGSDATUM]_[DEBITORENNR]_[ GPNR].pdf e.g. Index1_VGM0167_AD_RA_001_0167_05_2014_0000730004_23012014_1009632_001.pdf INDEX: Constant: index1 QUELLBUCHUNGSKREIS: Value of the CustField strvivaquellbuchungskreis. ARCHIV: Constant: AD RECHNUNGSART: Constant: RA MANDANT: Value of the CustField strvivamandant. BUCHUNGSKREIS: Value of the CustField strvivabuchungskreis. VIVA: Value of the CustField strvivakennzeichen (default is 05 ). JAHRAUSRECHNUNGSDATUM: The year exeprted from date of the invoice. RECHNUNGSNUMMER: The number of the invoice. RECHNUNGSDATUM: The date of the invoice. Format: DDMMYYYY DEBITORENNR: The first 7 characters of the customer debitor number. GPNR: The last 3 characters of the customer debitor number. The CustFields are in table id (entity) 1033. 6. Contact CodX Software AG Sinserstrasse 47 6330 Cham Schweiz +41 41 798 11 22 info@codx.ch www.codx.ch 33