import {z} from 'zod' export type GetApiQuickbooksDesktopSalesReceiptsArgs = {'Conductor-End-User-Id': string, ids?: Array | undefined, refNumbers?: Array | undefined, limit?: number | undefined, cursor?: string | undefined, updatedAfter?: string | undefined, updatedBefore?: string | undefined, transactionDateFrom?: string | undefined, transactionDateTo?: string | undefined, customerIds?: Array | undefined, accountIds?: Array | undefined, refNumberContains?: string | undefined, refNumberStartsWith?: string | undefined, refNumberEndsWith?: string | undefined, refNumberFrom?: string | undefined, refNumberTo?: string | undefined, currencyIds?: Array | undefined, includeLineItems?: boolean | undefined}; export type GetApiQuickbooksDesktopSalesReceiptsOptions = {baseUrl?: string | undefined, BearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const qbdAddress = z.object({line1: z.string().nullable(), line2: z.string().nullable(), line3: z.string().nullable(), line4: z.string().nullable(), line5: z.string().nullable(), city: z.string().nullable(), state: z.string().nullable(), postalCode: z.string().nullable(), country: z.string().nullable(), note: z.string().nullable()}); export const qbdCreditCardTransactionRequest = z.object({number: z.string(), expirationMonth: z.number(), expirationYear: z.number(), name: z.string().nullable(), address: z.string().nullable(), postalCode: z.string().nullable(), commercialCardCode: z.string().nullable(), transactionMode: z.enum(["card_not_present", "card_present"]).nullable(), transactionType: z.enum(["authorization", "capture", "charge", "refund", "voice_authorization"]).nullable()}); export const qbdCreditCardTransactionResponse = z.object({statusCode: z.number(), statusMessage: z.string(), creditCardTransactionId: z.string(), merchantAccountNumber: z.string(), authorizationCode: z.string().nullable(), avsStreetStatus: z.enum(["fail", "not_available", "pass"]).nullable(), avsZipStatus: z.enum(["fail", "not_available", "pass"]).nullable(), cardSecurityCodeMatch: z.enum(["fail", "not_available", "pass"]).nullable(), reconBatchId: z.string().nullable(), paymentGroupingCode: z.number().nullable(), paymentStatus: z.enum(["completed", "unknown"]), transactionAuthorizedAt: z.string(), transactionAuthorizationStamp: z.number().nullable(), clientTransactionId: z.string().nullable()}); export const qbdCreditCardTransaction = z.object({request: qbdCreditCardTransactionRequest.nullable(), response: qbdCreditCardTransactionResponse.nullable()}); export const qbdCustomField = z.object({ownerId: z.string(), name: z.string(), type: z.enum(["amount_type", "date_time_type", "integer_type", "percent_type", "price_type", "quantity_type", "string_1024_type", "string_255_type"]), value: z.string()}); export const qbdSalesReceiptLine = z.object({id: z.string(), objectType: z.literal("qbd_sales_receipt_line"), item: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), description: z.string().nullable(), quantity: z.number().nullable(), unitOfMeasure: z.string().nullable(), overrideUnitOfMeasureSet: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), rate: z.string().nullable(), ratePercent: z.string().nullable(), class: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), amount: z.string().nullable(), inventorySite: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), inventorySiteLocation: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), serialNumber: z.string().nullable(), lotNumber: z.string().nullable(), expirationDate: z.string().nullable(), serviceDate: z.string().nullable(), salesTaxCode: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), otherCustomField1: z.string().nullable(), otherCustomField2: z.string().nullable(), creditCardTransaction: qbdCreditCardTransaction.nullable(), customFields: z.array(qbdCustomField)}); export const qbdSalesReceiptLineGroup = z.object({id: z.string(), objectType: z.literal("qbd_sales_receipt_line_group"), itemGroup: z.object({id: z.string().nullable(), fullName: z.string().nullable()}), description: z.string().nullable(), quantity: z.number().nullable(), unitOfMeasure: z.string().nullable(), overrideUnitOfMeasureSet: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), shouldPrintItemsInGroup: z.boolean(), totalAmount: z.string(), serviceDate: z.string().nullable(), lines: z.array(qbdSalesReceiptLine), customFields: z.array(qbdCustomField)}); export const qbdSalesReceipt = z.object({id: z.string(), objectType: z.literal("qbd_sales_receipt"), createdAt: z.string(), updatedAt: z.string(), revisionNumber: z.string(), customer: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), class: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), documentTemplate: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), transactionDate: z.string(), refNumber: z.string().nullable(), billingAddress: qbdAddress.nullable(), shippingAddress: qbdAddress.nullable(), isPending: z.boolean().nullable(), checkNumber: z.string().nullable(), paymentMethod: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), dueDate: z.string().nullable(), salesRepresentative: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), shippingDate: z.string().nullable(), shippingMethod: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), shipmentOrigin: z.string().nullable(), subtotal: z.string(), salesTaxItem: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), salesTaxPercentage: z.string().nullable(), salesTaxTotal: z.string().nullable(), totalAmount: z.string(), currency: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), exchangeRate: z.number().nullable(), totalAmountInHomeCurrency: z.string().nullable(), memo: z.string().nullable(), customerMessage: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), isQueuedForPrint: z.boolean().nullable(), isQueuedForEmail: z.boolean().nullable(), salesTaxCode: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), depositToAccount: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), creditCardTransaction: qbdCreditCardTransaction.nullable(), otherCustomField: z.string().nullable(), externalId: z.string().nullable(), lines: z.array(qbdSalesReceiptLine), lineGroups: z.array(qbdSalesReceiptLineGroup), customFields: z.array(qbdCustomField)}); export const getApiQuickbooksDesktopSalesReceiptsResponse = z.object({objectType: z.literal("list"), url: z.string(), data: z.array(qbdSalesReceipt), nextCursor: z.string().nullable(), remainingCount: z.number().nullable(), hasMore: z.boolean()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * List all sales receipts * * GET /quickbooks-desktop/sales-receipts */ export const getApiQuickbooksDesktopSalesReceipts = async (args: GetApiQuickbooksDesktopSalesReceiptsArgs, options?: GetApiQuickbooksDesktopSalesReceiptsOptions) => { const {baseUrl = "https://api.conductor.is/v1", fetch: fetchFn = fetch, BearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Conductor-End-User-Id'] != null) headers.set("Conductor-End-User-Id", String(args['Conductor-End-User-Id'])) for (const item of args.ids ?? []) query.append("ids", String(item)) for (const item of args.refNumbers ?? []) query.append("refNumbers", String(item)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.cursor != null) query.append("cursor", String(args.cursor)) if (args.updatedAfter != null) query.append("updatedAfter", String(args.updatedAfter)) if (args.updatedBefore != null) query.append("updatedBefore", String(args.updatedBefore)) if (args.transactionDateFrom != null) query.append("transactionDateFrom", String(args.transactionDateFrom)) if (args.transactionDateTo != null) query.append("transactionDateTo", String(args.transactionDateTo)) for (const item of args.customerIds ?? []) query.append("customerIds", String(item)) for (const item of args.accountIds ?? []) query.append("accountIds", String(item)) if (args.refNumberContains != null) query.append("refNumberContains", String(args.refNumberContains)) if (args.refNumberStartsWith != null) query.append("refNumberStartsWith", String(args.refNumberStartsWith)) if (args.refNumberEndsWith != null) query.append("refNumberEndsWith", String(args.refNumberEndsWith)) if (args.refNumberFrom != null) query.append("refNumberFrom", String(args.refNumberFrom)) if (args.refNumberTo != null) query.append("refNumberTo", String(args.refNumberTo)) for (const item of args.currencyIds ?? []) query.append("currencyIds", String(item)) if (args.includeLineItems != null) query.append("includeLineItems", String(args.includeLineItems)) if (BearerAuth !== undefined) headers.set('authorization', `Bearer ${BearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/quickbooks-desktop/sales-receipts${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(getApiQuickbooksDesktopSalesReceiptsResponse, await res.json()) };