import {z} from 'zod' export type DebituraDomainModelInvoicePaymentsPayoutsEnumsPayoutCommissionPaymentStatus = 'Unpaid' | 'Paid' | 'Credited'; export type DebituraDomainModelCoreInvoicePaymentsPlatformInvoicingStatus = 'NotInvoiced' | 'InvoiceIssued' | 'PaymentReceived' | 'InvoiceCredited'; export type DebituraDomainModelReferralPartnersEnumsReferralInvoicingStatus = 'Pending' | 'Invoiced' | 'Paid' | 'Disputed'; export type DebituraWebReferralPartnerApiModelsReportingTransactionRevenueStage = 'Pending' | 'ConfirmedPendingInvoice' | 'AwaitingCollectionPartnerPayment' | 'ReadyToInvoiceDebitura' | 'AwaitingDebituraPayment' | 'Paid' | 'Disputed'; export type GetApiReportingTransactionsArgs = {FromDate?: string | undefined, ToDate?: string | undefined, ExternalTenantId?: string | undefined, HasRecognizedRevenue?: boolean | undefined, CommissionPaymentStatuses?: Array | undefined, PlatformInvoicingStatuses?: Array | undefined, ReferralInvoicingStatuses?: Array | undefined, RevenueStages?: Array | undefined, Search?: string | undefined, Page?: number | undefined, PageSize?: number | undefined, CountryIds?: Array | undefined, CollectionPartnerIds?: Array | undefined, Sort?: string | undefined}; export type GetApiReportingTransactionsOptions = {baseUrl?: string | undefined, ApiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const debituraWebReferralPartnerApiModelsReportingClientInfo = z.object({externalTenantId: z.string().nullable().optional(), creditorId: z.string().optional(), companyName: z.string().nullable().optional()}); export const debituraWebReferralPartnerApiModelsReportingCaseInfo = z.object({invoiceId: z.string().optional(), caseReference: z.string().nullable().optional(), debtorName: z.string().nullable().optional(), originalAmount: z.number().optional(), currency: z.string().nullable().optional(), collectionPartner: z.string().nullable().optional()}); export const debituraWebReferralPartnerApiModelsReportingPaymentInfo = z.object({amount: z.number().optional(), currency: z.string().nullable().optional(), paymentDate: z.string().optional()}); export const debituraWebReferralPartnerApiModelsReportingEarningsInfo = z.object({currency: z.string().nullable().optional(), debituraRevenue: z.number().optional(), debituraRevenueUsd: z.number().optional(), netDebituraRevenueUsd: z.number().optional(), successFeePercentageSnapshot: z.number().nullable().optional(), collectionPartnerAmount: z.number().optional(), collectionPartnerCurrency: z.string().nullable().optional(), referralFeePercentage: z.number().optional(), referralFeeAmount: z.number().optional(), referralFeeAmountUsd: z.number().optional(), isEstimate: z.boolean().optional()}); export const debituraWebReferralPartnerApiModelsReportingRecognitionInfo = z.object({isRecognized: z.boolean().optional(), referralFeeRecognizedUsd: z.number().optional()}); export const debituraWebReferralPartnerApiModelsReportingStatusInfo = z.object({commissionPaymentStatus: z.string().nullable().optional(), platformInvoicingStatus: z.string().nullable().optional(), referralInvoicingStatus: z.string().nullable().optional()}); export const debituraWebReferralPartnerApiModelsReportingTransactionItem = z.object({transactionId: z.string().optional(), payoutId: z.string().optional(), date: z.string().optional(), client: debituraWebReferralPartnerApiModelsReportingClientInfo.optional(), case: debituraWebReferralPartnerApiModelsReportingCaseInfo.optional(), payment: debituraWebReferralPartnerApiModelsReportingPaymentInfo.optional(), earnings: debituraWebReferralPartnerApiModelsReportingEarningsInfo.optional(), recognition: debituraWebReferralPartnerApiModelsReportingRecognitionInfo.optional(), status: debituraWebReferralPartnerApiModelsReportingStatusInfo.optional()}); export const debituraDomainModelBasePageData = z.object({totalResults: z.number().int().optional(), pageSize: z.number().int().optional(), currentPage: z.number().int().optional(), responseCount: z.number().int().optional(), totalPages: z.number().int().optional()}); export const debituraWebReferralPartnerApiModelsReportingRevenueBreakdown = z.object({pendingReferralFeeUsd: z.number().optional(), pendingCount: z.number().int().optional(), confirmedPendingInvoiceReferralFeeUsd: z.number().optional(), confirmedPendingInvoiceCount: z.number().int().optional(), awaitingCollectionPartnerPaymentReferralFeeUsd: z.number().optional(), awaitingCollectionPartnerPaymentCount: z.number().int().optional(), readyToInvoiceDebituraReferralFeeUsd: z.number().optional(), readyToInvoiceDebituraCount: z.number().int().optional(), awaitingDebituraPaymentReferralFeeUsd: z.number().optional(), awaitingDebituraPaymentCount: z.number().int().optional(), paidReferralFeeUsd: z.number().optional(), paidCount: z.number().int().optional(), disputedReferralFeeUsd: z.number().optional(), disputedCount: z.number().int().optional()}); export const debituraWebReferralPartnerApiModelsReportingTransactionsSummary = z.object({revenue: debituraWebReferralPartnerApiModelsReportingRevenueBreakdown.optional(), totalDebituraRevenueUsd: z.number().optional(), netTotalDebituraRevenueUsd: z.number().optional()}); export const debituraWebReferralPartnerApiModelsReportingTransactionsResponse = z.object({data: z.array(debituraWebReferralPartnerApiModelsReportingTransactionItem).nullable().optional(), page: debituraDomainModelBasePageData.optional(), summary: debituraWebReferralPartnerApiModelsReportingTransactionsSummary.optional()}); 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 }; /** * Get transaction-level revenue data * * GET /reporting/transactions */ export const getApiReportingTransactions = async (args: GetApiReportingTransactionsArgs, options?: GetApiReportingTransactionsOptions) => { const {baseUrl = "https://referral-api.debitura.com", fetch: fetchFn = fetch, ApiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.FromDate != null) query.append("FromDate", String(args.FromDate)) if (args.ToDate != null) query.append("ToDate", String(args.ToDate)) if (args.ExternalTenantId != null) query.append("ExternalTenantId", String(args.ExternalTenantId)) if (args.HasRecognizedRevenue != null) query.append("HasRecognizedRevenue", String(args.HasRecognizedRevenue)) for (const item of args.CommissionPaymentStatuses ?? []) query.append("CommissionPaymentStatuses", String(item)) for (const item of args.PlatformInvoicingStatuses ?? []) query.append("PlatformInvoicingStatuses", String(item)) for (const item of args.ReferralInvoicingStatuses ?? []) query.append("ReferralInvoicingStatuses", String(item)) for (const item of args.RevenueStages ?? []) query.append("RevenueStages", String(item)) if (args.Search != null) query.append("Search", String(args.Search)) if (args.Page != null) query.append("Page", String(args.Page)) if (args.PageSize != null) query.append("PageSize", String(args.PageSize)) for (const item of args.CountryIds ?? []) query.append("CountryIds", String(item)) for (const item of args.CollectionPartnerIds ?? []) query.append("CollectionPartnerIds", String(item)) if (args.Sort != null) query.append("Sort", String(args.Sort)) if (ApiKey !== undefined) headers.set("XApiKey", ApiKey) const url = `${baseUrl.replace(/\/+$/, '')}/reporting/transactions${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(debituraWebReferralPartnerApiModelsReportingTransactionsResponse, await res.json()) };