SInvce::Transfer (Interface: SInvce)
 
Transfers the Sales Invoice to a Sales Document.
 
void Transfer ()
 
Remarks
The option 'Accounting' is required to use this method.
Transfer() does not support sales invoices with payments (properties pAmountPayedDocC, pPayment1AmountDocC, pPayment2AmountDocC and pPayment3AmountDocC).
When a sales invoice is transferred, it is placed into a separate transfer group.
Transferring an invoice destroys the object positioning that was previously established via a SeekBy-method and the GetNext/GetPrevious-methods. The results of calling GetNext or GetPrevious after a transfer are not guaranteed.
The Transfer() method makes use of the parameters specified in the Transfer Dialog.
If the option 'Access management' is active, the user must have sufficient rights for performing a manual transfer via the Selective Transfer Dialog, otherwise an exception will be thrown.
When a credit note is transferred which has a reference to an invoice, the invoice will be ticked against the credit note when the appropriate conditions are met:
The invoice must already be transferred to accounting.
If the invoice was created in a previous financial year, the transfer of the previous financial year to the current financial year for the customer balance must have been performed (either partially or complete).
The invoice must still have an open amount.
If the invoice has no open amount, then the reference in the credit note will be ignored.
At most the open amount of the invoice will be ticked. If the total amount of the credit note exceeds the open amount of the invoice, the invoice will be closed, and part of the credit note amount will remain open.
To perform the ticking, a sundry document is inserted with the same book date as the credit note, and using the book as specified in the parameters of the transfer dialog, or by lack thereof, the tick book as specified in the general accounting parameters.
 
See Also
CreateSInvce
SeekByBook
 
Samples
 
C++
 
// Transfer a specific sales invoice
if (pSInvce->SeekByBook (smEqual, "Book", 12))
    pSInvce->Transfer ();

C#
 
// Transfer a specific sales invoice
if (oSInvce.SeekByBook (eSeekMode.smEqual, "Book", 12))
    oSInvce.Transfer ();

VBS
 
' Transfer a specific sales invoice
If oSInvce.SeekByBook(smEqual, "Book", 12) Then
    Call oSInvce.Transfer()
End If

VB.NET
 
' Transfer a specific sales invoice
If oSInvce.SeekByBook(eSeekMode.smEqual, "Book", 12) Then
    oSInvce.Transfer()
End If