import {z} from 'zod' export type GetApiQuickbooksDesktopCreditCardRefundsArgs = {'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 GetApiQuickbooksDesktopCreditCardRefundsOptions = {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 qbdCreditTransaction = z.object({transactionId: z.string().max(36), transactionType: z.enum(["ar_refund_credit_card", "bill", "bill_payment_check", "bill_payment_credit_card", "build_assembly", "charge", "check", "credit_card_charge", "credit_card_credit", "credit_memo", "deposit", "estimate", "inventory_adjustment", "invoice", "item_receipt", "journal_entry", "liability_adjustment", "paycheck", "payroll_liability_check", "purchase_order", "receive_payment", "sales_order", "sales_receipt", "sales_tax_payment_check", "transfer", "vendor_credit", "ytd_adjustment", "transfer_inventory", "unknown"]), transactionDate: z.string().nullable(), refNumber: z.string().nullable(), creditRemaining: z.string().nullable(), refundAmount: z.string(), creditRemainingInHomeCurrency: z.string().nullable(), refundAmountInHomeCurrency: z.string().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 qbdCreditCardRefund = z.object({id: z.string(), objectType: z.literal("qbd_credit_card_refund"), createdAt: z.string(), updatedAt: z.string(), revisionNumber: z.string(), customer: z.object({id: z.string().nullable(), fullName: z.string().nullable()}), refundFromAccount: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), receivablesAccount: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), transactionDate: z.string(), refNumber: 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(), address: qbdAddress.nullable(), paymentMethod: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), memo: z.string().nullable(), creditCardTransaction: qbdCreditCardTransaction.nullable(), externalId: z.string().nullable(), refundAppliedToTransactions: z.array(qbdCreditTransaction), customFields: z.array(qbdCustomField)}); export const getApiQuickbooksDesktopCreditCardRefundsResponse = z.object({objectType: z.literal("list"), url: z.string(), data: z.array(qbdCreditCardRefund), 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 credit card refunds * * GET /quickbooks-desktop/credit-card-refunds */ export const getApiQuickbooksDesktopCreditCardRefunds = async (args: GetApiQuickbooksDesktopCreditCardRefundsArgs, options?: GetApiQuickbooksDesktopCreditCardRefundsOptions) => { 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/credit-card-refunds${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(getApiQuickbooksDesktopCreditCardRefundsResponse, await res.json()) };