gtARCreditNoteINLine
This function supplies the information to add Inventory line items to Accounts Receivable Credit Note headers. The critical link is the Credit Note Reference parameter must be the unique ID returned by the gtARCreditNote function call.
Each Accounts Receivable Credit Note is uploaded to Greentree Desktop as a complete transaction set. The AR Credit Note either uploads in its entirety or nothing of the document is loaded into Greentree Desktop.
If the Inventory line being added is for a serial or lot item then the serial or lot numbers can be entered for the line using the gtINSerialLotLine function.
InvoiceReference
This must be the unique identifier generated by the gtARCreditNote function call. It has the format ARCN-nnn. This ensures the lines are of the correct Credit Note header details and it ensures Excel creates the header information before attempting to calculate and create the credit note line item details.
TransType
The transaction type for the transaction.
StockItem
The inventory item code for the transaction.
Net
The net amount of the line.
Tax
The amount of tax for this line.
Narration
Narration for the credit note line item.
TaxType
Valid tax types are Inclusive or Exclusive.
UOM
Unit of Measure for this inventory item (for example, EA for each)
Location (only mandatory if locations are in use)
The full location path for the inventory item.
PriceLevel
Indicates the pricing level which applies to this inventory item.
HoldAmount
The amount to be put on hold for this line.
DiscAmount
The amount of discount given on this line.
Quantity
The number of units relevant for this line. Defaults to 0.
UnitPrice
Price per unit of quantity. Normally zero on non-quantity general ledger accounts.
TaxPerc
The percentage of tax for this line item.
DiscPerc
The percentage discount given. Defaults to 0.
TaxCode
The code that determines the tax rate and type for the transaction. If not entered and Greentree Desktop cannot find a valid default, then an error is returned and the user must enter a valid code.
Returns
- Ok - If there are no errors.
- Error - If there is an error.
Errors Returned
- Invalid Invoice header reference. Should be ARCN-nnn
- Must have an Inventory Transaction Type
- Must have a inventory Item number
- Invalid Quantity. Must be number or omitted
- Invalid Hold Amount. Must be number or omitted
- Invalid Discount Amount. Must be number or omitted
- Invalid Unit Price. Must be number or omitted
- Invalid Tax Percentage. Must be number or omitted
- Invalid Discount Percentage. Must be number or omitted