DOCUMENT "INVOICE" USE PROFILE Date of release: 2009-12-11 Guide filename: UBL-TCF-UseProfile-Invoice.pdf
1. BUSINESS DESCRIPTION 1.1 This document This document is a use profile of UBL Invoice 2.0 document (http://docs.oasis-open.org/ubl/os-ubl- 2.0/xsd/maindoc/UBL-Invoice-2.0.xsd) for the Textile/Clothing and Footwear industry. 1.2 Generalities A document claiming payment for goods or services supplied under conditions agreed between the supplier and the customer. In most cases this document describes the actual financial commitment of goods or services ordered from the supplier. 2
2. USE PROFILE 2.1 General structure of XML document All the business data that can be exchanged through this class of documents are shown in the following "document structure", that provides a simplified vision of the Schema. In particular: - the two numbers following each element define its "cardinality" (minimum and maximum number of occurrences); the minimum equal zero indicates that the element is optional, the minimum greater than zero indicates that is mandatory; - the bold character denotes the complex elements (aggregates of simple elements) that were built for the sake of functionality and re-usability of some complex information sets. The child elements in each parent element are easily spotted as "indented"; - the symbol "@" denotes an attribute of the preceding element; here "the usage indicator (optional, required,...) is shown in square brackets. In the right column the content of each element is described. Structure XML Tag Content description Invoice UBLVersion Constant: 2.0 Customization Constant: ebiz-tcf-v2008-1 Profile Constant: ebiz-tcf-invoice Document number: an identifier for the Invoice assigned by the issuer. CopyIndicator 0-1 Document function: the function performed by the present message with regards to the. Possible values: true (the document is a copy) or false (the document is the original). IssueDate 1-1 Document date: the date on which the Invoice was issued. Note 0-1 Invoice text: free-form text (note or similar information) applying to the document. DocumentCurrencyCode 1-1 Invoice currency: the currency that is used for prices in the Invoice (ISO code). @listid [optional] Constant: ISO 4217 OrderReference 1-1 Customer order number: the Order identifier assigned by the Buyer (the reference of the Order associated to this Invoice). SalesOrder Supplier order number: the Order Identifier assigned by the Supplier (the reference of the Order associated to this Invoice). IssueDate 0-1 Order date: the date on which the Order was issued. CustomerReference 0-1 Customer reference number: a reference applied to the Order document by the order issuer (Buyer). DespatchDocumentReference 0-1 IssueDate 0-1 AdditionalDocumentReference 1-1 3 Despatch advice number: the identifier of the Despatch Advice (the reference of the Despatch Advice associated to this Invoice). Despatch advice date: the issue date of the Despatch Advice. Delivery note number: the identifier of the Delivery Note (the reference of the Delivery Note associated to this Invoice).
IssueDate 0-1 DocumentType 0-1 AccountingSupplierParty 1-1 Party 1-1 PartyTaxScheme 1-1 Company TaxScheme 1-1 AccountingCustomerParty 1-1 Party 1-1 BuyerCustomerParty 1-1 Party 1-1 PartyTaxScheme 1-1 Company Delivery 1-1 ActualDeliveryDate 0-1 DeliveryLocation 1-1 TaxScheme 1-1 DeliveryParty 1-1 4 Delivery note date: the issue date of the Delivery Note. Constant: Delivery note GLN supplier: GLN code of the place where the Supplier s physical location is. VAT Id supplier: the identifier assigned for tax purposes to the Supplier by the taxation authority. Identifies the tax scheme. Constant: VAT GLN invoicee: GLN code of the place where the physical location of the legal recipient of the Invoice is (who pays the invoice). GLN buyer: GLN code of the place where the Buyer s physical location is (the legal buyer of goods, normally the headquarter of the Buyer). VAT Id buyer: the identifier assigned for tax purposes to the Buyer by the taxation authority. Identifies the tax scheme. Constant: VAT Delivery date: the date on which the goods were delivered. GLN delivery location: GLN code of place where the goods have been physically brought to by the Supplier or his agent. GLN ultimate consignee: GLN code of the place inside the property of the retailer where the goods have been finally meant for. The Supplier isn t involved in this transport. PaymentMeans 0-1 PaymentMeansCode 1-1 Default: 1 (= Instrument not defined ) @listid [optional] Default: UN/ECE 4461 PaymentDueDate 1-1 Value date: the date when the invoice is due. AllowanceCharge 0-3 This element can be used to specify information about: - the Freight costs amount : in this case a charge is specified and the ChargeIndicator value must be
true and the AllowanceChargeReason must be Freight costs ; and/or - the Invoice discount amount : in this case, a discount is specified and the ChargeIndicator value must be false and the AllowanceChargeReason must be Invoice discount ; and/or - the Minimum order charge amount : in this case, a case a charge is specified and the ChargeIndicator value must be true and the AllowanceChargeReason must be Minimum order charge ; ChargeIndicator 1-1 AllowanceChargeReason 1-1 Amount 1-1 Indicates whether the Allowance Charge is a charge (true) or a discount (false). The reason for the Allowance Charge. Possible values: - Freight costs ; - Invoice discount ; - Minimum order charge. In case of Freight costs amount: costs incurred by the shipper in moving goods, by whatever means, from one place to another. In case of Invoice discount amount: the allowances applied to the Invoice as a whole. TaxTotal 1-1 TaxAmount 1-1 TaxSubtotal 1-1 TaxableAmount 0-1 TaxAmount 1-1 Percent 1-1 TaxCategory 1-1 TaxScheme 1-1 LegalMonetaryTotal 1-1 PayableAmount 1-1 InvoiceLine 1-9999 InvoicedQuantity 1-1 @unitcode [optional] LineExtensionAmount 1-1 5 In case of Minimum order charge amount: extra charge when the invoice amount is below a certain limit. Tax total: the total tax amount (it s the same value of TaxSubtotal/TaxAmount). Taxable amount: the net amount to which the tax percent (rate) is applied to calculate the tax amount. Tax total: the total tax amount. Invoice tax rate: the tax rate expressed as a percentage. Identifies the tax scheme. Constant: VAT Payable amount: the total amount to be paid. Line number: an unique identifier for the invoice line. Invoice quantity: the quantity of articles on the invoice line. Measurement unit: the unit of the invoice quantity. Line amount: the total amount for the invoice line, including Allowance Charges but net of taxes. Currency line amount: the currency that is used for
Item 1-1 Name 1-1 SellerItemIdentification 1-1 StandardItemIdentification 1-1 the line amount. Article name: a short name optionally given to an item, such as a name from a Catalogue, as distinct from a description. Supplier article number: an identifier for the item assigned by the Supplier. GTIN: GTIN (Global Trade Item Number) article identification code. In case of local identification systems it is necessary to declare the issuer in the schemename attribute and to put anyway the identifier in this element. Default: GTIN @schemename [required] MeasurementDimension 0-1 Attribute Constant: Net weight Measure 1-1 Net weight: the net weight of the single unit of article, declared for transport or customs purpose. @unitcode [required] Measurement unit: the unit of the Net weight. OriginCountry 0-1 Country of origin: the origin country of the article. IdentificationCode 0-1 The country name expressed as code. @listid [optional] Default: ISO 3166-1 Name 0-1 The country name expressed as text. CommodityClassification 0-1 ItemClassificationCode 0-1 Customs tariff number: the product code from @listname [required] ManufacturerParty 0-1 Price 1-1 PriceAmount 1-1 BaseQuantity 1-1 @unitcode [optional] harmonised system of customs authorities. Constant: Custom tariff GLN manufacturer: GLN code of the place where the Manufacture s physical location is (used only if the Manufacturer isn t the Supplier). Invoice price: the price of the article specified. Currency: the currency that is used for the invoice price. The actual quantity to which the price applies. Constant: 1 The base unit of product. 6