declare global {
    /**
     * `GET /reports?mode=sales&date=YYYYMM` response row — one entry per day.
     *
     * Revenue is attributed by DELIVERY date, returns by their OWN `dated` — the two
     * don't net to zero within a single row, by design. `returns`/`returnCost`/
     * `returnCount` are POSITIVE magnitudes; netting is expressed by `net`/`netCost`.
     */
    interface ReportSales {
        /** `YYYYMMDD` as a number, matching the API wire type. */
        date: number;
        /** Count of delivered orders on this date. */
        quantity: number;
        /** GROSS COGS of those delivered orders. */
        cost: number;
        /** GROSS revenue of those delivered orders (post-order-discount). */
        total: number;
        /**
         * Positive sum of credited return totals dated this day.
         * ⚠️ OPTIONAL, not forward-only any more: `GET /reports?mode=sales` now
         * emits the return/net quintet. They stay optional because a day with no
         * returns omits them rather than sending zeros — absent means "no returns
         * dated this day", which is not the same as a measured zero.
         */
        returns?: number;
        /** Count of returns dated this day. Forward-only — see `returns`. */
        returnCount?: number;
        /** Positive cost of the returned units. Forward-only — see `returns`. */
        returnCost?: number;
        /** `total - returns`. Forward-only — see `returns`. */
        net?: number;
        /** `cost - returnCost`. Forward-only — see `returns`. */
        netCost?: number;
    }
    /**
     * One FAC/NC/net bucket of the ventas IVA summary. Every amount is a POSITIVE
     * magnitude, including `credit` — netting is expressed by the `net` bucket only.
     */
    interface ReportInvoicesAmounts {
        /** Voucher count in this bucket. */
        quantity: number;
        /** Neto gravado summed over every declared alícuota. */
        neto: number;
        /** Débito fiscal (IVA) summed over every declared alícuota. */
        iva: number;
        /** `ImpTotal` sum. */
        total: number;
    }
    /**
     * One day of the `GET /reports?mode=invoices&date=YYYYMM` ventas summary.
     *
     * Covers only AUTHORIZED (deliverable) vouchers — `pending_cae` and
     * `rejected` are excluded upstream, and legacy rows with no `fiscalStatus`
     * count as authorized.
     */
    interface ReportInvoicesResume {
        /** `YYYYMMDD` as a NUMBER, matching `Invoice.dated`. */
        date: number;
        /** Count of ALL deliverable vouchers this day, credit notes included. */
        quantity: number;
        /**
         * Legacy roll-up columns summing EVERY deliverable voucher with a POSITIVE
         * sign (credit notes included), so `total` mixes debits and credits.
         * Retained for wire compatibility; prefer `gross`/`credit`/`net` below.
         */
        neto10: number;
        neto21: number;
        iva10: number;
        iva21: number;
        neto: number;
        iva: number;
        total: number;
        /** Non-credit vouchers — facturas and notas de débito. */
        gross: ReportInvoicesAmounts;
        /**
         * Notas de crédito only, as positive magnitudes, classified via `NC_CBTE_TIPOS`.
         * Notas de DÉBITO are deliberately NOT here — a débito increases what's owed,
         * so it belongs in `gross`.
         */
        credit: ReportInvoicesAmounts;
        /** `gross - credit`, field by field. The figure an operator should read. */
        net: ReportInvoicesAmounts;
    }
    /**
     * One voucher row of the ventas summary's spreadsheet export. Mixed string/number
     * by design — padded fiscal columns are strings, amounts are numbers.
     */
    interface ReportInvoicesVoucherRow {
        FECHA: string;
        CBTE_TIPO: string;
        PTO_VTA: string;
        CBTE_NUMERO: number;
        RAZON_SOCIAL: string;
        CUIT: string;
        NETO: number;
        NETO10: number;
        NETO21: number;
        TOTAL: number;
    }
    /**
     * `GET /reports?mode=invoices&date=YYYYMM` response payload. Carries BOTH the
     * operator-facing summary (`resume`, `period`) and the ARCA REGINFO_CV_VENTAS
     * flat files (`customers`, `reg_alicuotas`, `reg_cbte`) — the summary nets
     * credit notes, the flat files must keep every voucher a positive magnitude.
     */
    interface ReportInvoices {
        /** Per-day rows, ascending by `date`. */
        resume: ReportInvoicesResume[];
        /** Same FAC/NC/net split aggregated over the whole selected period. */
        period: {
            gross: ReportInvoicesAmounts;
            credit: ReportInvoicesAmounts;
            net: ReportInvoicesAmounts;
        };
        invoices: ReportInvoicesVoucherRow[];
        /** REGINFO_CV_VENTAS fixed-width padrón de clientes. */
        customers: string;
        /** REGINFO_CV_VENTAS_ALICUOTAS.TXT — one record per declared alícuota. */
        reg_alicuotas: string;
        /** REGINFO_CV_VENTAS_CBTE.TXT — one record per voucher. */
        reg_cbte: string;
    }
}
export {};