@opencxh/domain 1.301.0 → 1.302.0

package/dist/entities/purchase/feed.d.ts

@@ -6,7 +6,7 @@ import { OfferAvailability, SupplierOffer } from './types';
  * turned into a product or an offer by itself.
  */
 /** The columns a feed can fill. `vendorSku` or `gtin` is the key; the rest is optional. */
-export type FeedColumn = "vendorSku" | "gtin" | "description" | "cost" | "list" | "currency" | "stock" | "leadDays";
+export type FeedColumn = "vendorSku" | "gtin" | "description" | "brand" | "group" | "cost" | "list" | "currency" | "stock" | "leadDays";
 export declare const FEED_COLUMNS: readonly FeedColumn[];
 /** Per column, the header it is read from. Set once (the AI proposes, a person approves). */
 export type FeedMapping = Partial<Record<FeedColumn, string>>;
@@ -52,6 +52,9 @@ export interface FeedRow {
     vendorSku?: string;
     gtin?: string;
     description?: string;
+    /** Brand and product group: only to filter the unknown lines before they are imported. */
+    brand?: string;
+    group?: string;
     costCents?: Cents;
     listCents?: Cents;
     currency?: string;
@@ -108,6 +111,8 @@ export interface FeedUnmatched {
     vendorSku?: string;
     gtin?: string;
     description?: string;
+    brand?: string;
+    group?: string;
     costCents?: Cents;
     /** An article we have, with no offer from this supplier yet: "make an offer" is one click. */
     productId?: string;
@@ -126,7 +131,40 @@ export interface FeedOutcome {
  */
 export declare function feedOutcome(matches: readonly FeedMatch[], offers: readonly SupplierOffer[], now: number, jumpPercent?: number): FeedOutcome;
 /**
- * A first mapping from the header alone: an exact word, then a header that starts with one.
+ * A first mapping from the header alone: every exact word first, then a header that starts with
+ * one — so "Productgroep" is the group before "product" claims it as the description.
  * No AI, no guessing beyond the list — what it leaves open, the AI or a person fills.
  */
 export declare function guessFeedMapping(header: readonly string[]): FeedMapping;
+/**
+ * How lines from a feed become articles: the choices made once for every new article in an import.
+ * The name comes from the description, the EAN and the price from the line.
+ */
+export interface FeedImportDefaults {
+    categoryKey?: string;
+    unitKey?: string;
+    kind: "goods" | "service";
+    /** Our article number: none, or the supplier's. */
+    sku: "none" | "vendor";
+    sellable: boolean;
+}
+/** One line to import; `productId` links it to an article we have instead of making one. */
+export interface FeedImportItem {
+    line: number;
+    productId?: string;
+}
+/** An import from a run's unknown lines, as a screen shows it. */
+export interface FeedImportStatus {
+    state: "running" | "done";
+    total: number;
+    products: number;
+    offers: number;
+    /** A line not imported, with the reason's code (`sku_taken`, `feed_import_no_price`, …). */
+    skipped: {
+        line: number;
+        code: string;
+        text: string;
+    }[];
+    startedAt: number;
+    finishedAt?: number;
+}