sinfactura-types 1.10.430 → 1.10.432

package/dist/cjs/purchaseReceipt.js

@@ -29,6 +29,14 @@ exports.PURCHASE_RECEIPT_MAX_LINES_DEPOSITOS = 32;
  *   or `cancelled`; only `sent` and `partially_received` accept a delivery.
  * - `PURCHASE_ORDER_VERSION_CONFLICT` · 409 — the order changed between the read
  *   and the commit. Nothing moved; re-read and retry with the SAME `receiptKey`.
+ * - `PURCHASE_RECEIPT_TOO_MANY_LINES` · 400 — a store booking stock per depósito
+ *   takes at most `PURCHASE_RECEIPT_MAX_LINES_DEPOSITOS` lines; `data.max` is it.
+ * - `WAREHOUSE_NOT_FOUND` · 404 / `WAREHOUSE_INACTIVE` · 409 — the named
+ *   `warehouseId` (echoed in `data.warehouseId`) cannot receive stock.
+ * - `NO_PRIMARY_WAREHOUSE` · 409 — no depósito named and the store has no
+ *   active primary one.
+ * - `INVENTORY_LEVEL_VERSION_CONFLICT` · 409 — a depósito level changed between
+ *   the read and the commit. Nothing moved; retry.
  * - `STOCK_INCOME_RACED` · 409 — the ledger-key retry budget ran out. Nothing moved.
  * - `PRODUCT_NOT_FOUND` · 404 — a line's product no longer exists. Nothing moved.
  * - `PURCHASE_RECEIPT_NOT_FOUND` · 404 — `mode=receipt` addressed nothing.
@@ -47,6 +55,11 @@ exports.PURCHASE_RECEIPT_ERROR_CODES = [
     'PURCHASE_ORDER_LINE_NOT_FOUND',
     'PURCHASE_ORDER_ILLEGAL_TRANSITION',
     'PURCHASE_ORDER_VERSION_CONFLICT',
+    'PURCHASE_RECEIPT_TOO_MANY_LINES',
+    'WAREHOUSE_NOT_FOUND',
+    'WAREHOUSE_INACTIVE',
+    'NO_PRIMARY_WAREHOUSE',
+    'INVENTORY_LEVEL_VERSION_CONFLICT',
     'STOCK_INCOME_RACED',
     'PRODUCT_NOT_FOUND',
     'PURCHASE_RECEIPT_NOT_FOUND',

package/dist/cjs/supplier.js

@@ -66,9 +66,10 @@ exports.MAX_SUPPLIER_PAYMENT_APPLICATIONS = 25;
  * `mode: 'invoice'`).
  *
  * - `PAYMENT_OVERAPPLIED` · 400 — Σ `appliedTo` exceeds the movement's amount.
- * - `PAYMENT_APPLICATION_INVALID` · 400 — `appliedTo` on a debit, a bill of
- *   another supplier, a credit note, a bill with no total, or a bill in another
- *   currency. `data.invoiceId` names the bill when one is at fault.
+ * - `PAYMENT_APPLICATION_INVALID` · 400 — a bill of another supplier, a credit
+ *   note, a bill with no total, or a bill in another currency. `data.invoiceId`
+ *   names the bill. (`appliedTo` on a debit is `VALIDATION_FAILED`, refused by
+ *   the body schema before any read.)
  * - `SUPPLIER_INVOICE_NOT_FOUND` · 404 — `data.invoiceId` names it.
  * - `INVOICE_OVERPAID` · 409 — the slice exceeds what is still open on
  *   `data.invoiceId`; `data.remaining` is what is.

package/dist/product.d.ts

@@ -329,6 +329,12 @@ declare global {
             supplierName?: string;
             quantity: number;
             cost: number;
+            /**
+             * Currency `cost` is in, on a row a multi-line purchase-order receipt
+             * wrote — the ORDER's currency, which may not be the product's. Absent
+             * on every other row; see `StockIncome.currency`.
+             */
+            currency?: string;
         }[];
         /**
          * ⚠️ **Two shapes, chosen by `statsWindow`, and this field declares only

package/dist/purchaseReceipt.d.ts

@@ -78,8 +78,9 @@ declare global {
          * The depósito the whole delivery was received into. Every `INCOME#` row
          * the receipt wrote carries the same value.
          *
-         * ⚠️ OPTIONAL PERMANENTLY. Nothing writes it yet; absent means a receipt
-         * that moved only the store total.
+         * ⚠️ OPTIONAL PERMANENTLY. Written by `mode: 'receive'` on a store running
+         * `stockAuthority: 'depositos'`; absent means a receipt that moved only the
+         * store total.
          */
         warehouseId?: string;
         /** Operator note. ⚠️ Never personal data — this row is not scrubbed and has no TTL. */
@@ -100,6 +101,14 @@ declare global {
  *   or `cancelled`; only `sent` and `partially_received` accept a delivery.
  * - `PURCHASE_ORDER_VERSION_CONFLICT` · 409 — the order changed between the read
  *   and the commit. Nothing moved; re-read and retry with the SAME `receiptKey`.
+ * - `PURCHASE_RECEIPT_TOO_MANY_LINES` · 400 — a store booking stock per depósito
+ *   takes at most `PURCHASE_RECEIPT_MAX_LINES_DEPOSITOS` lines; `data.max` is it.
+ * - `WAREHOUSE_NOT_FOUND` · 404 / `WAREHOUSE_INACTIVE` · 409 — the named
+ *   `warehouseId` (echoed in `data.warehouseId`) cannot receive stock.
+ * - `NO_PRIMARY_WAREHOUSE` · 409 — no depósito named and the store has no
+ *   active primary one.
+ * - `INVENTORY_LEVEL_VERSION_CONFLICT` · 409 — a depósito level changed between
+ *   the read and the commit. Nothing moved; retry.
  * - `STOCK_INCOME_RACED` · 409 — the ledger-key retry budget ran out. Nothing moved.
  * - `PRODUCT_NOT_FOUND` · 404 — a line's product no longer exists. Nothing moved.
  * - `PURCHASE_RECEIPT_NOT_FOUND` · 404 — `mode=receipt` addressed nothing.
@@ -111,6 +120,6 @@ declare global {
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
  * as well.
  */
-export declare const PURCHASE_RECEIPT_ERROR_CODES: readonly ["VALIDATION_FAILED", "ADMIN_REQUIRED", "PURCHASE_ORDER_NOT_FOUND", "PURCHASE_ORDER_LINE_NOT_FOUND", "PURCHASE_ORDER_ILLEGAL_TRANSITION", "PURCHASE_ORDER_VERSION_CONFLICT", "STOCK_INCOME_RACED", "PRODUCT_NOT_FOUND", "PURCHASE_RECEIPT_NOT_FOUND", "INVALID_CURSOR"];
+export declare const PURCHASE_RECEIPT_ERROR_CODES: readonly ["VALIDATION_FAILED", "ADMIN_REQUIRED", "PURCHASE_ORDER_NOT_FOUND", "PURCHASE_ORDER_LINE_NOT_FOUND", "PURCHASE_ORDER_ILLEGAL_TRANSITION", "PURCHASE_ORDER_VERSION_CONFLICT", "PURCHASE_RECEIPT_TOO_MANY_LINES", "WAREHOUSE_NOT_FOUND", "WAREHOUSE_INACTIVE", "NO_PRIMARY_WAREHOUSE", "INVENTORY_LEVEL_VERSION_CONFLICT", "STOCK_INCOME_RACED", "PRODUCT_NOT_FOUND", "PURCHASE_RECEIPT_NOT_FOUND", "INVALID_CURSOR"];
 export type PurchaseReceiptErrorCode = (typeof PURCHASE_RECEIPT_ERROR_CODES)[number];
 export {};

package/dist/purchaseReceipt.js

@@ -26,6 +26,14 @@ export const PURCHASE_RECEIPT_MAX_LINES_DEPOSITOS = 32;
  *   or `cancelled`; only `sent` and `partially_received` accept a delivery.
  * - `PURCHASE_ORDER_VERSION_CONFLICT` · 409 — the order changed between the read
  *   and the commit. Nothing moved; re-read and retry with the SAME `receiptKey`.
+ * - `PURCHASE_RECEIPT_TOO_MANY_LINES` · 400 — a store booking stock per depósito
+ *   takes at most `PURCHASE_RECEIPT_MAX_LINES_DEPOSITOS` lines; `data.max` is it.
+ * - `WAREHOUSE_NOT_FOUND` · 404 / `WAREHOUSE_INACTIVE` · 409 — the named
+ *   `warehouseId` (echoed in `data.warehouseId`) cannot receive stock.
+ * - `NO_PRIMARY_WAREHOUSE` · 409 — no depósito named and the store has no
+ *   active primary one.
+ * - `INVENTORY_LEVEL_VERSION_CONFLICT` · 409 — a depósito level changed between
+ *   the read and the commit. Nothing moved; retry.
  * - `STOCK_INCOME_RACED` · 409 — the ledger-key retry budget ran out. Nothing moved.
  * - `PRODUCT_NOT_FOUND` · 404 — a line's product no longer exists. Nothing moved.
  * - `PURCHASE_RECEIPT_NOT_FOUND` · 404 — `mode=receipt` addressed nothing.
@@ -44,6 +52,11 @@ export const PURCHASE_RECEIPT_ERROR_CODES = [
     'PURCHASE_ORDER_LINE_NOT_FOUND',
     'PURCHASE_ORDER_ILLEGAL_TRANSITION',
     'PURCHASE_ORDER_VERSION_CONFLICT',
+    'PURCHASE_RECEIPT_TOO_MANY_LINES',
+    'WAREHOUSE_NOT_FOUND',
+    'WAREHOUSE_INACTIVE',
+    'NO_PRIMARY_WAREHOUSE',
+    'INVENTORY_LEVEL_VERSION_CONFLICT',
     'STOCK_INCOME_RACED',
     'PRODUCT_NOT_FOUND',
     'PURCHASE_RECEIPT_NOT_FOUND',

package/dist/report.d.ts

@@ -811,6 +811,19 @@ declare global {
          * have dropped the very day the denomination moved.
          */
         mixedCurrency: boolean;
+        /**
+         * `true` when `currency` is not the peso — and then every order denominated
+         * in anything else is valued at TODAY's display rate, not the one of its day.
+         *
+         * An order stamps its own rate INTO THE PESO (`currencyValue`), never into
+         * the display currency, so converting it here is `currencyValue ÷ the
+         * store's CURRENT display rate`. On a peso display that divisor is 1 and the
+         * figure is exactly historical; on any other display a cross-currency day
+         * moves when the store edits that rate. Nothing on the order records the
+         * display rate of the sale day, so the figure cannot be pinned — only
+         * disclosed. Store-level, so it is emitted on a truncated response too.
+         */
+        liveDisplayRate: boolean;
         /** Ascending by `date`, sparse. Absent when the read truncated. */
         points?: ReportCogsSeriesPoint[];
         /** Absent when the read truncated. */

package/dist/supplier.d.ts

@@ -198,7 +198,10 @@ declare global {
         paidAmount?: number;
         /**
          * SERVER-OWNED, derived from `paidAmount` against `total`: `paid` at exactly
-         * `paidAmount == total` (2 dp). Stamped `open` on every new non-NC bill.
+         * `paidAmount == total` (2 dp). Stamped `open` on every new non-NC bill —
+         * the operator's and a peso one the received-FCE poller discovers (a
+         * foreign-currency one only when an edit first gives it a currency) — and
+         * re-derived when an edit moves `type` across NC (dropped / stamped).
          * ⚠️ Absent on bills written before payables existed: they are UNTRACKED,
          * not open, and the aging report leaves them out until a payment is
          * applied to them.
@@ -215,6 +218,16 @@ declare global {
          * that order had at that moment.
          */
         receiptIds?: string[];
+        /**
+         * SERVER-OWNED. `true` when the bill named no receipts, so `receiptIds` is
+         * the server's list and the match counts every unit the order received —
+         * its lines' `receivedQuantity`, including units booked through the
+         * single-line `POST /products` stock entry, which writes no receipt. An edit
+         * that moves none of the match's inputs keeps the verdict and these ids; one
+         * that moves an input and names none re-reads the order. Absent when the
+         * bill named its receipts, and on rows written before this existed.
+         */
+        receiptIdsFromOrder?: boolean;
         /**
          * Header-level three-way match. SERVER-OWNED: every write recomputes it and
          * a value in the body is ignored. Absent on rows written before the match
@@ -577,9 +590,10 @@ export declare const MAX_SUPPLIER_PAYMENT_APPLICATIONS = 25;
  * `mode: 'invoice'`).
  *
  * - `PAYMENT_OVERAPPLIED` · 400 — Σ `appliedTo` exceeds the movement's amount.
- * - `PAYMENT_APPLICATION_INVALID` · 400 — `appliedTo` on a debit, a bill of
- *   another supplier, a credit note, a bill with no total, or a bill in another
- *   currency. `data.invoiceId` names the bill when one is at fault.
+ * - `PAYMENT_APPLICATION_INVALID` · 400 — a bill of another supplier, a credit
+ *   note, a bill with no total, or a bill in another currency. `data.invoiceId`
+ *   names the bill. (`appliedTo` on a debit is `VALIDATION_FAILED`, refused by
+ *   the body schema before any read.)
  * - `SUPPLIER_INVOICE_NOT_FOUND` · 404 — `data.invoiceId` names it.
  * - `INVOICE_OVERPAID` · 409 — the slice exceeds what is still open on
  *   `data.invoiceId`; `data.remaining` is what is.

package/dist/supplier.js

@@ -63,9 +63,10 @@ export const MAX_SUPPLIER_PAYMENT_APPLICATIONS = 25;
  * `mode: 'invoice'`).
  *
  * - `PAYMENT_OVERAPPLIED` · 400 — Σ `appliedTo` exceeds the movement's amount.
- * - `PAYMENT_APPLICATION_INVALID` · 400 — `appliedTo` on a debit, a bill of
- *   another supplier, a credit note, a bill with no total, or a bill in another
- *   currency. `data.invoiceId` names the bill when one is at fault.
+ * - `PAYMENT_APPLICATION_INVALID` · 400 — a bill of another supplier, a credit
+ *   note, a bill with no total, or a bill in another currency. `data.invoiceId`
+ *   names the bill. (`appliedTo` on a debit is `VALIDATION_FAILED`, refused by
+ *   the body schema before any read.)
  * - `SUPPLIER_INVOICE_NOT_FOUND` · 404 — `data.invoiceId` names it.
  * - `INVOICE_OVERPAID` · 409 — the slice exceeds what is still open on
  *   `data.invoiceId`; `data.remaining` is what is.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sinfactura-types",
-	"version": "1.10.430",
+	"version": "1.10.432",
 	"description": "Shared wire and entity contracts for the SINFACTURA platform.",
 	"type": "module",
 	"main": "dist/index.js",