ItemReceipts

5 min read
    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceipt Record Count. Returns number of records in QuickBooks
    ''' In case of error returns: will return -1
    ''' </summary>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptRecordCount(Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As Integer

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get All ItemReceipt. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' NOTE: IF YOU HAVE TOO MANY RECORDS GET ItemReceipt BY DATERANGE
    ''' </summary>
    ''' <param name="ActiveStatus">qbActiveStatus enum. Values (ActiveOnly [DEFAULT], InactiveOnly, All)</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetAllItemReceipt(Optional ByVal ActiveStatus As qbActiveStatus = qbActiveStatus.All, Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceipt By ListIDs. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' NOTE: IF YOU HAVE TOO MANY RECORDS GET ItemReceipt BY DATERANGE
    ''' </summary>
    ''' <param name="ListIDs">ListIDs of the ItemReceipt. If it is one ListIDs, just add one ListID to the List(Of String)</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByListIDs(ByVal ListIDs As List(Of String), Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceipt By FullNames. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' NOTE: IF YOU HAVE TOO MANY RECORDS GET ItemReceipt BY DATERANGE
    ''' </summary>
    ''' <param name="FullNames">FullNames of the ItemReceipt. If it is one FullNames, just add one FullNames to the List(Of String)</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByFullNames(ByVal FullNames As List(Of String), Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceipts By DateRange. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="FromModifiedDate">FromDate</param>
    ''' <param name="ToModifiedDate">ToDate</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptsByDateRange(ByVal FromModifiedDate As DateTime, ByVal ToModifiedDate As DateTime, Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceipts By Name. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="Name">ItemReceipt Name</param>
    ''' <param name="MatchCriterion">qbMatchCriterion enum. Values(StartsWith, Contains, EndsWith)</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByName(ByVal Name As String, ByVal MatchCriterion As qbMatchCriterion, Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceipts By NameRange. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="FromName">FromName value</param>
    ''' <param name="ToName">ToName value.</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByNameRange(ByVal FromName As String, ByVal ToName As String, Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceiptBy Class ListIDs. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="ListIDs">Entities ListIDs</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByClassListIDs(ByVal ListIDs As List(Of String), Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceiptBy Class FullNames. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="FullNames">Entities FullNames</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByClassFullNames(ByVal FullNames As List(Of String), Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceiptBy Class ListIDWithChildren. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="ListIDWithChildren">Class ListIDWithChildren</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByClassListIDWithChildren(ByVal ListIDWithChildren As String, Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' QuickBooks connection needs to be open first.
    ''' Get ItemReceiptBy Class FullNameWithChildren. Returns List(Of ItemReceipt)
    ''' In case of error returns: new List(Of ItemReceipt)
    ''' </summary>
    ''' <param name="FullNameWithChildren">Class FullNameWithChildren</param>
    ''' <param name="MaxReturned">max number of records to get</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function GetItemReceiptByClassFullNameWithChildren(ByVal FullNameWithChildren As String, Optional ByVal MaxReturned As Integer = 0, Optional ByRef errorMsg As String = "") As List(Of ItemReceipt)

    ''' <summary>
    ''' It will delete the record from QuickBooks.
    ''' Once deleted, there is no way to retrieve
    ''' </summary>
    ''' <param name="ListID">to add new records to QB set ListID to a temporal one</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function DeleteItemReceiptFromQuickBooksByListID(ByVal ListID As String, Optional ByRef errorMsg As String = "") As Boolean

    ''' <summary>
    ''' It will add a new ItemReceipt to ItemReceiptList.
    ''' CustomField1-CustomField15: Fotmat[CustomFieldName:CustomFieldValue]
    ''' </summary>
    ''' <param name="_ListID">to add new records to QB set ListID to a temporal one</param>
    ''' <param name="_Operation">set to empty, update, add, or delete</param>
    ''' <param name="errorMsg">returned error message</param>
Public Function AddToItemReceiptList(_TxnID As String, _VendorRef_ListID As String, _VendorRef_FullName As String, Optional ByVal _TimeCreated As String = "", Optional ByVal _TimeModified As String = "", Optional ByVal _EditSequence As String = "", Optional ByVal _TxnNumber As String = "", Optional ByVal _APAccountRef_ListID As String = "", Optional ByVal _APAccountRef_FullName As String = "", Optional ByVal _TxnDate As String = "", Optional ByVal _TotalAmount As String = "", Optional ByVal _CurrencyRef_ListID As String = "", Optional ByVal _CurrencyRef_FullName As String = "", Optional ByVal _LiabilityAccountRef_ListID As String = "", Optional ByVal _LiabilityAccountRef_FullName As String = "", Optional ByVal _ExchangeRate As String = "", Optional ByVal _TotalAmountInHomeCurrency As String = "", Optional ByVal _RefNumber As String = "", Optional ByVal _Memo As String = "", Optional ByVal _IsTaxIncluded As String = "", Optional ByVal _SalesTaxCodeRef_ListID As String = "", Optional ByVal _SalesTaxCodeRef_FullName As String = "", Optional ByVal _CustomField1 As String = "", Optional ByVal _CustomField2 As String = "", Optional ByVal _CustomField3 As String = "", Optional ByVal _CustomField4 As String = "", Optional ByVal _CustomField5 As String = "", Optional ByVal _CustomField6 As String = "", Optional ByVal _CustomField7 As String = "", Optional ByVal _CustomField8 As String = "", Optional ByVal _CustomField9 As String = "", Optional ByVal _CustomField10 As String = "", Optional ByVal _CustomField11 As String = "", Optional ByVal _CustomField12 As String = "", Optional ByVal _CustomField13 As String = "", Optional ByVal _CustomField14 As String = "", Optional ByVal _CustomField15 As String = "", Optional ByVal _ExternalGUID As String = "", Optional ByVal _UserData As String = "", Optional ByVal _Operation As String = "", Optional ByRef errorMsg As String = "") As ItemReceipt