@autologix-engineering/shared 1.2.263 → 1.2.265

package/src/lib/utilities/src/pick.numbered.invoice.for.booking.js

@@ -0,0 +1,96 @@
+import { InstantInvoiceBodyField, NumberedInvoiceField, RequestField, TaxInvoiceField, TripField, } from '../../models/src/index';
+import { InvoiceType } from '../../enums/src/index';
+/**
+ * Resolve the per-booking NumberedInvoice and the right line-item slice
+ * for a (request, taxInvoice) pair, with CN/DN, full-cancel, and
+ * consolidated cases handled.
+ *
+ *   - CN/DN: source NI from `ti.ReferenceInvoice` (the parent TI), not
+ *     the CN itself. CN entities don't carry their own NumberedInvoice
+ *     for the original sale — only the reversal.
+ *   - Consolidated source: walk `sourceTI.NumberedInvoices` and pick
+ *     the one whose `instantInvBody.tripId` matches the request's
+ *     `Trip.TripId`. Single-child fallback when no tripId match.
+ *   - Non-consolidated source: use `sourceTI.NumberedInvoice` (direct
+ *     ManyToOne FK on the TI entity).
+ *   - Consolidated full-cancel CN/DN: returns the parent NI's
+ *     lineItems (positive originals) and `negateForFullCancel=true`
+ *     so the caller sign-flips. If per-booking NI can't be resolved,
+ *     returns empty lineItems rather than surfacing the consolidated
+ *     whole-invoice total once per booking.
+ *
+ * Mirrors `VendorKnockOffCalculationService.pickNumberedInvoiceAndLineItems`
+ * — kept in shared so BA-payout / booking-report / vendor-KO can all
+ * use one source of truth.
+ */
+export function pickNumberedInvoiceForBooking(request, taxInvoice, debug) {
+    const allNumberedInvoices = request?.[RequestField.NumberedInvoices] || [];
+    const isCNOrDN = !!taxInvoice &&
+        (taxInvoice[TaxInvoiceField.InvoiceType] === InvoiceType.CreditNote ||
+            taxInvoice[TaxInvoiceField.InvoiceType] === InvoiceType.DebitNote);
+    const sourceTI = isCNOrDN
+        ? taxInvoice?.[TaxInvoiceField.ReferenceInvoice]
+        : taxInvoice;
+    const isConsolidatedSource = !!sourceTI?.[TaxInvoiceField.Consolidated];
+    let ni;
+    if (sourceTI) {
+        if (isConsolidatedSource) {
+            const requestTripId = request?.[RequestField.Trip]?.[TripField.TripId] ||
+                request?.[RequestField.TripId];
+            const candidateNIs = sourceTI?.[TaxInvoiceField.NumberedInvoices] || [];
+            if (requestTripId) {
+                ni = candidateNIs.find((n) => n?.[NumberedInvoiceField.InstantInvoiceBody]?.[InstantInvoiceBodyField.TripId] === requestTripId);
+            }
+            if (!ni && candidateNIs.length === 1) {
+                ni = candidateNIs[0];
+            }
+            if (!ni) {
+                debug?.(`[picker] consolidated source TI ${sourceTI?.[TaxInvoiceField.InvoiceId]} ` +
+                    `has no NI matching tripId=${requestTripId} for ` +
+                    `booking ${request?.[RequestField.BookingNumber]} — falling back to last NI on request`);
+            }
+        }
+        else {
+            ni = sourceTI?.[TaxInvoiceField.NumberedInvoice];
+        }
+    }
+    const fellBackToRequestNI = !ni;
+    if (!ni) {
+        ni = allNumberedInvoices[allNumberedInvoices.length - 1];
+    }
+    const isFullCancelCNDN = isCNOrDN && !!taxInvoice?.[TaxInvoiceField.FullCancel];
+    let lineItems;
+    let sourcedFromParentNI = false;
+    if (isFullCancelCNDN && isConsolidatedSource) {
+        if (ni && !fellBackToRequestNI) {
+            lineItems = ni?.[NumberedInvoiceField.LineItems];
+            sourcedFromParentNI = !!lineItems?.length;
+        }
+        if (!lineItems?.length) {
+            debug?.(`[picker] consolidated full-cancel ${taxInvoice?.[TaxInvoiceField.InvoiceType]} ` +
+                `${taxInvoice?.[TaxInvoiceField.InvoiceId]} could not resolve per-booking NI ` +
+                `for booking ${request?.[RequestField.BookingNumber]} — empty lineItems`);
+            lineItems = [];
+            sourcedFromParentNI = false;
+        }
+    }
+    else if (isConsolidatedSource) {
+        if (ni && !fellBackToRequestNI) {
+            lineItems = ni?.[NumberedInvoiceField.LineItems];
+        }
+        if (!lineItems?.length) {
+            debug?.(`[picker] consolidated TI ${taxInvoice?.[TaxInvoiceField.InvoiceId]} ` +
+                `could not resolve per-booking NI for booking ` +
+                `${request?.[RequestField.BookingNumber]} — empty lineItems`);
+            lineItems = [];
+        }
+    }
+    else if (taxInvoice && !isConsolidatedSource) {
+        lineItems = taxInvoice?.[TaxInvoiceField.LineItems];
+    }
+    else if (ni) {
+        lineItems = ni?.[NumberedInvoiceField.LineItems];
+    }
+    return { ni, lineItems, negateForFullCancel: sourcedFromParentNI };
+}
+//# sourceMappingURL=pick.numbered.invoice.for.booking.js.map

package/src/lib/utilities/src/pick.numbered.invoice.for.booking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.numbered.invoice.for.booking.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/pick.numbered.invoice.for.booking.ts"],"names":[],"mappings":"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"}