e-Invoice.bg 1.0
Electronic invoice representation in XML according to the eInvoice.bg XML standard
Kontrax JSC
Contents
1
Introduction ..................................................................................................................................... 3
1.1
Description .............................................................................................................................. 3
1.2
Used XML standards and specifications .................................................................................. 3
2
Notations used in scheme description ............................................................................................ 3
3
e-Invoice.bg 1.0 ............................................................................................................................... 5
3.1
Invoice ..................................................................................................................................... 5
3.2
Signature ................................................................................................................................. 7
3.3
InvoicePreamble ...................................................................................................................... 9
3.4
Delivery.................................................................................................................................. 10
3.4.1
Address .......................................................................................................................... 11
3.5
Biller....................................................................................................................................... 12
3.6
InvoiceRecipient .................................................................................................................... 13
3.7
OrderingParty ........................................................................................................................ 15
3.8
Details .................................................................................................................................... 16
3.8.1
ListLineItem ................................................................................................................... 18
3.9
ReductionDetails ................................................................................................................... 21
3.10
Tax ......................................................................................................................................... 22
3.11
PaymentMethod.................................................................................................................... 23
3.11.1
UniversalBankTransaction ............................................................................................. 23
3.11.2
DirectDebit .................................................................................................................... 24
3.11.3
NoPayment .................................................................................................................... 25
3.12
PaymentConditions ............................................................................................................... 25
3.13
PresentationDetails ............................................................................................................... 26
3.14
Other ..................................................................................................................................... 27
4
Compatibility reference with ebInterface 3.0 ............................................................................... 27
5
Compatibility reference with eFaktura.bg 1.0 .............................................................................. 28
6
References ..................................................................................................................................... 28
2010-11-17
e-Invoice.bg 1.0
2/28
1 Introduction
1.1 Description
This document specifies fully the e-invoice.bg XML structure. It is based on the ebInterface 3.0
standard with some necessary changes in order to comply with the Bulgarian legislation.
Used XML standards and specifications
Префикс
dsig
Пространство на имената
Стандарт
http://www.w3.org/2000/09/xmldsig#
xs
http://www.w3.org/2001/XMLSchema
XML Digital Signatures (XMLDSIG) – W3C:
Електронни подписи [W3C02]
W3C – XMLSchema [W3C01]
2 Notations used in scheme description
Name
Name of XML Element/ Attribute. Attributes ares denoted by the „@” prefix
Meaning
Meaning of Element/ Attribute and its usage
Type
Type of Element/ Attribute (e.g xs:string, integer, etc)
Count
Обозначава броя на срещанията на съответния Element
Count
0..1
0..*
1..1
1..*
Meaning
Тип
AlphaNumType
Позволени знаци
Zero or one
Zero or more
Exactly one
One or more
124567890
ABCDEFGHIJKLMNOPQRSTUVWXYZ
abcdefghijklmnopqrstuvwxyz
АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЖЪьЮЯ
абвгдежзийклмнопрстуфхцчшщъьюя
BICType
CountryCodeType
CurrencyType
Decimal2Type
2010-11-17
[0-9|A-Z|a-z]{8}([0-9|A-Z|a-z]{3})?
8 or 11 characters according to ISO 9362
Language code according to ISO 3166-1, e.g. “BG”, “US”
and so on
Currency code according to ISO 4217, for instance
„BGN”, “USD”, “EUR”
-9999999999999.99
Number with up to 13 digits and 2 digits after the
decimal point
e-Invoice.bg 1.0
3/28
Decimal4Type
DocumentTypeType
EmptyType
IBANType
LanguageType
PercentageType
Complex XML
xs:anyURI
xs:boolean
xs:date
xs:integer
xs:positiveInteger
xs:string
-9999999999999.9999
Number with up to 13 digits and 4 digits after the
decimal point
One of the following:
 Invoice
 ProformInvoice
 InvoiceForAdvancePayment)
 InvoiceForPartialDelivery
 FinalSettlement
 SubsequentCredit
 DebitMemo
 CreditMemo
 SubsequentDebit
 SelfBilling
 TestInvoice
Empty
ISO 13616 и EBS-Standard (European Banking Standard)
34 characters max, digits, characters
Language code according to ISO 639-2, e.g „BUL”, “ENG”
etc.
99.99
Percentage
Note: Decimal point (.) is used instead of comma (,)
Complex XML element, contains other XML elements
URI (Uniform Resource Identifier) в смисъла
дефиниран в RFC3986
true|false, 1|0
Date in format „YYYY-MM-DD” according to ISO 8601
standard
{…,-2,-1,0,1,2,…}
{0,1,2,…}
Empty symbol
!#$%&’()*+,-./:;=?@[\]^_`{|}~
124567890
ABCDEFGHIJKLMNOPQRSTUVWXYZ
abcdefghijklmnopqrstuvwxyz
АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЖЪьЮЯ
абвгдежзийклмнопрстуфхцчшщъьюя
The following words MUST, MUST NOT, REQUIRED, SHOULD NOT, RECOMMENDED, MAY и
OPTIONAL are used as specified in RFC2119 (RFC 2119: Keywords for use in RFCs to Indicate
Requirement Levels. March)
2010-11-17
e-Invoice.bg 1.0
4/28
3 e-Invoice.bg 1.0
3.1 Invoice
Invoice Element MUST be used as root element and contains all the required information about the
electronic invoice.
2010-11-17
e-Invoice.bg 1.0
5/28
Име
@GeneratingSystem
@CancelledOriginalD
ocument
@DocumentType
@DocumentTypeText
Значение
ERP Name
Optional Attribute, which is used
for instance for storno.
If the current document is a storno
then the number of the original
invoice should be stored
(InvoicePreamble\InvoiceNumbe
r)
Specifies type of document. MUST
be one of the following types:
Invoice
ProformInvoice
InvoiceForAdvancePayment
InvoiceForPartialDelivery
FinalSettlement
SubsequentCredit
DebitMemo
CreditMemo
SubsequentDebit
SelfBilling
TestInvoice
Specifies type of document in free
text – for example Проформа
Тип
Attribute
Attribute
Брой
1..1
0..1
Формат
xs:string
AlphaNumType
Attribute
1..1
DocumentType
Type
Attribute
1..1
xs:string
Attribute
1..1
CurrencyType
Attribute
0..1
xs:boolean
Attribute
Attribute
Element
Element
0..1
0..1
0..1
1..1
xs:string
LanguageType
Nested XML
Nested XML
Element
0..1
Nested XML
Element
Element
Element
1..1
1..1
0..1
Nested XML
Nested XML
Nested XML
Element
Element
Element
Element
Element
1..1
0..1
1..1
1..1
0..1
Nested XML
Nested XML
Nested XML
Decimal2Type
Nested XML
фактура (Proform Invoice)
@InvoiceCurrency
@ManualProcessing
@DocumentTitle
@Language
dsig:Signature
InvoicePreamble
Delivery
Currency Code. All sums in the
invoice use this currency
If this optional attribute is set to
true the invoice needs to be
manually processed
Document title
Invoice language
Electronic signature
Contains some mandatory fields
according to the Bulgarian
legislation
Delivery information
Specific delivery information is
specified in
Invoice/Details/ItemList/L
istLineItem/Delivery
Biller
InvoiceRecipient
OrderingParty
Details
ReductionDetails
Tax
TotalGrossAmount
PaymentMethod
2010-11-17
Biller’s information
Invoice Recipient’s information
Information about the ordering
party
Invoice details
Reduction details
Information about taxes and fees
Total Gross Amount
Payment Method
e-Invoice.bg 1.0
6/28
PaymentConditions
PresentationDetails
Other
Custom
Payment conditions
Presentation details
Other information, which is
relevant to the invoice
Custom extensions
Element
Element
Element
0..1
0..1
0..1
Nested XML
Nested XML
Nested XML
Element
0..*
Nested XML
Example:
<?xml version="1.0" encoding="UTF-8"?>
<Invoice GeneratingSystem="none" CancelledOriginalDocument="false"
DocumentTitle="Фактура" DocumentTypeText="Фактура" DocumentType="Invoice"
InvoiceCurrency="BGN" Language="bul" ManualProcessing="false"
xmlns:dsig="http://www.w3.org/2000/09/xmldsig#"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.e-invoice.bg/scheme/eInvoice-1.0.xsd"
<InvoicePreamble>
<InvoiceNumber>993433000298</InvoiceNumber>
<InvoiceDate>2009-08-01</InvoiceDate>
<InvoiceKind>0</InvoiceKind>
<InvoiceKindText>оригинал</InvoiceKindText>
<InvoiceTaxDate>2009-08-02</InvoiceTaxDate>
<InvoiceCreator>Стефан Стефанов</InvoiceCreator>
<DealPlace>гр. София</DealPlace>
</InvoicePreamble>
…
<TotalGrossAmount>118.08</TotalGrossAmount>
…
</Invoice>
3.2 Signature
Element Signature is OPTIONAL. Structure of this element conforms to the XMLDSIG specification.
The presence of a signature certifies that the document (electronic invoice) is signed by the Biller.
Example:
2010-11-17
e-Invoice.bg 1.0
7/28
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod
Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="">
<Transforms>
<Transform
Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
</Transforms>
<DigestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>ZyJ4lnOoCkxziu3UZe2iC1TkpIA=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>XsD2/NP9crP18hATGPSUcWrks5O4Iw5i0nBj7cVuiaQVdKfioGO
URHSd3ZKoWIoOfUR7uZDTy6BD8CjKFx4ngw49AvoJmRux7cfUP8B923qcMgi2zaBZU2
wZOagL+6ZQrKWP0S20rcf7GbQvYyVQR2b1VXuGxbtthg0ILFRETWo=</SignatureValue
>
<KeyInfo>
<KeyName>C=BG + O=InfoNotary PLC + DC=qsign-personal-ca +
CN=i-Notary Personal Q Sign CA + OU=i-Notary Personal Q Sign CA</KeyName>
<KeyValue>
<RSAKeyValue>
<Modulus>jdzCmSwYKWGHSR9WL0ZqRQzvUzafdrC3mPxbLO50BLhgnB/pCFqn
1RBcpcCOllk7t5n…</Modulus>
<Exponent>AQAB</Exponent>
</RSAKeyValue>
</KeyValue>
<X509Data>
<X509Certificate>MIIG+TCCBeGgAwIBAgIIPgez3xV3n6MwDQYJKoZIhvcNAQE
FBQAwgY4xgYswCQYDVQQGDAJCRzAVBgNVBAoMDkluZm9Ob3RhcnkgUExDMB8
…</X509Certificate>
<X509Certificate>MIIF0zCCBLugAwIBAgIIIL+xJ/Rw/wUwDQYJKoZIhvcNAQEF
BQAwcjFwMAkGA1UEBgwCQkcwFQYDVQQKDA5JbmZvTm90YXJ5IFBMQzAWBgoJ
…</X509Certificate>
<X509Certificate>MIIGxTCCBK2gAwIBAgIIaJiig3FuiDcwDQYJKoZIhvcNAQEFB
QAwgZUxgZIwCQYDVQQGDAJCRzAVBgNVBAoMDkluZm9Ob3RhcnkgUExDMBUGC
.. </X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
2010-11-17
e-Invoice.bg 1.0
8/28
3.3 InvoicePreamble
This element is MANDATORY and contains data required by the Bulgarian legislation
Име
InvoiceNumber
InvoiceDate
InvoiceKind
InvoiceKindText
InvoiceTaxDate
InvoiceCreator
DealPlace
Значение
Invoice number.
It is a mandatory field. Should be
unique for this biller and current
year
Invoice date.
It is a mandatory field.
0- Invoice original
1- Invoice copy
Text specifying the invoice type
ОРИГИНАЛ, КОПИЕ
Invoice Tax Date
Invoice Creator full name
Place where deal occurred
Тип
Element
Брой
1..1
Формат
AlphaNumType
Element
1..1
xs:date
Element
1..1
xs:integer
Element
1..1
xs:string
Element
Element
Element
1..1
1..1
0..1
xs:date
xs:string
xs:string
Example:
<InvoicePreamble>
<InvoiceNumber>993433000298</InvoiceNumber>
<InvoiceDate>2009-08-01</InvoiceDate>
<InvoiceKind>0</InvoiceKind>
<InvoiceKindText>ОРИГИНАЛ</InvoiceKindText>
<InvoiceTaxDate>2009-08-02</InvoiceTaxDate>
<InvoiceCreator>Стефан Стефанов</InvoiceCreator>
<DealPlace>София</DealPlace>
</InvoicePreamble>
2010-11-17
e-Invoice.bg 1.0
9/28
3.4 Delivery
Element Delivery is OPTIONAL and contains all delivery information. It SHOULD specify either date or
periodfor delivery. The element Invoice/Delivery SHOULD be used just in case all goods and
services are delivered at once. Otherwise the delivery information may be specified in
Invoice/Details/ItemList/ListLineItem/Delivery. In case both elements have data than
this element Invoice/Details/ItemList/ListLineItem/Delivery has precendence.
Име
DeliveryID
Date
Period
Period/FromDate
Period/ToDate
Address
Description
Значение
Delivery identification number
Delivery Date
Delivery period
Delivert start date
Delivery end date
Address
Description
Тип
Element
Element
Element
Element
Element
Element
Element
Брой
0..1
1..1
1..1
1..1
1..1
0..1
0..1
Формат
AlphaNumType
xs:date
Nested XML
xs:date
xs:date
Nested XML
xs:string
Example 1 (delivery period):
<Delivery>
<FromDate>2008-08-03</FromDate>
<ToDate>2008-08-05</ToDate>
<Address>
<Name>Фирма ЕООД</Name>
<Street>България 1</Street>
<Town>София</Town>
<ZIP>1000</ZIP>
<Country>България</Country>
<Contact>Г-н Иван Иванов</Contact>
</Address>
</Delivery>
Example 2 (delivery date):
2010-11-17
e-Invoice.bg 1.0
10/28
<Delivery>
<Date>2008-08-03</Date>
<Address>
<Name>Фирма ЕООД</Name>
<Street>България 1</Street>
<Town>София</Town>
<ZIP>1000</ZIP>
<Country>България</Country>
<Contact>Г-н Иван Иванов</Contact>
</Address>
</Delivery>
3.4.1 Address
Address element must contain at least Name, Street, Town, Country. It is highly recommended that
the e-mail field is filled properly.
Име
Salutation
Name
Street
POBox
2010-11-17
Значение
Salutation (Mr, Mrs, etc)
Name
Street
PO Box
e-Invoice.bg 1.0
Тип
Element
Element
Element
Element
Брой
0..1
1..1
1..1
0..1
Формат
xs:string
xs:string
xs:string
xs:string
11/28
ZIP
Country
Phone
Fax
Email
Contact
WebAddress
AddressExtension
ZIP Code
Country
Phone
Fax
e-mail
Contact name
Web address
Extensions to the address, branches,
additional info, etc
Element
Element
Element
Element
Element
Element
Element
Element
0..1
1..1
0..1
0..1
0..1
0..1
0..1
0..*
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
Example:
<Address>
<Name>Контракс ЕАД</Name>
<Street>Тинтява 13</Street>
<Town>София</Town>
<ZIP>1113</ZIP>
<Country>Bulgaria</Country>
<Phone>+359 (02) 960977</Phone>
<Email>[email protected]</Email>
<Contact>Йордан Йорданов</Contact>
<WebAddress>www.kontrax.bg</WebAddress>
<AddressExtension>Централно управление</AddressExtension>
</Address>
3.5 Biller
Element Biller is MANDATORY. It contains information about the invoice biller.
Име
VATIdentificationNumer
2010-11-17
Значение
VAT Identification number. This is
optional field, because the firm
may not have a VAT registration
e-Invoice.bg 1.0
Тип
Element
Брой
0..1
Формат
xs:string
12/28
FurtherIdentification
Additional identification number
Element
0..* AlphaNumType
if necessary.
FurtherIdentification/@I Type of additional identification
Attribute
1..1 xs:string
dentificationType
number (for example EIK)
ConsolidatorsBillerID
BillerID number assigned by the
Element
0..1 AlphaNumType
Consolidator
OrderReference
Order reference. This element is
Element
0..1 Nested XML
optional
Address
Address (exact format is specified
Element
1..1 Nested XML
in 3.4.1)
MOL
Материално Отговорно Лице
Element
0..1 xs:string
(МОЛ). This field is optional and
left for compatibility with older
ERP systems
Note: In case the company is VAT registered, both fields VATIdentificationNumber and
FurtherIdentificationNumber need to be properly filled. Otherwise only the
FurtherIdentificationNumber has to be filled.
Example:
<Biller>
<VATIdentificationNumber>BG51507409</VATIdentificationNumber>
<FurtherIdentification IdentificationType="EIK">51507409</FurtherIdentification>
<ConsolidatorsBillerID>CFF45KL</ConsolidatorsBillerID>
<InvoiceRecipientsBillerID>ID4456</InvoiceRecipientsBillerID>
<OrderReference>
<OrderID>OR3456</OrderID>
<ReferenceDate>2004-11-03</ReferenceDate>
<Description>Поръчано по Факс</Description>
</OrderReference>
<Address>
<Name>Контракс ЕАД</Name>
<Street>Тинтява 13</Street>
<Town>София</Town>
<ZIP>1113</ZIP>
<Country>Bulgaria</Country>
<Phone>+359 (02) 960977</Phone>
<Email>[email protected]</Email>
<Contact>Йордан Йорданов</Contact>
<WebAddress>www.kontrax.bg</WebAddress>
<AddressExtension>Централен Офис София</AddressExtension>
</Address>
<MOL>Йордан Йорданов</MOL>
</Biller>
3.6 InvoiceRecipient
This Element е MANDATORY and contains information about invoice recipient.
2010-11-17
e-Invoice.bg 1.0
13/28
Име
VATIdentificationNumer
FurtherIdentification
FurtherIdentification/@I
dentificationType
BillersInvoiceRecipientID
OrderReference
Address
MOL
Значение
VAT Identification number. This is
optional field, because the firm
may not have a VAT registration
Additional identification number
if necessary.
Type of additional identification
number (for example EIK)
Invoice Recipient ID given by the
Biller
Address
Материално Отговорно Лице
(МОЛ). Това поле е
НЕЗАДЪЛЖИТЕЛНО и е
оставено за съвместимост с постари ERP/ счетоводни системи
Тип
Element
Брой
0..1
Формат
xs:string
Element
0..*
AlphaNumType
Attribute
1..1
xs:string
Element
0..1
AlphaNumType
Element
Element
Element
0..1
1..1
0..1
Nested XML
Nested XML
xs:string
Note: In case the company is VAT registered, both fields VATIdentificationNumber and
FurtherIdentificationNumber need to be properly filled. Otherwise only FurtherIdentificationNumer is
needed (EIK/ EGN)
Example:
<InvoiceRecipient>
<VATIdentificationNumber>BG1234567890</VATIdentificationNumber>
<BillersInvoiceRecipientID>12345678</BillersInvoiceRecipientID>
<OrderReference>
<OrderID>ID3456</OrderID>
<ReferenceDate>2008-07-29</ReferenceDate>
<Description>Поръчка по каталог</Description>
</OrderReference>
<Address>
<Salutation>Фирма</Salutation>
2010-11-17
e-Invoice.bg 1.0
14/28
<Name>Дайрект Сървисиз ООД</Name>
<Street>Тинтява 11</Street>
<Town>София</Town>
<Country>Bulgaria</Country>
<Contact>Тодор Тодоров</Contact>
</Address>
<MOL>Тодор Тодоров</MOL>
</InvoiceRecipient>
3.7 OrderingParty
The Element OrderingParty is OPTIONAL. It is used to indicate the client, who ordered the goods and
services if different from the invoice recipient.
Име
VATIdentificationNumer
FurtherIdentification
FurtherIdentification/@I
dentificationType
BillersOrderingPartyID
OrderReference
Address
Значение
VAT Identification number. This is
optional field, because the firm
may not have a VAT registration
Additional identification number
if necessary.
Type of additional identification
number (for example EIK)
Ordering Party ID given by the
Biller
Address
Тип
Element
Брой
0..1
Формат
xs:string
Element
0..*
AlphaNumType
Attribute
1..1
xs:string
Element
0..1
AlphaNumType
Element
Element
0..1
1..1
Nested XML
Nested XML
Example:
<OrderingParty>
<VATIdentificationNumber>BG9876543210</VATIdentificationNumber>
2010-11-17
e-Invoice.bg 1.0
15/28
<FurtherIdentification
IdentificationType="EIK">9876543210</FurtherIdentification>
<BillersOrderingPartyID>12345678</BillersOrderingPartyID>
<Address>
<Name>Третият човек ООД</Name>
<Street>Тинтява 17</Street>
<Town>София</Town>
<Country>Bulgaria</Country>
</Address>
</OrderingParty>
3.8 Details
Име
HeaderDescription
ItemList
ItemList/HeaderDescript
ion
ItemList/FooterDescripti
on
ItemList/ListLineItem
FooterDescription
Значение
Header description (free form)
for all invoice items
Invoice items may be grouped in
several sections. Each section is
contained in single ItemList
Element
Header description for this
particular ItemList (free form)
Footer description for this
particular ItemList (free form)
Information about a single line
item in the invoice
Footer description (free form) for
all invoice items
Тип
Element
Брой
0..1
Формат
xs:string
Element
1..*
Nested XML
Element
0..1
xs:string
Element
0..1
xs:string
Element
1..*
Nested XML
Element
0..1
xs:string
Example:
<Details>
<ItemList>
<ListLineItem>
2010-11-17
e-Invoice.bg 1.0
16/28
<PositionNumber>1</PositionNumber>
<Description>Тетрадка</Description>
<Quantity Unit="брой">8.00</Quantity>
<UnitPrice>10.20</UnitPrice>
<TaxRate>20.0</TaxRate>
<LineItemAmount>84.00</LineItemAmount>
</ListLineItem>
<ListLineItem>
<PositionNumber>2</PositionNumber>
<Description>Молив HB</Description>
<Quantity Unit="брой">2.00</Quantity>
<UnitPrice>1.20</UnitPrice>
<TaxRate>20.0</TaxRate>
<LineItemAmount>2.40</LineItemAmount>
</ListLineItem>
<ListLineItem>
<PositionNumber>3</PositionNumber>
<Description>Копирна хартия A4 - рециклирана
хартия</Description>
<Quantity Unit="брой">1.00</Quantity>
<UnitPrice>12.00</UnitPrice>
<TaxRate>20.0</TaxRate>
<LineItemAmount>12.00</LineItemAmount>
</ListLineItem>
</ItemList>
</Details>
2010-11-17
e-Invoice.bg 1.0
17/28
3.8.1
ListLineItem
Име
PositionNumber
Description
BillersArticleNumber
InvoiceRecipientsArticle
2010-11-17
Значение
Position number of invoice item
(usually it is consecutive)
Description
Article Number or Code in biller’s
articles list
Article Number or Code in invoice
e-Invoice.bg 1.0
Тип
Element
Брой
0..1
Element
Element
1..*
0..1
Формат
xs:positiveInteg
er
xs:string
AlphaNumType
Element
0..1
AlphaNumType
18/28
Number
Quantity
recipient’s articles list
Quantity. If necessary an
alternative quantity may be
expressed in
Element
1..1
Decimal4Type
Unit
Unit Price
Unit Price in alternative currency
Alternative currency
Attribute
Element
Element
Attribute
1..1
1..1
0..1
1..1
xs:string
Decimal4Type
Decimal4Type
CurrencyType
Tax rate (percent)
Element
Attribute
Element
Element
Element
1..1
0..1
0..1
0..1
0..1
PercentageType
xs:string
xs:boolean
PercentageType
Nested XML
Element
Element
0..1
1..1
Nested XML
AlphaNumType
Element
0..1
AlphaNumType
Element
0..1
Nested XML
Element
1..1
AlphaNumType
Element
0..1
AlphaNumType
Element
0..1
Nested XML
Element
0..1
Nested XML
Element
Element
1..1
0..1
Decimal2Type
Decimal2Type
Attribute
1..1
CurrencyType
AdditionalInformation\Alt
ernativeQuantity
Quantity/@Unit
UnitPrice
AlternativeUnitPrice
AlternativeUnitPrice/@C
urrency
TaxRate
TaxRate/@TaxCode
DiscountFlag
ReductionRate
Delivery
BillersOrderReference
BillersOrderReference/O
rderID
BillersOrderReference/O
rderPositionNumber
InvoiceRecipientsOrderR
eference
InvoiceRecipientsOrderR
eference/OrderReferenc
eOrderID
InvoiceRecipientsOrderR
eference/OrderPosition
Number
AdditionalInformation
Custom
LineItemAmount
AlternativeLineItemAmo
unt
AlternativeLineItemAmo
unt/@Currency
Reduction Rate
Delivery information for this
particular element (as described
in 3.4)
Additional information about
goods/ services
Extension of current specification
with elements from another
namespace
Line Item Amount (netto)
Line Item Amount (netto) in
alternative currency
Alternative currency
3.8.1.1 AdditionalInformation
Element AdditionalInformation is OPTIONAL and contains additional information for each invoice
item.
2010-11-17
e-Invoice.bg 1.0
19/28
Име
SerialNumber
ChargeNumber
Classification
Classification/@Classific
ationSchema
AlternativeQuantity
AlternativeQuantity/@U
nit
Size
Weight
Weight/@Unit
Boxes
2010-11-17
Значение
Serial number
Classification
Classification schema (free form)
Тип
Element
Element
Element
Attribute
Брой
0..*
0..*
0..*
0..1
Формат
AlphaNumType
AlphaNumType
xs:string
xs:string
Alternative Quantity
Alternative Quantity unit
Element
Attribute
0..1
0..1
Decimal4Type
xs:string
Size (free text)
Weight
Weight unit
Number of boxes or containers
Element
Element
Attribute
Element
0..1
0..1
1..1
0..1
AlphaNumType
Decimal4Type
xs:string
xs:positiveInteg
er
e-Invoice.bg 1.0
20/28
Color
Color
Element
0..1
Xs:string
Тип
Element
Element
Element
Attribute
Брой
1..*
1..1
1..1
0..1
Формат
Nested XML
Decimal2Type
PercentageType
xs:string
Element
Element
1..1
0..1
PercentageType
Decimal2Type
3.9 ReductionDetails
Име
Reduction
Reduction/BaseAmount
Reduction/TaxRate
Reduction/TaxRate/@Ta
xCode
Reduction/Percentage
Reduction/Amount
Значение
Reduction information
Base amount
Tax rate
Reduction in percentage points
Reduction amount. Usually it is
calculated byt BaseAmount x
Percentage
Example:
<ReductionDetails>
<Reduction>
<BaseAmount>118.80</BaseAmount>
<TaxRate>20.00</TaxRate>
<Percentage>1.00</Percentage>
<Amount>1.19</Amount>
</Reduction>
</ReductionDetails>
2010-11-17
e-Invoice.bg 1.0
21/28
3.10 Tax
Име
VAT
VAT/TaxExemption
VAT/Item
VAT/Item/TaxedAmount
VAT/Item/TaxRate
VAT/Item/TaxRate/@Tax
Code
VAT/Item/Amount
Значение
Value Added Tax (VAT)
information
This field should be filled in case
the invoice is exempted from
VAT
Taxed amount
Tax rate
Tax amount. Usually it is
calculated as TaxedAmount x
Тип
Element
Брой
1..1
Формат
Nested XML
Element
0/1..1
xs:string
Element
Element
Element
0/1..*
1..1
1..1
Attribute
0..1
Nested XML
Decimal2Type
PercentageTy
pe
xs:string
Element
1..1
Decimal2Type
Element
Element
Element
0..*
1..1
1..1
Nested XML
xs:string
Decimal2Type
TaxRate
OtherTax
OtherTax/Comment
OtherTax/Amount
Other taxed
Comment (free text)
Other taxes amount
Example:
<Tax>
<VAT>
<Item>
<TaxedAmount>98.40</TaxedAmount>
<TaxRate>20.00</TaxRate>
2010-11-17
e-Invoice.bg 1.0
22/28
<Amount>19.68</Amount>
</Item>
</VAT>
</Tax>
3.11 PaymentMethod
Element PaymentMethod is OPTIONAL and specifies the payment method:



UniversalBankTransaction
DirectDebit – Direct debit payment
NoPayment – no payment
3.11.1 UniversalBankTransaction
Име
@ConsolidatorPayable
Comment
BeneficiaryAccount
BeneficiaryAccount/Bank
2010-11-17
Значение
Този Attribute показва дали
плащането е възможно чрез
платформата на
Консолидатора. Ако
стойността е true, то
плащането е възможно, ако е
установено в false, то
плащането не е позволено.
Payment comment
Bank Name
e-Invoice.bg 1.0
Тип
Attribute
Брой
0..1
Формат
xs:boolean
Element
Element
Element
0..1
0..*
0..1
xs:string
Nested XML
xs:string
23/28
Name
BeneficiaryAccount/BankC
ode
BeneficiaryAccount/BankC
ode/@BankCodeType
BeneficiaryAccount/BIC
BeneficiaryAccount/Bank
AccountNr
BeneficiaryAccount/IBAN
BeneficiaryAccount/Bank
AccountOwner
PaymentReference
Bank Code
Element
0..1
xs:integer
Attribute
1..1
Bank Identification Code (BIC)
Bank Account Number
Element
Element
0..1
0..1
CountryCodeTy
pe
BICType
xs:string
International Bank Account
Number (IBAN)
Bank Account Number
Element
0..1
IBANType
Element
0..1
xs:string
Element
0..1
xs:integer
Example:
<PaymentMethod xsi:type="UniversalBankTransactionType">
<Comment>Молим за навременно плащане на сумата</Comment>
<BeneficiaryAccount>
<BankName>Банка ДСК</BankName>
<BankCode BankCodeType="BG">12000</BankCode>
<BIC>STSABGSF</BIC>
<BankAccountNr>11111111111</BankAccountNr>
<IBAN>BGSTSABGSF11111111111</IBAN>
<BankAccountOwner>Йордан Йорданов</BankAccountOwner>
</BeneficiaryAccount>
<PaymentReference>993433000298</PaymentReference>
</PaymentMethod>
3.11.2 DirectDebit
Име
Comment
Значение
Payment comment
Тип
Element
Брой
0..1
Формат
xs:string
Example:
<PaymentMethod xsi:type=”DirectDebitType”>
<Comment>
Сумата по фактурата ще бъде дебитирана на 05.08.2009
</Comment>
</Delivery>
2010-11-17
e-Invoice.bg 1.0
24/28
3.11.3 NoPayment
Име
Comment
Значение
Payment comment
Тип
Element
Брой
0..1
Формат
xs:string
Тип
Element
Element
Element
Брой
1..1
0..*
1..1
Формат
xs:date
Nested XML
xs:date
Element
Element
Element
Element
Element
0..1
1..1
0..1
0..1
0..1
Example:
<PaymentMethod xsi:type=”NoPaymentType”>
<Comment>
Моля не плащайте
</Comment>
</Delivery>
3.12 PaymentConditions
Име
DueDate
Discount
Discount/PaymentDate
Discount/BaseAmount
Discount/Percentage
Discount/Amount
Minimum-Payment
Comment
2010-11-17
Значение
Due date
Discount
The date of validity of the
discount
Base amount
Dicsount percentage
Dicsount amount
Minimum payment
Comment (free text)
e-Invoice.bg 1.0
Decimal2Type
PercentageType
Decimal2Type
Decimal2Type
xs:string
25/28
Example:
<PaymentConditions>
<DueDate>2009-08-15</DueDate>
<Discount>
<PaymentDate>2005-08-08</PaymentDate>
<Percentage>3.00</Percentage>
</Discount>
<Discount>
<PaymentDate>2005-08-12</PaymentDate>
<Percentage>2.00</Percentage>
</Discount>
<MinimumPayment>50.65</MinimumPayment>
<Comment>Коментар към условията за плащане </Comment>
</PaymentConditions>
3.13 PresentationDetails
Element PresentationDetails may be used to fine tune the visualization of the invoice.
Име
URL
LogoURL
LayoutID
SuppressZero
Attachments
2010-11-17
Значение
URL
Logo URL
Specifies layout ID (Template is stored on
e-Invoice.bg)
Suppress zero values
Attachments (must be unique for this
biller). Generation of GUID is
recommended
e-Invoice.bg 1.0
Тип
Element
Element
Element
Брой
0..1
0..1
0..1
Element
Element
0..1
0..1
Формат
xs:anyURI
xs:anyURI
AlphaNumType
xs:boolean
Nested XML
26/28
Attachments/Att
achment
Attachments/Att
achment/Conten
tType
Attachments/Att
achment/Archive
Name of attached file
Element
1..*
xs:string
Optional attribute which specifies
attachment type (DOC, PDF, XLS, TXT и
др.)
Should the invoice attachment be
archived
Attribute
0..1
ContentTypeTy
pe
Attribute
1..1
xs:boolean
Example:
<PresentationDetails>
<URL>www.kontrax.bg</URL>
<LogoURL>http://e-invoice.bg:88/comres/KontraxLogo.png</LogoURL>
<LayoutID>0100</LayoutID>
<SuppressZero>true</SuppressZero>
</PresentationDetails>
3.14 Other
Element Other contains information in a hashtable like structure <key, value> for storing additional
data in the invoice.
Име
Information
Information/Key
Information/Val
ue
Значение
Additional information for the invoice
Key
Value
Тип
Element
Element
Element
Брой
1..*
1..1
1..1
Формат
Nested XML
xs:string
AlphaNumType
Example:
<Other>
<Information>
<Key>Words</Key>
<Value>сто и осемнадесет лева и осем стотинки</Value>
</Information>
</Other>
4 Compatibility reference with ebInterface 3.0
Not yet implemented
2010-11-17
e-Invoice.bg 1.0
27/28
5 Compatibility reference with eFaktura.bg 1.0
Not yet implemented
6 References
RFC 2119: Keywords for use in RFCs to Indicate Requirement Levels. March. (n.d.). Retrieved from
http://www.rfc-archive.org/getrfc.php?rfc=2119
XML Schema. W3C Recommendation. (n.d.). Retrieved from http://www.w3.org/XML/Schema
XML-Signature Syntax and Processing (XMLDSig). W3C Recommendation. (n.d.). Retrieved from
http://www.w3.org/TR/xmldsig-core/
2010-11-17
e-Invoice.bg 1.0
28/28