@vitrina/api 11.37.1 → 11.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -38178,7 +38178,7 @@ interface paths {
38178
38178
  };
38179
38179
  /**
38180
38180
  * Export the deals and their margins (xlsx / csv)
38181
- * @description One row per live nota de venta in the window, with every settlement column: folio, date, status, patente, vehicle, regime, seller, buyer, buyer origin channel, leads, days in stock, published price, discount (amount and %), total paid (with IVA), IVA, net sale price, retained add-ons, net revenue, purchase cost, gross margin, additional costs, commissions, net margin, pass-through add-ons (neutral) and `Completo`. A figure that is not recorded or not computable is an EMPTY cell, never 0.
38181
+ * @description One row per live nota de venta in the window, with every settlement column: folio, date, status, patente, vehicle, regime, seller, buyer, buyer origin channel, leads, days in stock, published price, discount (amount and %), total paid (with IVA), IVA, net sale price, retained add-ons, net revenue, purchase cost, gross margin, additional costs, commissions, Utilidad del negocio, pass-through add-ons (neutral) and `Completo`. A figure that is not recorded or not computable is an EMPTY cell, never 0.
38182
38182
  *
38183
38183
  * Pass `period` (`YYYY-MM`, the Margen screen’s month) OR `from`/`to` (`YYYY-MM-DD`, inclusive, on the dealership’s calendar) — one of the two is required (400 otherwise), never both. `format` is `xlsx` (default) or `csv`. **413** over 2000 deals. Requires `dealership_economics:read`.
38184
38184
  */
@@ -38279,7 +38279,7 @@ interface paths {
38279
38279
  cookie?: never;
38280
38280
  };
38281
38281
  /**
38282
- * The deal settlement (liquidación del negocio) of one unit
38282
+ * The Resumen del negocio of one unit
38283
38283
  * @description Everything about one car’s deal on one read: the published price, the discount (amount and %), the sale price, the purchase or consignment basis, the cost lines grouped by category with who absorbs each (`automotora` / `dueno` / `cliente`), the margin (the platform’s one margin definition, embedded whole with `complete` and `gaps`), the commission of each salesperson, the seller, the buyer and the buyer’s origin channel (the sale note’s lead first, then the buyer’s first conversation, then the contact’s recorded origin), how many people asked about the unit, days in stock (entry → approval) and days to sell (first publication → sale).
38284
38284
  *
38285
38285
  * `state` is `sold` (the newest live nota de venta is approved), `pending_approval` (issued, not yet approved) or `preview` (no live nota de venta: the settlement at the published price, with no discount, add-ons or commissions, flagged by a `preview` gap). A figure that is not recorded is `null`, never 0. Requires `dealership_economics:read`.
@@ -38295,7 +38295,7 @@ interface paths {
38295
38295
  };
38296
38296
  requestBody?: never;
38297
38297
  responses: {
38298
- /** @description The deal settlement */
38298
+ /** @description The Resumen del negocio */
38299
38299
  200: {
38300
38300
  headers: {
38301
38301
  [name: string]: unknown;
@@ -38600,8 +38600,8 @@ interface paths {
38600
38600
  cookie?: never;
38601
38601
  };
38602
38602
  /**
38603
- * Print the deal settlement (PDF)
38604
- * @description The liquidación del negocio as a PDF (`application/pdf`, served `inline`): the workspace’s default `deal_settlement` template — or `template_id` — filled with the deal’s facts, followed by a fixed table of the result walk, the costs by category and who absorbs them, and the commissions. With no live template it prints the standard text. A missing fact prints «no registrado»; nothing is refused. A preview carries a «VISTA PREVIA» banner. `X-Template-Version` names the prose used. Requires `dealership_economics:read`.
38603
+ * Print the Resumen del negocio (PDF)
38604
+ * @description The Resumen del negocio as a PDF (`application/pdf`, served `inline`): the workspace’s default `deal_settlement` template — or `template_id` — filled with the deal’s facts, followed by a fixed table of the result walk, the costs by category and who absorbs them, and the commissions. With no live template it prints the standard text. A missing fact prints «no registrado»; nothing is refused. A preview carries a «VISTA PREVIA» banner. `X-Template-Version` names the prose used. Requires `dealership_economics:read`.
38605
38605
  */
38606
38606
  get: {
38607
38607
  parameters: {
@@ -38616,7 +38616,7 @@ interface paths {
38616
38616
  };
38617
38617
  requestBody?: never;
38618
38618
  responses: {
38619
- /** @description The printable deal settlement */
38619
+ /** @description The printable Resumen del negocio, named `resumen-del-negocio-<folio>.pdf` */
38620
38620
  200: {
38621
38621
  headers: {
38622
38622
  [name: string]: unknown;
@@ -38697,8 +38697,8 @@ interface paths {
38697
38697
  cookie?: never;
38698
38698
  };
38699
38699
  /**
38700
- * Export the deal settlement (xlsx / csv)
38701
- * @description The same settlement as a planilla. `xlsx` (default) carries three sheets — **Resumen** (the result walk and the deal’s facts), **Costos** (by category and party) and **Comisiones** (per salesperson); `csv` carries the Resumen. Requires `dealership_economics:read`.
38700
+ * Export the Resumen del negocio (xlsx / csv)
38701
+ * @description The same Resumen del negocio as a planilla. `xlsx` (default) carries three sheets — **Resumen** (the result walk and the deal’s facts), **Costos** (by category and party) and **Comisiones** (per salesperson); `csv` carries the Resumen. Requires `dealership_economics:read`.
38702
38702
  */
38703
38703
  get: {
38704
38704
  parameters: {
package/dist/index.d.ts CHANGED
@@ -38178,7 +38178,7 @@ interface paths {
38178
38178
  };
38179
38179
  /**
38180
38180
  * Export the deals and their margins (xlsx / csv)
38181
- * @description One row per live nota de venta in the window, with every settlement column: folio, date, status, patente, vehicle, regime, seller, buyer, buyer origin channel, leads, days in stock, published price, discount (amount and %), total paid (with IVA), IVA, net sale price, retained add-ons, net revenue, purchase cost, gross margin, additional costs, commissions, net margin, pass-through add-ons (neutral) and `Completo`. A figure that is not recorded or not computable is an EMPTY cell, never 0.
38181
+ * @description One row per live nota de venta in the window, with every settlement column: folio, date, status, patente, vehicle, regime, seller, buyer, buyer origin channel, leads, days in stock, published price, discount (amount and %), total paid (with IVA), IVA, net sale price, retained add-ons, net revenue, purchase cost, gross margin, additional costs, commissions, Utilidad del negocio, pass-through add-ons (neutral) and `Completo`. A figure that is not recorded or not computable is an EMPTY cell, never 0.
38182
38182
  *
38183
38183
  * Pass `period` (`YYYY-MM`, the Margen screen’s month) OR `from`/`to` (`YYYY-MM-DD`, inclusive, on the dealership’s calendar) — one of the two is required (400 otherwise), never both. `format` is `xlsx` (default) or `csv`. **413** over 2000 deals. Requires `dealership_economics:read`.
38184
38184
  */
@@ -38279,7 +38279,7 @@ interface paths {
38279
38279
  cookie?: never;
38280
38280
  };
38281
38281
  /**
38282
- * The deal settlement (liquidación del negocio) of one unit
38282
+ * The Resumen del negocio of one unit
38283
38283
  * @description Everything about one car’s deal on one read: the published price, the discount (amount and %), the sale price, the purchase or consignment basis, the cost lines grouped by category with who absorbs each (`automotora` / `dueno` / `cliente`), the margin (the platform’s one margin definition, embedded whole with `complete` and `gaps`), the commission of each salesperson, the seller, the buyer and the buyer’s origin channel (the sale note’s lead first, then the buyer’s first conversation, then the contact’s recorded origin), how many people asked about the unit, days in stock (entry → approval) and days to sell (first publication → sale).
38284
38284
  *
38285
38285
  * `state` is `sold` (the newest live nota de venta is approved), `pending_approval` (issued, not yet approved) or `preview` (no live nota de venta: the settlement at the published price, with no discount, add-ons or commissions, flagged by a `preview` gap). A figure that is not recorded is `null`, never 0. Requires `dealership_economics:read`.
@@ -38295,7 +38295,7 @@ interface paths {
38295
38295
  };
38296
38296
  requestBody?: never;
38297
38297
  responses: {
38298
- /** @description The deal settlement */
38298
+ /** @description The Resumen del negocio */
38299
38299
  200: {
38300
38300
  headers: {
38301
38301
  [name: string]: unknown;
@@ -38600,8 +38600,8 @@ interface paths {
38600
38600
  cookie?: never;
38601
38601
  };
38602
38602
  /**
38603
- * Print the deal settlement (PDF)
38604
- * @description The liquidación del negocio as a PDF (`application/pdf`, served `inline`): the workspace’s default `deal_settlement` template — or `template_id` — filled with the deal’s facts, followed by a fixed table of the result walk, the costs by category and who absorbs them, and the commissions. With no live template it prints the standard text. A missing fact prints «no registrado»; nothing is refused. A preview carries a «VISTA PREVIA» banner. `X-Template-Version` names the prose used. Requires `dealership_economics:read`.
38603
+ * Print the Resumen del negocio (PDF)
38604
+ * @description The Resumen del negocio as a PDF (`application/pdf`, served `inline`): the workspace’s default `deal_settlement` template — or `template_id` — filled with the deal’s facts, followed by a fixed table of the result walk, the costs by category and who absorbs them, and the commissions. With no live template it prints the standard text. A missing fact prints «no registrado»; nothing is refused. A preview carries a «VISTA PREVIA» banner. `X-Template-Version` names the prose used. Requires `dealership_economics:read`.
38605
38605
  */
38606
38606
  get: {
38607
38607
  parameters: {
@@ -38616,7 +38616,7 @@ interface paths {
38616
38616
  };
38617
38617
  requestBody?: never;
38618
38618
  responses: {
38619
- /** @description The printable deal settlement */
38619
+ /** @description The printable Resumen del negocio, named `resumen-del-negocio-<folio>.pdf` */
38620
38620
  200: {
38621
38621
  headers: {
38622
38622
  [name: string]: unknown;
@@ -38697,8 +38697,8 @@ interface paths {
38697
38697
  cookie?: never;
38698
38698
  };
38699
38699
  /**
38700
- * Export the deal settlement (xlsx / csv)
38701
- * @description The same settlement as a planilla. `xlsx` (default) carries three sheets — **Resumen** (the result walk and the deal’s facts), **Costos** (by category and party) and **Comisiones** (per salesperson); `csv` carries the Resumen. Requires `dealership_economics:read`.
38700
+ * Export the Resumen del negocio (xlsx / csv)
38701
+ * @description The same Resumen del negocio as a planilla. `xlsx` (default) carries three sheets — **Resumen** (the result walk and the deal’s facts), **Costos** (by category and party) and **Comisiones** (per salesperson); `csv` carries the Resumen. Requires `dealership_economics:read`.
38702
38702
  */
38703
38703
  get: {
38704
38704
  parameters: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vitrina/api",
3
- "version": "11.37.1",
3
+ "version": "11.39.0",
4
4
  "description": "Typed TypeScript SDK for the Vitrina API pública — generated from the committed openapi.public.json (ADR 0106).",
5
5
  "type": "module",
6
6
  "license": "MIT",