intifact 1.0.0

package/README.md

@@ -0,0 +1,148 @@
+# intifact
+
+SDK TypeScript para la API de Facturación Electrónica SUNAT de [Intifact](https://intifact.com).
+
+Emite facturas, boletas, notas de crédito/débito y guías de remisión electrónicas directamente desde tu aplicación.
+
+## Instalación
+
+```bash
+npm install intifact
+```
+
+## Uso rápido
+
+```typescript
+import { Intifact } from "intifact";
+
+const client = new Intifact({
+  apiKey: "tu-api-key",
+});
+
+// Emitir una factura
+const { data, error } = await client.sendInvoice({
+  tipoDoc: "01",
+  serie: "F001",
+  correlativo: "123",
+  fechaEmision: "2025-01-15T00:00:00-05:00",
+  client: {
+    tipoDoc: "6",
+    numDoc: "20000000001",
+    rznSocial: "Empresa SAC",
+  },
+  company: {
+    ruc: "20000000001",
+  },
+  details: [
+    {
+      codProducto: "P001",
+      unidad: "NIU",
+      cantidad: 2,
+      descripcion: "Producto de ejemplo",
+      mtoValorUnitario: 100,
+    },
+  ],
+});
+
+if (error) {
+  console.error("Error:", error);
+} else {
+  console.log("Factura enviada:", data);
+}
+```
+
+## Métodos disponibles
+
+### Facturas y Boletas
+
+| Método | Descripción |
+|--------|-------------|
+| `sendInvoice(body)` | Enviar factura (01) o boleta (03) a SUNAT |
+| `getInvoicePdf(id)` | Obtener PDF del comprobante |
+| `getInvoiceXml(id)` | Obtener XML firmado |
+| `getInvoiceCdr(id)` | Obtener CDR de SUNAT |
+| `cancelInvoice(body)` | Comunicar baja de factura |
+| `cancelBoleta(body)` | Comunicar baja de boleta |
+
+### Notas de Crédito / Débito
+
+| Método | Descripción |
+|--------|-------------|
+| `sendNote(body)` | Enviar nota de crédito o débito |
+| `getNotePdf(id)` | Obtener PDF de la nota |
+| `getNoteXml(id)` | Obtener XML firmado |
+
+### Guías de Remisión
+
+| Método | Descripción |
+|--------|-------------|
+| `sendDespatch(body)` | Enviar guía de remisión |
+| `getDespatchPdf(id)` | Obtener PDF de la guía |
+| `getDespatchXml(id)` | Obtener XML de la guía |
+
+### Resúmenes y Anulaciones
+
+| Método | Descripción |
+|--------|-------------|
+| `sendSummary(body)` | Enviar resumen diario de boletas |
+| `sendVoided(body)` | Enviar comunicación de baja |
+| `getTicketStatus(ticket)` | Consultar estado de un ticket |
+
+### Documentos
+
+| Método | Descripción |
+|--------|-------------|
+| `listDocuments(query?)` | Listar documentos emitidos |
+| `getDocument(id)` | Obtener documento por ID |
+| `retryDocument(id)` | Reintentar envío de documento fallido |
+| `getNextCorrelativo(query)` | Obtener siguiente correlativo |
+
+### Empresas
+
+| Método | Descripción |
+|--------|-------------|
+| `listCompanies()` | Listar empresas registradas |
+| `createCompany(body)` | Registrar nueva empresa |
+| `getCompany(id)` | Obtener datos de empresa |
+| `updateCompany(id, body)` | Actualizar empresa |
+| `uploadCertificate(id, body)` | Subir certificado digital |
+| `uploadLogo(id, body)` | Subir logo (aparece en PDFs) |
+| `getLogo(id)` | Obtener logo |
+| `deleteLogo(id)` | Eliminar logo |
+
+### Webhooks
+
+| Método | Descripción |
+|--------|-------------|
+| `listWebhooks()` | Listar webhooks |
+| `createWebhook(body)` | Crear webhook |
+| `getWebhook(id)` | Obtener webhook |
+| `updateWebhook(id, body)` | Actualizar webhook |
+| `deleteWebhook(id)` | Eliminar webhook |
+| `listWebhookDeliveries(id)` | Listar entregas |
+| `redeliverWebhook(endpointId, deliveryId)` | Re-enviar entrega |
+| `testWebhook(id)` | Enviar evento de prueba |
+
+### Otros
+
+| Método | Descripción |
+|--------|-------------|
+| `getUsage()` | Consumo actual del plan |
+| `getQueueStats()` | Estado de las colas |
+| `health()` | Verificar disponibilidad |
+| `consultarDocumento(ruc, tipoDoc, serie, numero)` | Consulta pública de documento |
+| `consultarDocumentoPdf(...)` | PDF de consulta pública |
+| `consultarDocumentoXml(...)` | XML de consulta pública |
+
+## Configuración
+
+```typescript
+const client = new Intifact({
+  apiKey: "tu-api-key",
+  baseUrl: "https://api.intifact.com", // opcional, default
+});
+```
+
+## Licencia
+
+MIT