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, where 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 as a complete transaction set. The standing invoice will either be uploaded in its entirety or nothing of the document will be loaded into Greentree Desktop.
Company
The company code of the company the invoice is to be created in.
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 will be fixed against 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 will be 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