gtARStandingInvoiceNSLine

---

This function supplies the information to add NS lines to AR Standing Invoice headers. The InvoiceReference parameter must be the unique ID returned by the gtARStandingInvoice function call.

Each AR Standing Invoice is uploaded to Greentree Desktop as a complete transaction set. The standing 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 gtARStandingInvoice function call. It has the format ARST-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 code of the line.

Amount

The net amount of the line.

Tax

The tax amount of the line.

Narration

Narration for the line, if applicable.

TaxType

Valid tax types are Inclusive or Exclusive.

DiscAmount

The discount amount for the line, if applicable.

Quantity

The number of units relevant for the line. Defaults to 0.

UnitPrice

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

TaxPerc

Tax percentage of the line. This defaults if left blank.

DiscPerc

Discount percentage of the line (if applicable). Defaults to zero.

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.

SubCode

The sub code for the non stock item, if applicable.

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

---