public class DocumentLevelAllowances
extends java.lang.Object
A group of business terms providing information about allowances applicable to the Invoice as a whole.
Deductions, such as withheld tax may also be specified in this group.
ChargeIndicator=false
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge
public DocumentLevelAllowances setAllowanceOrChargeIndicatorValue(java.lang.Boolean value)
value
- BG-20-1:Allowance or Charge indicator Value
Value = false
Value = false
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ChargeIndicator/udt:Indicator
public DocumentLevelAllowances setDocumentLevelAllowancePercentage(Percentage value)
value
- BT-94:Document level allowance percentage
The percentage that may be used, in conjunction with the document level allowance base amount, to calculate the document level allowance amount.
The value to enter is the percentage. For example, for 20%, it must be filled 20 (and not 0.2)
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CalculationPercent
public DocumentLevelAllowances setDocumentLevelAllowanceBaseAmount(Amount value)
value
- BT-93:Document level allowance base amount
The base amount that may be used, in conjunction with the document level allowance percentage, to calculate the document level allowance amount.
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:BasisAmount
public DocumentLevelAllowances setDocumentLevelAllowanceAmount(Amount value)
value
- BT-92:Document level allowance amount
The amount of an allowance, without VAT.
BR-31: Each Document level allowance (BG-20) shall have a Document level allowance amount (BT-92).
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ActualAmount
public DocumentLevelAllowances setDocumentLevelAllowanceReasonCode(Codes.SubsetForAllowanceIdentificationCode value)
value
- BT-98:Document level allowance reason code
The reason for the document level allowance, expressed as a code.
Use entries of the UNTDID 5189 code list [6]. The Document level allowance reason code and the Document level allowance reason shall indicate the same allowance reason.
BR-33: Each Document level allowance (BG-20) shall have a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98).BR-CO-5: Document level allowance reason code (BT-98) and Document level allowance reason (BT-97) shall indicate the same type of allowance.BR-CO-21: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode
public DocumentLevelAllowances setDocumentLevelAllowanceReason(java.lang.String value)
value
- BT-97:Document level allowance reason
The reason for the document level allowance, expressed as text.
BR-33: Each Document level allowance (BG-20) shall have a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98).BR-CO-5: Document level allowance reason code (BT-98) and Document level allowance reason (BT-97) shall indicate the same type of allowance.BR-CO-21: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:Reason
public DocumentLevelAllowances setDocumentLevelAllowanceVATCategoryCode(Codes.VATCategoryCode value)
value
- BT-95:Document level allowance VAT category code
A coded identification of what VAT category applies to the document level allowance.
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)
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
BR-32: Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95).
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:CategoryCode
public DocumentLevelAllowances setDocumentLevelAllowanceVATRate(Percentage value)
value
- BT-96:Document level allowance VAT rate
The VAT rate, represented as percentage that applies to the document level allowance.
The value to enter is the percentage. For example, for 20%, it must be filled 20 (and not 0.2)
XPath:/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:RateApplicablePercent
public java.lang.Boolean getAllowanceOrChargeIndicatorValue()
Value = false
Value = false
public Percentage getDocumentLevelAllowancePercentage()
The percentage that may be used, in conjunction with the document level allowance base amount, to calculate the document level allowance amount.
The value to enter is the percentage. For example, for 20%, it must be filled 20 (and not 0.2)
public Amount getDocumentLevelAllowanceBaseAmount()
The base amount that may be used, in conjunction with the document level allowance percentage, to calculate the document level allowance amount.
public Amount getDocumentLevelAllowanceAmount()
The amount of an allowance, without VAT.
BR-31: Each Document level allowance (BG-20) shall have a Document level allowance amount (BT-92).
public Codes.SubsetForAllowanceIdentificationCode getDocumentLevelAllowanceReasonCode()
The reason for the document level allowance, expressed as a code.
Use entries of the UNTDID 5189 code list [6]. The Document level allowance reason code and the Document level allowance reason shall indicate the same allowance reason.
BR-33: Each Document level allowance (BG-20) shall have a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98).BR-CO-5: Document level allowance reason code (BT-98) and Document level allowance reason (BT-97) shall indicate the same type of allowance.BR-CO-21: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.
public java.lang.String getDocumentLevelAllowanceReason()
The reason for the document level allowance, expressed as text.
BR-33: Each Document level allowance (BG-20) shall have a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98).BR-CO-5: Document level allowance reason code (BT-98) and Document level allowance reason (BT-97) shall indicate the same type of allowance.BR-CO-21: Each Document level allowance (BG-20) shall contain a Document level allowance reason (BT-97) or a Document level allowance reason code (BT-98), or both.
public Codes.VATTypeCode getVATTypeCodeForDocumentLevelAllowances() throws ComputationException
Value = VAT
Fixed value "VAT"
Invoice.setRecompute(boolean)
has been called with a value of false in which case the value /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:TypeCode is returnedComputationException
public Codes.VATCategoryCode getDocumentLevelAllowanceVATCategoryCode()
A coded identification of what VAT category applies to the document level allowance.
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)
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
BR-32: Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95).
public Percentage getDocumentLevelAllowanceVATRate()
The VAT rate, represented as percentage that applies to the document level allowance.
The value to enter is the percentage. For example, for 20%, it must be filled 20 (and not 0.2)