gtARCreditNote

This function provides the information for the credit note header. This header must exist before credit note line items can be added to it. The function returns a unique identifier that links the associated line items.

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

The unique identifier returned by the function call is structured as ARCN-nnn if nnn is a sequential number that is unique for the current Excel session. This number links the AR Credit Note line item function calls with its header call. This number is not updated to or in any way passed to Greentree.

Company

The company identifier that the credit note is created in.

Batch

The batch number the credit note is posted in. A new batch is created if it does not exist and a Batch Description is entered.

BatchDesc

The batch description if a new batch is created. Ignored if the batch already exists. If the batch description is null and the batch does not exist, an error is returned.

Branch

The branch code that the credit note belongs to.

Reference

The customers credit note number. A credit note with this number cannot already exist for the customer or an error is returned.

Customer

The Customer code for the transaction.

DocumentDate

The document date for the credit note entry.

PostingDate

The posting date for the transaction. This determines the financial period the credit note posts to.

SalesPerson

The salesman for the transaction.

PaymentDate

The date the invoice is due for payment. If this date is left blank, the payment date is calculated from the customer's payment terms.

Narration

Narration for the credit note header.

CurrencyRate

The rate for the foreign currency transaction.

MulitplyRate

Defaults to True. If True, the rate above is a multiply rate rather than a divide rate.

Returns

Unique identifier.

Errors Returned

Must have a Company Identifier
Must have a Batch Identifier
Must have a Branch Identifier
Must have a Credit Note Reference
Must have a Customer Number
Must have a Salesperson identifier
Must have a Document Date
Must have a Posting Date
Invalid Payment Date
Invalid Narration, must be a string or omitted
Invalid Currency Rate, must be a number or omitted
Invalid MultplyRate, must be True, False or omitted