rerobe-js-orm 4.9.10 → 4.9.11

package/lib/helpers/FiscalHelpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Country-fiscal validators. Pure + framework-agnostic so backend (srv4pos
+ * activation), web (activation UI), and onboarding all share one source.
+ *
+ * A Swedish organisationsnummer (and personnummer) is 10 digits whose last digit
+ * is a Luhn check digit; Skatteverket / srv4pos reject any corporateId that
+ * fails it (SHOULD_MATCH_CORPORATE_ID_VALIDATION_LUHN).
+ */
+export declare function passesLuhn(value: string | number): boolean;
+export declare function normalizeSwedishOrgNumber(value: string | number | null | undefined): string;
+export declare function isValidSwedishOrgNumber(value: string | number | null | undefined): boolean;

package/lib/helpers/FiscalHelpers.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Country-fiscal validators. Pure + framework-agnostic so backend (srv4pos
+ * activation), web (activation UI), and onboarding all share one source.
+ *
+ * A Swedish organisationsnummer (and personnummer) is 10 digits whose last digit
+ * is a Luhn check digit; Skatteverket / srv4pos reject any corporateId that
+ * fails it (SHOULD_MATCH_CORPORATE_ID_VALIDATION_LUHN).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.passesLuhn = passesLuhn;
+exports.normalizeSwedishOrgNumber = normalizeSwedishOrgNumber;
+exports.isValidSwedishOrgNumber = isValidSwedishOrgNumber;
+// Standard Luhn checksum over a string of digits.
+function passesLuhn(value) {
+    const digits = String(value);
+    if (!/^\d+$/.test(digits))
+        return false;
+    let sum = 0;
+    let alternate = false;
+    for (let i = digits.length - 1; i >= 0; i -= 1) {
+        let n = Number(digits[i]);
+        if (alternate) {
+            n *= 2;
+            if (n > 9)
+                n -= 9;
+        }
+        sum += n;
+        alternate = !alternate;
+    }
+    return sum % 10 === 0;
+}
+// Strip non-digits to the 10-digit form srv4pos/Stripe expect (no hyphen).
+function normalizeSwedishOrgNumber(value) {
+    return String(value !== null && value !== void 0 ? value : '').replace(/\D/g, '');
+}
+// True when `value` is a valid Swedish organisationsnummer: exactly 10 digits
+// (hyphens/spaces ignored) satisfying the Luhn checksum.
+function isValidSwedishOrgNumber(value) {
+    const digits = normalizeSwedishOrgNumber(value);
+    return /^\d{10}$/.test(digits) && passesLuhn(digits);
+}

package/lib/helpers/OrderHelpers.d.ts

@@ -7,6 +7,13 @@ export default class OrderHelpers {
     getSalesChannelUsingTags(tags: string | null | undefined): string | null;
     buildLineItemFromProduct(product: CompleteProduct, currencyCode: string, quantity?: number, taxProps?: RibbnTaxProps, marketplace?: MarketplaceLineSnapshot): ReRobeOrderLineItem;
     toFixedPointPrice(price: number | string): string;
+    static getReturnedLineAmounts(refundLineItem: any, { presentment }?: {
+        presentment?: boolean;
+    }): {
+        quantity: number;
+        net: number;
+        currencyCode: string;
+    };
     getAmountSumByField(array: OrderRefund[] | ReRobeOrderLineItem[], fieldKey: string): number;
     getOrderInfoWithRefundsAndFulfillments(order: CompleteOrder): OrderWithRefundsAndFulfillmentsInfoObj;
     getUpdatedOrderObjWithRefunds(orderObj: CompleteOrder, refundObj: OrderRefund): CompleteOrder;

package/lib/helpers/OrderHelpers.js

@@ -138,6 +138,25 @@ class OrderHelpers {
     toFixedPointPrice(price) {
         return Number(price).toFixed(2);
     }
+    // Units + net amount returned for a stored RefundLineItem — refunded
+    // (fulfilled) + canceled (unfulfilled), since a cancellation of unfulfilled
+    // units still returns money. Net is taken from subtotalRefund + subtotalCanceled
+    // (the presentment variants when `presentment` is set), net of tax. The single
+    // source of truth for "how much of a line was returned" — used by the inline
+    // RETUR section here and the per-partner RETUR receipts (MarketplaceReceiptHelpers).
+    static getReturnedLineAmounts(refundLineItem, { presentment = false } = {}) {
+        const rli = refundLineItem || {};
+        const lineItem = rli.lineItem || {};
+        const quantity = Number(rli.quantityRefund || 0) + Number(rli.quantityCancel || 0);
+        const refundAmt = presentment ? rli.subtotalRefundPresentment : rli.subtotalRefund;
+        const cancelAmt = presentment ? rli.subtotalCanceledPresentment : rli.subtotalCanceled;
+        const net = Number((Number((refundAmt && refundAmt.amount) || 0) + Number((cancelAmt && cancelAmt.amount) || 0)).toFixed(2));
+        const currencyCode = (lineItem.originalTotalPrice && lineItem.originalTotalPrice.currencyCode) ||
+            (refundAmt && refundAmt.currencyCode) ||
+            (cancelAmt && cancelAmt.currencyCode) ||
+            'SEK';
+        return { quantity, net, currencyCode };
+    }
     getAmountSumByField(array, fieldKey) {
         return array.map((item) => { var _a; return Number(((_a = item[fieldKey]) === null || _a === void 0 ? void 0 : _a.amount) || 0); }).reduce((a, b) => a + b, 0);
     }
@@ -742,17 +761,12 @@ class OrderHelpers {
                 fractionDigits: 2,
             }),
             refundLineItems: (order.refunds || []).flatMap((refund) => (refund.refundLineItems || []).map((item) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h;
-                // A stored RefundLineItem is { lineItem, quantityRefund,
-                // quantityCancel, subtotalRefund(Presentment), subtotalCanceled(
-                // Presentment) } — the title/amount live on `lineItem`, not flat on
-                // the item. Returned units = refunded + canceled (a cancellation of
-                // unfulfilled units still returns money). The subtotals are net of
-                // tax (originalUnitPrice basis), so gross them up for the receipt.
+                // Returned units + net come from the canonical helper (refunded +
+                // canceled; subtotals are net of tax, so gross them up here).
                 const lineItem = item.lineItem || {};
-                const quantity = Number(item.quantityRefund || 0) + Number(item.quantityCancel || 0);
-                const net = Number((_d = (_b = (_a = item.subtotalRefundPresentment) === null || _a === void 0 ? void 0 : _a.amount) !== null && _b !== void 0 ? _b : (_c = item.subtotalRefund) === null || _c === void 0 ? void 0 : _c.amount) !== null && _d !== void 0 ? _d : 0) +
-                    Number((_h = (_f = (_e = item.subtotalCanceledPresentment) === null || _e === void 0 ? void 0 : _e.amount) !== null && _f !== void 0 ? _f : (_g = item.subtotalCanceled) === null || _g === void 0 ? void 0 : _g.amount) !== null && _h !== void 0 ? _h : 0);
+                const { quantity, net } = OrderHelpers.getReturnedLineAmounts(item, {
+                    presentment: true,
+                });
                 const taxRate = Number(lineItem.taxRate || 0);
                 const gross = lineItem.isTaxable && taxRate ? net * (1 + taxRate) : net;
                 return {

package/lib/helpers/marketplace/MarketplaceReceiptHelpers.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Per-partner fiscal receipt logic for the managed marketplace: split a
+ * mixed-partner order into per-seller (per-company) groups, resolve which
+ * company's Control Unit signs each receipt (active seller vs channel-partner
+ * backup), and build the per-seller order views + receipt-log descriptors —
+ * including RETUR (refund) receipts.
+ *
+ * Pure + framework-agnostic (no Firebase / Express): the backend order-completion
+ * wiring and the admin receipt simulator both consume these, and the live fiscal
+ * recording maps each seller subset to the CU that records it.
+ */
+export declare function toOre(amount: string | number | null | undefined): number;
+export declare function lineItemGrossOre(lineItem: any): number;
+export declare function lineItemsGrossOre(lineItems: any[]): number;
+export declare function oreToSekString(ore: number): string;
+export declare function resolveLineSellerId(lineItem: any, channelPartnerMerchantId: string): string;
+export type SellerGroup = {
+    sellerMerchantId: string;
+    isChannelPartnerOwn: boolean;
+    lineItems: any[];
+};
+/**
+ * Group an order's line items by the seller (company) responsible for them.
+ * One group per distinct seller, in first-seen order.
+ */
+export declare function groupOrderLineItemsBySeller(order: any): SellerGroup[];
+/**
+ * Build a receipt line for a single refunded item, from a stored refund line
+ * item (`order.refunds[].refundLineItems[]`). Reuses the original line item so
+ * the title, variant label, tax rate, and marketplace attribution are preserved,
+ * and narrows the amount + quantity to the RETURNED portion (refunded + canceled,
+ * via OrderHelpers.getReturnedLineAmounts). The stale display `price` is dropped
+ * so ReceiptBuilder recomputes a consistent, negated amount.
+ */
+export declare function buildRefundLineItemView(refundLineItem: any): any;
+export type RefundSellerGroup = {
+    sellerMerchantId: string;
+    isChannelPartnerOwn: boolean;
+    refundIndex: number;
+    refundLineItems: any[];
+};
+/**
+ * Group an order's returned line items into per-seller groups, one set per refund
+ * EVENT — each refund is its own return transaction, so it yields its own RETUR
+ * receipt. A line is included when it returns any units (refunded OR canceled).
+ */
+export declare function groupRefundsBySeller(order: any): RefundSellerGroup[];
+/**
+ * Number of receipts an order will produce — one per distinct seller group.
+ * Independent of compliance status, which only affects which CU signs each
+ * receipt, not how many there are.
+ */
+export declare function plannedReceiptCount(order: any): number;
+export type FiscalEntity = {
+    fiscalMerchantId: string;
+    organizationNumber: string;
+    name: string;
+    isBackup: boolean;
+};
+/**
+ * Decide which company's fiscal credentials/identity sign a seller group's
+ * receipt: channel partner's own goods -> the CP; active marketplace seller ->
+ * the seller's own company; pending seller -> the CP, flagged as backup.
+ */
+export declare function resolveFiscalEntity({ group, channelPartner, seller, sellerComplianceActive, }: {
+    group: {
+        isChannelPartnerOwn: boolean;
+    };
+    channelPartner: any;
+    seller: any;
+    sellerComplianceActive: boolean;
+}): FiscalEntity;
+/**
+ * Build the order-shaped object that ReceiptBuilder / recordFiscalTransaction
+ * consume for a single seller group: the seller's line-item subset plus the
+ * SELLER's own identity. The receipt header always carries the seller's company
+ * (they are the legal seller of their goods) regardless of which CU signs it.
+ */
+export declare function buildSellerOrderView({ order, group, seller, fiscalEntity, channelPartner, }: {
+    order: any;
+    group: any;
+    seller: any;
+    fiscalEntity: FiscalEntity;
+    channelPartner?: any;
+}): any;
+/**
+ * Reconcile the per-seller split against the order's recorded total: the sum of
+ * every seller group's gross should equal order.totalPrice. A non-zero
+ * difference means money would be lost or double-counted in the split.
+ */
+export declare function reconcileReceiptTotals(order: any): {
+    orderTotalOre: number;
+    sellersTotalOre: number;
+    differenceOre: number;
+    balanced: boolean;
+};
+/**
+ * Compose the full per-partner receipt plan for an order: purchase receipts
+ * (one per seller group) + RETUR receipts (one per refund event per seller),
+ * plus the receipt count and reconciliation. Shared by the simulator (dry-run)
+ * and the live order-completion wiring.
+ */
+export declare function buildPerPartnerReceiptPlan({ order, channelPartner, sellersById, complianceBySeller, }: {
+    order: any;
+    channelPartner: any;
+    sellersById?: Record<string, any>;
+    complianceBySeller?: Record<string, boolean>;
+}): any;
+/**
+ * Map a per-partner receipt plan + fiscal results into the descriptors needed to
+ * write one receiptLog entry per seller. PURE — the live wiring builds the ESC/POS
+ * receiptData from `view` and persists.
+ *
+ * Control-code rule (Skatteverket): a receipt may only carry the kontrollkod of
+ * the Control Unit that actually signed it. Phase B records each seller subset
+ * under the CU responsible for it and passes the per-seller results in via
+ * `fiscalResultsBySeller` (keyed by sellerMerchantId -> {controlCode,
+ * receiptNumber, fiscalRecordId}). `cpFiscalResult` is the legacy/whole-order
+ * channel-partner result, used as a fallback for the CP's own goods.
+ */
+export declare function buildPerPartnerReceiptLogEntries({ plan, cpFiscalResult, fiscalResultsBySeller, }?: {
+    plan?: any;
+    cpFiscalResult?: any;
+    fiscalResultsBySeller?: Record<string, any>;
+}): any[];

package/lib/helpers/marketplace/MarketplaceReceiptHelpers.js

@@ -0,0 +1,351 @@
+"use strict";
+/**
+ * Per-partner fiscal receipt logic for the managed marketplace: split a
+ * mixed-partner order into per-seller (per-company) groups, resolve which
+ * company's Control Unit signs each receipt (active seller vs channel-partner
+ * backup), and build the per-seller order views + receipt-log descriptors —
+ * including RETUR (refund) receipts.
+ *
+ * Pure + framework-agnostic (no Firebase / Express): the backend order-completion
+ * wiring and the admin receipt simulator both consume these, and the live fiscal
+ * recording maps each seller subset to the CU that records it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOre = toOre;
+exports.lineItemGrossOre = lineItemGrossOre;
+exports.lineItemsGrossOre = lineItemsGrossOre;
+exports.oreToSekString = oreToSekString;
+exports.resolveLineSellerId = resolveLineSellerId;
+exports.groupOrderLineItemsBySeller = groupOrderLineItemsBySeller;
+exports.buildRefundLineItemView = buildRefundLineItemView;
+exports.groupRefundsBySeller = groupRefundsBySeller;
+exports.plannedReceiptCount = plannedReceiptCount;
+exports.resolveFiscalEntity = resolveFiscalEntity;
+exports.buildSellerOrderView = buildSellerOrderView;
+exports.reconcileReceiptTotals = reconcileReceiptTotals;
+exports.buildPerPartnerReceiptPlan = buildPerPartnerReceiptPlan;
+exports.buildPerPartnerReceiptLogEntries = buildPerPartnerReceiptLogEntries;
+const OrderHelpers_1 = require("../OrderHelpers");
+// --- Money helpers. Amounts are SEK; öre = round(SEK * 100). ---
+// SEK amount (string like "80.00" or number) -> integer öre.
+function toOre(amount) {
+    if (amount === null || amount === undefined)
+        return 0;
+    const numAmount = typeof amount === 'string' ? parseFloat(amount) : Number(amount);
+    if (Number.isNaN(numAmount))
+        return 0;
+    return Math.round(numAmount * 100);
+}
+// Per-line gross total in öre = net * (1 + taxRate), matching ReceiptBuilder.
+function lineItemGrossOre(lineItem) {
+    const netPrice = (lineItem && lineItem.originalTotalPrice && lineItem.originalTotalPrice.amount) || 0;
+    const taxRate = (lineItem && lineItem.taxRate) || 0;
+    return toOre(Math.abs(Number(netPrice) * (1 + Number(taxRate))));
+}
+// Sum of gross totals (öre) across a set of line items.
+function lineItemsGrossOre(lineItems) {
+    return (lineItems || []).reduce((sum, lineItem) => sum + lineItemGrossOre(lineItem), 0);
+}
+// Integer öre -> SEK string with 2 decimals.
+function oreToSekString(ore) {
+    return (ore / 100).toFixed(2);
+}
+// A line item belongs to a managed seller only when it is explicitly flagged as
+// a marketplace item AND carries the seller's merchant id. Anything else (the
+// channel partner's own goods, or malformed marketplace metadata) is attributed
+// to the channel partner that owns the order.
+function resolveLineSellerId(lineItem, channelPartnerMerchantId) {
+    const marketplace = lineItem && lineItem.marketplace;
+    if (marketplace && marketplace.isMarketplaceItem === true && marketplace.managedMerchantId) {
+        return marketplace.managedMerchantId;
+    }
+    return channelPartnerMerchantId;
+}
+/**
+ * Group an order's line items by the seller (company) responsible for them.
+ * One group per distinct seller, in first-seen order.
+ */
+function groupOrderLineItemsBySeller(order) {
+    const channelPartnerMerchantId = order && order.merchantId;
+    const lineItems = (order && order.lineItems) || [];
+    const groupsBySeller = new Map();
+    lineItems.forEach((lineItem) => {
+        const sellerMerchantId = resolveLineSellerId(lineItem, channelPartnerMerchantId);
+        if (!groupsBySeller.has(sellerMerchantId)) {
+            groupsBySeller.set(sellerMerchantId, {
+                sellerMerchantId,
+                isChannelPartnerOwn: sellerMerchantId === channelPartnerMerchantId,
+                lineItems: [],
+            });
+        }
+        groupsBySeller.get(sellerMerchantId).lineItems.push(lineItem);
+    });
+    return Array.from(groupsBySeller.values());
+}
+/**
+ * Build a receipt line for a single refunded item, from a stored refund line
+ * item (`order.refunds[].refundLineItems[]`). Reuses the original line item so
+ * the title, variant label, tax rate, and marketplace attribution are preserved,
+ * and narrows the amount + quantity to the RETURNED portion (refunded + canceled,
+ * via OrderHelpers.getReturnedLineAmounts). The stale display `price` is dropped
+ * so ReceiptBuilder recomputes a consistent, negated amount.
+ */
+function buildRefundLineItemView(refundLineItem) {
+    const lineItem = (refundLineItem && refundLineItem.lineItem) || {};
+    const { quantity, net, currencyCode } = OrderHelpers_1.default.getReturnedLineAmounts(refundLineItem);
+    const taxRate = Number(lineItem.taxRate || 0);
+    const view = Object.assign(Object.assign({}, lineItem), { quantity, originalTotalPrice: Object.assign(Object.assign({}, lineItem.originalTotalPrice), { amount: net, currencyCode }), 
+        // Prorated to the returned quantity so the RETUR VAT line is correct even on
+        // a partial return (the original line's tax covers the full quantity).
+        taxAmountWithDiscount: {
+            amount: Number((net * taxRate).toFixed(2)),
+            currencyCode,
+        } });
+    // Let ReceiptBuilder recompute the (negated) display price.
+    delete view.price;
+    return view;
+}
+/**
+ * Group an order's returned line items into per-seller groups, one set per refund
+ * EVENT — each refund is its own return transaction, so it yields its own RETUR
+ * receipt. A line is included when it returns any units (refunded OR canceled).
+ */
+function groupRefundsBySeller(order) {
+    const channelPartnerMerchantId = order && order.merchantId;
+    const refunds = (order && order.refunds) || [];
+    const groups = [];
+    refunds.forEach((refund, refundIndex) => {
+        const bySeller = new Map();
+        const refundLineItems = (refund && refund.refundLineItems) || [];
+        refundLineItems.forEach((refundLineItem) => {
+            if (!refundLineItem) {
+                return;
+            }
+            const quantityReturned = Number(refundLineItem.quantityRefund || 0) + Number(refundLineItem.quantityCancel || 0);
+            if (quantityReturned <= 0) {
+                return;
+            }
+            const sellerMerchantId = resolveLineSellerId(refundLineItem.lineItem, channelPartnerMerchantId);
+            if (!bySeller.has(sellerMerchantId)) {
+                bySeller.set(sellerMerchantId, {
+                    sellerMerchantId,
+                    isChannelPartnerOwn: sellerMerchantId === channelPartnerMerchantId,
+                    refundIndex,
+                    refundLineItems: [],
+                });
+            }
+            bySeller.get(sellerMerchantId).refundLineItems.push(refundLineItem);
+        });
+        groups.push(...Array.from(bySeller.values()));
+    });
+    return groups;
+}
+/**
+ * Number of receipts an order will produce — one per distinct seller group.
+ * Independent of compliance status, which only affects which CU signs each
+ * receipt, not how many there are.
+ */
+function plannedReceiptCount(order) {
+    return groupOrderLineItemsBySeller(order).length;
+}
+/**
+ * Decide which company's fiscal credentials/identity sign a seller group's
+ * receipt: channel partner's own goods -> the CP; active marketplace seller ->
+ * the seller's own company; pending seller -> the CP, flagged as backup.
+ */
+function resolveFiscalEntity({ group, channelPartner, seller, sellerComplianceActive, }) {
+    const useSellerOwn = !group.isChannelPartnerOwn && sellerComplianceActive;
+    const entity = useSellerOwn ? seller : channelPartner;
+    return {
+        fiscalMerchantId: entity.documentId,
+        organizationNumber: entity.organizationNumber,
+        name: entity.name,
+        isBackup: !group.isChannelPartnerOwn && !sellerComplianceActive,
+    };
+}
+/**
+ * Build the order-shaped object that ReceiptBuilder / recordFiscalTransaction
+ * consume for a single seller group: the seller's line-item subset plus the
+ * SELLER's own identity. The receipt header always carries the seller's company
+ * (they are the legal seller of their goods) regardless of which CU signs it.
+ */
+function buildSellerOrderView({ order, group, seller, fiscalEntity, channelPartner, }) {
+    const grossOre = lineItemsGrossOre(group.lineItems);
+    const currencyCode = (group.lineItems &&
+        group.lineItems[0] &&
+        group.lineItems[0].originalTotalPrice &&
+        group.lineItems[0].originalTotalPrice.currencyCode) ||
+        (order.totalPrice && order.totalPrice.currencyCode) ||
+        'SEK';
+    const sellerName = (seller && seller.name) || '';
+    const sellerOrganizationNumber = (seller && seller.organizationNumber) || '';
+    // Return policy governing this receipt: the channel partner's own goods follow
+    // the partner's own policy; managed sellers' goods follow the marketplace-wide
+    // managed default, falling back to the seller's own.
+    const returnPolicy = group.isChannelPartnerOwn
+        ? channelPartner && channelPartner.returnPolicy
+        : (channelPartner && channelPartner.managedReturnPolicyDefault) || (seller && seller.returnPolicy);
+    return Object.assign(Object.assign({}, order), { orderId: order.documentId || order.id, orderNumber: order.orderNumber, lineItems: group.lineItems, 
+        // Per-seller brutto from the seller's OWN line items — never the whole
+        // order's totalPrice.
+        totalPrice: { amount: oreToSekString(grossOre), currencyCode }, merchantName: sellerName, organizationNumber: sellerOrganizationNumber, sellerMerchantId: group.sellerMerchantId, sellerDisplayName: sellerName, isFiscalBackup: fiscalEntity.isBackup, returnPolicy });
+}
+/**
+ * Reconcile the per-seller split against the order's recorded total: the sum of
+ * every seller group's gross should equal order.totalPrice. A non-zero
+ * difference means money would be lost or double-counted in the split.
+ */
+function reconcileReceiptTotals(order) {
+    const groups = groupOrderLineItemsBySeller(order);
+    const sellersTotalOre = groups.reduce((sum, group) => sum + lineItemsGrossOre(group.lineItems), 0);
+    const orderTotalOre = toOre(order && order.totalPrice && order.totalPrice.amount);
+    return {
+        orderTotalOre,
+        sellersTotalOre,
+        differenceOre: orderTotalOre - sellersTotalOre,
+        balanced: orderTotalOre === sellersTotalOre,
+    };
+}
+// Resolve the seller identity, compliance status, and signing fiscal entity for
+// a single seller group — shared by purchase and refund receipts.
+function resolveReceiptParties({ group, channelPartner, sellersById, complianceBySeller, }) {
+    const seller = group.isChannelPartnerOwn
+        ? channelPartner
+        : sellersById[group.sellerMerchantId] || {
+            documentId: group.sellerMerchantId,
+            organizationNumber: '',
+            name: '',
+        };
+    const sellerComplianceActive = group.isChannelPartnerOwn
+        ? false
+        : Boolean(complianceBySeller[group.sellerMerchantId]);
+    const fiscalEntity = resolveFiscalEntity({
+        group,
+        channelPartner,
+        seller,
+        sellerComplianceActive,
+    });
+    return { seller, fiscalEntity, sellerDisplayName: seller.name || '' };
+}
+/**
+ * Compose the full per-partner receipt plan for an order: purchase receipts
+ * (one per seller group) + RETUR receipts (one per refund event per seller),
+ * plus the receipt count and reconciliation. Shared by the simulator (dry-run)
+ * and the live order-completion wiring.
+ */
+function buildPerPartnerReceiptPlan({ order, channelPartner, sellersById = {}, complianceBySeller = {}, }) {
+    const groups = groupOrderLineItemsBySeller(order);
+    const receipts = groups.map((group) => {
+        const { seller, fiscalEntity, sellerDisplayName } = resolveReceiptParties({
+            group,
+            channelPartner,
+            sellersById,
+            complianceBySeller,
+        });
+        const view = buildSellerOrderView({
+            order,
+            group,
+            seller,
+            fiscalEntity,
+            channelPartner,
+        });
+        return {
+            sellerMerchantId: group.sellerMerchantId,
+            isChannelPartnerOwn: group.isChannelPartnerOwn,
+            sellerDisplayName,
+            totalOre: lineItemsGrossOre(group.lineItems),
+            fiscalEntity,
+            // Control code only when the seller's OWN Control Unit signs it (their own
+            // goods, or an srv4pos-active partner). Pending partners are backed by the
+            // channel partner's CU.
+            showControlCode: !fiscalEntity.isBackup,
+            view,
+        };
+    });
+    // RETUR receipts for any refunded line items — one per refund event per seller,
+    // mirroring the validated single-merchant refund receipt (RETURKVITTO). Same
+    // fiscal split as purchase: active seller carries its own kontrollkod; pending
+    // is backed by the channel partner's CU.
+    const refundGroups = groupRefundsBySeller(order);
+    const refundReceipts = refundGroups.map((group) => {
+        const { seller, fiscalEntity, sellerDisplayName } = resolveReceiptParties({
+            group,
+            channelPartner,
+            sellersById,
+            complianceBySeller,
+        });
+        const refundLineItemViews = group.refundLineItems.map(buildRefundLineItemView);
+        const lineGroup = {
+            sellerMerchantId: group.sellerMerchantId,
+            isChannelPartnerOwn: group.isChannelPartnerOwn,
+            lineItems: refundLineItemViews,
+        };
+        const view = Object.assign(Object.assign({}, buildSellerOrderView({
+            order,
+            group: lineGroup,
+            seller,
+            fiscalEntity,
+            channelPartner,
+        })), { 
+            // Drives RETURKVITTO / RETUR labels + negative amounts in ReceiptBuilder.
+            isRefund: true });
+        return {
+            kind: 'refund',
+            sellerMerchantId: group.sellerMerchantId,
+            isChannelPartnerOwn: group.isChannelPartnerOwn,
+            sellerDisplayName,
+            totalOre: lineItemsGrossOre(refundLineItemViews),
+            fiscalEntity,
+            showControlCode: !fiscalEntity.isBackup,
+            view,
+        };
+    });
+    return {
+        receiptCount: groups.length,
+        reconciliation: reconcileReceiptTotals(order),
+        receipts,
+        refundReceiptCount: refundReceipts.length,
+        refundReceipts,
+    };
+}
+/**
+ * Map a per-partner receipt plan + fiscal results into the descriptors needed to
+ * write one receiptLog entry per seller. PURE — the live wiring builds the ESC/POS
+ * receiptData from `view` and persists.
+ *
+ * Control-code rule (Skatteverket): a receipt may only carry the kontrollkod of
+ * the Control Unit that actually signed it. Phase B records each seller subset
+ * under the CU responsible for it and passes the per-seller results in via
+ * `fiscalResultsBySeller` (keyed by sellerMerchantId -> {controlCode,
+ * receiptNumber, fiscalRecordId}). `cpFiscalResult` is the legacy/whole-order
+ * channel-partner result, used as a fallback for the CP's own goods.
+ */
+function buildPerPartnerReceiptLogEntries({ plan, cpFiscalResult = null, fiscalResultsBySeller = {}, } = {}) {
+    if (!plan || !Array.isArray(plan.receipts))
+        return [];
+    const cpControlCode = cpFiscalResult && cpFiscalResult.controlCode ? cpFiscalResult.controlCode : null;
+    const bySeller = fiscalResultsBySeller && typeof fiscalResultsBySeller === 'object' ? fiscalResultsBySeller : {};
+    return plan.receipts.map((receipt) => {
+        const isFiscalBackup = Boolean(receipt.fiscalEntity && receipt.fiscalEntity.isBackup);
+        // Prefer the result of the CU that actually recorded THIS seller's subset.
+        const perSeller = bySeller[receipt.sellerMerchantId] || null;
+        let controlCode = perSeller && perSeller.controlCode ? perSeller.controlCode : null;
+        // Fall back to the CP whole-order result only for the CP's own goods.
+        if (!controlCode && receipt.isChannelPartnerOwn) {
+            controlCode = cpControlCode;
+        }
+        const receiptNumber = perSeller && perSeller.receiptNumber !== undefined ? perSeller.receiptNumber : null;
+        return {
+            sellerMerchantId: receipt.sellerMerchantId,
+            isChannelPartnerOwn: receipt.isChannelPartnerOwn,
+            isFiscalBackup,
+            sellerDisplayName: receipt.sellerDisplayName,
+            showControlCode: receipt.showControlCode,
+            controlCode,
+            receiptNumber,
+            fiscalRecordId: perSeller && perSeller.fiscalRecordId ? perSeller.fiscalRecordId : null,
+            totalOre: receipt.totalOre,
+            view: receipt.view,
+        };
+    });
+}

package/lib/index.d.ts

@@ -47,6 +47,8 @@ import * as MarketplaceLedgerHelpers from './helpers/marketplace/MarketplaceLedg
 import * as MarketplaceLegacyAdapters from './helpers/marketplace/MarketplaceLegacyAdapters';
 import * as MarketplaceLineDisplayHelpers from './helpers/marketplace/MarketplaceLineDisplayHelpers';
 import * as MarketplaceOrderHelpers from './helpers/marketplace/MarketplaceOrderHelpers';
+import * as MarketplaceReceiptHelpers from './helpers/marketplace/MarketplaceReceiptHelpers';
+import * as FiscalHelpers from './helpers/FiscalHelpers';
 import TaxHelpers from './helpers/TaxHelpers';
 import PricingHelpers from './helpers/PricingHelpers';
 import ProductSkuHelpers, { DEFAULT_SKU_LENGTH, SKU_ALPHABET } from './helpers/ProductSkuHelpers';
@@ -57,7 +59,7 @@ import ProductInventoryHelpers, { PLACEHOLDER_VARIANT_ID } from './helpers/Produ
 import RetailProductFactory from './factories/Product/RetailProductFactory';
 import { FALLBACK_TAX_COUNTRY_CODE, TAX_CATEGORIES, TAX_CATEGORY_ALIASES, TAX_CATEGORY_BASE_LABELS, TAX_CATEGORY_RATES } from './constants/tax-constants';
 import { ADMIN_SIMPLIFIED_STATES, ADMIN_STATES, PRODUCT_CLASS_VALUES, PRODUCT_STATES, PRODUCT_STATE_LABELS, RETAIL_EDITABLE_PRODUCT_STATES, getProductStateLabel, getRetailEditableProductStateOptions } from './constants/product-constants';
-export { RibbnFile, ProductFromAlgoliaJSONDoc, ProductFromShopifyWebhookJSONDoc, ProductFromShopifyJSClientJSONDoc, ProductFormStateFactory, ProductCollectionFormStateFactory, ProductCollectionHelpers, SellRequestFormStateFactory, PickUpFormStateFactory, AddressFormStateFactory, UserFormStateFactory, UserFromShopifyWebhookJSONDoc, UserFromAuthTemplateMethod, DraftOrderFromMirakl, DraftOrderFromApp, ChatRoomFromNewUserSignUp, KlarnaSessionFactory, Product, ProductStateManager, Order, OrderFromShopifyWebhook, OrderFromShopifyAdminApi, OrderFromShopifyStorefrontApi, OrderFromApp, OrderFromTraderaEmail, OrderFormStateFactory, RefundFormStateFactory, PayoutAccount, PayoutAccountFormState, Merchant, MERCHANT_ACCOUNT_MODES, MERCHANT_ACCOUNT_CLASSES, MERCHANT_RELATIONSHIP_TYPES, MARKETPLACE_SELLER_CAPABILITIES, DEFAULT_MARKETPLACE_SELLER_CAPABILITIES, MerchantFormState, MerchantFormStateFactory, MerchantConfigAutomatedPayouts, MerchantConfigAutomatedPayoutsFormState, ReRobeProductHelpers, MarketplaceProductHelpers, MarketplaceLedgerHelpers, MarketplaceLegacyAdapters, MarketplaceLineDisplayHelpers, MarketplaceOrderHelpers, MARKETPLACE_LISTING_STATUSES, MARKETPLACE_COMMISSION_BASES, MARKETPLACE_RELATIONSHIP_TYPES, MARKETPLACE_FEE_TYPES, MARKETPLACE_FEE_ALLOCATION_BASES, MARKETPLACE_LEDGER_STATUSES, MARKETPLACE_INVENTORY_POLICY_KINDS, MARKETPLACE_SELLER_DEFAULT_COMMISSION, STOCK_STATUSES, DEFAULT_MARKETPLACE_LISTING_STATUS, DEFAULT_MARKETPLACE_COMMISSION_BASIS, DEFAULT_MARKETPLACE_RELATIONSHIP_TYPE, DEFAULT_STRIPE_FEE_ALLOCATION_BASIS, DEFAULT_RIBBN_FEE_ALLOCATION_BASIS, DEFAULT_MARKETPLACE_LEDGER_STATUS, User, AnalyticsHelpers, OrderHelpers, WebhookFormState, MerchantWebPage, ShopifyMerchantAccount, CustomerNotification, TaxHelpers, PricingHelpers, ProductSkuHelpers, ProductVariantHelpers, ReturnPolicyHelpers, ReceiptXmlHelpers, ProductInventoryHelpers, RetailProductFactory, SKU_ALPHABET, DEFAULT_SKU_LENGTH, PLACEHOLDER_VARIANT_ID, TAX_CATEGORIES, TAX_CATEGORY_RATES, TAX_CATEGORY_BASE_LABELS, TAX_CATEGORY_ALIASES, FALLBACK_TAX_COUNTRY_CODE, PRODUCT_STATES, PRODUCT_STATE_LABELS, PRODUCT_CLASS_VALUES, ADMIN_STATES, ADMIN_SIMPLIFIED_STATES, RETAIL_EDITABLE_PRODUCT_STATES, getProductStateLabel, getRetailEditableProductStateOptions, };
+export { RibbnFile, ProductFromAlgoliaJSONDoc, ProductFromShopifyWebhookJSONDoc, ProductFromShopifyJSClientJSONDoc, ProductFormStateFactory, ProductCollectionFormStateFactory, ProductCollectionHelpers, SellRequestFormStateFactory, PickUpFormStateFactory, AddressFormStateFactory, UserFormStateFactory, UserFromShopifyWebhookJSONDoc, UserFromAuthTemplateMethod, DraftOrderFromMirakl, DraftOrderFromApp, ChatRoomFromNewUserSignUp, KlarnaSessionFactory, Product, ProductStateManager, Order, OrderFromShopifyWebhook, OrderFromShopifyAdminApi, OrderFromShopifyStorefrontApi, OrderFromApp, OrderFromTraderaEmail, OrderFormStateFactory, RefundFormStateFactory, PayoutAccount, PayoutAccountFormState, Merchant, MERCHANT_ACCOUNT_MODES, MERCHANT_ACCOUNT_CLASSES, MERCHANT_RELATIONSHIP_TYPES, MARKETPLACE_SELLER_CAPABILITIES, DEFAULT_MARKETPLACE_SELLER_CAPABILITIES, MerchantFormState, MerchantFormStateFactory, MerchantConfigAutomatedPayouts, MerchantConfigAutomatedPayoutsFormState, ReRobeProductHelpers, MarketplaceProductHelpers, MarketplaceLedgerHelpers, MarketplaceLegacyAdapters, MarketplaceLineDisplayHelpers, MarketplaceOrderHelpers, MarketplaceReceiptHelpers, FiscalHelpers, MARKETPLACE_LISTING_STATUSES, MARKETPLACE_COMMISSION_BASES, MARKETPLACE_RELATIONSHIP_TYPES, MARKETPLACE_FEE_TYPES, MARKETPLACE_FEE_ALLOCATION_BASES, MARKETPLACE_LEDGER_STATUSES, MARKETPLACE_INVENTORY_POLICY_KINDS, MARKETPLACE_SELLER_DEFAULT_COMMISSION, STOCK_STATUSES, DEFAULT_MARKETPLACE_LISTING_STATUS, DEFAULT_MARKETPLACE_COMMISSION_BASIS, DEFAULT_MARKETPLACE_RELATIONSHIP_TYPE, DEFAULT_STRIPE_FEE_ALLOCATION_BASIS, DEFAULT_RIBBN_FEE_ALLOCATION_BASIS, DEFAULT_MARKETPLACE_LEDGER_STATUS, User, AnalyticsHelpers, OrderHelpers, WebhookFormState, MerchantWebPage, ShopifyMerchantAccount, CustomerNotification, TaxHelpers, PricingHelpers, ProductSkuHelpers, ProductVariantHelpers, ReturnPolicyHelpers, ReceiptXmlHelpers, ProductInventoryHelpers, RetailProductFactory, SKU_ALPHABET, DEFAULT_SKU_LENGTH, PLACEHOLDER_VARIANT_ID, TAX_CATEGORIES, TAX_CATEGORY_RATES, TAX_CATEGORY_BASE_LABELS, TAX_CATEGORY_ALIASES, FALLBACK_TAX_COUNTRY_CODE, PRODUCT_STATES, PRODUCT_STATE_LABELS, PRODUCT_CLASS_VALUES, ADMIN_STATES, ADMIN_SIMPLIFIED_STATES, RETAIL_EDITABLE_PRODUCT_STATES, getProductStateLabel, getRetailEditableProductStateOptions, };
 export type { PlaceholderVariantInput, PlaceholderVariantInventory, PlaceholderVariantLocation, } from './helpers/ProductInventoryHelpers';
 export type { RetailOwnershipInput, RetailAccountingInput, RetailLocationInput, ClothingDetailsInput, NonClothingDetailsInput, OneOfAKindClothingInput, MultivariantClothingInput, TrackedRetailInput, UntrackedRetailInput, } from './factories/Product/RetailProductFactory';
 export type { TaxCategoryValue } from './constants/tax-constants';

package/lib/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MARKETPLACE_FEE_ALLOCATION_BASES = exports.MARKETPLACE_FEE_TYPES = exports.MARKETPLACE_RELATIONSHIP_TYPES = exports.MARKETPLACE_COMMISSION_BASES = exports.MARKETPLACE_LISTING_STATUSES = exports.MarketplaceOrderHelpers = exports.MarketplaceLineDisplayHelpers = exports.MarketplaceLegacyAdapters = exports.MarketplaceLedgerHelpers = exports.MarketplaceProductHelpers = exports.ReRobeProductHelpers = exports.MerchantConfigAutomatedPayoutsFormState = exports.MerchantConfigAutomatedPayouts = exports.MerchantFormStateFactory = exports.MerchantFormState = exports.DEFAULT_MARKETPLACE_SELLER_CAPABILITIES = exports.MARKETPLACE_SELLER_CAPABILITIES = exports.MERCHANT_RELATIONSHIP_TYPES = exports.MERCHANT_ACCOUNT_CLASSES = exports.MERCHANT_ACCOUNT_MODES = exports.Merchant = exports.PayoutAccountFormState = exports.PayoutAccount = exports.RefundFormStateFactory = exports.OrderFormStateFactory = exports.OrderFromTraderaEmail = exports.OrderFromApp = exports.OrderFromShopifyStorefrontApi = exports.OrderFromShopifyAdminApi = exports.OrderFromShopifyWebhook = exports.Order = exports.ProductStateManager = exports.Product = exports.KlarnaSessionFactory = exports.ChatRoomFromNewUserSignUp = exports.DraftOrderFromApp = exports.DraftOrderFromMirakl = exports.UserFromAuthTemplateMethod = exports.UserFromShopifyWebhookJSONDoc = exports.UserFormStateFactory = exports.AddressFormStateFactory = exports.PickUpFormStateFactory = exports.SellRequestFormStateFactory = exports.ProductCollectionHelpers = exports.ProductCollectionFormStateFactory = exports.ProductFormStateFactory = exports.ProductFromShopifyJSClientJSONDoc = exports.ProductFromShopifyWebhookJSONDoc = exports.ProductFromAlgoliaJSONDoc = exports.RibbnFile = void 0;
-exports.getRetailEditableProductStateOptions = exports.getProductStateLabel = exports.RETAIL_EDITABLE_PRODUCT_STATES = exports.ADMIN_SIMPLIFIED_STATES = exports.ADMIN_STATES = exports.PRODUCT_CLASS_VALUES = exports.PRODUCT_STATE_LABELS = exports.PRODUCT_STATES = exports.FALLBACK_TAX_COUNTRY_CODE = exports.TAX_CATEGORY_ALIASES = exports.TAX_CATEGORY_BASE_LABELS = exports.TAX_CATEGORY_RATES = exports.TAX_CATEGORIES = exports.PLACEHOLDER_VARIANT_ID = exports.DEFAULT_SKU_LENGTH = exports.SKU_ALPHABET = exports.RetailProductFactory = exports.ProductInventoryHelpers = exports.ReceiptXmlHelpers = exports.ReturnPolicyHelpers = exports.ProductVariantHelpers = exports.ProductSkuHelpers = exports.PricingHelpers = exports.TaxHelpers = exports.CustomerNotification = exports.ShopifyMerchantAccount = exports.MerchantWebPage = exports.WebhookFormState = exports.OrderHelpers = exports.AnalyticsHelpers = exports.User = exports.DEFAULT_MARKETPLACE_LEDGER_STATUS = exports.DEFAULT_RIBBN_FEE_ALLOCATION_BASIS = exports.DEFAULT_STRIPE_FEE_ALLOCATION_BASIS = exports.DEFAULT_MARKETPLACE_RELATIONSHIP_TYPE = exports.DEFAULT_MARKETPLACE_COMMISSION_BASIS = exports.DEFAULT_MARKETPLACE_LISTING_STATUS = exports.STOCK_STATUSES = exports.MARKETPLACE_SELLER_DEFAULT_COMMISSION = exports.MARKETPLACE_INVENTORY_POLICY_KINDS = exports.MARKETPLACE_LEDGER_STATUSES = void 0;
+exports.MARKETPLACE_RELATIONSHIP_TYPES = exports.MARKETPLACE_COMMISSION_BASES = exports.MARKETPLACE_LISTING_STATUSES = exports.FiscalHelpers = exports.MarketplaceReceiptHelpers = exports.MarketplaceOrderHelpers = exports.MarketplaceLineDisplayHelpers = exports.MarketplaceLegacyAdapters = exports.MarketplaceLedgerHelpers = exports.MarketplaceProductHelpers = exports.ReRobeProductHelpers = exports.MerchantConfigAutomatedPayoutsFormState = exports.MerchantConfigAutomatedPayouts = exports.MerchantFormStateFactory = exports.MerchantFormState = exports.DEFAULT_MARKETPLACE_SELLER_CAPABILITIES = exports.MARKETPLACE_SELLER_CAPABILITIES = exports.MERCHANT_RELATIONSHIP_TYPES = exports.MERCHANT_ACCOUNT_CLASSES = exports.MERCHANT_ACCOUNT_MODES = exports.Merchant = exports.PayoutAccountFormState = exports.PayoutAccount = exports.RefundFormStateFactory = exports.OrderFormStateFactory = exports.OrderFromTraderaEmail = exports.OrderFromApp = exports.OrderFromShopifyStorefrontApi = exports.OrderFromShopifyAdminApi = exports.OrderFromShopifyWebhook = exports.Order = exports.ProductStateManager = exports.Product = exports.KlarnaSessionFactory = exports.ChatRoomFromNewUserSignUp = exports.DraftOrderFromApp = exports.DraftOrderFromMirakl = exports.UserFromAuthTemplateMethod = exports.UserFromShopifyWebhookJSONDoc = exports.UserFormStateFactory = exports.AddressFormStateFactory = exports.PickUpFormStateFactory = exports.SellRequestFormStateFactory = exports.ProductCollectionHelpers = exports.ProductCollectionFormStateFactory = exports.ProductFormStateFactory = exports.ProductFromShopifyJSClientJSONDoc = exports.ProductFromShopifyWebhookJSONDoc = exports.ProductFromAlgoliaJSONDoc = exports.RibbnFile = void 0;
+exports.getRetailEditableProductStateOptions = exports.getProductStateLabel = exports.RETAIL_EDITABLE_PRODUCT_STATES = exports.ADMIN_SIMPLIFIED_STATES = exports.ADMIN_STATES = exports.PRODUCT_CLASS_VALUES = exports.PRODUCT_STATE_LABELS = exports.PRODUCT_STATES = exports.FALLBACK_TAX_COUNTRY_CODE = exports.TAX_CATEGORY_ALIASES = exports.TAX_CATEGORY_BASE_LABELS = exports.TAX_CATEGORY_RATES = exports.TAX_CATEGORIES = exports.PLACEHOLDER_VARIANT_ID = exports.DEFAULT_SKU_LENGTH = exports.SKU_ALPHABET = exports.RetailProductFactory = exports.ProductInventoryHelpers = exports.ReceiptXmlHelpers = exports.ReturnPolicyHelpers = exports.ProductVariantHelpers = exports.ProductSkuHelpers = exports.PricingHelpers = exports.TaxHelpers = exports.CustomerNotification = exports.ShopifyMerchantAccount = exports.MerchantWebPage = exports.WebhookFormState = exports.OrderHelpers = exports.AnalyticsHelpers = exports.User = exports.DEFAULT_MARKETPLACE_LEDGER_STATUS = exports.DEFAULT_RIBBN_FEE_ALLOCATION_BASIS = exports.DEFAULT_STRIPE_FEE_ALLOCATION_BASIS = exports.DEFAULT_MARKETPLACE_RELATIONSHIP_TYPE = exports.DEFAULT_MARKETPLACE_COMMISSION_BASIS = exports.DEFAULT_MARKETPLACE_LISTING_STATUS = exports.STOCK_STATUSES = exports.MARKETPLACE_SELLER_DEFAULT_COMMISSION = exports.MARKETPLACE_INVENTORY_POLICY_KINDS = exports.MARKETPLACE_LEDGER_STATUSES = exports.MARKETPLACE_FEE_ALLOCATION_BASES = exports.MARKETPLACE_FEE_TYPES = void 0;
 const ProductFromShopifyJSClientJSONDoc_1 = require("./factories/Product/ProductFromShopifyJSClientJSONDoc");
 exports.ProductFromShopifyJSClientJSONDoc = ProductFromShopifyJSClientJSONDoc_1.default;
 const ProductFromAlgoliaJSONDoc_1 = require("./factories/Product/ProductFromAlgoliaJSONDoc");
@@ -118,6 +118,10 @@ const MarketplaceLineDisplayHelpers = require("./helpers/marketplace/Marketplace
 exports.MarketplaceLineDisplayHelpers = MarketplaceLineDisplayHelpers;
 const MarketplaceOrderHelpers = require("./helpers/marketplace/MarketplaceOrderHelpers");
 exports.MarketplaceOrderHelpers = MarketplaceOrderHelpers;
+const MarketplaceReceiptHelpers = require("./helpers/marketplace/MarketplaceReceiptHelpers");
+exports.MarketplaceReceiptHelpers = MarketplaceReceiptHelpers;
+const FiscalHelpers = require("./helpers/FiscalHelpers");
+exports.FiscalHelpers = FiscalHelpers;
 const TaxHelpers_1 = require("./helpers/TaxHelpers");
 exports.TaxHelpers = TaxHelpers_1.default;
 const PricingHelpers_1 = require("./helpers/PricingHelpers");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rerobe-js-orm",
-  "version": "4.9.10",
+  "version": "4.9.11",
   "description": "ReRobe's Javascript ORM Framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",