Description of file format for the domestic payments Multicash PLI

Transcription

1 Description of file format for the domestic payments Multicash PLI 1 Description of file format 1.1 Generic Information The document is dedicated to Customers creating interfaces for PLN (Polish zloty) payments exported from their ERP systems into inord Business. This type of file should be used for PLN payments such as: 1. Standard domestic and internal payments 2. Payments to tax authority (tax payments) 3. VAT (Value Added Tax) payments using SPLIT PAYMNTS mechanism In order to import foreign payments (SWIFT payments) Multicash PLA format should be used. For SEPA payments please use XML Orders format, which can also be used for all types of payments (internal, domestic and foreign). 1.2 Requirements regarding the file 1. The file does not contain the header. 2. One file may contain many payment orders, single payment in one row/line. Each row/line must be separated with the New Line sign <CR><LF>. 3. Text fields must be placed within quotes ( EXAMPLE TEXT ). 4. Each field is separated with comma (,). 5. If a field is composed of several rows (ex. Payment details field: 4*35 char), each row shall be separated with " " (Hex 7C). 6. Only alphanumeric and characters: ()-:,.?/ are allowed. 1.3 Symbols used in file description 1. Field status: M mandatory, O optional 2. Field format: n Numeric only (0-9) a Letters only (a-z, A-Z) c Alphanumeric (0-9, a-z, A-Z) x Alphanumeric and other permitted characters! required specific s of characters Example: 1. 2n up to 2 digits 2. 3!a always 3 letters 3. 4*35x 4 lines up to 35 char each Internet Banking inordbusiness

2 2 Description of file format 2.1 Standard domestic payments File format description Field name Status Format Description Order code M 3!n Order type: 110 for domestic payment and tax payment 120 for Social Security payment (available only to ) 110 Payment date M 8!n Payment date In the format YYYYMMDD Amount M 15n Amount without decimal separators (for PLN) Sender s bank settlement M 8!n Sender s bank settlement (always 8 digits) Zero Field M 1!n Always zero "0" Sender s account M 26!n Account in IBAN or NRB format PL Recipient s account M 26!n Account in IBAN or NRB format PL Sender s data M 4*35x Sender s name and address. 4 subfields (rows) separated with " " (Hex 7C). Field must contain exactly 3 characters as subfield separators. ZAKLADY FRYZJERSKI DAMSKO MESKI UL.WLODARZEWSKA 51H/ WARSZAWA Beneficiary s data M 4*35x Beneficiary s name and address. 4 subfields (rows) separated with " " (Hex 7C). Field must contain exactly 3 characters as subfield separators. HURTOWNIA CHEMICZNA SP. Z O.O. UL. WLOSKA GDAŃSK Zero Field M 1!n Always zero 0 Beneficiary s bank settlement M 8!n Recipient s bank settlement (always 8 digits) Payment description M 4*35x 4 subfields of payment description details separated with " " (Hex 7C). Field must contain exactly 3 characters as subfield separators. ACCORDING TO THE ORDER NO 2013/1501 PLUS INVOICE NO: 2368/2013, 9232/ , 7/2013 Important: for SPLIT payments and Tax payments this field is structures in a dedicated way described below. Blank field O 0 "" Blank field O 0 "" Order classification M 2!n "51" for standard domestic payments and social security payments 53 for SPLIT PAYMENTS "71" for payments to Tax Authorities Customer s Reference 51 O 35x Customers reference presented on statement "REF " Example of file with 3 standard payments order 110, ,531200, ,0," "," ","FIRM A TESTOWA KWIATOWA WARSZAWA","OPAKOWANI SP. Z O.O. UL. ROMUŃSKA Internet Banking inordbusiness

3 GDAŃSK",0, ,"ZAPLATA ZA OPAKOWANIA DO KINESKOPOW 17 I 21 CALI Z NADRUKIEM LOGO FIRMY FVT 2368/ /2002 ","","","51","REF " 110, ,88563, ,0," "," ","FIRMA TESTOWA KWIATOWA WARSZAWA","TUR RELACJE UL.KRÓTKA 70/ GDAŃSK",0, ,"SKLADKA UBEZP.TYT.UMOWA NR. F318001/2003 ","","","51","REFERENCE ID 1234" 110, ,15000, ,0," "," ","FIRMA TESTOWA KWIATOWA WARSZAWA","EKSPEDYTOR SA UL.ODKRYCIE WARSZAWA",0, ,"ZAPLATA ZA WYSYLKE TOWARU DO NL DIGITAL, EINDHOVEN, HOLLAND LIPIEC 2003 FVT 2323/0393/2002","","","51" 2.2 Payments to tax authorities (tax payments) and customs chambers In case of fax payments and payments for customs chambers, the field Payment Details should be formatted in a proper manner Description of the field with payment details for tax payments (option 1) Field name Status Format Comments /TI/ Identifier type and content M /TI/1!c14c Identifier type and content for tax payer (up to 14 alphanumeric characters). Identifier type: N NIP R REGON P PESEL 1 series and of personal ID 2 series and of passport /OKR/ Year, Type of period and of period that payment is dedicated to M /OKR/2!n1!a4 n e.g. for NIP identifier: /TI/N Year (as 2 digits e.g. 16 for 2016), Type of period and of period that payment is dedicated to. Type of period: R year P half year K quarter M month D decade (10 days) J day Important: If payment covers the whole year, then the field period should be blank. If for chosen tax form symbol period is not required then of period should be 0 (zero). /SFP/ tax form symbol tax payment for May 2014: /OKR/14M05 tax payment for 2014: /OKR/14R tax payment for : /OKR/18J2803 when period is not required: /OKR/0 M /SFP/7c Tax form symbol: PIT37, VAT7, CIT2, AKC2A, CIT, VAT, AKC, GL, KP, PPE, PN, SD, PCC, OS, other possible /SFP/PIT37 /TXT/ O /TXT/40x Obligation identification (type of document, e.g. decision, execution title), any text related with payment up to 40 alphanumeric characters. /TXT/ADVANCE Complete example of payment details/ description field for tax payment: /TI/N /OKR/14M01/SFP/PIT37 /TXT/ADVANCE Important: If encoded field does not fit its line (just to remind payment details field 4*35n) of payment details, then the remaining part shall be placed in next line and marked with // (2 Hex 2F) at its beginning /TI/P /OKR/18M2803/SFP/PI //T37/TXT/ADVANCE Internet Banking inordbusiness

4 2.2.2 Example of file with payment to tax authorities (option 1) 110, ,34500, ,0," "," ","FIRM A TESTOWA KWIATOWA WARSZAWA","URZĄD SKARBOWY KRAKOW STARE MIASTO GRODZKA KRAKOW",0, ,"/TI/N /OKR/16M12/SFP/CIT /TXT/DEC. RYCZAŁT ","","","71" Alternative format for payment details for tax payment (option 2) In the alternative formatting method one field goes for one line of payment details. Field name Status Format Comments Identifier type and content (first line for payment Year, Type of period and of period that payment is dedicated to (second line for payment tax form symbol (third line for payment Obligation identification (fourth line of payment Example file with a tax payment (option 2) M 1!c14c Identifier type and content for tax payer (Up to 14 alphanumeric). Type of payer s ID: N NIP R Regon P PESEL 1 Serie and of personal ID 2 serie and of passport e.g. for NIP identifier: N M 2!n1!a4n Period Year, Type of period and of period that payment is dedicated to. Type of periods: R Year (as 2 digits ex 14 for 2014) P half year K quarter M month D decade (10 days) J day Important: If payment covers the whole year, the of period should be blank. If for chosen tax form symbol period is not required then of period should be 0 (zero). tax payment for May 2014: /OKR/14M05 tax payment for 2014: /OKR/14R tax payment for : /OKR/18J2803 when period is not required: /OKR/0 M 7c Tax form symbol: PIT37, VAT7, CIT2, AKC2A, CIT, VAT, AKC, GL, KP, PPE, PN, SD, PCC, OS, INNE VAT7 O 40x Obligation identification (type of document, e.g. decision, execution title), any text related with payment up to 40 alphanumeric characters. ADVANCE 110, ,34500, ,0," "," ","FIRMA TESTOWA KWIATOWA WARSZAWA","URZĄD SKARBOWY KRAKOW STARE MIASTO GRODZKA KRAKOW",0, ,"N M12 VAT7 ADVANCE","","","71" 2.3 Social Security Payments (ZUS Payments) Attention! From the all payments to the Social Security Institution (ZUS) must be ordered as standard domestic payments (to a single, individual contribution account) 2.4 SPLIT PAYMENTS For Split Payment description details field must be formatted In a dedicated way SPLIT PAYMNET format Subfield name Status Format Subfield Description VAT amount M 5!x + 13d Constant /VAT/ and VAT amount with comma as decimal Internet Banking inordbusiness

5 separator. Amount must be greater than 0 and less or equal than amount of payment. /VAT/12345,00 Tax ID M 5!x + 14x Constant /IDC/ and beneficiary NIP (or other valid tax ) /IDC/ Invoice *) M 5!x + 35x Constant /INV/ and Invoice Additional information *) /INV/FA O 5!x + 33x Constant /TXT/ and additional information Np.: /TXT/advance Complete payments description for SPLIT PAYMENT /VAT/12345,00/IDC/ /INV/FA /TXT/advance *) In this field should not be used constants: /VAT/, /IDC/, /INV/ and /TXT/ as a user text Example file with a SPLIT PAYMENT 110, , , ,0," "," ","FIR MA TESTOWA KWIATOWA WARSZAWA","FIRMA VAT WARSZAWSKA RADOM",0, ,"/VAT/12345,00/IDC/ /INV/FA /TXT/advance ","","","53", reference Internet Banking inordbusiness