gtARInvoiceNSLine

---

This function supplies the information to add non-stock line items to Accounts Receivable invoice headers. The InvoiceReference parameter must be the unique ID returned by the gtARInvoice function call.

Each Accounts Receivable Invoice is uploaded to Greentree Desktop as a complete transaction set. The invoice either uploads in its entirety or nothing of the document is loaded into Greentree Desktop.

InvoiceReference

This must be the unique identifier generated by the gtARInvoice function call. It has the format ARINV-nnn. This ensures the lines are of the correct invoice header details and it ensures Excel creates the header information before attempting to calculate and create the invoice line item details.

NSCode

The non-stock item identifying code.

Net

The net amount of the line.

Tax

The amount of tax for this line.

Narration

The narration for the transaction.

TaxType

Valid tax types are Inclusive or Exclusive.

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

The price per unit of quantity above. Defaults to 0.

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, an error returns and the user must enter a valid code.

Returns

Ok if all is okay.

Errors Returned

• Must have a valid Invoice Reference number
• Must have a Non-stock code number
• Invalid Quantity. Must be number or omitted
• Invalid Hold Amount, must be a number or omitted
• Invalid Unit Price, must be a number or omitted
• Invalid Tax Percentage, must be a number or omitted
• Invalid Discount Amount. Must be number or omitted
• Invalid Discount Percentage. Must be number or omitted

---