@bacano/sdk 1.2.8 → 1.2.9

package/CATALOG_MANAGEMENT.md

@@ -131,6 +131,49 @@ El paquete exporta `CatalogCreateProposal`, `CatalogContentProposal` y
 IDs, convertir atributos informativos en variantes, inventar bodegas ni escoger
 automáticamente la primera web. Preguntar las decisiones de mostrar/ocultar por web.
 
+### Preguntas obligatorias antes de crear el lote
+
+El SDK expone datos y operaciones; **el agente que lo utiliza** debe consultar
+`getContext()` y `getReferences()` y confirmar estas decisiones con la persona
+**antes** de `createBatch` o `sendProposals`. Puede agruparlas en una conversación,
+pero no omitirlas aunque el archivo de origen parezca completo:
+
+`getCatalogImportPreflight(references)` (exportado desde
+`@bacano/sdk/catalog-management`) devuelve las cuatro preguntas, los perfiles
+y precios disponibles, la base tributaria de la empresa y las bodegas únicas
+que pueden preseleccionarse. El agente debe presentar y resolver esas preguntas;
+la función no reemplaza la confirmación humana.
+
+1. **Destinos y publicación:** ¿en cuáles sucursales autorizadas se crearán los
+   productos y en cuáles webs se mostrarán? Confirmar también el estado inicial
+   (borrador o activo) por sucursal. No escoger la primera opción por orden.
+2. **Precios:** ¿solo el precio normal `CLIENT` o todos/alguno de los tipos
+   habilitados (`WHOLESALE`, `WHOLESALE_2`, `SALE`)? ¿De qué columna o regla sale
+   cada importe y difiere entre sucursales? `CLIENT` es el precio principal;
+   no generar precios faltantes ni interpretar un importe vacío como cero.
+3. **IVA:** ¿qué perfil de `taxProfiles` corresponde a los productos y los
+   precios de la fuente incluyen IVA o lo excluyen? Mostrar el valor actual de
+   `company.sales_prices_include_tax_default` para que la persona confirme la
+   base. `price_tax_basis` del borrador debe coincidir con ese valor de empresa;
+   si la fuente usa otra base, acordar explícitamente la conversión antes de
+   normalizar. No inferir tarifa, responsabilidad tributaria ni convertir
+   importes silenciosamente; si hay productos con IVA distinto, pedir una regla
+   por grupo.
+4. **Inventario:** ¿se cargará inventario inicial? Si sí, ¿qué cantidad para cada
+   variante, sucursal y bodega? El cero explícito es válido; una celda vacía
+   queda pendiente. Si una sucursal tiene **una sola bodega vinculada**, usarla
+   como selección predeterminada y confirmarla. Si tiene varias, preguntar cuál
+   o cuáles corresponden a cada cantidad, sin escoger la primera ni repetir la
+   misma cantidad en todas. Si no hay bodegas vinculadas, pedir configuración
+   en Bacano antes de continuar.
+
+Resumir las respuestas y pedir confirmación antes del primer envío. Si una
+respuesta esencial falta, detener esa parte y conservarla como pendiente de
+revisión; nunca rellenarla por conjetura. Los precios son por sucursal y tipo;
+el inventario es por sucursal, bodega y variante. `getReferences()` puede
+cambiar, así que volver a consultarlo si la persona configura nuevos destinos,
+bodegas, perfiles o tipos de precio.
+
 ```ts
 // Guardar este identificador y el nombre ANTES de hacer la petición.
 const batchRequest = {

package/catalog-import-preflight.d.ts

@@ -0,0 +1,19 @@
+import type { CatalogReferences } from "./catalog-management-types";
+export interface CatalogImportPreflightQuestion {
+    id: "destinations" | "prices" | "tax" | "inventory";
+    prompt: string;
+    options?: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+/** Questions for the agent to resolve with a person before creating a batch. */
+export declare function getCatalogImportPreflight(references: CatalogReferences): {
+    questions: CatalogImportPreflightQuestion[];
+    taxBasis: "included" | "excluded";
+    soleWarehouseDefaults: Array<{
+        chainId: string;
+        warehouseId: string;
+        warehouseName: string;
+    }>;
+};

package/catalog-management.cjs

@@ -21,9 +21,57 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var catalog_management_exports = {};
 __export(catalog_management_exports, {
   CatalogManagementError: () => CatalogManagementError,
-  createCatalogManagementClient: () => createCatalogManagementClient
+  createCatalogManagementClient: () => createCatalogManagementClient,
+  getCatalogImportPreflight: () => getCatalogImportPreflight
 });
 module.exports = __toCommonJS(catalog_management_exports);
+
+// libs/sdk/src/catalog-import-preflight.ts
+function getCatalogImportPreflight(references) {
+  const taxBasis = references.company.sales_prices_include_tax_default ? "included" : "excluded";
+  return {
+    taxBasis,
+    soleWarehouseDefaults: references.branches.flatMap((branch) => {
+      const link = branch.chains_warehouses[0];
+      return branch.chains_warehouses.length === 1 && link ? [
+        {
+          chainId: branch.id,
+          warehouseId: link.warehouse.id,
+          warehouseName: link.warehouse.name
+        }
+      ] : [];
+    }),
+    questions: [
+      {
+        id: "destinations",
+        prompt: "\xBFEn qu\xE9 sucursales se crear\xE1n los productos, en qu\xE9 webs se mostrar\xE1n y con qu\xE9 estado inicial?",
+        options: references.branches.map((branch) => ({
+          id: branch.id,
+          name: branch.name
+        }))
+      },
+      {
+        id: "prices",
+        prompt: "\xBFUsaremos solo el precio normal o tambi\xE9n otros precios habilitados? \xBFQu\xE9 importe corresponde a cada sucursal?",
+        options: references.priceTypes.filter((type) => type.is_enabled).map((type) => ({ id: type.price_type, name: type.price_type }))
+      },
+      {
+        id: "tax",
+        prompt: `\xBFQu\xE9 perfil de IVA corresponde? \xBFLos precios de origen incluyen o excluyen IVA? La empresa espera precios con IVA ${taxBasis === "included" ? "incluido" : "excluido"}.`,
+        options: references.taxProfiles.map((profile) => ({
+          id: profile.code,
+          name: `${profile.name} (${profile.rate} %)`
+        }))
+      },
+      {
+        id: "inventory",
+        prompt: "\xBFCargaremos inventario inicial? Si s\xED, \xBFqu\xE9 cantidad va en cada variante, sucursal y bodega? Confirma la bodega \xFAnica o elige entre las disponibles."
+      }
+    ]
+  };
+}
+
+// libs/sdk/src/catalog-management.ts
 var CatalogManagementError = class extends Error {
   constructor(code, status, message, details) {
     super(message);

package/catalog-management.d.ts

@@ -1,5 +1,6 @@
 import type { CatalogManagementConfig, CatalogManagementContext, CatalogProductPage, CatalogReferences, CatalogTaxonomy } from "./catalog-management-types";
 export * from "./catalog-draft-types";
+export * from "./catalog-import-preflight";
 export * from "./catalog-management-types";
 import type { CatalogDraftBatch, CatalogDraftBatchPage, CatalogDraftChunkResult, CatalogDraftImageResult, CatalogDraftResult, CatalogDraftWrite } from "./catalog-draft-types";
 export declare class CatalogManagementError extends Error {

package/catalog-management.js

@@ -1,3 +1,48 @@
+// libs/sdk/src/catalog-import-preflight.ts
+function getCatalogImportPreflight(references) {
+  const taxBasis = references.company.sales_prices_include_tax_default ? "included" : "excluded";
+  return {
+    taxBasis,
+    soleWarehouseDefaults: references.branches.flatMap((branch) => {
+      const link = branch.chains_warehouses[0];
+      return branch.chains_warehouses.length === 1 && link ? [
+        {
+          chainId: branch.id,
+          warehouseId: link.warehouse.id,
+          warehouseName: link.warehouse.name
+        }
+      ] : [];
+    }),
+    questions: [
+      {
+        id: "destinations",
+        prompt: "\xBFEn qu\xE9 sucursales se crear\xE1n los productos, en qu\xE9 webs se mostrar\xE1n y con qu\xE9 estado inicial?",
+        options: references.branches.map((branch) => ({
+          id: branch.id,
+          name: branch.name
+        }))
+      },
+      {
+        id: "prices",
+        prompt: "\xBFUsaremos solo el precio normal o tambi\xE9n otros precios habilitados? \xBFQu\xE9 importe corresponde a cada sucursal?",
+        options: references.priceTypes.filter((type) => type.is_enabled).map((type) => ({ id: type.price_type, name: type.price_type }))
+      },
+      {
+        id: "tax",
+        prompt: `\xBFQu\xE9 perfil de IVA corresponde? \xBFLos precios de origen incluyen o excluyen IVA? La empresa espera precios con IVA ${taxBasis === "included" ? "incluido" : "excluido"}.`,
+        options: references.taxProfiles.map((profile) => ({
+          id: profile.code,
+          name: `${profile.name} (${profile.rate} %)`
+        }))
+      },
+      {
+        id: "inventory",
+        prompt: "\xBFCargaremos inventario inicial? Si s\xED, \xBFqu\xE9 cantidad va en cada variante, sucursal y bodega? Confirma la bodega \xFAnica o elige entre las disponibles."
+      }
+    ]
+  };
+}
+
 // libs/sdk/src/catalog-management.ts
 var CatalogManagementError = class extends Error {
   constructor(code, status, message, details) {
@@ -100,5 +145,6 @@ function createCatalogManagementClient(config) {
 }
 export {
   CatalogManagementError,
-  createCatalogManagementClient
+  createCatalogManagementClient,
+  getCatalogImportPreflight
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacano/sdk",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "description": "TypeScript SDK for building websites on the Bacano ERP",
   "main": "./index.cjs",
   "module": "./index.js",