XML and TXT formatshavebeendevelopedforimportfrom a filecontainingthefollowingpaymentdocuments:
- Fundstransfers BGN
- SEBRA Payment
- Paymentfrom/to theBudget
- DirectDebitOrder
- FCY fundstransfer
- FCY fundstransferwithin UBB
Pleaseobservethefollowinginstructionsuponstructuringthefiles:
- Thefilenameshouldnotcontainspecialcharactersanditsextensionshouldbeeither .txtor .xml .
- Thefieldsmarked BOLD aremandatoryforeachtransaction. Theotherfieldsareoptional.
- For XML format:
- Thefieldnamesarecase-sensitive
- Incasethereisnodatafor a certainfield, itdoesnotexistforthistransaction
- FortheFCY fundstransferthetextinformationhas to beinLatin
- For TXT format:
- Eachoperationshallbeon a newrowandshallendwithEnter (CR LF)
- Thefields'separatorshallbe " | ", includingalsotheoptionalfield
- Fundstransfers BGN
- Structure
FieldName / Length / Description
TRANSID / 7 / Operationidentifier(IBAN311)
NAME_R / 35 / Beneficiary'sname
IBAN_R / 22 / Beneficiary's IBAN
BIC_R / 8 / BIC of beneficiary'sbank
CURRENCY / 3 / (BGN)
JSUM / 12.2 / Amountwith a decimalpointas a separator
REM_I / 35 / Paymentreason
REM_II / 35 / Additionalexplanation
RINGS / 2 / Fortransfersbelow BGN 100000 through RINGS (on)
DECL30000 / 50 / Declarationfortheorigin of funds (fortransactionsexceeding BGN 30000)
- Formats: XML and TXT
- Examples:XMLandTXT
- SEBRA Payment
- Structure
FieldName / Length / Description
TRANSID / 7 / Operationidentifier(IBAN312)
NAME_R / 26 / Beneficiary'sname
IBAN_R / 22 / Beneficiary's IBAN
CURRENCY / 3 / (BGN)
JSUM / 12.2 / Amountwith a decimalpointas a separator
REM_I / 26 / Paymentreason
REM_II / 26 / Additionalexplanation
PAY_R / 6 / Beneficiary'spaymenttype (onlyforadministrators of State Budgetrevenues)
KIND / 2+4 / Type of paymentin SEBRA - thefirsttwosymbolsaremandatory
CODEACTIVITY / 4 / ActivityCode
- Formats: TXT
- Examples: TXT
- Paymentfrom/to theBudget
- Structure
FieldName / Length / Description
TRANSID / 7 / Operationidentifier(IBAN313)
NAME_R / 30 / Beneficiary'sname
IBAN_R / 22 / Beneficiary's IBAN
BIC_R / 8 / BIC of beneficiary'sbank
CURRENCY / 3 / (BGN)
JSUM / 12.2 / Amountwith a decimalpointas a separator
REM_I / 35 / PaymentReason
REM_II / 35 / Additionalexplanation
PAY_R / 6 / Beneficiary'spaymenttype(onlyforadministrators of State Budgetrevenues)
PAY_S / 6 / Payer'spaymenttype (onlyforadministrators of State Budgetrevenues)
TYPEDOC / 18 / Documenttypeandnumber
DOCDATE / 8 / DocumentdateDDMMYYYY
FROMDATE / 8 / PeriodStartDDMMYYYY
TODATE / 8 / PeriodEndDDMMYYYY
OBLIG_NAME / 30 / DebitedPartyName
BULSTAT / 13 / DebitedParty BULSTAT
EGN / 10 / DebitedPartyPersonalIdentityNumber
LNC / 10 / DebitedPartyPersonalIdentityNumber of a Foreigner
RINGS / 2 / Fortransfersbelow BGN 100000 through RINGS (on)
DECL30000 / 50 / Declarationontheorigin of funds (fortransfersexceeding BGN 30000)
- Formats: XML and TXT
- Examples: XMLandTXT
- DirectDebitOrder
- Structure
FieldName / Length / Description
TRANSID / 7 / Operationidentifier(IBAN411)
NAME_R / 35 / Payer'sName
IBAN_R / 22 / Payer's IBAN
BIC_R / 8 / BIC of payer'sbank
CURRENCY / 3 / (BGN)
JSUM / 12.2 / Amountwith a decimalpointas a separator
REM_I / 35 / Paymentreason
REM_II / 35 / Additionalexplanation
DATEEXECUTION / 8 / ExecutionDateDDMMYYYY
- Formats: XML and TXT
- Examples:XMLandTXT
- FCY fundstransfer
- Structure
FieldName / Length / Description
TRANSID / 5 / Operationidentifier(SWIFT)
NAME_R / 35 / 59 - Beneficiary'sname
CUST2 / 35 / 50 - Payer'saddress
CUST3 / 35 / 50 - Payer'saddress
BRANCH_R / 35 / 57 - Branch of beneficiary'sbank, SWIFT code
ACC_NO_R / 34 / 59 - Beneficiary'saccount; IBAN
CURR_NO_R / 3 / 32А - Transfercurrencycode
ADR1 / 35 / 59 - Beneficiary'saddress
ADR2 / 35 / 59 – Beneficiary'scountry
BENBANK1 / 35 / 57 – Name of beneficiary'sbank
BENBANK2 / 35 / 57 - Address of beneficiary'sbank, SWIFT, Bank Code
CITY / 17 / 57 - City of beneficiary'sbank
COUNTRY / 17 / 57 - Country of beneficiary'sbank
REM_I / 35 / 70 - Details of payment – documentname (contract, invoiceandetc., documentdateandnumber)
REM_II / 35 / 70 - Details of payment – documentname (contract, invoiceandetc., documentdateandnumber)
DETAILS3 / 35 / 70 - Details of payment – documentname (contract, invoiceandetc., documentdateandnumber)
DETAILS4 / 35 / 70 - Details of payment – documentname (contract, invoiceandetc., documentdateandnumber)
BENEF / 17 / Payer'stype - (A RESIDENT / A NON-RESIDENT)
JSUM / 12.2 / Amountwith a decimalpointas a separator
NAME_S / 35 / 50 - Payer (name), legalstatus, registeredaddress/permanentaddress
CHARGES / 3 / Expenses(SHA, BEN, OUR)
BK_TO_BK_INFO / 12 / Onlyforexpresstransfer(/ACC/EXPRESS)
CHARGE_TYPE / 9 / Onlyforexpresstransfer(OUTFCEXPR)
DECL30000 / 50 / Declarationontheorigin of funds (fortransfersexceeding BGN 30000)
DECL_BNB / 1 / Please, indicatewith „Y“ for YES or „N“ for NO whetherthepaymentrelates to granting a loanbetweenlocallegalentitiesorsoletradersandforeignentities (Y,N) – asregardsfundtransfersbetweenlocalandforeignentities.
- Formats: XML
- Examples: XML
- FCY fundstransferwithin UBB
- Structure
FieldName / Length / Description
TRANSID / 6 / Operationidentifier(SWIFT2)
NAME_R / 26 / Beneficiary'sname
IBAN_R / 22 / Beneficiary's IBAN
CURR_NO_R / 3 / Currencycode of thebeneficiary'saccount
JSUM / 12.2 / Amountwith a decimalpointas a separator
REM_I / 35 / Paymentreason - documentname (contract, invoice, etc., documentnumberanddate)
REM_II / 35 / Paymentreason - documentname (contract, invoice, etc., documentnumberanddate)
REM_III / 35 / Paymentreason - documentname (contract, invoice, etc., documentnumberanddate)
TYPE_R / 17 / Beneficiary'stype(A RESIDENT / A NON-RESIDENT)
DECL30000 / 50 / Declarationontheorigin of funds (fortransactionsexceeding BGN 30000)
DECL_BNB / 1 / Please, indicatewith „Y“ for YES or „N“ for NO whetherthepaymentrelates to granting a loanbetweenlocallegalentitiesorsoletradersandforeignentities (Y,N) – asregardsfundtransfersbetweenlocalandforeignentities.
- Formats: XML
- Examples: XML