keycae-ts 1.1.0 → 1.3.0

package/README.md

@@ -48,6 +48,42 @@ console.log(`CAE: ${invoice.cae}`);
 console.log(`PDF: ${invoice.url_pdf}`);
 ```
 
+### Precios netos (sin IVA)
+
+Por defecto `conceptos[].precio` se envía con IVA incluido. Si tu sistema maneja precios netos, pasá `iva_incluido: false` y KeyCAE calcula el IVA automáticamente:
+
+```typescript
+const invoice = await client.emitInvoice({
+  cuit_emisor: '20254459306',
+  punto_de_venta: 1,
+  tipo_comprobante: 'A',
+  iva_incluido: false, // conceptos[].precio son netos
+  receptor: { tipo_doc: 'CUIT', nro_doc: '30999888776' },
+  conceptos: [{ descripcion: 'Servicio profesional', precio: 1000, alicuota_iva: 21 }]
+}, 'idempotency_key_43');
+// → Neto $1.000 | IVA 21% $210 | Total $1.210
+```
+
+### Datos fiscales del emisor en el PDF
+
+Los datos del emisor que se imprimen en el PDF (razón social, domicilio, Ingresos Brutos, inicio de actividades) se pueden enviar **por comprobante**. Tienen prioridad sobre la configuración de la cuenta y **no requieren cuenta ni login** (funcionan también en sandbox):
+
+```typescript
+const invoice = await client.emitInvoice({
+  cuit_emisor: '20254459306',
+  punto_de_venta: 1,
+  tipo_comprobante: 'B',
+  emisor_razon_social: 'Mi Empresa S.A.',
+  emisor_ingresos_brutos: '901-999999-9',
+  emisor_direccion: 'Av. Corrientes 1500, CABA',
+  emisor_inicio_actividades: '01/03/2021',
+  receptor: { tipo_doc: 'SIN_IDENTIFICAR', nro_doc: '0' },
+  conceptos: [{ descripcion: 'Producto', precio: 1210 }]
+});
+```
+
+Los cuatro campos `emisor_*` son opcionales; enviá sólo los que quieras que aparezcan.
+
 ## Modelos de Conexión
 
 ### Modalidad A: Delegación Directa (Recomendada)

package/dist/index.d.ts

@@ -50,6 +50,13 @@ export interface InvoiceInput {
     tipo_comprobante: 'A' | 'B' | 'C' | 'M' | 'E' | 'NCA' | 'NCB' | 'NCC' | 'NCE' | 'NCM' | 'NDA' | 'NDB' | 'NDC' | 'NDE' | 'NDM' | 'FCE_A' | 'FCE_B' | 'FCE_C' | 'FCE_NDA' | 'FCE_NDB' | 'FCE_NDC' | 'FCE_NCA' | 'FCE_NCB' | 'FCE_NCC';
     receptor: InvoiceReceptor;
     conceptos: InvoiceItem[];
+    /**
+     * Default `true`: los `conceptos[].precio` se envían con IVA incluido (precio final).
+     * Con `false`, los precios se interpretan como netos (sin IVA) y KeyCAE calcula
+     * y adiciona el IVA según la `alicuota_iva` de cada ítem.
+     * Sin efecto en comprobantes sin discriminación de IVA (tipo C / E).
+     */
+    iva_incluido?: boolean;
     tributos?: Tributo[];
     moneda?: string;
     moneda_cotizacion?: number;
@@ -61,6 +68,16 @@ export interface InvoiceInput {
     opcionales?: Opcional[];
     brand_logo_url?: string;
     brand_color?: string;
+    /**
+     * Datos fiscales del emisor a imprimir en el PDF. Override por comprobante:
+     * tienen prioridad sobre la configuración de la cuenta (Personalizar PDF) y
+     * no requieren cuenta ni login, por lo que funcionan también desde sandbox.
+     * Cada campo se resuelve de forma independiente.
+     */
+    emisor_razon_social?: string;
+    emisor_direccion?: string;
+    emisor_ingresos_brutos?: string;
+    emisor_inicio_actividades?: string;
     cbtes_asociados?: {
         tipo: string | number;
         punto_de_venta: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keycae-ts",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Official TypeScript & JavaScript SDK client for KeyCAE.ar impositive compliance API (ARCA)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -65,6 +65,13 @@ export interface InvoiceInput {
     | 'FCE_NCA' | 'FCE_NCB' | 'FCE_NCC';
   receptor: InvoiceReceptor;
   conceptos: InvoiceItem[];
+  /**
+   * Default `true`: los `conceptos[].precio` se envían con IVA incluido (precio final).
+   * Con `false`, los precios se interpretan como netos (sin IVA) y KeyCAE calcula
+   * y adiciona el IVA según la `alicuota_iva` de cada ítem.
+   * Sin efecto en comprobantes sin discriminación de IVA (tipo C / E).
+   */
+  iva_incluido?: boolean;
   tributos?: Tributo[];
   moneda?: string;
   moneda_cotizacion?: number;
@@ -76,6 +83,16 @@ export interface InvoiceInput {
   opcionales?: Opcional[];
   brand_logo_url?: string;
   brand_color?: string;
+  /**
+   * Datos fiscales del emisor a imprimir en el PDF. Override por comprobante:
+   * tienen prioridad sobre la configuración de la cuenta (Personalizar PDF) y
+   * no requieren cuenta ni login, por lo que funcionan también desde sandbox.
+   * Cada campo se resuelve de forma independiente.
+   */
+  emisor_razon_social?: string;
+  emisor_direccion?: string;
+  emisor_ingresos_brutos?: string;
+  emisor_inicio_actividades?: string;
   cbtes_asociados?: {
     tipo: string | number;
     punto_de_venta: number;