quickbooks-api/src/packages/api/credit-memo/services/get-credit-memos-for-date-range.ts

A modular TypeScript SDK for seamless integration with Intuit QuickBooks APIs. Provides robust authentication handling and future-ready foundation for accounting, payments, and commerce operations.

// Import the Query Builder
import { QuickbooksError, type CreditMemo, type CreditMemoOptions, type SearchResponse } from '../../../../types/types';
import { ApiClient } from '../../api-client';
import { CreditMemoAPI } from '../credit-memo-api';

/**
 * Get CreditMemos for a Date Range
 * @param this - The CreditMemo API
 * @param startDate - The start date
 * @param endDate - The end date
 * @returns The CreditMemos
 */
export async function getCreditMemosForDateRange(
	this: CreditMemoAPI,
	startDate: Date,
	endDate: Date,
	options: CreditMemoOptions = {},
): Promise<SearchResponse<CreditMemo>> {
	// Ensure the Start Date is Before the End Date
	if (startDate > endDate) throw new QuickbooksError('Start date must be before end date', await ApiClient.getIntuitErrorDetails(null));

	// Get the Query Builder
	const queryBuilder = await this.getQueryBuilder();

	// Setup the Date Range Filters
	queryBuilder.whereLastUpdatedAfter(startDate);
	queryBuilder.whereLastUpdatedBefore(endDate);

	// Setup the Search Options (if provided)
	if (options.searchOptions) queryBuilder.setSearchOptions(options.searchOptions);

	// Setup the URL
	const url = queryBuilder.build();

	// Get the CreditMemos
	const { responseData, intuitTID } = await this.apiClient.runRequest(url, { method: 'GET' });

	// Format the Response
	const creditmemos = await this.formatResponse(responseData);

	// Setup the Search Response
	const searchResponse: SearchResponse<CreditMemo> = {
		results: creditmemos,
		hasNextPage: await this.hasNextPage(queryBuilder),
		intuitTID,
	};

	// Return the CreditMemos
	return searchResponse;
}