gtARStandingInvoice
This function supplies the information needed to create an AR Standing Invoice header. The unique identifier returned by the function call is structured as: ARST-nnn, if nnn is a sequential number that is unique for the current Excel session. This number links the AR Standing Invoice line item function calls with its header 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.
Company
The code of the company in which the invoice is created.
Branch
The branch code that the invoice belongs to.
Reference
The reference number for the invoice. This must be unique.
Customer
The customer code.
DateStart
The standing invoice start date.
DateEnd
The standing invoice end date.
DateNext
The next action date for the standing invoice.
FreqType
The frequency type: Day, Week, Month, Last day of month, Last day of period, and Year.
Freq
The frequency (used with type to determine next action dates). This must be an integer.
Narration
Narration of the standing invoice if applicable.
SalesPerson
The salesperson of the invoice. This defaults if left blank.
PaymentTerms
Supplier's payment terms, This is taken from the supplier if left blank.
OrderNo
The customer order number of the invoice, if applicable.
CurrencyRate
This is enabled if IsFixedTransRate is True. An exchange rate can be set specifically for the standing invoice. If left blank, the rate is determined when the invoice is generated.
CurrencyCode
Leave empty - this defaults to the supplier's currency code.
IsFixedTransRate
Defaults to True. If this is selected, the currency rate is fixed with the invoice.
IsCurrRateMultiply
Defaults to True. If true the currency rate is a multiply rate rather than a divide rate.
RecalculatePrice
Defaults to False. Indicates whether the invoice price is recalculated when the invoice is generated.
DeliveryAddressNo
The delivery address number of the invoice, if applicable.
Returns
Unique identifier.
Errors Returned
- Must have a Company Identifier
- Must have a Branch Identifier
- Must have an Invoice Reference
- Must have a Customer Identifier
- Must have a Start Date
- Must have an End Date
- Invalid Frequency Type
- Invalid Frequency
- Invalid Narration, must be a string or omitted
- Invalid Currency Rate
- Invalid Multiply Rate flag