DetailRecordAddendum Property

Optional Detail Record Addendum data (such as Level2 or Level3 data) The DetailAggregate property contains an xml aggregate of the transaction retrieved from the TSYSECOMMERCE , TSYSRETAIL , or TSYSDETAILRECORD component's GetDetailAggregate method.

Syntax

tsyssettlecontrol.DetailRecordAddendum(DetailRecordIndex)[=string]

Default Value

""

Remarks

Optional Detail Record Addendum data (such as Level2 or Level3 data)

The DetailRecordDetailAggregate property contains an xml aggregate of the transaction retrieved from the TSYSECommerce, TSYSRetail, or TSYSDetailRecord control's GetDetailAggregate method. If you wish to accept corporate purchasing cards you will also need to send Level2, and possibly Level3 addendum data along with the DetailRecordDetailAggregate. The DetailRecordAddendumAggregate property takes an xml aggregate containing either Level2 or Level3 addendum data, which will be added to the DetailRecordDetailAggregate. The addendum aggregate may be created with either the TSYSLevel2 or TSYSLevel3 controls, and then returned via those control's GetAddendum method.

For example:

  'First authorize the credit card
  TSYSECommerce1.TransactionAmount = "53"
  TSYSECommerce.Authorize()
  
  'Then, put the result into the settlement component
  TSYSSettle.DetailRecordCount = 1
  TSYSSettle.DetailAggregate[0] = TSYSECommerce.GetDetailAggregate()

  'Now build the Level3 Extension. 
  'The following properties are required for a Visa Corporate Purchasing Card:
  TSYSLevel3.CardType = ctVisa
  TSYSLevel3.LocalTax = "EXEMPT"
  TSYSLevel3.NationalTax = "0"
  TSYSLevel3.PurchaseOrder = "purchOrdNum"
  TSYSLevel3.MerchantTaxId = "merchantTaxId"
  TSYSLevel3.CustomerTaxId = "customerTaxId"
  TSYSLevel3.CommodityCode = "fake"
  TSYSLevel3.DiscountAmount = "0"
  TSYSLevel3.FreightAmount = "0"
  TSYSLevel3.DutyAmount = "0"
  TSYSLevel3.DestinationZip = "27709"
  TSYSLevel3.ShipFromZip = "27709"
  TSYSLevel3.DestinationCountry = "840"
  TSYSLevel3.TaxInvoiceNumber = "VATInvoiceRefNo"
  TSYSLevel3.OrderDate = "060526"
  TSYSLevel3.FreightTaxAmount = "0"
  TSYSLevel3.FreightTaxRate = "0"
  
  'Begin adding line items:
  TSYSLevel3.LineItemCount = 2
  
  TSYSLevel3.LineItemCommodityCode(0) = "fake"
  TSYSLevel3.LineItemDescription(0) = "hardware"
  TSYSLevel3.LineItemProductCode(0) = "productCode123"
  TSYSLevel3.LineItemQuantity(0) = 1
  TSYSLevel3.LineItemUnits(0) = ""
  TSYSLevel3.LineItemUnitCost(0) = "33"
  TSYSLevel3.LineItemTaxAmount(0) = "0"
  TSYSLevel3.LineItemTaxRate(0) = "0"
  TSYSLevel3.LineItemDiscountAmount(0) = "0"
  TSYSLevel3.LineItemTotal(0) = "33"
  
  TSYSLevel3.LineItemCommodityCode(1) = "fake"
  TSYSLevel3.LineItemDescription(1) = "hardware"
  TSYSLevel3.LineItemProductCode(1) = "productCode124"
  TSYSLevel3.LineItemQuantity(1) = 1
  TSYSLevel3.LineItemUnits(1) = ""
  TSYSLevel3.LineItemUnitCost(1) = "20"
  TSYSLevel3.LineItemTaxAmount(1) = "0"
  TSYSLevel3.LineItemTaxRate(1) = "0"
  TSYSLevel3.LineItemDiscountAmount(1) = "0"
  TSYSLevel3.LineItemTotal(1) = "20"
  
  'Finally, add the Level3 addendum to the same index in the settlement.
  TSYSSettle.DetailRecordAddendum(0) = TSYSLevel31.GetAddendum()

Note that you may mix corporate and non-corporate card transactions in the same settlement. It is not necessary that all DetailRecordDetailAggregates have a corresponding DetailRecordAddendumAggregate.

The size of the array is controlled by the DetailRecordCount property.

This property is not available at design time.

Data Type

String