Field Offset Field length Description Comments Note = Invoice Header Obligatory Version code File format version V03 or V02 or V04

Transcription

1 Document 1 (5) The structure of MAI.DAT file new version 4.0 New changes are represented by yellow colour (for details see History). File MAI.DAT consists of records of types: Invoice Header and Invoice Line. Each invoice begins from Invoice Header record that is followed by Invoice Line records. Invoice Header record has length 2251 (for old version - 434). Invoice Line record has length 610 Invoice Header record format. (Record Len 1596) Field Offset Field length Description Comments Note = Invoice Header Version code File format version V03 or V02 or V04 To export invoices version V02 is used if in System Table option Code_Type= MaiExpVer has CodeNumber_1 = 2, if CodeNumber_1 = 3 it is used version V03 otherwise it is used version V Vendor number Program adds new vendor if such Vendor number does not exist in vendor Vendor name If Vendor name is empty then Address If Vendor address is empty then Post code If Post code is empty then program taken it Contact Person If Contact Person is empty then Vendor bank account If bank account is empty and IBAN is Finish bank then program takes bank account from IBAN. If bank account and IBAN are empty then program takes it from vendor If bank account is invalid then Reference number If reference number is invalid then the incorrect reference number transferred to field Viesti /Message with information text: Virheellinen viite: xxxxxxx / Incorrect reference number: xxxxxx. Program puts corresponding message to protocol about this Luettu virheellinen viitenumero viestikenttään / Incorrect reference number has been put to field Message. To the end of protocol report added information text for user: Korjaa ostolaskujen virheelliset viitenumero / Repair incorrect reference numbers of purchases Currency If Currency is empty then program takes Home currency.

2 Document 2 (5) Invoice Number After import pprogram assigns new invoice number DDMMYYYY Invoice date If invoice date is empty then program takes system date Message When both reference number and message are missing than program fills it vendor s invoice number Invoice Type 1 = ordinary 2 = credit DDMMYYYY Due day Invoice due day. If empty then due day is calculated based on vendor s payment terms External transaction number to identify invoice in archive Invoice s URL address Invoice status 0 unaccepted 1 - on hold 2 accepted DDMMYYYY BK-date If BK-date is empty then program takes invoice date Vendor's invoice number If it is empty, then invoice number field is used Code of payment term If Code of Payment is empty or isn t defined in payment term then program takes it from vendor or general defaults Description of payment term If Terms of Payment is empty then program takes it from selected payment term Days of payment If Days, DaysPercent and IntrRate term V04 this field is empty. If same invoice is imported again with different status then program changes status accordingly and contact information (vendor name, vendor address, post code).if they are different. If imported invoice has status greater then current one program replaces the invoice lines. If invoice is imported with same status again then program asks to confirm Invoice already exists. Do you want to create a new invoice? This message is put once. If user answers Yes then program generates new invoice for all such invoices else all such invoices are not imported but contact information of same invoice is updated.

3 Document 3 (5) Discount days If Days, DaysPercent and IntrRate are Empty or zero then program term Discount percent Interest percent If Days, DaysPercent and IntrRate term If Days, DaysPercent and IntrRate term Vendor bank name If it is empty then program takes it Vendor bank address1 If it is empty then program takes it Vendor bank address2 If it is empty then program takes it Vendor bank post If it is empty then program takes it Vendor bank swift code If it is empty then program takes it Country code If it is empty then program takes it Foreign bank account If it is empty then program takes it Foreign payment type M - Maksutapa, P - Express transfer, Q - Group transfer, S - Cheque (send to receiver), T - Cheque (send to sender), K - Oma tilisiirto, C - 0-arvopäivämaksu If it is empty then program takes it Charges J Beneficiary, T Our If it is empty then program takes it Currency rate Format 5.6 without decimal point If it is empty or zero then program takes it from currency by currency field External transaction number 2 If external transaction number 2 is empty then program takes external transaction number Memo If it is empty and reference number field isn t numeric then program takes reference number IBAN If IBAN is empty or invalid or inconsistent with bank account then program generated from bank account If IBAN is invalid or inconsistent with bank account then program puts corresponding message to protocol BIC If BIC is empty then it is generated from IBAN Payment prevention If it is empty then program takes not PaymForbidden 1 PaymForbidden Bank Account Field format can be BBAN or IBAN. If Bank Account is invalid or it does not exist in bank account then message to protocol and ignores it. V04 this field program generated from bank account V04 this field program generated from IBAN

4 Document 4 (5) ExtInvoicePDF If PDF file exists and archive folder is set (Purchasing Setup /General Default /Archive /Archive (scanned invoices) then program copies PDF file in archive folder and saves new name file in invoice. If PDF file doesn t exist then message to protocol and ignores it. If PDF file exists the program copies this file to the folder with the file mai.dat POProjectCode CA1 If it is empty or absent then CA2 If it is empty or absent then CA3 If it is empty or absent then Internal explanation RF reference number If RF reference number is empty, then program used field Reference number. If reference number is invalid then the incorrect reference number transferred to field Viesti /Message with information text: Virheellinen viite: xxxxxxx / Incorrect reference number: xxxxxx. Program puts corresponding message to protocol about this Luettu virheellinen viitenumero viestikenttään / Incorrect reference number has been put to field Message. To the end of protocol report added information text for user: Korjaa ostolaskujen virheelliset viitenumero / Repair incorrect reference numbers of purchases Construction Key If ConstructionKey has invalid format Program adds new ConstructionKey if such ConstructionKey does not exist in Invoice Line record format. (Record Len 64) Field Offset Field length Description Comments Note = Invoice Line Total. Format 11.2 If total is negative then expense account is credit otherwise debit. Negative sign is leading (e.g )

5 VAT sum. Format VAT percent If VAT sum=0 then program calculates its value by Total and VAT percent Expense account If Expense account is Empty then program taken it or general default CA1 If it is empty or absent then program picks up it CA2 If it is empty or absent then program picks up it CA3 If it is empty or absent then program picks up it VAT number A - automatic, VAT priority is used, same when entering lines by hand; <empty > - field VAT percent from line; percent from VAT code with this VAT number is used and accounts are created same way if entered manually Document 5 (5) for version V02 and version V03 if field VAT number is empty During invoice export program puts VAT number corresponding VAT code in VAT If VAT number is 0 but VAT percent<>0 then program puts empty value (space) to file Internal explanation LT-structure line1 If option Laskentatunniste käytössä / LT -Structure In Use is OFF and it is not empty, program ignores it Construction Key If ConstructionKey has invalid format Program adds new ConstructionKey if such ConstructionKey does not exist in Note1. All decimal values into invoice line must be like the field Total (format 11.2 without decimal point, 2 last are decimal. E.g ,50 = ). Decimal point is virtual. Note2. System supports also file MAI.DAT of more old structures. Note3. Program mark imported files to change format version Vnn to Xnn in first line of file. If user select marked file for import then program puts confirmed message File is marked as imported. Do you really want to repeat import? Program not import marked files by automatic mode. It put information in import protocol about this only. Program mark files as imported when these are moved to archived folder. Note4. File MAI_Example\MAIDat_example.dat is sample file.