@sixtyninecommerce/admin 0.10.0 → 0.11.0

package/dist/documents/ar.d.ts

@@ -0,0 +1,307 @@
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { PaymentTerms } from '../customers/credit.js';
+import type { Call, ListOptions } from '../types.js';
+/**
+ * The documents of the store's accounts-receivable ledger (`admin.documents.ar`, headless
+ * W10-30): AR invoices and statements, AR credit notes, and the open invoices an ERP keeps for an
+ * ERP-linked customer. Correcting an AR invoice is `documents.planCorrection` /
+ * `commitCorrection` with `ledger: 'AR'`.
+ *
+ * Every write needs `UpdateOrder` and a store that keeps its AR ledger (else
+ * `AR_LEDGER_NOT_ENABLED`, → `BusinessRuleError`); every read `ReadOrder`. A customer the store
+ * does not hold is `CUSTOMER_NOT_FOUND` (→ `NotFoundError`). Money is in integer minor units of
+ * the document's own currency.
+ *
+ * **Keys.** `issueCreditNote`, `generateInvoice` and `generateStatement` take
+ * `options.idempotencyKey`: a repeat under the same key answers the first call's document instead
+ * of issuing another (a retry after a timeout draws no second number), and another request under
+ * the key is refused `IDEMPOTENCY_CONFLICT` (→ `ConflictError`, 409); one that arrives while the
+ * first still runs, `IDEMPOTENCY_IN_PROGRESS`. Without a key `issueCreditNote` is NOT
+ * de-duplicated: a double submit issues two credit notes.
+ */
+/** One frozen line of an issued AR document, minor units. */
+export interface ArDocumentLine {
+    description: string;
+    /** Empty for a free-form row. */
+    sku: string;
+    orderLineId: string | null;
+    quantity: number;
+    unitPriceNet: number;
+    unitPriceWithTax: number;
+    /** Percentage, may be fractional. */
+    taxRate: number;
+    lineTotalNet: number;
+    lineTotalWithTax: number;
+    /** `net` or `gross`: the side that is exact. */
+    unitPriceBasis: string;
+}
+export type ArInvoiceStatus = 'open' | 'partially_paid' | 'paid' | 'overdue' | 'voided';
+/** An AR invoice or statement, with its settlement figures. */
+export interface ArInvoice {
+    id: string;
+    invoiceNumber: string;
+    /** `platform`, or the ERP that numbered it. */
+    numberingProvider: string;
+    customerId: string;
+    issuedOn: string;
+    dueOn: string;
+    paymentTermsDays: number;
+    paymentTerms: (PaymentTerms & {
+        customerId: string | null;
+    }) | null;
+    currencyCode: string;
+    totalWithTax: number;
+    /** Payments allocated: money that arrived. */
+    allocatedAmount: number;
+    /** Partial credit notes: collectable reduced with no money in. */
+    creditedAmount: number;
+    /** Still collectable; 0 once voided. */
+    outstandingAmount: number;
+    status: ArInvoiceStatus;
+    notes: string | null;
+    hasPdf: boolean;
+    orderIds: string[];
+    voidedOn: string | null;
+    reversedByCreditNoteId: string | null;
+    supersededByInvoiceId: string | null;
+    reissueOfInvoiceId: string | null;
+    /** `standard` or `supplementary`. */
+    kind: string;
+    supplementsInvoiceId: string | null;
+    lines: ArDocumentLine[] | null;
+    /** SEPA direct debit: the day the debtor was told it would be collected. */
+    collectOn: string | null;
+    prenotifiedAt: string | null;
+    prenotifiedAmount: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** An AR credit note. */
+export interface ArCreditNote {
+    id: string;
+    creditNoteNumber: string;
+    numberingProvider: string;
+    customerId: string;
+    issuedOn: string;
+    currencyCode: string;
+    amount: number;
+    reason: string;
+    orderId: string | null;
+    hasPdf: boolean;
+    /** `correction`, `cancellation`, `return` or `adjustment`. */
+    kind: string;
+    invoiceId: string | null;
+    reversalOfInvoiceId: string | null;
+    lines: ArDocumentLine[] | null;
+    refundId: string | null;
+    /** False only for the fiscal note of a refund that went back to a card. */
+    creditsAccount: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * An ERP-mirrored invoice's status, judged against today in the STORE's zone: `credit_note`
+ * (outstanding below zero), `overdue`, `partially_paid`, `open`. Never `paid`: the ERP drops a
+ * paid invoice.
+ */
+export type ArExternalInvoiceStatus = 'credit_note' | 'overdue' | 'partially_paid' | 'open';
+/** An open invoice the ERP keeps for an ERP-linked customer (a read-only mirror). */
+export interface ArExternalInvoice {
+    id: string;
+    customerId: string;
+    /** The ERP, e.g. `afas`. */
+    source: string;
+    externalDebtorId: string;
+    externalInvoiceNumber: string;
+    issuedOn: string;
+    dueOn: string;
+    currencyCode: string;
+    totalWithTax: number;
+    /** Signed: below zero is a credit note. */
+    outstandingAmount: number;
+    description: string | null;
+    administrationUnit: number | null;
+    syncedAt: string;
+    status: ArExternalInvoiceStatus;
+}
+export interface ArExternalInvoiceSyncResult {
+    /** True when the ERP answered and the mirror was replaced. */
+    synced: boolean;
+    upserted: number;
+    removed: number;
+    /** Why nothing was synced (no provider, no ERP data, a read error); null when it was. */
+    skippedReason: string | null;
+}
+/** A filter on an AR document list: one customer, or the whole store. */
+export interface ArDocumentListOptions extends ListOptions {
+    customerId?: string;
+}
+export interface IssueArCreditNoteInput {
+    customerId: string;
+    /** Minor units, above zero. */
+    amount: number;
+    reason: string;
+    /** The order it relates to; bounded by what that order's live invoices billed. */
+    orderId?: string | null;
+    /** `YYYY-MM-DD`; defaults to today in the store's zone. */
+    issuedOn?: string;
+}
+/** Explicit terms for an invoice: days, or an ERP condition code, never both. */
+export interface ArInvoiceTermsInput {
+    paymentTermsDays?: number;
+    paymentConditionCode?: string;
+    /** `YYYY-MM-DD`; defaults to today in the store's zone. */
+    issuedOn?: string;
+    notes?: string | null;
+}
+export interface GenerateArInvoiceInput extends ArInvoiceTermsInput {
+    orderId: string;
+}
+export interface GenerateArStatementInput extends ArInvoiceTermsInput {
+    customerId: string;
+    /** The orders it bills, all in one currency (`customers.credit.invoiceableOrders`). */
+    orderIds: string[];
+}
+/** The displayed shape of the store's AR credit-note numbers. */
+export interface ArCreditNoteNumbering {
+    prefix: string;
+    suffix: string;
+    /** 3 to 8. */
+    digits: number;
+    /** `none`, `short` or `full`. */
+    yearFormat: string;
+    yearReset: boolean;
+}
+export type UpdateArCreditNoteNumberingInput = Partial<ArCreditNoteNumbering>;
+export interface ArCreditNoteNumberingModule {
+    /**
+     * The store's AR credit-note number format (created with defaults on first read).
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    get(options?: Call): Promise<ArCreditNoteNumbering>;
+    /**
+     * Change the format. `digits` is clamped to 3..8; a `yearFormat` other than `none`, `short`
+     * or `full` is refused, as is a change that would make numbers repeat
+     * (`NUMBERING_RESTART_WOULD_REPEAT`). The counter itself never moves here.
+     *
+     * @effect write
+     * @permission UpdateOrder
+     */
+    set(input: UpdateArCreditNoteNumberingInput, options?: Call): Promise<ArCreditNoteNumbering>;
+}
+export interface ArDocumentsModule {
+    /**
+     * AR invoices and statements, newest first, one customer's or the store's, paged (`limit` up
+     * to 100). Voided ones are listed with `status: 'voided'`.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    invoices(options?: ArDocumentListOptions): Promise<Page<ArInvoice>>;
+    /**
+     * AR credit notes, newest first, one customer's or the store's, paged (`limit` up to 100).
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    creditNotes(options?: ArDocumentListOptions): Promise<Page<ArCreditNote>>;
+    /**
+     * The open invoices the ERP keeps for an ERP-linked customer, as last mirrored, each with its
+     * status judged against the store's today. An engine older than `status` fails the
+     * document's validation.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    externalInvoices(customerId: string, options?: Call): Promise<ArExternalInvoice[]>;
+    /**
+     * Refresh a customer's ERP invoice mirror now. A skipped sync is an answer
+     * (`skippedReason`), not an error.
+     *
+     * @effect write
+     * @permission UpdateOrder
+     */
+    syncExternal(customerId: string, options?: Call): Promise<ArExternalInvoiceSyncResult>;
+    /**
+     * An AR invoice's or credit note's rendered PDF, or null when none is stored yet. A document
+     * of another store answers null.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    pdf(id: string, kind: 'invoice' | 'credit-note', options?: Call): Promise<Uint8Array | null>;
+    /**
+     * Issue a lump-sum AR credit note, posting a ledger credit that lowers the customer's balance.
+     * It draws a number (an ERP's, on a store whose ERP numbers credit notes). Pass
+     * `options.idempotencyKey`: without one a repeat issues a second note. With an `orderId` it is
+     * held to what that order's live invoices still bill (`AR_ORDER_CREDIT_EXCEEDS_BILLED`), and to
+     * what each of those invoices billed (`INVOICE_CREDIT_EXCEEDS_INVOICE`). Their sentence states
+     * money in the document's currency (an older engine stated minor units); their one `details`
+     * entry restates the figures in minor units.
+     *
+     * Refusals: `AR_LEDGER_NOT_ENABLED`, `CUSTOMER_NOT_FOUND`, `AR_CURRENCY_MISMATCH`,
+     * `ORDER_NOT_FOUND` (an order not in this store; `USER_INPUT_ERROR` on an older engine),
+     * `AR_INVOICE_CHANGED_CONFLICT` (the order's invoices were corrected while it waited: nothing was
+     * credited, issue it again; the key is released), and a field refusal (`USER_INPUT_ERROR`) for an
+     * amount or reason that is not one.
+     *
+     * @effect money
+     * @permission UpdateOrder
+     */
+    issueCreditNote(input: IssueArCreditNoteInput, options?: Call): Promise<ArCreditNote>;
+    /**
+     * Invoice one placed order on the AR ledger: draws an invoice number, debits the customer,
+     * and applies what was already collected on the order. A repeat under the same key answers
+     * the same invoice; without a key a repeat is refused (the order is invoiced already,
+     * `INVOICE_ISSUE_CONFLICT` → `ConflictError`; an older engine answered `USER_INPUT_ERROR` with the
+     * same sentence). Terms: the order's frozen ones, else the customer's, unless given here.
+     * Refused for an ERP-linked customer (`AR_ACCOUNT_IN_ERP`), when the terms state no single due
+     * date, for an order in a state no invoice is issued in (a draft, a cart, a cancelled order:
+     * `INVOICE_ORDER_STATE_BLOCKS_ISSUE`), and for an order a live STORE invoice bills
+     * (`INVOICE_LEDGER_CONFLICT` → `ConflictError`: an order is billed by one ledger; `details`
+     * names the order and the invoice). Nothing is numbered on a refusal. An engine before these
+     * two refusals ISSUED the AR invoice in both cases. Also refused, coded (each a
+     * `USER_INPUT_ERROR`, or for the terms an uncoded server error, on an older engine):
+     * `ORDER_NOT_FOUND`, `AR_ORDER_HAS_NO_CUSTOMER`, `AR_PAYMENT_TERMS_MISSING` (no terms resolve
+     * and none are given), `INVOICE_PAYMENT_TERMS_UNREPRESENTABLE` (the terms state no single due
+     * date), `PAYMENT_TERMS_NOT_ACCEPTED` (days given for a customer an ERP governs, or a condition
+     * for one whose terms are kept here), `PAYMENT_CONDITION_UNKNOWN`, `PAYMENT_CONDITION_UNUSABLE`
+     * and `PAYMENT_TERMS_UNRESOLVED` (the ERP's terms for the order are not known yet).
+     *
+     * @effect money
+     * @permission UpdateOrder
+     */
+    generateInvoice(input: GenerateArInvoiceInput, options?: Call): Promise<ArInvoice>;
+    /**
+     * One statement invoice over several of the customer's orders, all in one currency and on
+     * one payment rule. Keys and refusals as {@link generateInvoice}; `CUSTOMER_NOT_FOUND`,
+     * `AR_ORDER_CUSTOMER_MISMATCH` (an order of another customer), `AR_CURRENCY_MISMATCH` (orders
+     * in two currencies) and `AR_STATEMENT_TERMS_MISMATCH` (different payment rules). One
+     * refused order refuses the whole statement: nothing is billed in part, and
+     * `INVOICE_LEDGER_CONFLICT` names every order a store invoice bills.
+     *
+     * @effect money
+     * @permission UpdateOrder
+     */
+    generateStatement(input: GenerateArStatementInput, options?: Call): Promise<ArInvoice>;
+    creditNoteNumbering: ArCreditNoteNumberingModule;
+}
+export declare const AR_INVOICES_QUERY = "\n  query ArInvoices($options: ArListOptions) {\n    arInvoices(options: $options) {\n      items { \n  id\n  invoiceNumber\n  numberingProvider\n  customerId\n  issuedOn\n  dueOn\n  paymentTermsDays\n  paymentTerms {\n    customerId\n    source\n    managedExternally\n    status\n    conditionCode\n    conditionDescription\n    summary\n    classification\n    paymentDays\n    paymentEndOfMonths\n    paymentMethod\n    percentage\n    discountPaymentDays\n    discountPercentage\n    paymentDiscountType\n    stale\n    syncedAt\n    error\n  }\n  currencyCode\n  totalWithTax\n  allocatedAmount\n  creditedAmount\n  outstandingAmount\n  status\n  notes\n  hasPdf\n  orderIds\n  voidedOn\n  reversedByCreditNoteId\n  supersededByInvoiceId\n  reissueOfInvoiceId\n  kind\n  supplementsInvoiceId\n  lines { \n  description\n  sku\n  orderLineId\n  quantity\n  unitPriceNet\n  unitPriceWithTax\n  taxRate\n  lineTotalNet\n  lineTotalWithTax\n  unitPriceBasis\n }\n  collectOn\n  prenotifiedAt\n  prenotifiedAmount\n  createdAt\n  updatedAt\n }\n      totalItems\n    }\n  }\n";
+export declare const AR_CREDIT_NOTES_QUERY = "\n  query ArCreditNotes($options: ArListOptions) {\n    arCreditNotes(options: $options) {\n      items { \n  id\n  creditNoteNumber\n  numberingProvider\n  customerId\n  issuedOn\n  currencyCode\n  amount\n  reason\n  orderId\n  hasPdf\n  kind\n  invoiceId\n  reversalOfInvoiceId\n  lines { \n  description\n  sku\n  orderLineId\n  quantity\n  unitPriceNet\n  unitPriceWithTax\n  taxRate\n  lineTotalNet\n  lineTotalWithTax\n  unitPriceBasis\n }\n  refundId\n  creditsAccount\n  createdAt\n  updatedAt\n }\n      totalItems\n    }\n  }\n";
+export declare const AR_EXTERNAL_INVOICES_QUERY = "\n  query ArExternalInvoices($customerId: ID!) {\n    arExternalInvoices(customerId: $customerId) {\n      items {\n        id\n        customerId\n        source\n        externalDebtorId\n        externalInvoiceNumber\n        issuedOn\n        dueOn\n        currencyCode\n        totalWithTax\n        outstandingAmount\n        description\n        administrationUnit\n        syncedAt\n        status\n      }\n    }\n  }\n";
+export declare const SYNC_EXTERNAL_INVOICES_MUTATION = "\n  mutation SyncExternalInvoices($customerId: ID!) {\n    syncExternalInvoices(customerId: $customerId) {\n      synced\n      upserted\n      removed\n      skippedReason\n    }\n  }\n";
+export declare const AR_INVOICE_PDF_QUERY = "\n  query ArInvoicePdf($id: ID!) {\n    arInvoicePdf(id: $id)\n  }\n";
+export declare const AR_CREDIT_NOTE_PDF_QUERY = "\n  query ArCreditNotePdf($id: ID!) {\n    arCreditNotePdf(id: $id)\n  }\n";
+export declare const ISSUE_AR_CREDIT_NOTE_MUTATION = "\n  mutation IssueArCreditNote($input: IssueArCreditNoteInput!, $idempotencyKey: String) {\n    issueArCreditNote(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  creditNoteNumber\n  numberingProvider\n  customerId\n  issuedOn\n  currencyCode\n  amount\n  reason\n  orderId\n  hasPdf\n  kind\n  invoiceId\n  reversalOfInvoiceId\n  lines { \n  description\n  sku\n  orderLineId\n  quantity\n  unitPriceNet\n  unitPriceWithTax\n  taxRate\n  lineTotalNet\n  lineTotalWithTax\n  unitPriceBasis\n }\n  refundId\n  creditsAccount\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const GENERATE_AR_INVOICE_MUTATION = "\n  mutation GenerateArInvoice($input: GenerateArInvoiceInput!, $idempotencyKey: String) {\n    generateArInvoice(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  invoiceNumber\n  numberingProvider\n  customerId\n  issuedOn\n  dueOn\n  paymentTermsDays\n  paymentTerms {\n    customerId\n    source\n    managedExternally\n    status\n    conditionCode\n    conditionDescription\n    summary\n    classification\n    paymentDays\n    paymentEndOfMonths\n    paymentMethod\n    percentage\n    discountPaymentDays\n    discountPercentage\n    paymentDiscountType\n    stale\n    syncedAt\n    error\n  }\n  currencyCode\n  totalWithTax\n  allocatedAmount\n  creditedAmount\n  outstandingAmount\n  status\n  notes\n  hasPdf\n  orderIds\n  voidedOn\n  reversedByCreditNoteId\n  supersededByInvoiceId\n  reissueOfInvoiceId\n  kind\n  supplementsInvoiceId\n  lines { \n  description\n  sku\n  orderLineId\n  quantity\n  unitPriceNet\n  unitPriceWithTax\n  taxRate\n  lineTotalNet\n  lineTotalWithTax\n  unitPriceBasis\n }\n  collectOn\n  prenotifiedAt\n  prenotifiedAmount\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const GENERATE_AR_STATEMENT_MUTATION = "\n  mutation GenerateArStatement($input: GenerateArStatementInput!, $idempotencyKey: String) {\n    generateArStatement(input: $input, idempotencyKey: $idempotencyKey) { \n  id\n  invoiceNumber\n  numberingProvider\n  customerId\n  issuedOn\n  dueOn\n  paymentTermsDays\n  paymentTerms {\n    customerId\n    source\n    managedExternally\n    status\n    conditionCode\n    conditionDescription\n    summary\n    classification\n    paymentDays\n    paymentEndOfMonths\n    paymentMethod\n    percentage\n    discountPaymentDays\n    discountPercentage\n    paymentDiscountType\n    stale\n    syncedAt\n    error\n  }\n  currencyCode\n  totalWithTax\n  allocatedAmount\n  creditedAmount\n  outstandingAmount\n  status\n  notes\n  hasPdf\n  orderIds\n  voidedOn\n  reversedByCreditNoteId\n  supersededByInvoiceId\n  reissueOfInvoiceId\n  kind\n  supplementsInvoiceId\n  lines { \n  description\n  sku\n  orderLineId\n  quantity\n  unitPriceNet\n  unitPriceWithTax\n  taxRate\n  lineTotalNet\n  lineTotalWithTax\n  unitPriceBasis\n }\n  collectOn\n  prenotifiedAt\n  prenotifiedAmount\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const AR_CREDIT_NOTE_NUMBERING_QUERY = "\n  query CreditNoteNumberingConfig {\n    creditNoteNumberingConfig { \n  prefix\n  suffix\n  digits\n  yearFormat\n  yearReset\n }\n  }\n";
+export declare const UPDATE_AR_CREDIT_NOTE_NUMBERING_MUTATION = "\n  mutation UpdateCreditNoteNumberingConfig($input: UpdateCreditNoteNumberingConfigInput!) {\n    updateCreditNoteNumberingConfig(input: $input) { \n  prefix\n  suffix\n  digits\n  yearFormat\n  yearReset\n }\n  }\n";
+/** `ListOptions` → the engine's offset page (the offset hides inside the cursor, spec §9.3). */
+export declare function arPageWindow(options?: ListOptions): {
+    skip: number;
+    take: number;
+};
+export declare function createArDocumentsModule(transport: Transport): ArDocumentsModule;

package/dist/documents/ar.js

@@ -0,0 +1,254 @@
+import { pageFromVendureList, readOffsetCursor, } from '@sixtyninecommerce/core';
+import { decodePdf } from './pdf.js';
+const DOCUMENT_LINE_FIELDS = /* GraphQL */ `
+  description
+  sku
+  orderLineId
+  quantity
+  unitPriceNet
+  unitPriceWithTax
+  taxRate
+  lineTotalNet
+  lineTotalWithTax
+  unitPriceBasis
+`;
+const AR_INVOICE_FIELDS = /* GraphQL */ `
+  id
+  invoiceNumber
+  numberingProvider
+  customerId
+  issuedOn
+  dueOn
+  paymentTermsDays
+  paymentTerms {
+    customerId
+    source
+    managedExternally
+    status
+    conditionCode
+    conditionDescription
+    summary
+    classification
+    paymentDays
+    paymentEndOfMonths
+    paymentMethod
+    percentage
+    discountPaymentDays
+    discountPercentage
+    paymentDiscountType
+    stale
+    syncedAt
+    error
+  }
+  currencyCode
+  totalWithTax
+  allocatedAmount
+  creditedAmount
+  outstandingAmount
+  status
+  notes
+  hasPdf
+  orderIds
+  voidedOn
+  reversedByCreditNoteId
+  supersededByInvoiceId
+  reissueOfInvoiceId
+  kind
+  supplementsInvoiceId
+  lines { ${DOCUMENT_LINE_FIELDS} }
+  collectOn
+  prenotifiedAt
+  prenotifiedAmount
+  createdAt
+  updatedAt
+`;
+const AR_CREDIT_NOTE_FIELDS = /* GraphQL */ `
+  id
+  creditNoteNumber
+  numberingProvider
+  customerId
+  issuedOn
+  currencyCode
+  amount
+  reason
+  orderId
+  hasPdf
+  kind
+  invoiceId
+  reversalOfInvoiceId
+  lines { ${DOCUMENT_LINE_FIELDS} }
+  refundId
+  creditsAccount
+  createdAt
+  updatedAt
+`;
+const NUMBERING_FIELDS = /* GraphQL */ `
+  prefix
+  suffix
+  digits
+  yearFormat
+  yearReset
+`;
+export const AR_INVOICES_QUERY = /* GraphQL */ `
+  query ArInvoices($options: ArListOptions) {
+    arInvoices(options: $options) {
+      items { ${AR_INVOICE_FIELDS} }
+      totalItems
+    }
+  }
+`;
+export const AR_CREDIT_NOTES_QUERY = /* GraphQL */ `
+  query ArCreditNotes($options: ArListOptions) {
+    arCreditNotes(options: $options) {
+      items { ${AR_CREDIT_NOTE_FIELDS} }
+      totalItems
+    }
+  }
+`;
+export const AR_EXTERNAL_INVOICES_QUERY = /* GraphQL */ `
+  query ArExternalInvoices($customerId: ID!) {
+    arExternalInvoices(customerId: $customerId) {
+      items {
+        id
+        customerId
+        source
+        externalDebtorId
+        externalInvoiceNumber
+        issuedOn
+        dueOn
+        currencyCode
+        totalWithTax
+        outstandingAmount
+        description
+        administrationUnit
+        syncedAt
+        status
+      }
+    }
+  }
+`;
+export const SYNC_EXTERNAL_INVOICES_MUTATION = /* GraphQL */ `
+  mutation SyncExternalInvoices($customerId: ID!) {
+    syncExternalInvoices(customerId: $customerId) {
+      synced
+      upserted
+      removed
+      skippedReason
+    }
+  }
+`;
+export const AR_INVOICE_PDF_QUERY = /* GraphQL */ `
+  query ArInvoicePdf($id: ID!) {
+    arInvoicePdf(id: $id)
+  }
+`;
+export const AR_CREDIT_NOTE_PDF_QUERY = /* GraphQL */ `
+  query ArCreditNotePdf($id: ID!) {
+    arCreditNotePdf(id: $id)
+  }
+`;
+export const ISSUE_AR_CREDIT_NOTE_MUTATION = /* GraphQL */ `
+  mutation IssueArCreditNote($input: IssueArCreditNoteInput!, $idempotencyKey: String) {
+    issueArCreditNote(input: $input, idempotencyKey: $idempotencyKey) { ${AR_CREDIT_NOTE_FIELDS} }
+  }
+`;
+export const GENERATE_AR_INVOICE_MUTATION = /* GraphQL */ `
+  mutation GenerateArInvoice($input: GenerateArInvoiceInput!, $idempotencyKey: String) {
+    generateArInvoice(input: $input, idempotencyKey: $idempotencyKey) { ${AR_INVOICE_FIELDS} }
+  }
+`;
+export const GENERATE_AR_STATEMENT_MUTATION = /* GraphQL */ `
+  mutation GenerateArStatement($input: GenerateArStatementInput!, $idempotencyKey: String) {
+    generateArStatement(input: $input, idempotencyKey: $idempotencyKey) { ${AR_INVOICE_FIELDS} }
+  }
+`;
+export const AR_CREDIT_NOTE_NUMBERING_QUERY = /* GraphQL */ `
+  query CreditNoteNumberingConfig {
+    creditNoteNumberingConfig { ${NUMBERING_FIELDS} }
+  }
+`;
+export const UPDATE_AR_CREDIT_NOTE_NUMBERING_MUTATION = /* GraphQL */ `
+  mutation UpdateCreditNoteNumberingConfig($input: UpdateCreditNoteNumberingConfigInput!) {
+    updateCreditNoteNumberingConfig(input: $input) { ${NUMBERING_FIELDS} }
+  }
+`;
+const AR_PAGE_LIMIT = 100;
+const AR_PAGE_SIZE = 25;
+/** `ListOptions` → the engine's offset page (the offset hides inside the cursor, spec §9.3). */
+export function arPageWindow(options) {
+    return {
+        take: Math.min(options?.limit ?? AR_PAGE_SIZE, AR_PAGE_LIMIT),
+        skip: options?.after === undefined ? 0 : readOffsetCursor(options.after),
+    };
+}
+/** `undefined`, never null: `JSON.stringify` drops it, so an omitted key stays off the wire. */
+const keyOf = (options) => options?.idempotencyKey;
+export function createArDocumentsModule(transport) {
+    const listPage = async (query, field, customerId, skip, take, options) => {
+        const data = await transport.graphql({ api: 'admin', query, variables: { options: { customerId, skip, take } } }, options);
+        const list = data[field];
+        if (!list)
+            throw new Error(`The engine answered no ${field}`);
+        return pageFromVendureList(list, skip, take, (cursor) => listPage(query, field, customerId, readOffsetCursor(cursor), take, options));
+    };
+    return {
+        invoices(options) {
+            const { skip, take } = arPageWindow(options);
+            return listPage(AR_INVOICES_QUERY, 'arInvoices', options?.customerId, skip, take, options);
+        },
+        creditNotes(options) {
+            const { skip, take } = arPageWindow(options);
+            return listPage(AR_CREDIT_NOTES_QUERY, 'arCreditNotes', options?.customerId, skip, take, options);
+        },
+        async externalInvoices(customerId, options) {
+            const data = await transport.graphql({ api: 'admin', query: AR_EXTERNAL_INVOICES_QUERY, variables: { customerId } }, options);
+            return data.arExternalInvoices.items;
+        },
+        async syncExternal(customerId, options) {
+            const data = await transport.graphql({ api: 'admin', query: SYNC_EXTERNAL_INVOICES_MUTATION, variables: { customerId } }, options);
+            return data.syncExternalInvoices;
+        },
+        async pdf(id, kind, options) {
+            if (kind === 'invoice') {
+                const data = await transport.graphql({ api: 'admin', query: AR_INVOICE_PDF_QUERY, variables: { id } }, options);
+                return data.arInvoicePdf === null ? null : decodePdf(data.arInvoicePdf);
+            }
+            const data = await transport.graphql({ api: 'admin', query: AR_CREDIT_NOTE_PDF_QUERY, variables: { id } }, options);
+            return data.arCreditNotePdf === null ? null : decodePdf(data.arCreditNotePdf);
+        },
+        async issueCreditNote(input, options) {
+            const data = await transport.graphql({
+                api: 'admin',
+                query: ISSUE_AR_CREDIT_NOTE_MUTATION,
+                variables: { input, idempotencyKey: keyOf(options) },
+            }, options);
+            return data.issueArCreditNote;
+        },
+        async generateInvoice(input, options) {
+            const data = await transport.graphql({
+                api: 'admin',
+                query: GENERATE_AR_INVOICE_MUTATION,
+                variables: { input, idempotencyKey: keyOf(options) },
+            }, options);
+            return data.generateArInvoice;
+        },
+        async generateStatement(input, options) {
+            const data = await transport.graphql({
+                api: 'admin',
+                query: GENERATE_AR_STATEMENT_MUTATION,
+                variables: { input, idempotencyKey: keyOf(options) },
+            }, options);
+            return data.generateArStatement;
+        },
+        creditNoteNumbering: {
+            async get(options) {
+                const data = await transport.graphql({ api: 'admin', query: AR_CREDIT_NOTE_NUMBERING_QUERY }, options);
+                return data.creditNoteNumberingConfig;
+            },
+            async set(input, options) {
+                const data = await transport.graphql({ api: 'admin', query: UPDATE_AR_CREDIT_NOTE_NUMBERING_MUTATION, variables: { input } }, options);
+                return data.updateCreditNoteNumberingConfig;
+            },
+        },
+    };
+}