Class InvoiceLine
BG-25 INVOICE LINE — A group of business terms providing information on individual Invoice lines.
The EN 16931 business terms and groups implemented by this class:
| Represents | BG-25 |
|---|---|
| Covers | BG-29, BG-30, BG-30-00, BG-31, BT-126-00, BT-129-00, BT-131-00, BT-146-00 |
| Business terms (value fields) | BT-126, BT-127, BT-129, BT-130, BT-131, BT-133, BT-134, BT-134-0, BT-135, BT-135-0, BT-146, BT-147, BT-147-02, BT-148, BT-149, BT-149-1, BT-150, BT-150-1, BT-151, BT-151-0, BT-152, BT-153, BT-154, BT-155, BT-156, BT-157, BT-157-1, BT-159 |
| Business groups (object lists) | BG-27, BG-28, BG-32, BT-128-00, BT-132-00, BT-158-00 |
Documentation of the represented business group:
| Description | EN | A group of business terms providing information on individual Invoice lines. |
|---|---|---|
| FR | Groupe de termes métiers fournissant des informations sur des lignes de Facture individuelles. | |
| Business rule | EN | BR-16: An Invoice shall have at least one Invoice line (BG-25). |
| FR | BR-16 : Une Facture doit avoir au moins une ligne de Facture (BG-25). |
- Since:
- 1.0.06/2.2
-
Method Summary
Modifier and TypeMethodDescriptionDeprecated.appendNewInvoiceLineObjectIdentifier(String invoiceLineObjectIdentifier, Codes.InvoiceTypeCode130 typeCode) Creates, appends and returns a newInvoiceLineObjectIdentifier(BT-128-00 (Invoice line object identifier)).Deprecated.appendNewItemAttributes(String itemAttributeName, String itemAttributeValue) Creates, appends and returns a newItemAttributes(BG-32 ITEM ATTRIBUTES).Creates, appends and returns a newItemClassificationIdentifier(BT-158-00 (ITEM CLASSIFICATION IDENTIFIER)).Creates, appends and returns a newReferencedPurchaseOrderLineReference(BT-132-00 (Referenced purchase order line reference)).Returns BT-156 Item Buyer's identifier — An identifier, assigned by the Buyer, for the item.Returns BT-135-0 Date format.Returns BT-149-1 Item price base quantity — The number of item units to which the price applies.Returns BT-150-1 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Returns BT-151 Invoiced item VAT category code — The VAT category code for the invoiced item.Returns BT-152 Invoiced item VAT rate — The VAT rate, represented as percentage that applies to the invoiced item.Returns BT-129 Invoiced quantity — The quantity of items (goods or services) that is charged in the Invoice line.Returns BT-130 Invoiced quantity unit of measure code — The unit of measure that applies to the invoiced quantity.Returns BT-133 Invoice line Buyer accounting reference — A textual value that specifies where to book the relevant data into the Buyer's financial accounts.Returns BT-126 Invoice line identifier — A unique identifier for the individual line within the Invoice.Returns BT-131 Invoice line net amount — The total amount of the Invoice line.Returns BT-127 Invoice line note — A textual note that gives unstructured information that is relevant to the Invoice line.Returns BT-135 Invoice line period end date — The date when the Invoice period for this Invoice line ends.Returns BT-134 Invoice line period start date — The date when the Invoice period for this Invoice line starts.Returns BT-159 Item country of origin — The code identifying the country from which the item originates.Returns BT-154 Item description — A description for an item.Returns BT-148 Item gross price — The unit price, exclusive of VAT, before subtracting Item price discount.Returns BT-153 Item name — A name for an item.Returns BT-146 Item net price — The price of an item, exclusive of VAT, after subtracting item price discount.Returns BT-147-02 (Item price discount).Returns BT-147 Item price discount — The total discount subtracted from the Item gross price to calculate the Item net price.Returns BT-157 Item standard identifier — An item identifier based on a registered scheme.Returns BT-149 Item price base quantity — The number of item units to which the price applies.Returns BT-150 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Returns BT-157-1 Scheme identifier for Item standard identifier — The identification scheme identifier of the Item standard identifierReturns BT-155 Item Seller's identifier — An identifier, assigned by the Seller, for the item.Returns BT-134-0 Date format.Returns BT-151-0 VAT type code on line level — The VAT category code for the invoiced item.setBuyerAssignedID(String value) Sets BT-156 Item Buyer's identifier — An identifier, assigned by the Buyer, for the item.Sets BT-149-1 Item price base quantity — The number of item units to which the price applies.Sets BT-150-1 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Sets BT-151 Invoiced item VAT category code — The VAT category code for the invoiced item.setInvoicedItemVATRate(Percentage value) Sets BT-152 Invoiced item VAT rate — The VAT rate, represented as percentage that applies to the invoiced item.setInvoicedQuantity(Quantity value) Sets BT-129 Invoiced quantity — The quantity of items (goods or services) that is charged in the Invoice line.Sets BT-130 Invoiced quantity unit of measure code — The unit of measure that applies to the invoiced quantity.Sets BT-133 Invoice line Buyer accounting reference — A textual value that specifies where to book the relevant data into the Buyer's financial accounts.setInvoiceLineIdentifier(String value) Sets BT-126 Invoice line identifier — A unique identifier for the individual line within the Invoice.setInvoiceLineNetAmount(Amount value) Sets BT-131 Invoice line net amount — The total amount of the Invoice line.setInvoiceLineNote(String value) Sets BT-127 Invoice line note — A textual note that gives unstructured information that is relevant to the Invoice line.Sets BT-135 Invoice line period end date — The date when the Invoice period for this Invoice line ends.Sets BT-134 Invoice line period start date — The date when the Invoice period for this Invoice line starts.Sets BT-159 Item country of origin — The code identifying the country from which the item originates.setItemDescription(String value) Sets BT-154 Item description — A description for an item.setItemGrossPrice(UnitPriceAmount value) Sets BT-148 Item gross price — The unit price, exclusive of VAT, before subtracting Item price discount.setItemName(String value) Sets BT-153 Item name — A name for an item.setItemNetPrice(UnitPriceAmount value) Sets BT-146 Item net price — The price of an item, exclusive of VAT, after subtracting item price discount.Sets BT-147 Item price discount — The total discount subtracted from the Item gross price to calculate the Item net price.setItemStandardIdentifier(String value) Sets BT-157 Item standard identifier — An item identifier based on a registered scheme.Sets BT-149 Item price base quantity — The number of item units to which the price applies.Sets BT-150 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Sets BT-157-1 Scheme identifier for Item standard identifier — The identification scheme identifier of the Item standard identifiersetSellerAssignedID(String value) Sets BT-155 Item Seller's identifier — An identifier, assigned by the Seller, for the item.
-
Method Details
-
setInvoiceLineIdentifier
Sets BT-126 Invoice line identifier — A unique identifier for the individual line within the Invoice.Rule: BR-21: Each Invoice line (BG-25) shall have an Invoice line identifier (BT-126).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:AssociatedDocumentLineDocument/ram:LineIDFR: Identifiant de ligne de facture — Identifiant unique d'une ligne au sein de la Facture.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.09.2/2.5.2
-
setInvoiceLineNote
Sets BT-127 Invoice line note — A textual note that gives unstructured information that is relevant to the Invoice line.XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:AssociatedDocumentLineDocument/ram:IncludedNote/ram:ContentFR: Note de ligne de facture — Commentaire fournissant des informations non structurées concernant la ligne de Facture.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoicedQuantity
Sets BT-129 Invoiced quantity — The quantity of items (goods or services) that is charged in the Invoice line.Conditions (CIUS): CHORUS PRO: Invoiced quantity is supported on 10 digits maximum.
Rule: BR-22: Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantityFR: Quantité facturée — Quantité d'articles (biens ou services) prise en compte dans la ligne de Facture.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoicedQuantityUnitOfMeasureCode
Sets BT-130 Invoiced quantity unit of measure code — The unit of measure that applies to the invoiced quantity.Usage: The unit of measure shall be chosen from the lists in UN/ECE Recommendation N°. 20 “Codes for Units of Measure Used in International Trade” [7] and UN/ECE Recommendation N° 21 “Codes for Passengers, Types of Cargo, Packages and Packaging Materials (with Complementary Codes for Package Names)” [19] applying the method described in UN/ECE Rec N° 20 Intro 2.a). Note that in most cases it is not needed for Buyers and Sellers to implement these lists fully in their software. Sellers need only to support the units needed for their goods and services; Buyers only need to verify that the units used in the Invoice are equal to the units used in other documents (such as Contract, Catalogue, Order and Despatch advice).
Conditions (CIUS): In particular, the most common units of measurement are:LTR = litre (1 dm3)MTQ = cubic meterKGM = kilogramMTR = meterC62 = unitTNE = ton
Rule: BR-23: An Invoice line (BG-25) shall have an Invoiced quantity unit of measure code (BT-130).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity/@unitCodeFR: Unité de mesure de la quantité facturée — Unité de mesure applicable à la quantité facturée.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoiceLineNetAmount
Sets BT-131 Invoice line net amount — The total amount of the Invoice line.Usage: The amount is “net” without VAT, i.e. inclusive of line level allowances and charges as well as other relevant taxes.
Rule: BR-24: Each Invoice line (BG-25) shall have an Invoice line net amount (BT-131).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeSettlementLineMonetarySummation/ram:LineTotalAmountFR: Montant net de ligne de facture — Montant total de la ligne de Facture.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
- API Note:
- This is a computed value: by default it is computed from the invoice contents, and a
value supplied through this method is ignored. There is normally no reason to call this method.
Calling this setter stores the value, but
getInvoiceLineNetAmount()returns that stored value if and only if recomputation is disabled -- that is, eitherInvoice.setRecompute(false)has been called and is in effect, or line-amount computation has been switched off (thefacturx.computeBT131system property set tofalse), at the momentgetInvoiceLineNetAmount()is invoked; otherwisegetInvoiceLineNetAmount()returns the freshly computed value and the stored value is ignored.Because
toXML()reads this value throughgetInvoiceLineNetAmount(), a value set here appears in the generated XML only under those same conditions.
-
setInvoiceLineBuyerAccountingReference
Sets BT-133 Invoice line Buyer accounting reference — A textual value that specifies where to book the relevant data into the Buyer's financial accounts.Usage: If required, this reference shall be provided by the Buyer to the Seller prior to the issuing of the Invoice.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ReceivableSpecifiedTradeAccountingAccount/ram:IDFR: Référence comptable de l'acheteur — Valeur textuelle spécifiant où imputer les données pertinentes dans les comptes comptables de l'Acheteur.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoiceLinePeriodStartDate
Sets BT-134 Invoice line period start date — The date when the Invoice period for this Invoice line starts.Usage: The date is the first day of the period.
Conditions (CIUS): This date must be less than or equal to the end date of the period (BT-135), if it exists
Rule: BR-CO-20: If Invoice line period (BG-26) is used, the Invoice line period start date (BT-134) or the Invoice line period end date (BT-135) shall be filled, or both.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:StartDateTime/udt:DateTimeStringFR: Date de début de période de facturation d'une ligne — Date à laquelle la période de facturation commence pour cette ligne de Facture.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoiceLinePeriodEndDate
Sets BT-135 Invoice line period end date — The date when the Invoice period for this Invoice line ends.Usage: The date is the last day of the period.
Conditions (CIUS): This date must be greater than or equal to the period start date (BT-134), if it exists
Rule: BR-30: If both Invoice line period start date (BT-134) and Invoice line period end date (BT-135) are given then the Invoice line period end date (BT-135) shall be later or equal to the Invoice line period start date (BT-134).BR-CO-20: If Invoice line period (BG-26) is used, the Invoice line period start date (BT-134) or the Invoice line period end date (BT-135) shall be filled, or both.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:EndDateTime/udt:DateTimeStringFR: Date de fin de période de facturation d'une ligne — Date à laquelle la période de facturation se termine pour cette ligne de Facture.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setItemNetPrice
Sets BT-146 Item net price — The price of an item, exclusive of VAT, after subtracting item price discount.Usage: The Item net price has to be equal with the Item gross price less the Item price discount.
Conditions (CIUS): The Item net price MUST NOT be negative
Rule: BR-26: Each Invoice line (BG-25) shall contain the Item net price (BT-146).BR-27: The Item net price (BT-146) shall NOT be negative.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:ChargeAmountFR: Prix net de l'article — Prix d'un article, hors TVA, après application du Rabais sur le prix de l'article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
- API Note:
- This value is normally computed from the invoice contents, so there is usually no reason
to call this method. Unlike the other computed fields, however, a value you set here is
always honoured:
getItemNetPrice()returns it and recomputation never overrides it.Because
toXML()reads this value throughgetItemNetPrice(), a value set here is always written to the generated XML.
-
setItemPriceDiscount
Sets BT-147 Item price discount — The total discount subtracted from the Item gross price to calculate the Item net price.Usage: Only applies if the discount is provided per unit and if it is not included in the Item gross price.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:AppliedTradeAllowanceCharge/ram:ActualAmountFR: Rabais sur le prix de l'article — Remise totale qui, une fois soustraite du Prix brut de l'article, donne le Prix net de l'article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setItemGrossPrice
Sets BT-148 Item gross price — The unit price, exclusive of VAT, before subtracting Item price discount.Conditions (CIUS): The Item gross price MUST NOT be negative
Rule: BR-28: The Item gross price (BT-148) shall NOT be negative.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:ChargeAmountFR: Prix brut de l'article — Prix unitaire, hors TVA, avant application du Rabais sur le prix de l'article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
- API Note:
- This value is normally computed from the invoice contents, so there is usually no reason
to call this method. Unlike the other computed fields, however, a value you set here is
always honoured:
getItemGrossPrice()returns it and recomputation never overrides it.Because
toXML()reads this value throughgetItemGrossPrice(), a value set here is always written to the generated XML.
-
setNetItemPriceBaseQuantity
Sets BT-149 Item price base quantity — The number of item units to which the price applies.Conditions (CIUS): Optional, if filled and if BT-148 is present (EN16931 and EXTENDED profiles), then it should be the same value than BT-149-1
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:BasisQuantityFR: Quantité de base du prix de l'article — Nombre d'articles sur lequel s'applique le prix.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setGrossItemPriceBaseQuantity
Sets BT-149-1 Item price base quantity — The number of item units to which the price applies.Conditions (CIUS): To fill if BT-149 is present and if BT-148 is present, with the same value than BT-149
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:BasisQuantityFR: Quantité de base du prix de l'article — Nombre d'articles sur lequel s'applique le prix.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setNetItemPriceBaseQuantityUnitOfMeasureCode
Sets BT-150 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Usage: The Item price base quantity unit of measure shall be the same as the Invoiced quantity unit of measure (BT-130).
Conditions (CIUS): In particular, the most common units of measurement are:LTR = litre (1 dm3)MTQ = cubic meterKGM = kilogramMTR = meterC62 = unitTNE = ton
Rule: BT-130, BT-150 and BT-150-1 must be equal if stated.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:BasisQuantity/@unitCodeFR: Unité de mesure de la quantité de base du prix de l'article — Unité de mesure applicable à la Quantité de base du prix de l'article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setGrossItemPriceBaseQuantityUnitOfMeasureCode
Sets BT-150-1 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Usage: The Item price base quantity unit of measure shall be the same as the Invoiced quantity unit of measure (BT-130).
Conditions (CIUS): In particular, the most common units of measurement are:LTR = litre (1 dm3)MTQ = cubic meterKGM = kilogramMTR = meterC62 = unitTNE = ton
Rule: BT-130, BT-150 and BT-150-1 must be equal if stated.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:BasisQuantity/@unitCodeFR: Unité de mesure de la quantité de base du prix de l'article — Unité de mesure applicable à la Quantité de base du prix de l'article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoicedItemVATCategoryCode
Sets BT-151 Invoiced item VAT category code — The VAT category code for the invoiced item.Usage: The following entries of UNTDID 5305 [6] are used (further clarification between brackets):- Standard rate (Liable for VAT in a standard way)- Zero rated goods (Liable for VAT with a percentage rate of zero)- Exempt from tax (VAT/IGIC/IPSI)- VAT Reverse Charge (Reverse charge VAT/IGIC/IPSI rules apply)- VAT exempt for intra community supply of goods (VAT/IGIC/IPSI not levied due to Intra-community supply rules)- Free export item, tax not charged (VAT/IGIC/IPSI not levied due to export outside of the EU)- Services outside scope of tax (Sale is not subject to VAT/IGIC/IPSI)- Canary Islands General Indirect Tax (Liable for IGIC tax)- Liable for IPSI (Ceuta/Melilla tax)
Conditions (CIUS): The VAT category codes are as follows:S = Standard VAT rateZ = Zero rated goodsE = VAT exemptAE = Reverse chargeK = Intra-Community supply (specific reverse charge)G = Exempt VAT for Export outside EUO = Outside VAT scopeL = Canary IslandsM = Ceuta and Mellila
Rule: BR-CO-4: Each Invoice line (BG-25) shall be categorized with an Invoiced item VAT category code (BT-151).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCodeFR: Code de type de TVA de l'article facturé — Code de type de TVA applicable à l'article facturé.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setInvoicedItemVATRate
Sets BT-152 Invoiced item VAT rate — The VAT rate, represented as percentage that applies to the invoiced item.Conditions (CIUS): The value to enter is the percentage. For example, for 20%, it must be given as 20 (and not 0.2)
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax/ram:RateApplicablePercentFR: Taux de TVA de l'article facturé — Taux de TVA, exprimé sous forme de pourcentage, applicable à l'article facturé.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setItemName
Sets BT-153 Item name — A name for an item.Rule: BR-25: Each Invoice line (BG-25) shall contain the Item name (BT- 153).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:NameFR: Nom de l'article — Nom d'un article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setItemDescription
Sets BT-154 Item description — A description for an item.Usage: The Item description allows for describing the item and its features in more detail than the Item name.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:DescriptionFR: Description de l'article — Description d'un article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setSellerAssignedID
Sets BT-155 Item Seller's identifier — An identifier, assigned by the Seller, for the item.XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:SellerAssignedIDFR: Identifiant vendeur de l'article — Identifiant attribué par le Vendeur à un article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.09.2/2.5.2
-
setBuyerAssignedID
Sets BT-156 Item Buyer's identifier — An identifier, assigned by the Buyer, for the item.XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:BuyerAssignedIDFR: Identifiant acheteur de l'article — Identifiant attribué par l'Acheteur à un article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.09.2/2.5.2
-
setItemStandardIdentifier
Sets BT-157 Item standard identifier — An item identifier based on a registered scheme.Conditions (CIUS): CHORUSPRO: this field is limited to 40 characters
Rule: BR-64: The Item standard identifier (BT-157) shall have a Scheme identifier
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:GlobalIDFR: Identifiant standard de l'article — Identifiant d'article basé sur un schéma enregistré.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.09.2/2.5.2
-
setSchemeIdentifierForItemStandardIdentifier
Sets BT-157-1 Scheme identifier for Item standard identifier — The identification scheme identifier of the Item standard identifierUsage: The identification scheme shall be identified from the entries of the list published by the ISO/IEC 6523 maintenance agency.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:GlobalID/@schemeIDFR: Identifiant du schéma — Identifiant du schéma de l'identifiant standard de l'article
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
setItemCountryOfOrigin
Sets BT-159 Item country of origin — The code identifying the country from which the item originates.Usage: The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:OriginTradeCountry/ram:IDFR: Pays d'origine de l'article — Code identifiant le pays d'où provient l'article.
- Parameters:
value- the value to set- Returns:
- this
InvoiceLinefor chaining - Since:
- 1.0.06/2.2
-
getInvoiceLineIdentifier
Returns BT-126 Invoice line identifier — A unique identifier for the individual line within the Invoice.Rule: BR-21: Each Invoice line (BG-25) shall have an Invoice line identifier (BT-126).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:AssociatedDocumentLineDocument/ram:LineIDFR: Identifiant de ligne de facture — Identifiant unique d'une ligne au sein de la Facture.
- Returns:
- the
BT-126value - Since:
- 1.09.2/2.5.2
-
getInvoiceLineNote
Returns BT-127 Invoice line note — A textual note that gives unstructured information that is relevant to the Invoice line.XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:AssociatedDocumentLineDocument/ram:IncludedNote/ram:ContentFR: Note de ligne de facture — Commentaire fournissant des informations non structurées concernant la ligne de Facture.
- Returns:
- the
BT-127value - Since:
- 1.0.06/2.2
-
getInvoicedQuantity
Returns BT-129 Invoiced quantity — The quantity of items (goods or services) that is charged in the Invoice line.Conditions (CIUS): CHORUS PRO: Invoiced quantity is supported on 10 digits maximum.
Rule: BR-22: Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantityFR: Quantité facturée — Quantité d'articles (biens ou services) prise en compte dans la ligne de Facture.
- Returns:
- the
BT-129value - Since:
- 1.0.06/2.2
-
getInvoicedQuantityUnitOfMeasureCode
Returns BT-130 Invoiced quantity unit of measure code — The unit of measure that applies to the invoiced quantity.Usage: The unit of measure shall be chosen from the lists in UN/ECE Recommendation N°. 20 “Codes for Units of Measure Used in International Trade” [7] and UN/ECE Recommendation N° 21 “Codes for Passengers, Types of Cargo, Packages and Packaging Materials (with Complementary Codes for Package Names)” [19] applying the method described in UN/ECE Rec N° 20 Intro 2.a). Note that in most cases it is not needed for Buyers and Sellers to implement these lists fully in their software. Sellers need only to support the units needed for their goods and services; Buyers only need to verify that the units used in the Invoice are equal to the units used in other documents (such as Contract, Catalogue, Order and Despatch advice).
Conditions (CIUS): In particular, the most common units of measurement are:LTR = litre (1 dm3)MTQ = cubic meterKGM = kilogramMTR = meterC62 = unitTNE = ton
Rule: BR-23: An Invoice line (BG-25) shall have an Invoiced quantity unit of measure code (BT-130).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity/@unitCodeFR: Unité de mesure de la quantité facturée — Unité de mesure applicable à la quantité facturée.
- Returns:
- the
BT-130value - Since:
- 1.0.06/2.2
-
getInvoiceLineBuyerAccountingReference
Returns BT-133 Invoice line Buyer accounting reference — A textual value that specifies where to book the relevant data into the Buyer's financial accounts.Usage: If required, this reference shall be provided by the Buyer to the Seller prior to the issuing of the Invoice.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ReceivableSpecifiedTradeAccountingAccount/ram:IDFR: Référence comptable de l'acheteur — Valeur textuelle spécifiant où imputer les données pertinentes dans les comptes comptables de l'Acheteur.
- Returns:
- the
BT-133value - Since:
- 1.0.06/2.2
-
getInvoiceLinePeriodStartDate
Returns BT-134 Invoice line period start date — The date when the Invoice period for this Invoice line starts.Usage: The date is the first day of the period.
Conditions (CIUS): This date must be less than or equal to the end date of the period (BT-135), if it exists
Rule: BR-CO-20: If Invoice line period (BG-26) is used, the Invoice line period start date (BT-134) or the Invoice line period end date (BT-135) shall be filled, or both.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:StartDateTime/udt:DateTimeStringFR: Date de début de période de facturation d'une ligne — Date à laquelle la période de facturation commence pour cette ligne de Facture.
- Returns:
- the
BT-134value - Since:
- 1.0.06/2.2
-
getStartDateFormat
Returns BT-134-0 Date format.Usage: Only value "102"
Rule: Only value "102"
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:StartDateTime/udt:DateTimeString/@formatFR: Date, format
- Returns:
- the
BT-134-0value - Throws:
ComputationException- Since:
- 1.0.06/2.2
-
getInvoiceLinePeriodEndDate
Returns BT-135 Invoice line period end date — The date when the Invoice period for this Invoice line ends.Usage: The date is the last day of the period.
Conditions (CIUS): This date must be greater than or equal to the period start date (BT-134), if it exists
Rule: BR-30: If both Invoice line period start date (BT-134) and Invoice line period end date (BT-135) are given then the Invoice line period end date (BT-135) shall be later or equal to the Invoice line period start date (BT-134).BR-CO-20: If Invoice line period (BG-26) is used, the Invoice line period start date (BT-134) or the Invoice line period end date (BT-135) shall be filled, or both.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:EndDateTime/udt:DateTimeStringFR: Date de fin de période de facturation d'une ligne — Date à laquelle la période de facturation se termine pour cette ligne de Facture.
- Returns:
- the
BT-135value - Since:
- 1.0.06/2.2
-
getEndDateFormat
Returns BT-135-0 Date format.Usage: Only value "102"
Rule: Only value "102"
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:EndDateTime/udt:DateTimeString/@formatFR: Date, format
- Returns:
- the
BT-135-0value - Throws:
ComputationException- Since:
- 1.0.06/2.2
-
getItemPriceDiscount
Returns BT-147 Item price discount — The total discount subtracted from the Item gross price to calculate the Item net price.Usage: Only applies if the discount is provided per unit and if it is not included in the Item gross price.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:AppliedTradeAllowanceCharge/ram:ActualAmountFR: Rabais sur le prix de l'article — Remise totale qui, une fois soustraite du Prix brut de l'article, donne le Prix net de l'article.
- Returns:
- the
BT-147value - Since:
- 1.0.06/2.2
-
getItemPriceChargeIndicator
Returns BT-147-02 (Item price discount).Usage: Price allowance => false
Rule: Value = false
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:AppliedTradeAllowanceCharge/ram:ChargeIndicator/udt:IndicatorFR: (Rabais sur le prix de l'article)
- Returns:
- the
BT-147-02value - Throws:
ComputationException- Since:
- 1.09.2/2.5.2
- API Note:
- This value is normally computed by the API. A value assigned through the corresponding setter is
returned here only if
Invoice.setRecompute(false)has been called and is in effect at the moment this getter is invoked; otherwise this getter returns the freshly computed value, which is also whattoXML()writes.
-
getNetItemPriceBaseQuantity
Returns BT-149 Item price base quantity — The number of item units to which the price applies.Conditions (CIUS): Optional, if filled and if BT-148 is present (EN16931 and EXTENDED profiles), then it should be the same value than BT-149-1
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:BasisQuantityFR: Quantité de base du prix de l'article — Nombre d'articles sur lequel s'applique le prix.
- Returns:
- the
BT-149value - Since:
- 1.0.06/2.2
-
getGrossItemPriceBaseQuantity
Returns BT-149-1 Item price base quantity — The number of item units to which the price applies.Conditions (CIUS): To fill if BT-149 is present and if BT-148 is present, with the same value than BT-149
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:BasisQuantityFR: Quantité de base du prix de l'article — Nombre d'articles sur lequel s'applique le prix.
- Returns:
- the
BT-149-1value - Since:
- 1.0.06/2.2
-
getNetItemPriceBaseQuantityUnitOfMeasureCode
Returns BT-150 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Usage: The Item price base quantity unit of measure shall be the same as the Invoiced quantity unit of measure (BT-130).
Conditions (CIUS): In particular, the most common units of measurement are:LTR = litre (1 dm3)MTQ = cubic meterKGM = kilogramMTR = meterC62 = unitTNE = ton
Rule: BT-130, BT-150 and BT-150-1 must be equal if stated.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:BasisQuantity/@unitCodeFR: Unité de mesure de la quantité de base du prix de l'article — Unité de mesure applicable à la Quantité de base du prix de l'article.
- Returns:
- the
BT-150value - Since:
- 1.0.06/2.2
-
getGrossItemPriceBaseQuantityUnitOfMeasureCode
Returns BT-150-1 Item price base quantity unit of measure code — The unit of measure that applies to the Item price base quantity.Usage: The Item price base quantity unit of measure shall be the same as the Invoiced quantity unit of measure (BT-130).
Conditions (CIUS): In particular, the most common units of measurement are:LTR = litre (1 dm3)MTQ = cubic meterKGM = kilogramMTR = meterC62 = unitTNE = ton
Rule: BT-130, BT-150 and BT-150-1 must be equal if stated.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:BasisQuantity/@unitCodeFR: Unité de mesure de la quantité de base du prix de l'article — Unité de mesure applicable à la Quantité de base du prix de l'article.
- Returns:
- the
BT-150-1value - Since:
- 1.0.06/2.2
-
getInvoicedItemVATCategoryCode
Returns BT-151 Invoiced item VAT category code — The VAT category code for the invoiced item.Usage: The following entries of UNTDID 5305 [6] are used (further clarification between brackets):- Standard rate (Liable for VAT in a standard way)- Zero rated goods (Liable for VAT with a percentage rate of zero)- Exempt from tax (VAT/IGIC/IPSI)- VAT Reverse Charge (Reverse charge VAT/IGIC/IPSI rules apply)- VAT exempt for intra community supply of goods (VAT/IGIC/IPSI not levied due to Intra-community supply rules)- Free export item, tax not charged (VAT/IGIC/IPSI not levied due to export outside of the EU)- Services outside scope of tax (Sale is not subject to VAT/IGIC/IPSI)- Canary Islands General Indirect Tax (Liable for IGIC tax)- Liable for IPSI (Ceuta/Melilla tax)
Conditions (CIUS): The VAT category codes are as follows:S = Standard VAT rateZ = Zero rated goodsE = VAT exemptAE = Reverse chargeK = Intra-Community supply (specific reverse charge)G = Exempt VAT for Export outside EUO = Outside VAT scopeL = Canary IslandsM = Ceuta and Mellila
Rule: BR-CO-4: Each Invoice line (BG-25) shall be categorized with an Invoiced item VAT category code (BT-151).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCodeFR: Code de type de TVA de l'article facturé — Code de type de TVA applicable à l'article facturé.
- Returns:
- the
BT-151value - Since:
- 1.0.06/2.2
-
getVATTypeCodeOnLineLevel
Returns BT-151-0 VAT type code on line level — The VAT category code for the invoiced item.Usage: For more information on the recommended codes, please refer to subclause 6.3.3.2 - Specification of VAT category codes.Fixed value = "VAT"
Rule: Fixed value "VAT"
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax/ram:TypeCodeFR: Code de type de TVAInvoiced item VAT category code, Content — The VAT category code for the invoiced item.
- Returns:
- the
BT-151-0value - Throws:
ComputationException- Since:
- 1.0.06/2.2
-
getInvoicedItemVATRate
Returns BT-152 Invoiced item VAT rate — The VAT rate, represented as percentage that applies to the invoiced item.Conditions (CIUS): The value to enter is the percentage. For example, for 20%, it must be given as 20 (and not 0.2)
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax/ram:RateApplicablePercentFR: Taux de TVA de l'article facturé — Taux de TVA, exprimé sous forme de pourcentage, applicable à l'article facturé.
- Returns:
- the
BT-152value - Since:
- 1.0.06/2.2
-
getItemName
Returns BT-153 Item name — A name for an item.Rule: BR-25: Each Invoice line (BG-25) shall contain the Item name (BT- 153).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:NameFR: Nom de l'article — Nom d'un article.
- Returns:
- the
BT-153value - Since:
- 1.0.06/2.2
-
getItemDescription
Returns BT-154 Item description — A description for an item.Usage: The Item description allows for describing the item and its features in more detail than the Item name.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:DescriptionFR: Description de l'article — Description d'un article.
- Returns:
- the
BT-154value - Since:
- 1.0.06/2.2
-
getSellerAssignedID
Returns BT-155 Item Seller's identifier — An identifier, assigned by the Seller, for the item.XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:SellerAssignedIDFR: Identifiant vendeur de l'article — Identifiant attribué par le Vendeur à un article.
- Returns:
- the
BT-155value - Since:
- 1.09.2/2.5.2
-
getBuyerAssignedID
Returns BT-156 Item Buyer's identifier — An identifier, assigned by the Buyer, for the item.XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:BuyerAssignedIDFR: Identifiant acheteur de l'article — Identifiant attribué par l'Acheteur à un article.
- Returns:
- the
BT-156value - Since:
- 1.09.2/2.5.2
-
getItemStandardIdentifier
Returns BT-157 Item standard identifier — An item identifier based on a registered scheme.Conditions (CIUS): CHORUSPRO: this field is limited to 40 characters
Rule: BR-64: The Item standard identifier (BT-157) shall have a Scheme identifier
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:GlobalIDFR: Identifiant standard de l'article — Identifiant d'article basé sur un schéma enregistré.
- Returns:
- the
BT-157value - Since:
- 1.09.2/2.5.2
-
getSchemeIdentifierForItemStandardIdentifier
Returns BT-157-1 Scheme identifier for Item standard identifier — The identification scheme identifier of the Item standard identifierUsage: The identification scheme shall be identified from the entries of the list published by the ISO/IEC 6523 maintenance agency.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:GlobalID/@schemeIDFR: Identifiant du schéma — Identifiant du schéma de l'identifiant standard de l'article
- Returns:
- the
BT-157-1value - Since:
- 1.0.06/2.2
-
getItemCountryOfOrigin
Returns BT-159 Item country of origin — The code identifying the country from which the item originates.Usage: The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions".
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedTradeProduct/ram:OriginTradeCountry/ram:IDFR: Pays d'origine de l'article — Code identifiant le pays d'où provient l'article.
- Returns:
- the
BT-159value - Since:
- 1.0.06/2.2
-
appendNewItemAttributes
Creates, appends and returns a newItemAttributes(BG-32 ITEM ATTRIBUTES).- Parameters:
itemAttributeName- BT-160 Item attribute name — The name of the attribute or property of the item.Usage: Such as "Colour".
Rule: BR-54: Each Item attribute (BG-32) shall contain an Item attribute name (BT-160) and an Item attribute value (BT-161).
FR: Nom d'attribut d'article — Nom de l'attribut ou de la propriété de l'article.
itemAttributeValue- BT-161 Item attribute value — The value of the attribute or property of the item.Usage: Such as "Red".
Rule: BR-54: Each Item attribute (BG-32) shall contain an Item attribute name (BT-160) and an Item attribute value (BT-161).
FR: Valeur d'attribut d'article — Valeur de l'attribut ou de la propriété de l'article.
- Returns:
- the new
ItemAttributes - Since:
- 1.09.2/2.5.2
-
appendNewItemAttributes
Deprecated. -
getItemAttributes
-
appendNewItemClassificationIdentifier
Creates, appends and returns a newItemClassificationIdentifier(BT-158-00 (ITEM CLASSIFICATION IDENTIFIER)).- Returns:
- the new
ItemClassificationIdentifier - Since:
- 1.0.06/2.2
-
getItemClassificationIdentifiers
-
appendNewReferencedPurchaseOrderLineReference
Creates, appends and returns a newReferencedPurchaseOrderLineReference(BT-132-00 (Referenced purchase order line reference)).- Returns:
- the new
ReferencedPurchaseOrderLineReference - Since:
- 1.0.06/2.2
-
getReferencedPurchaseOrderLineReferences
-
appendNewInvoiceLineAllowance
-
getInvoiceLineAllowances
-
appendNewInvoiceLineCharge
-
getInvoiceLineCharges
-
appendNewInvoiceLineObjectIdentifier
public InvoiceLineObjectIdentifier appendNewInvoiceLineObjectIdentifier(String invoiceLineObjectIdentifier, Codes.InvoiceTypeCode130 typeCode) Creates, appends and returns a newInvoiceLineObjectIdentifier(BT-128-00 (Invoice line object identifier)).- Parameters:
invoiceLineObjectIdentifier- BT-128 Invoice line object identifier — An identifier for an object on which the invoice line is based, given by the Seller.Usage: It may be a subscription number, telephone number, meter point etc., as applicable.
FR: Identifiant de l'objet à la ligne — Identifiant d'un objet sur lequel la ligne de facturation est basée, attribué par le vendeur.
typeCode- BT-128-0 0Usage: Value = 130
Rule: Use with TypeCode "130"
- Returns:
- the new
InvoiceLineObjectIdentifier - Since:
- 1.09.2/2.5.2
-
appendNewInvoiceLineObjectIdentifier
Deprecated. -
getInvoiceLineObjectIdentifiers
-
getInvoiceLineNetAmount
Returns BT-131 Invoice line net amount — The total amount of the Invoice line.Usage: The amount is “net” without VAT, i.e. inclusive of line level allowances and charges as well as other relevant taxes.
Rule: BR-24: Each Invoice line (BG-25) shall have an Invoice line net amount (BT-131).
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeSettlementLineMonetarySummation/ram:LineTotalAmountFR: Montant net de ligne de facture — Montant total de la ligne de Facture.
- Returns:
- the
BT-131value - Throws:
ComputationException- Since:
- 1.0.06/2.2
- API Note:
- This value is normally computed by the API. A value assigned through the corresponding setter is
returned here only if
Invoice.setRecompute(false)is in effect, or line-amount computation has been disabled (thefacturx.computeBT131system property set tofalse), at the moment this getter is invoked; otherwise this getter returns the freshly computed value, which is also whattoXML()writes.
-
getItemNetPrice
Returns BT-146 Item net price — The price of an item, exclusive of VAT, after subtracting item price discount.Usage: The Item net price has to be equal with the Item gross price less the Item price discount.
Conditions (CIUS): The Item net price MUST NOT be negative
Rule: BR-26: Each Invoice line (BG-25) shall contain the Item net price (BT-146).BR-27: The Item net price (BT-146) shall NOT be negative.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:ChargeAmountFR: Prix net de l'article — Prix d'un article, hors TVA, après application du Rabais sur le prix de l'article.
- Returns:
- the
BT-146value - Throws:
ComputationException- Since:
- 1.0.06/2.2
- API Note:
- This value is normally computed by the API. A value assigned through the corresponding setter is
always returned here (and written by
toXML()); unlike the other computed fields, recomputation never overrides an explicitly set value.
-
getItemGrossPrice
Returns BT-148 Item gross price — The unit price, exclusive of VAT, before subtracting Item price discount.Conditions (CIUS): The Item gross price MUST NOT be negative
Rule: BR-28: The Item gross price (BT-148) shall NOT be negative.
XPath:
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeAgreement/ram:GrossPriceProductTradePrice/ram:ChargeAmountFR: Prix brut de l'article — Prix unitaire, hors TVA, avant application du Rabais sur le prix de l'article.
- Returns:
- the
BT-148value - Throws:
ComputationException- Since:
- 1.0.06/2.2
- API Note:
- This value is normally computed by the API. A value assigned through the corresponding setter is
always returned here (and written by
toXML()); unlike the other computed fields, recomputation never overrides an explicitly set value.
-