arca-sdk 1.0.4 → 1.1.1

package/CHANGELOG.md

@@ -4,6 +4,29 @@ Todos los cambios notables de este proyecto se documentan en este archivo.
 
 ---
 
+## [1.1.1] — 2026-03-03
+
+### ✨ Soporte para Opcionales y Resolución General 5616
+
+- **Opcionales en WSFE**: Se agregó soporte completo para enviar el campo `<ar:Opcionales>` en todas las operaciones de emisión de comprobantes (Facturas A/B/C, Notas de Crédito, Notas de Débito, Recibos y Tickets).
+- **Condición IVA Receptor**: Esto permite dar pleno cumplimiento a la reciente RG 5616 de AFIP, que hace obligatorio enviar la Condición frente al IVA del receptor en ciertas Facturas C, enviando el ID `1010` dentro de los opcionales.
+- **Consulta de Comprobantes**: El método `WsfeService.getInvoice()` ahora retorna el array de `optionals` si el comprobante los posee.
+
+---
+
+## [1.1.0] — 2026-02-28
+
+### ✨ Nuevos Comprobantes (Vouchers)
+
+Se expandió la funcionalidad del servicio de facturación (`WsfeService`) para cubrir el espectro completo de comprobantes básicos:
+
+- **Notas de Crédito**: Agregados métodos `issueCreditNoteA()`, `issueCreditNoteB()` y `issueCreditNoteC()`.
+- **Notas de Débito**: Agregados métodos `issueDebitNoteA()`, `issueDebitNoteB()` y `issueDebitNoteC()`.
+- **Recibos**: Agregados métodos `issueReceiptA()`, `issueReceiptB()` y `issueReceiptC()`.
+- **Comprobantes Asociados**: El SDK ahora genera correctamente el nodo `<ar:CbtesAsoc>` de forma obligatoria para emitir NC/ND, asegurando que la operación de contingencia (anulación total o parcial de una factura) respete el estándar del ente recaudador. 
+
+---
+
 ## [1.0.4] — 2026-02-27
 
 ### 🐛 Bugfix — Timezone Handling

package/README.md

@@ -127,9 +127,12 @@ console.log('QR:', result.qrUrl);             // 'https://www.afip.gob.ar/fe/qr/
 |--------|-------------|---------------|
 | `issueSimpleReceipt()` | Ticket C | Monto total, sin detalle. Ideal para POS simple |
 | `issueReceipt()` | Ticket C + items | Con detalle de productos guardado localmente |
-| `issueInvoiceC()` | Factura C | Monotributistas a consumidor final |
+| `issueInvoiceC()` | Factura C | Monotributistas a consumidor final / Empresas |
 | `issueInvoiceB()` | Factura B | Responsable Inscripto a consumidor final / Monotributo |
 | `issueInvoiceA()` | Factura A | Responsable Inscripto a Responsable Inscripto |
+| `issueCreditNoteA/B/C()` | Nota de Crédito | Anulación/Devolución (Requiere asociar la factura original) |
+| `issueDebitNoteA/B/C()` | Nota de Débito | Cobro extra/Penalidad (Requiere asociar la factura original) |
+| `issueReceiptA/B/C()` | Recibo | Comprobante de pago (misma emisión que una factura) |
 
 ### ✅ Consultas disponibles
 
@@ -180,6 +183,46 @@ result.vat?.forEach(v => {
 });
 ```
 
+### Factura C con Parámetros Opcionales (Ej: Condición IVA Receptor - RG 5616)
+
+AFIP requiere mediante la RG 5616 incluir la "Condición frente al IVA del receptor" en ciertas Facturas C, lo cual se envía a través del campo Opcionales.
+
+```typescript
+const result = await wsfe.issueInvoiceC({
+  items: [
+    { description: 'Licencia de software', quantity: 1, unitPrice: 15000 },
+  ],
+  optionals: [
+    {
+      id: 1010, // ID 1010: Condición IVA Receptor
+      value: '2' // 2: Responsable Monotributo
+    }
+  ]
+});
+
+console.log('Factura emitida exitosamente con Opcionales integrados.');
+```
+
+### Nota de Crédito (Anulando factura previa)
+
+```typescript
+import { InvoiceType } from 'arca-sdk';
+
+const result = await wsfe.issueCreditNoteC({
+  items: [
+    { description: 'Anulación de equipo defectuoso', quantity: 1, unitPrice: 45000 },
+  ],
+  // ⚠️ Obligatorio en NC/ND: especificar el comprobante original afectado
+  associatedInvoices: [{
+    type: InvoiceType.FACTURA_C, // La factura que estoy anulando
+    pointOfSale: 4,
+    invoiceNumber: 15302,
+  }],
+});
+
+console.log('CAE de anulación:', result.cae);
+```
+
 ### Consulta de Padrón A13
 
 ```typescript
@@ -270,6 +313,9 @@ try {
 }
 ```
 
+### 🚚 Acerca de los Remitos
+> **¡Atención!** Este SDK implementa nativamente el servicio `WSFE` (Facturación Electrónica). Si tu negocio necesita emitir **Remitos Electrónicos Oficiales** para el traslado físico de mercaderías (Remitos Cárnicos, Azucareros, Harineros, etc.), tené en cuenta que la AFIP exige usar un webservice totalmente distinto llamado `WSREM` o similares. Estos servicios aún no están cubiertos por esta versión del SDK.
+
 ---
 
 ## Compatibilidad
@@ -300,7 +346,7 @@ import { InvoiceType, BillingConcept, TaxIdType } from 'arca-sdk';
 import type { WsaaConfig, WsfeConfig, TaxpayerServiceConfig } from 'arca-sdk';
 
 // Tipos de respuesta
-import type { CAEResponse, InvoiceDetails, PointOfSale, ServiceStatus } from 'arca-sdk';
+import type { CAEResponse, InvoiceDetails, PointOfSale, ServiceStatus, InvoiceOptional } from 'arca-sdk';
 import type { TaxpayerResponse, Taxpayer, Address, Activity, TaxRecord } from 'arca-sdk';
 
 // Items de factura