@taxdao/fintax-mcp 0.2.0

package/dist/schemas/domains/business-documents.js

@@ -0,0 +1,1153 @@
+import { z } from 'zod/v4';
+import { artifactMetadataSchema, contextSchema, paginatedSuccessEnvelopeSchema, viewPageSuccessEnvelopeSchema, successEnvelopeSchema, } from '../common.js';
+import { dateSchema, dateTimeSchema, decimalStringSchema, upstreamDecimalSchema, uuidSchema, } from '../primitives.js';
+export const businessDocumentTypeSchema = z.enum(['payable', 'receivable']);
+export const businessDocumentSubtypeSchema = z.enum([
+    'STANDARD',
+    'CREDIT',
+    'PREPAYMENT',
+    'ACCRUED',
+    'SURCHARGE',
+    'STANDARD_APPLY_ACCRUED',
+    'OFFSET',
+]);
+export const businessDocumentReadSubtypeSchema = z.string().min(1);
+const knownBusinessDocumentReadSubtypes = new Set([
+    ...businessDocumentSubtypeSchema.options,
+    'REVERSAL',
+    'PAYMENT',
+]);
+export function isKnownBusinessDocumentReadSubtype(value) {
+    return knownBusinessDocumentReadSubtypes.has(value);
+}
+export const businessDocumentVerificationStatusSchema = z
+    .enum(['D', 'V', 'F'])
+    .describe('Upstream verification status code. Pass D, V, or F exactly as returned by the service.');
+export const payablePostingStatusSchema = z
+    .enum(['N', 'C'])
+    .describe('Upstream payable posting status code. Pass N or C exactly as returned by the service.');
+export const businessDocumentApprovalStatusSchema = z.enum([
+    'NONE',
+    'PENDING',
+    'APPROVED',
+    'REJECTED',
+    'WITHDRAWN',
+]);
+const commonListFilterFields = {
+    search: z.string().min(1).optional(),
+    symbol: z.string().min(1).max(32).optional(),
+    amount_from: decimalStringSchema.optional(),
+    amount_to: decimalStringSchema.optional(),
+    biz_date_from: dateSchema.optional(),
+    biz_date_to: dateSchema.optional(),
+    gl_date_from: dateSchema.optional(),
+    gl_date_to: dateSchema.optional(),
+    created_by: z.uuid().optional(),
+    verification_status: businessDocumentVerificationStatusSchema.optional(),
+    approval_status: businessDocumentApprovalStatusSchema.optional(),
+    journal_number_from: z.string().min(1).optional(),
+    journal_number_to: z.string().min(1).optional(),
+};
+export const payableBusinessDocumentSortSchema = z
+    .object({
+    field: z.enum([
+        'created_at',
+        'ap_no',
+        'biz_date',
+        'amount_total',
+        'verification_status',
+        'ap_type',
+    ]),
+    direction: z.enum(['asc', 'desc']).default('desc'),
+})
+    .strict();
+export const receivableBusinessDocumentSortSchema = z
+    .object({
+    field: z.enum([
+        'created_at',
+        'ar_no',
+        'biz_date',
+        'gl_date',
+        'amount_total',
+        'verification_status',
+        'approval_status',
+        'posting_status',
+        'ar_type',
+        'period_name',
+    ]),
+    direction: z.enum(['asc', 'desc']).default('desc'),
+})
+    .strict();
+function validateListDateRanges(filters, context) {
+    if (filters.biz_date_from !== undefined &&
+        filters.biz_date_to !== undefined &&
+        filters.biz_date_from > filters.biz_date_to) {
+        context.addIssue({
+            code: 'custom',
+            path: ['biz_date_to'],
+            message: 'biz_date_to must not be earlier than biz_date_from',
+        });
+    }
+    if (filters.gl_date_from !== undefined &&
+        filters.gl_date_to !== undefined &&
+        filters.gl_date_from > filters.gl_date_to) {
+        context.addIssue({
+            code: 'custom',
+            path: ['gl_date_to'],
+            message: 'gl_date_to must not be earlier than gl_date_from',
+        });
+    }
+}
+export const payableBusinessDocumentFiltersSchema = z
+    .object({
+    ...commonListFilterFields,
+    from_party_id: z.uuid().optional(),
+    ap_no: z.string().min(1).optional(),
+    posting_status: payablePostingStatusSchema.optional(),
+    ap_type: businessDocumentSubtypeSchema.optional(),
+})
+    .strict()
+    .superRefine(validateListDateRanges);
+export const receivableBusinessDocumentFiltersSchema = z
+    .object({
+    ...commonListFilterFields,
+    to_party_id: z.uuid().optional(),
+    ar_no: z.string().min(1).optional(),
+    posting_status: z.enum(['POSTED', 'UNPOSTED']).optional(),
+    ar_type: businessDocumentSubtypeSchema.optional(),
+})
+    .strict()
+    .superRefine(validateListDateRanges);
+const listPagingFields = {
+    page: z.number().int().positive().default(1),
+    page_size: z.number().int().min(1).max(100).default(20),
+    context: contextSchema.optional(),
+};
+const documentReadFields = {
+    document_id: z.uuid(),
+    context: contextSchema.optional(),
+};
+export const queryBusinessDocumentsInputSchema = z.union([
+    z
+        .object({
+        document_type: z.literal('payable'),
+        view: z.literal('list'),
+        filters: payableBusinessDocumentFiltersSchema.default({}),
+        sort: payableBusinessDocumentSortSchema.optional(),
+        ...listPagingFields,
+    })
+        .strict()
+        .describe('Payable lists support sorting the complete result set by allowlisted sort fields.'),
+    z
+        .object({
+        document_type: z.literal('receivable'),
+        view: z.literal('list'),
+        filters: receivableBusinessDocumentFiltersSchema.default({}),
+        sort: receivableBusinessDocumentSortSchema.optional(),
+        ...listPagingFields,
+    })
+        .strict()
+        .describe('Receivable lists support sorting the complete result set by allowlisted sort fields.'),
+    z
+        .object({
+        document_type: z.literal('payable'),
+        view: z.literal('detail'),
+        ...documentReadFields,
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('receivable'),
+        view: z.literal('detail'),
+        ...documentReadFields,
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('payable'),
+        view: z.literal('offsets'),
+        ...documentReadFields,
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('receivable'),
+        view: z.literal('offsets'),
+        ...documentReadFields,
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('payable'),
+        view: z.literal('offset_document_lines'),
+        offset_document_id: z.uuid(),
+        ...documentReadFields,
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('receivable'),
+        view: z.literal('offset_document_lines'),
+        offset_document_id: z.uuid(),
+        ...documentReadFields,
+    })
+        .strict(),
+]);
+export const queryPayableDocumentsInputSchema = z
+    .object({
+    filters: payableBusinessDocumentFiltersSchema.default({}),
+    sort: payableBusinessDocumentSortSchema.optional(),
+    ...listPagingFields,
+})
+    .strict()
+    .describe('List payable documents. Filters and paging apply only to this list Tool.');
+export const queryReceivableDocumentsInputSchema = z
+    .object({
+    filters: receivableBusinessDocumentFiltersSchema.default({}),
+    sort: receivableBusinessDocumentSortSchema.optional(),
+    ...listPagingFields,
+})
+    .strict()
+    .describe('List receivable documents. Filters and paging apply only to this list Tool.');
+export const getPayableDocumentInputSchema = z
+    .object(documentReadFields)
+    .strict()
+    .describe('Read one payable document by document_id.');
+export const getReceivableDocumentInputSchema = z
+    .object(documentReadFields)
+    .strict()
+    .describe('Read one receivable document by document_id.');
+export const queryPayableOffsetsInputSchema = z
+    .object(documentReadFields)
+    .strict()
+    .describe('Read completed offsets for one payable document.');
+export const queryReceivableOffsetsInputSchema = z
+    .object(documentReadFields)
+    .strict()
+    .describe('Read completed offsets for one receivable document.');
+export const queryPayableOffsetLinesInputSchema = z
+    .object({
+    offset_document_id: z.uuid(),
+    ...documentReadFields,
+})
+    .strict()
+    .describe('Read lines for one payable offset document.');
+export const queryReceivableOffsetLinesInputSchema = z
+    .object({
+    offset_document_id: z.uuid(),
+    ...documentReadFields,
+})
+    .strict()
+    .describe('Read lines for one receivable offset document.');
+const nullableUpstreamDecimalSchema = upstreamDecimalSchema.nullable();
+const nullableDecimalSchema = decimalStringSchema.nullable();
+const nullableStringSchema = z.string().nullable();
+const nullableUuidSchema = z.uuid().nullable();
+const nullableDateSchema = dateSchema.nullable();
+const nullableDateTimeSchema = dateTimeSchema.nullable();
+const journalDigestUpstreamSchema = z
+    .object({
+    journal_id: z.uuid(),
+    journal_number: nullableStringSchema,
+    event_id: nullableUuidSchema,
+    approval_status: nullableStringSchema,
+    org_id: nullableUuidSchema,
+    org_name: nullableStringSchema,
+    ledger_id: nullableUuidSchema,
+    period_name: nullableStringSchema,
+})
+    .passthrough();
+const journalDigestSchema = z
+    .object({
+    journal_id: z.uuid(),
+    journal_number: nullableStringSchema,
+    event_id: nullableUuidSchema,
+    approval_status: nullableStringSchema,
+    org_id: nullableUuidSchema,
+    org_name: nullableStringSchema,
+    ledger_id: nullableUuidSchema,
+    period_name: nullableStringSchema,
+})
+    .strict();
+const payableSummaryUpstreamSchema = z
+    .object({
+    invoice_amount: nullableUpstreamDecimalSchema,
+    tax_amount: nullableUpstreamDecimalSchema,
+    base_amount: nullableUpstreamDecimalSchema,
+    remaining_amount: nullableUpstreamDecimalSchema,
+    base_currency: nullableStringSchema,
+})
+    .passthrough();
+const payableSummarySchema = z
+    .object({
+    invoice_amount: nullableDecimalSchema,
+    tax_amount: nullableDecimalSchema,
+    base_amount: nullableDecimalSchema,
+    remaining_amount: nullableDecimalSchema,
+    base_currency: nullableStringSchema,
+})
+    .strict();
+const receivableSummaryUpstreamSchema = z
+    .object({
+    receivable_amount: nullableUpstreamDecimalSchema,
+    income_amount: nullableUpstreamDecimalSchema,
+    tax_amount: nullableUpstreamDecimalSchema,
+    received_amount: nullableUpstreamDecimalSchema,
+    net_amount: nullableUpstreamDecimalSchema,
+    due_balance: nullableUpstreamDecimalSchema,
+    base_currency: nullableStringSchema,
+})
+    .passthrough();
+const receivableSummarySchema = z
+    .object({
+    receivable_amount: nullableDecimalSchema,
+    income_amount: nullableDecimalSchema,
+    tax_amount: nullableDecimalSchema,
+    received_amount: nullableDecimalSchema,
+    net_amount: nullableDecimalSchema,
+    due_balance: nullableDecimalSchema,
+    base_currency: nullableStringSchema,
+})
+    .strict();
+export const payableBusinessDocumentListItemUpstreamSchema = z
+    .object({
+    id: z.uuid(),
+    ap_no: z.string(),
+    ap_type: businessDocumentReadSubtypeSchema,
+    from_party_id: nullableUuidSchema,
+    from_party_name: nullableStringSchema,
+    verification_status: businessDocumentVerificationStatusSchema,
+    posting_status: payablePostingStatusSchema,
+    create_approval_status: nullableStringSchema,
+    journal_numbers: z.array(z.string()),
+    journals: z.array(journalDigestUpstreamSchema),
+    biz_date: nullableDateSchema,
+    gl_date: nullableDateSchema,
+    period_name: z.string(),
+    currency: nullableStringSchema,
+    amount_total: nullableUpstreamDecimalSchema,
+    created_by: nullableUuidSchema,
+    created_at: nullableDateTimeSchema,
+    version: z.number().int(),
+    cancelled_at: nullableDateTimeSchema,
+    attachment_count: z.number().int().nonnegative(),
+    pending_offsets: z.number().int().nonnegative(),
+    offset_count: z.number().int().nonnegative(),
+    parent_id: nullableUuidSchema,
+})
+    .passthrough();
+export const receivableBusinessDocumentListItemUpstreamSchema = z
+    .object({
+    id: z.uuid(),
+    org_id: z.uuid(),
+    ar_no: z.string(),
+    ar_type: businessDocumentReadSubtypeSchema,
+    to_party_id: nullableUuidSchema,
+    to_party_name: nullableStringSchema,
+    verification_status: businessDocumentVerificationStatusSchema,
+    approval_status: businessDocumentApprovalStatusSchema,
+    posting_status: z.enum(['POSTED', 'UNPOSTED']),
+    journal_numbers: z.array(z.string()),
+    journals: z.array(journalDigestUpstreamSchema),
+    biz_date: nullableDateSchema,
+    gl_date: nullableDateSchema,
+    period_name: z.string(),
+    currency: nullableStringSchema,
+    amount_total: nullableUpstreamDecimalSchema,
+    created_by: nullableUuidSchema,
+    created_at: nullableDateTimeSchema,
+    version: z.number().int(),
+    summary: receivableSummaryUpstreamSchema,
+    attachment_count: z.number().int().nonnegative(),
+    offset_count: z.number().int().nonnegative(),
+    pending_offsets: z.number().int().nonnegative(),
+    cancelled_at: nullableDateTimeSchema,
+    parent_id: nullableUuidSchema,
+})
+    .passthrough();
+export const payableBusinessDocumentPageUpstreamSchema = z
+    .object({
+    records: z.array(payableBusinessDocumentListItemUpstreamSchema),
+    total: z.number().int().nonnegative(),
+    page: z.number().int().positive(),
+    page_size: z.number().int().positive(),
+    offsets: z.array(payableBusinessDocumentListItemUpstreamSchema),
+})
+    .passthrough();
+export const receivableBusinessDocumentPageUpstreamSchema = z
+    .object({
+    records: z.array(receivableBusinessDocumentListItemUpstreamSchema),
+    total: z.number().int().nonnegative(),
+    page: z.number().int().positive(),
+    page_size: z.number().int().positive(),
+    offsets: z.array(receivableBusinessDocumentListItemUpstreamSchema),
+})
+    .passthrough();
+const payableBusinessDocumentListItemSchema = z
+    .object({
+    id: z.uuid(),
+    ap_no: z.string(),
+    ap_type: businessDocumentReadSubtypeSchema,
+    from_party_id: nullableUuidSchema,
+    from_party_name: nullableStringSchema,
+    verification_status: businessDocumentVerificationStatusSchema,
+    posting_status: payablePostingStatusSchema,
+    create_approval_status: nullableStringSchema,
+    journal_numbers: z.array(z.string()),
+    journals: z.array(journalDigestSchema),
+    biz_date: nullableDateSchema,
+    gl_date: nullableDateSchema,
+    period_name: z.string(),
+    currency: nullableStringSchema,
+    amount_total: nullableDecimalSchema,
+    created_by: nullableUuidSchema,
+    created_at: nullableDateTimeSchema,
+    version: z.number().int(),
+    cancelled_at: nullableDateTimeSchema,
+    attachment_count: z.number().int().nonnegative(),
+    pending_offsets: z.number().int().nonnegative(),
+    offset_count: z.number().int().nonnegative(),
+    parent_id: nullableUuidSchema,
+})
+    .strict();
+const receivableBusinessDocumentListItemSchema = z
+    .object({
+    id: z.uuid(),
+    org_id: z.uuid(),
+    ar_no: z.string(),
+    ar_type: businessDocumentReadSubtypeSchema,
+    to_party_id: nullableUuidSchema,
+    to_party_name: nullableStringSchema,
+    verification_status: businessDocumentVerificationStatusSchema,
+    approval_status: businessDocumentApprovalStatusSchema,
+    posting_status: z.enum(['POSTED', 'UNPOSTED']),
+    journal_numbers: z.array(z.string()),
+    journals: z.array(journalDigestSchema),
+    biz_date: nullableDateSchema,
+    gl_date: nullableDateSchema,
+    period_name: z.string(),
+    currency: nullableStringSchema,
+    amount_total: nullableDecimalSchema,
+    created_by: nullableUuidSchema,
+    created_at: nullableDateTimeSchema,
+    version: z.number().int(),
+    summary: receivableSummarySchema,
+    attachment_count: z.number().int().nonnegative(),
+    offset_count: z.number().int().nonnegative(),
+    pending_offsets: z.number().int().nonnegative(),
+    cancelled_at: nullableDateTimeSchema,
+    parent_id: nullableUuidSchema,
+})
+    .strict();
+const offsetDocumentRefUpstreamSchema = z
+    .object({
+    id: z.uuid(),
+    approval_status: z.string(),
+    version: z.number().int(),
+    biz_date: nullableDateSchema,
+    period_name: z.string(),
+})
+    .passthrough();
+const payableOffsetDocumentRefUpstreamSchema = offsetDocumentRefUpstreamSchema.extend({
+    ap_no: z.string(),
+});
+const receivableOffsetDocumentRefUpstreamSchema = offsetDocumentRefUpstreamSchema.extend({ ar_no: z.string() });
+const offsetDocumentRefSchema = z
+    .object({
+    id: z.uuid(),
+    document_no: z.string(),
+    approval_status: z.string(),
+    version: z.number().int(),
+    biz_date: nullableDateSchema,
+    period_name: z.string(),
+})
+    .strict();
+const attributeUpstreamFields = {
+    attribute1: nullableStringSchema.optional(),
+    attribute2: nullableStringSchema.optional(),
+    attribute3: nullableStringSchema.optional(),
+    attribute4: nullableStringSchema.optional(),
+    attribute5: nullableStringSchema.optional(),
+    attribute6: nullableStringSchema.optional(),
+    attribute7: nullableStringSchema.optional(),
+    attribute8: nullableStringSchema.optional(),
+    attribute9: nullableStringSchema.optional(),
+    attribute10: nullableStringSchema.optional(),
+    attribute11: nullableStringSchema.optional(),
+    attribute12: nullableStringSchema.optional(),
+};
+export const businessDocumentAttributesSchema = z
+    .object({
+    attribute1: nullableStringSchema,
+    attribute2: nullableStringSchema,
+    attribute3: nullableStringSchema,
+    attribute4: nullableStringSchema,
+    attribute5: nullableStringSchema,
+    attribute6: nullableStringSchema,
+    attribute7: nullableStringSchema,
+    attribute8: nullableStringSchema,
+    attribute9: nullableStringSchema,
+    attribute10: nullableStringSchema,
+    attribute11: nullableStringSchema,
+    attribute12: nullableStringSchema,
+})
+    .strict();
+const commonLineUpstreamFields = {
+    id: nullableUuidSchema,
+    line_no: z.number().int(),
+    system_type: z.string(),
+    p_id: nullableUuidSchema,
+    is_offset: z.boolean(),
+    offset_type: nullableStringSchema,
+    offset_id: nullableUuidSchema,
+    offset_source_no: nullableStringSchema,
+    symbol: z.string(),
+    quantity: nullableUpstreamDecimalSchema,
+    base_rate: nullableUpstreamDecimalSchema,
+    base_amount: nullableUpstreamDecimalSchema,
+    base_currency: nullableStringSchema,
+    base_rate_time: nullableDateTimeSchema,
+    biz_type1: nullableStringSchema,
+    biz_type2: nullableStringSchema,
+    biz_type3: nullableStringSchema,
+    biz_type4: nullableStringSchema,
+    ledger_id: nullableUuidSchema,
+    coa_code: nullableStringSchema,
+    coa_name: nullableStringSchema,
+    description: nullableStringSchema,
+    reference: nullableStringSchema,
+    ...attributeUpstreamFields,
+    tax_code: nullableStringSchema,
+    tax_rate: nullableUpstreamDecimalSchema,
+    ratio: nullableUpstreamDecimalSchema,
+    offset_h_id: nullableUuidSchema,
+    version: z.number().int().nullable(),
+};
+export const payableBusinessDocumentLineUpstreamSchema = z
+    .object({
+    ...commonLineUpstreamFields,
+    offset_no: nullableStringSchema,
+    offset_approval_status: nullableStringSchema,
+})
+    .passthrough();
+export const receivableBusinessDocumentLineUpstreamSchema = z
+    .object(commonLineUpstreamFields)
+    .passthrough();
+const commonLineOutputFields = {
+    id: nullableUuidSchema,
+    line_no: z.number().int(),
+    system_type: z.string(),
+    p_id: nullableUuidSchema,
+    is_offset: z.boolean(),
+    offset_type: nullableStringSchema,
+    offset_id: nullableUuidSchema,
+    offset_source_no: nullableStringSchema,
+    symbol: z.string(),
+    quantity: nullableDecimalSchema,
+    base_rate: nullableDecimalSchema,
+    base_amount: nullableDecimalSchema,
+    base_currency: nullableStringSchema,
+    base_rate_time: nullableDateTimeSchema,
+    biz_type1: nullableStringSchema,
+    biz_type2: nullableStringSchema,
+    biz_type3: nullableStringSchema,
+    biz_type4: nullableStringSchema,
+    ledger_id: nullableUuidSchema,
+    coa_code: nullableStringSchema,
+    coa_name: nullableStringSchema,
+    description: nullableStringSchema,
+    reference: nullableStringSchema,
+    attributes: businessDocumentAttributesSchema,
+    tax_code: nullableStringSchema,
+    tax_rate: nullableDecimalSchema,
+    ratio: nullableDecimalSchema,
+    offset_h_id: nullableUuidSchema,
+    version: z.number().int().nullable(),
+};
+const payableBusinessDocumentLineSchema = z
+    .object({
+    ...commonLineOutputFields,
+    offset_no: nullableStringSchema,
+    offset_approval_status: nullableStringSchema,
+})
+    .strict();
+const receivableBusinessDocumentLineSchema = z
+    .object(commonLineOutputFields)
+    .strict();
+export const payableBusinessDocumentDetailUpstreamSchema = z
+    .object({
+    id: z.uuid(),
+    org_id: z.uuid(),
+    ap_type: businessDocumentReadSubtypeSchema,
+    parent_id: nullableUuidSchema,
+    from_party_id: nullableUuidSchema,
+    from_party_name: nullableStringSchema,
+    ap_no: z.string(),
+    source: z.string(),
+    source_no: nullableStringSchema,
+    biz_date: nullableDateSchema,
+    period_name: z.string(),
+    verification_status: businessDocumentVerificationStatusSchema,
+    verify_error: nullableStringSchema,
+    ledger_id: z.uuid(),
+    coa_code: nullableStringSchema,
+    coa_name: nullableStringSchema,
+    description: nullableStringSchema,
+    reference: nullableStringSchema,
+    invoice_no: nullableStringSchema,
+    usage_qty: nullableUpstreamDecimalSchema,
+    usage_unit: nullableStringSchema,
+    unit_price: nullableUpstreamDecimalSchema,
+    ...attributeUpstreamFields,
+    to_party_id: nullableUuidSchema,
+    to_party_name: nullableStringSchema,
+    to_party_address_id: nullableUuidSchema,
+    to_party_payment_method: nullableStringSchema,
+    to_party_payment_terms: nullableStringSchema,
+    to_party_payment_term_date: nullableDateTimeSchema,
+    to_party_payee_account_no: nullableStringSchema,
+    to_party_payee_account_name: nullableStringSchema,
+    to_party_swift_code: nullableStringSchema,
+    to_party_iban: nullableStringSchema,
+    to_party_branch: nullableStringSchema,
+    to_party_channel: nullableStringSchema,
+    version: z.number().int(),
+    created_at: nullableDateTimeSchema,
+    updated_at: nullableDateTimeSchema,
+    summary: payableSummaryUpstreamSchema,
+    has_pending_offset_approval: z.boolean(),
+    offset_docs: z.array(payableOffsetDocumentRefUpstreamSchema),
+    active_offset_doc_id: nullableUuidSchema,
+    submittable_offsets: z.number().int().nonnegative(),
+    lines: z.array(payableBusinessDocumentLineUpstreamSchema),
+})
+    .passthrough();
+export const receivableBusinessDocumentDetailUpstreamSchema = z
+    .object({
+    id: z.uuid(),
+    org_id: z.uuid(),
+    ar_type: businessDocumentReadSubtypeSchema,
+    to_party_id: nullableUuidSchema,
+    to_party_name: nullableStringSchema,
+    ar_no: z.string(),
+    source: z.string(),
+    source_no: nullableStringSchema,
+    biz_date: nullableDateSchema,
+    period_name: z.string(),
+    verification_status: businessDocumentVerificationStatusSchema,
+    verify_error: nullableStringSchema,
+    approval_status: businessDocumentApprovalStatusSchema,
+    ledger_id: z.uuid(),
+    coa_code: nullableStringSchema,
+    coa_name: nullableStringSchema,
+    description: nullableStringSchema,
+    reference: nullableStringSchema,
+    invoice_no: nullableStringSchema,
+    usage_qty: nullableUpstreamDecimalSchema,
+    usage_unit: nullableStringSchema,
+    unit_price: nullableUpstreamDecimalSchema,
+    ...attributeUpstreamFields,
+    from_party_address_id: nullableUuidSchema,
+    from_party_id: nullableUuidSchema,
+    from_party_name: nullableStringSchema,
+    from_party_collection_method: nullableStringSchema,
+    from_party_collection_terms: nullableStringSchema,
+    from_party_collection_term_date: nullableDateTimeSchema,
+    from_party_payer_account_no: nullableStringSchema,
+    from_party_payer_account_name: nullableStringSchema,
+    from_party_swift_code: nullableStringSchema,
+    from_party_iban: nullableStringSchema,
+    from_party_branch: nullableStringSchema,
+    from_party_channel: nullableStringSchema,
+    version: z.number().int(),
+    created_at: nullableDateTimeSchema,
+    updated_at: nullableDateTimeSchema,
+    parent_id: nullableUuidSchema,
+    parent_ar_no: nullableStringSchema,
+    parent_incl_tax_basis: nullableUpstreamDecimalSchema,
+    parent_state_valid: z.boolean().nullable(),
+    has_pending_offset_approval: z.boolean(),
+    submittable_offsets: z.number().int().nonnegative(),
+    offset_docs: z.array(receivableOffsetDocumentRefUpstreamSchema),
+    active_offset_doc_id: nullableUuidSchema,
+    summary: receivableSummaryUpstreamSchema,
+    lines: z.array(receivableBusinessDocumentLineUpstreamSchema),
+})
+    .passthrough();
+const payableBusinessDocumentDetailSchema = z
+    .object({
+    id: z.uuid(),
+    org_id: z.uuid(),
+    ap_type: businessDocumentReadSubtypeSchema,
+    parent_id: nullableUuidSchema,
+    from_party_id: nullableUuidSchema,
+    from_party_name: nullableStringSchema,
+    ap_no: z.string(),
+    source: z.string(),
+    source_no: nullableStringSchema,
+    biz_date: nullableDateSchema,
+    period_name: z.string(),
+    verification_status: businessDocumentVerificationStatusSchema,
+    verify_error: nullableStringSchema,
+    ledger_id: z.uuid(),
+    coa_code: nullableStringSchema,
+    coa_name: nullableStringSchema,
+    description: nullableStringSchema,
+    reference: nullableStringSchema,
+    invoice_no: nullableStringSchema,
+    usage_qty: nullableDecimalSchema,
+    usage_unit: nullableStringSchema,
+    unit_price: nullableDecimalSchema,
+    attributes: businessDocumentAttributesSchema,
+    to_party_id: nullableUuidSchema,
+    to_party_name: nullableStringSchema,
+    to_party_address_id: nullableUuidSchema,
+    to_party_payment_method: nullableStringSchema,
+    to_party_payment_terms: nullableStringSchema,
+    to_party_payment_term_date: nullableDateTimeSchema,
+    to_party_payee_account_no: nullableStringSchema,
+    to_party_payee_account_name: nullableStringSchema,
+    to_party_swift_code: nullableStringSchema,
+    to_party_iban: nullableStringSchema,
+    to_party_branch: nullableStringSchema,
+    to_party_channel: nullableStringSchema,
+    version: z.number().int(),
+    created_at: nullableDateTimeSchema,
+    updated_at: nullableDateTimeSchema,
+    summary: payableSummarySchema,
+    has_pending_offset_approval: z.boolean(),
+    offset_docs: z.array(offsetDocumentRefSchema),
+    active_offset_doc_id: nullableUuidSchema,
+    submittable_offsets: z.number().int().nonnegative(),
+    lines: z.array(payableBusinessDocumentLineSchema),
+})
+    .strict();
+const receivableBusinessDocumentDetailSchema = z
+    .object({
+    id: z.uuid(),
+    org_id: z.uuid(),
+    ar_type: businessDocumentReadSubtypeSchema,
+    to_party_id: nullableUuidSchema,
+    to_party_name: nullableStringSchema,
+    ar_no: z.string(),
+    source: z.string(),
+    source_no: nullableStringSchema,
+    biz_date: nullableDateSchema,
+    period_name: z.string(),
+    verification_status: businessDocumentVerificationStatusSchema,
+    verify_error: nullableStringSchema,
+    approval_status: businessDocumentApprovalStatusSchema,
+    ledger_id: z.uuid(),
+    coa_code: nullableStringSchema,
+    coa_name: nullableStringSchema,
+    description: nullableStringSchema,
+    reference: nullableStringSchema,
+    invoice_no: nullableStringSchema,
+    usage_qty: nullableDecimalSchema,
+    usage_unit: nullableStringSchema,
+    unit_price: nullableDecimalSchema,
+    attributes: businessDocumentAttributesSchema,
+    from_party_address_id: nullableUuidSchema,
+    from_party_id: nullableUuidSchema,
+    from_party_name: nullableStringSchema,
+    from_party_collection_method: nullableStringSchema,
+    from_party_collection_terms: nullableStringSchema,
+    from_party_collection_term_date: nullableDateTimeSchema,
+    from_party_payer_account_no: nullableStringSchema,
+    from_party_payer_account_name: nullableStringSchema,
+    from_party_swift_code: nullableStringSchema,
+    from_party_iban: nullableStringSchema,
+    from_party_branch: nullableStringSchema,
+    from_party_channel: nullableStringSchema,
+    version: z.number().int(),
+    created_at: nullableDateTimeSchema,
+    updated_at: nullableDateTimeSchema,
+    parent_id: nullableUuidSchema,
+    parent_ar_no: nullableStringSchema,
+    parent_incl_tax_basis: nullableDecimalSchema,
+    parent_state_valid: z.boolean().nullable(),
+    has_pending_offset_approval: z.boolean(),
+    submittable_offsets: z.number().int().nonnegative(),
+    offset_docs: z.array(offsetDocumentRefSchema),
+    active_offset_doc_id: nullableUuidSchema,
+    summary: receivableSummarySchema,
+    lines: z.array(receivableBusinessDocumentLineSchema),
+})
+    .strict();
+export const businessDocumentOffsetUpstreamSchema = z
+    .object({
+    offset_h_id: z.uuid(),
+    offset_no: nullableStringSchema,
+    approval_status: z.string(),
+    amount: nullableUpstreamDecimalSchema,
+    base_currency: nullableStringSchema,
+    line_count: z.number().int().nonnegative(),
+    created_at: nullableDateTimeSchema,
+    version: z.number().int().nullable(),
+    kind: z.enum(['DOC', 'TXN']),
+    cancellable: z.boolean(),
+    cancel_blocked_reason: nullableStringSchema,
+})
+    .passthrough();
+const businessDocumentOffsetSchema = z
+    .object({
+    offset_h_id: z.uuid(),
+    offset_no: nullableStringSchema,
+    approval_status: z.string(),
+    amount: nullableDecimalSchema,
+    base_currency: nullableStringSchema,
+    line_count: z.number().int().nonnegative(),
+    created_at: nullableDateTimeSchema,
+    version: z.number().int().nullable(),
+    kind: z.enum(['DOC', 'TXN']),
+    cancellable: z.boolean(),
+    cancel_blocked_reason: nullableStringSchema,
+})
+    .strict();
+export const businessDocumentOffsetLineUpstreamSchema = z
+    .object({
+    line_no: z.number().int().nullable(),
+    system_type: nullableStringSchema,
+    offset_type: nullableStringSchema,
+    source_ref: nullableStringSchema,
+    source_date: nullableDateTimeSchema,
+    symbol: nullableStringSchema,
+    quantity: nullableUpstreamDecimalSchema,
+    base_rate: nullableUpstreamDecimalSchema,
+    base_amount: nullableUpstreamDecimalSchema,
+    base_currency: nullableStringSchema,
+})
+    .passthrough();
+const businessDocumentOffsetLineSchema = z
+    .object({
+    line_no: z.number().int().nullable(),
+    system_type: nullableStringSchema,
+    offset_type: nullableStringSchema,
+    source_ref: nullableStringSchema,
+    source_date: nullableDateTimeSchema,
+    symbol: nullableStringSchema,
+    quantity: nullableDecimalSchema,
+    base_rate: nullableDecimalSchema,
+    base_amount: nullableDecimalSchema,
+    base_currency: nullableStringSchema,
+})
+    .strict();
+const payableDocumentsListOutputSchema = z
+    .object({
+    document_type: z.literal('payable'),
+    view: z.literal('list'),
+    records: z.array(payableBusinessDocumentListItemSchema),
+    offsets: z.array(payableBusinessDocumentListItemSchema),
+})
+    .strict();
+const receivableDocumentsListOutputSchema = z
+    .object({
+    document_type: z.literal('receivable'),
+    view: z.literal('list'),
+    records: z.array(receivableBusinessDocumentListItemSchema),
+    offsets: z.array(receivableBusinessDocumentListItemSchema),
+})
+    .strict();
+const payableDocumentDetailOutputSchema = z
+    .object({
+    document_type: z.literal('payable'),
+    view: z.literal('detail'),
+    document: payableBusinessDocumentDetailSchema,
+})
+    .strict();
+const receivableDocumentDetailOutputSchema = z
+    .object({
+    document_type: z.literal('receivable'),
+    view: z.literal('detail'),
+    document: receivableBusinessDocumentDetailSchema,
+})
+    .strict();
+const payableOffsetsOutputSchema = z
+    .object({
+    document_type: z.literal('payable'),
+    view: z.literal('offsets'),
+    document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetSchema),
+})
+    .strict();
+const receivableOffsetsOutputSchema = z
+    .object({
+    document_type: z.literal('receivable'),
+    view: z.literal('offsets'),
+    document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetSchema),
+})
+    .strict();
+const payableOffsetLinesOutputSchema = z
+    .object({
+    document_type: z.literal('payable'),
+    view: z.literal('offset_document_lines'),
+    document_id: z.uuid(),
+    offset_document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetLineSchema),
+})
+    .strict();
+const receivableOffsetLinesOutputSchema = z
+    .object({
+    document_type: z.literal('receivable'),
+    view: z.literal('offset_document_lines'),
+    document_id: z.uuid(),
+    offset_document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetLineSchema),
+})
+    .strict();
+/** Internal adapter response retaining the legacy discriminators for routing. */
+export const businessDocumentQueryAdapterOutputSchema = viewPageSuccessEnvelopeSchema(z.union([
+    payableDocumentsListOutputSchema,
+    receivableDocumentsListOutputSchema,
+    payableDocumentDetailOutputSchema,
+    receivableDocumentDetailOutputSchema,
+    payableOffsetsOutputSchema,
+    receivableOffsetsOutputSchema,
+    payableOffsetLinesOutputSchema,
+    receivableOffsetLinesOutputSchema,
+]), ['list']);
+const payableDocumentsListPublicOutputSchema = z
+    .object({
+    records: z.array(payableBusinessDocumentListItemSchema),
+    offsets: z.array(payableBusinessDocumentListItemSchema),
+})
+    .strict();
+const receivableDocumentsListPublicOutputSchema = z
+    .object({
+    records: z.array(receivableBusinessDocumentListItemSchema),
+    offsets: z.array(receivableBusinessDocumentListItemSchema),
+})
+    .strict();
+const payableDocumentDetailPublicOutputSchema = z
+    .object({ document: payableBusinessDocumentDetailSchema })
+    .strict();
+const receivableDocumentDetailPublicOutputSchema = z
+    .object({ document: receivableBusinessDocumentDetailSchema })
+    .strict();
+const payableOffsetsPublicOutputSchema = z
+    .object({
+    document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetSchema),
+})
+    .strict();
+const receivableOffsetsPublicOutputSchema = z
+    .object({
+    document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetSchema),
+})
+    .strict();
+const payableOffsetLinesPublicOutputSchema = z
+    .object({
+    document_id: z.uuid(),
+    offset_document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetLineSchema),
+})
+    .strict();
+const receivableOffsetLinesPublicOutputSchema = z
+    .object({
+    document_id: z.uuid(),
+    offset_document_id: z.uuid(),
+    items: z.array(businessDocumentOffsetLineSchema),
+})
+    .strict();
+export const queryPayableDocumentsOutputSchema = paginatedSuccessEnvelopeSchema(payableDocumentsListPublicOutputSchema);
+export const queryReceivableDocumentsOutputSchema = paginatedSuccessEnvelopeSchema(receivableDocumentsListPublicOutputSchema);
+export const getPayableDocumentOutputSchema = successEnvelopeSchema(payableDocumentDetailPublicOutputSchema);
+export const getReceivableDocumentOutputSchema = successEnvelopeSchema(receivableDocumentDetailPublicOutputSchema);
+export const queryPayableOffsetsOutputSchema = successEnvelopeSchema(payableOffsetsPublicOutputSchema);
+export const queryReceivableOffsetsOutputSchema = successEnvelopeSchema(receivableOffsetsPublicOutputSchema);
+export const queryPayableOffsetLinesOutputSchema = successEnvelopeSchema(payableOffsetLinesPublicOutputSchema);
+export const queryReceivableOffsetLinesOutputSchema = successEnvelopeSchema(receivableOffsetLinesPublicOutputSchema);
+export const businessDocumentExportFormatSchema = z.enum(['xlsx', 'csv']);
+export const exportBusinessDocumentsInputSchema = z.union([
+    z
+        .object({
+        document_type: z.literal('payable'),
+        filters: payableBusinessDocumentFiltersSchema.default({}),
+        sort: payableBusinessDocumentSortSchema.optional(),
+        format: businessDocumentExportFormatSchema.default('xlsx'),
+        context: contextSchema.optional(),
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('receivable'),
+        filters: receivableBusinessDocumentFiltersSchema.default({}),
+        sort: receivableBusinessDocumentSortSchema.optional(),
+        format: businessDocumentExportFormatSchema.default('xlsx'),
+        context: contextSchema.optional(),
+    })
+        .strict(),
+]);
+export const exportBusinessDocumentsOutputSchema = successEnvelopeSchema(z
+    .object({
+    document_type: businessDocumentTypeSchema,
+    format: businessDocumentExportFormatSchema,
+    artifact: artifactMetadataSchema,
+})
+    .strict());
+const draftSubtypeSchema = z.enum([
+    'STANDARD',
+    'CREDIT',
+    'PREPAYMENT',
+    'ACCRUED',
+    'SURCHARGE',
+    'STANDARD_APPLY_ACCRUED',
+]);
+const optionalText = (max) => z.string().max(max).optional();
+const attributeValuesSchema = z
+    .array(z.string().max(255).nullable())
+    .max(12)
+    .optional();
+export const businessDocumentDraftLineSchema = z
+    .object({
+    id: uuidSchema.optional(),
+    line_no: z.number().int().positive().optional(),
+    system_type: optionalText(32),
+    party_id: uuidSchema.optional(),
+    is_offset: z.boolean().optional(),
+    offset_type: optionalText(32),
+    offset_id: uuidSchema.optional(),
+    symbol: optionalText(32),
+    quantity: decimalStringSchema.optional(),
+    base_rate: decimalStringSchema.optional(),
+    base_currency: optionalText(8),
+    base_rate_time: dateTimeSchema.optional(),
+    business_types: z.array(z.string().max(64).nullable()).max(4).optional(),
+    ledger_id: uuidSchema.optional(),
+    coa_code: optionalText(50),
+    description: optionalText(512),
+    reference: optionalText(256),
+    attributes: attributeValuesSchema,
+    tax_code: optionalText(64),
+    tax_rate: decimalStringSchema.optional(),
+    ratio: decimalStringSchema.optional(),
+    version: z.number().int().nonnegative().optional(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    if ((value.offset_type === undefined) !== (value.offset_id === undefined)) {
+        context.addIssue({
+            code: 'custom',
+            path: ['offset_id'],
+            message: 'offset_type and offset_id must be provided or omitted together',
+        });
+    }
+});
+const commonDraftHeadShape = {
+    subtype: draftSubtypeSchema,
+    parent_id: uuidSchema.optional(),
+    source_no: optionalText(50),
+    biz_date: dateSchema.optional(),
+    period_name: z.string().min(1).max(16),
+    ledger_id: uuidSchema,
+    coa_code: optionalText(50),
+    description: optionalText(512),
+    reference: optionalText(256),
+    invoice_no: optionalText(100),
+    usage_qty: decimalStringSchema.optional(),
+    usage_unit: optionalText(32),
+    unit_price: decimalStringSchema.optional(),
+    attributes: attributeValuesSchema,
+    lines: z.array(businessDocumentDraftLineSchema).max(500).default([]),
+};
+export const payableDraftValuesSchema = z
+    .object({
+    ...commonDraftHeadShape,
+    from_party_id: uuidSchema.optional(),
+    document_no: optionalText(50),
+    to_party_id: uuidSchema.optional(),
+    to_party_address_id: uuidSchema.optional(),
+    to_party_payment_method: optionalText(64),
+    to_party_payment_terms: optionalText(128),
+    to_party_payment_term_date: dateTimeSchema.optional(),
+    to_party_payee_account_no: optionalText(128),
+    to_party_payee_account_name: optionalText(200),
+    to_party_swift_code: optionalText(64),
+})
+    .strict();
+export const receivableDraftValuesSchema = z
+    .object({
+    ...commonDraftHeadShape,
+    to_party_id: uuidSchema.optional(),
+    document_no: optionalText(50),
+    from_party_id: uuidSchema.optional(),
+    from_party_address_id: uuidSchema.optional(),
+    from_party_collection_method: optionalText(64),
+    from_party_collection_terms: optionalText(128),
+    from_party_collection_term_date: dateTimeSchema.optional(),
+    from_party_payer_account_no: optionalText(128),
+    from_party_payer_account_name: optionalText(200),
+    from_party_swift_code: optionalText(64),
+})
+    .strict();
+export const payableCreateValuesSchema = payableDraftValuesSchema.extend({
+    attachment_file_ids: z.array(uuidSchema).max(10).optional(),
+});
+export const receivableCreateValuesSchema = receivableDraftValuesSchema.extend({
+    attachment_file_ids: z.array(uuidSchema).max(10).optional(),
+});
+const writeContextSchema = z.object({ org_id: uuidSchema }).strict();
+export const saveBusinessDocumentDraftInputSchema = z.discriminatedUnion('document_type', [
+    z
+        .object({
+        document_type: z.literal('payable'),
+        context: writeContextSchema,
+        idempotency_key: uuidSchema,
+        mutation: z.discriminatedUnion('operation', [
+            z
+                .object({
+                operation: z.literal('create'),
+                values: payableCreateValuesSchema,
+            })
+                .strict(),
+            z
+                .object({
+                operation: z.literal('update'),
+                document_id: uuidSchema,
+                version: z.number().int().nonnegative(),
+                values: payableDraftValuesSchema,
+            })
+                .strict(),
+        ]),
+    })
+        .strict(),
+    z
+        .object({
+        document_type: z.literal('receivable'),
+        context: writeContextSchema,
+        idempotency_key: uuidSchema,
+        mutation: z.discriminatedUnion('operation', [
+            z
+                .object({
+                operation: z.literal('create'),
+                values: receivableCreateValuesSchema,
+            })
+                .strict(),
+            z
+                .object({
+                operation: z.literal('update'),
+                document_id: uuidSchema,
+                version: z.number().int().nonnegative(),
+                values: receivableDraftValuesSchema,
+            })
+                .strict(),
+        ]),
+    })
+        .strict(),
+]);
+export const saveBusinessDocumentDraftOutputSchema = successEnvelopeSchema(z
+    .object({
+    operation: z.enum(['created', 'updated']),
+    document_type: businessDocumentTypeSchema,
+    document: z
+        .object({
+        id: uuidSchema,
+        document_no: z.string().nullable(),
+        version: z.number().int().nonnegative().nullable(),
+    })
+        .strict(),
+})
+    .strict());
+//# sourceMappingURL=business-documents.js.map