Datatypes & Normalization
BLU DOC Datatypes and their Normalisation
| Type | Sample | Value Spec |
|---|---|---|
| Version | "x.y.z" | UTF-8 String |
| Id | Invoice.Id | UTF-8 String |
| Date | Invoice.Date | YYYY-MM-DD (ISO 8601) |
| Timestamp | Created.Timestamp | yyyy-MM-dd'T'HH:mm:ss.SSSZ (ISO 8601) |
| Decimal | decimal number | |
| Int | integer | |
| SmallAmount | Unit.SmallAmount | decimal separator '.', no group separator, four(!) decimal digits, e.g. 9.0009, 2314.5066, -12.9988 |
| Amount | GrandTotal.Amount | decimal separator '.', no group separator, two decimal digits, e.g. 9.00, 2314.50, -12.99 |
| Rate | Vat.Rate | decimal separator '.'; one decimal digits, e.g. 20.0, 19.0, 10.0; value less or equal 100.0 |
| Currency | Invoice.Currency | ISO-4217 |
| Name | Name | UTF-8 String |
| Type | Document.Type | categorical values, specific list of possible values |
| VatId | Value-added Tax Id | Following IBAN standard |
| Iban | Iban | Standardized account identifier |
| Bic | Bic | Standardized bank identifier |
| Duration | Due.Duration | days, int |
| Period | Is only implicitly defined within an Itam by means of a <NAME>PeriodStart.Date and <Name>PeriodEnd.Date | Item that consists of start and end date |
| @.__ ITU E.123 | ||
| Street | Street in contact incl. street num | To be normalized |
| Zip | Zip in Contact.Item | UTF-8 String, To be normalized |
| City | City in Contact.Item | UTF-8 String, To be normalized |
| Phone | Phone in Contact.Iteam | UTF-8 String, To be normalized |
| Country | Country in Contact.Item | ISO 3166-1 Alpha 2 |
| Languages | array of Language(s) | ISO 639-1 |
| Region | region in Contact.Iteam | |
| Website | e.g. www.example.top-level-domain | ITU E.123 |
| Item | Vat.Item or Line.Item | a group of details or again items |
| Text | Free Text | Continuous Text (Fließtext) |
| Bytes | Byte Content | e.g. images, etc. |
Category: Predefined categories
| Type | Sample | Value Spec |
|---|---|---|
| VatExemption.Type | e.g. in Invoice | describes essentials of value added tax exemption;Can have 4 values: "Reverse Charge","Intra-community supply", "Export outside the EU", "VATExemption", "" means no Exemption |
| Unit.Type | e.g. in Line Items | describes units like meters, tons, pcs, etc. - OPEN - NEW Version? |
| Article.Type | in Line Items | describes article categories with a "." notation; from left to right type becomes more specific: Main Types: Material, Service, Surcharge, Discount; With SubTypes for Surcharge.Service, Surcharge.Shipping, Surcharge.Payment, Surcharge.Environment, Surcharge.Fuel |
Item(s): Available Predefined Grouped Essentials (invoice schema)
| Type | Sample | Value Spec |
|---|---|---|
| Vat.Item | e.g. in Invoice | describes essentials of value added tax |
| Line.Item | e.g. in Invoice | describes essentials of an e.g. article line including amounts, decription, ids, etc. |
| BankAccount.Item | Sender.Contact.Item | Item that consists of contact info like address, email, website, phone, etc. |
| Contact.Item | Sender.Contact.Item | Item that consists of contact info like address, email, website, phone, etc. |
| DeliveryDate.Item | in Line Items or Invoice | denotes period and date |
| Discount.Item | in Line Items | denotes discount as rate or amount |
| Due.Item | in Line Items | denotes discount as rate or amount |
| Payment.Due.Item | e.g. in Invoice | describes due dates as due.item and discount amounts as discount.item |
| Surcharge.Item | as header field denotes surcharges | denotes surcharges as rates or amounts and the type |
| Contact.Item | Sender.Contact.Item | Item that consists of contact info like address, email, website, phone, etc. |
| QrCode.Item | QrCode | Item that outlines basic qr code value and if available essentials as defined per qrcode specification |