import {z} from 'zod' export type CreateApiQuickbooksDesktopReceivePaymentsArgs = {'Conductor-End-User-Id': string, body: {customerId: string, receivablesAccountId?: string | undefined, transactionDate: string, refNumber?: string | undefined, totalAmount: string, exchangeRate?: number | undefined, paymentMethodId?: string | undefined, memo?: string | undefined, depositToAccountId?: string | undefined, creditCardTransaction?: ({request?: ({number: string, expirationMonth: number, expirationYear: number, name: string, address?: string | undefined, postalCode?: string | undefined, commercialCardCode?: string | undefined, transactionMode?: ('card_not_present' | 'card_present') | undefined, transactionType?: ('authorization' | 'capture' | 'charge' | 'refund' | 'voice_authorization') | undefined}) | undefined, response?: ({statusCode: number, statusMessage: string, creditCardTransactionId: string, merchantAccountNumber: string, authorizationCode?: string | undefined, avsStreetStatus?: ('fail' | 'not_available' | 'pass') | undefined, avsZipStatus?: ('fail' | 'not_available' | 'pass') | undefined, cardSecurityCodeMatch?: ('fail' | 'not_available' | 'pass') | undefined, reconBatchId?: string | undefined, paymentGroupingCode?: number | undefined, paymentStatus: 'completed' | 'unknown', transactionAuthorizedAt: string, transactionAuthorizationStamp?: number | undefined, clientTransactionId?: string | undefined}) | undefined}) | undefined, externalId?: string | undefined, isAutoApply?: boolean | undefined, applyToTransactions?: (Array<{transactionId: string, paymentAmount?: string | undefined, applyCredits?: (Array<{creditTransactionId: string, appliedAmount: string, overrideCreditApplication?: boolean | undefined}>) | undefined, discountAmount?: string | undefined, discountAccountId?: string | undefined, discountClassId?: string | undefined}>) | undefined}}; export type CreateApiQuickbooksDesktopReceivePaymentsOptions = {baseUrl?: string | undefined, BearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; 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 qbdLinkedTransaction = z.object({id: z.string(), objectType: z.literal("qbd_linked_transaction"), 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(), refNumber: z.string().nullable(), linkType: z.enum(["amount", "quantity"]).nullable(), amount: z.string().nullable()}); export const qbdTargetTransaction = 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(), balanceRemaining: z.string().nullable(), amount: z.string().nullable(), discountAmount: z.string().nullable(), discountAccount: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), discountClass: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), linkedTransactions: z.array(qbdLinkedTransaction)}); 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 qbdReceivePayment = z.object({id: z.string(), objectType: z.literal("qbd_receive_payment"), createdAt: z.string(), updatedAt: z.string(), revisionNumber: z.string(), customer: 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(), paymentMethod: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), memo: z.string().nullable(), depositToAccount: z.object({id: z.string().nullable(), fullName: z.string().nullable()}).nullable(), creditCardTransaction: qbdCreditCardTransaction.nullable(), unusedPayment: z.string().nullable(), unusedCredits: z.string().nullable(), externalId: z.string().nullable(), appliedToTransactions: z.array(qbdTargetTransaction), customFields: z.array(qbdCustomField)}); 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 }; /** * Create a receive-payment * * POST /quickbooks-desktop/receive-payments */ export const createApiQuickbooksDesktopReceivePayments = async (args: CreateApiQuickbooksDesktopReceivePaymentsArgs, options?: CreateApiQuickbooksDesktopReceivePaymentsOptions) => { const {baseUrl = "https://api.conductor.is/v1", fetch: fetchFn = fetch, BearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args['Conductor-End-User-Id'] != null) headers.set("Conductor-End-User-Id", String(args['Conductor-End-User-Id'])) if (BearerAuth !== undefined) headers.set('authorization', `Bearer ${BearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/quickbooks-desktop/receive-payments${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(qbdReceivePayment, await res.json()) };