factuplan 0.4.1 → 0.6.0

package/README.md

@@ -129,6 +129,27 @@ const { url } = await factuplan.invoices.downloadXml('invoice-id');
 const { url } = await factuplan.invoices.downloadPdf('invoice-id');
 ```
 
+### Importar factura ya autorizada por el SRI
+
+Si tienes una factura que ya fue autorizada directamente por el SRI (no a través de Factuplan), puedes importarla para almacenarla en tu cuenta y generar el PDF (RIDE):
+
+```typescript
+const result = await factuplan.invoices.importByAccessKey({
+  accessKey: '1512202501095019440700120010020000000116488711218',
+});
+
+console.log(result.id);         // ID interno del comprobante
+console.log(result.accessKey);  // Clave de acceso SRI
+console.log(result.sequential); // Número secuencial
+console.log(result.status);     // 'AUTHORIZED'
+console.log(result.total);      // Total del comprobante
+
+// El PDF se genera automáticamente. Descárgalo una vez listo:
+const { url } = await factuplan.invoices.downloadPdf(result.id);
+```
+
+> **Nota:** Este método no envía el comprobante al SRI ni envía correo al cliente. Solo importa y genera el PDF.
+
 ### Firmar y autorizar XML (Modo B)
 
 Si ya tienes tu XML generado (sin firmar), puedes enviarlo para que Factuplan lo firme con tu certificado y lo autorice ante el SRI:

package/dist/index.d.mts

@@ -115,6 +115,10 @@ interface CreateInvoiceInput {
     paymentMethod?: string;
     additionalInfo?: Record<string, string>;
 }
+interface ImportByAccessKeyInput {
+    /** 49-digit SRI access key (claveAcceso) of an already-authorized invoice */
+    accessKey: string;
+}
 interface Invoice {
     id: string;
     accessKey: string;
@@ -130,8 +134,13 @@ interface InvoiceStatus {
     authorizationDate?: string;
 }
 interface DownloadUrlResponse {
+    /** URL pre-firmada de S3 — expira en 5 minutos */
     url: string;
-    s3Key?: string;
+    /**
+     * URL permanente de visualización del comprobante en Factuplan.
+     * No expira. Formato: https://app.factuplan.com.ec/verify?clave={accessKey}
+     */
+    previewUrl?: string;
 }
 interface SignAndAuthorizeInput {
     /** Unsigned XML string */
@@ -201,7 +210,7 @@ interface WebhookReceiptData {
     customerIdentification: string;
 }
 interface FactuplanOptions {
-    /** Base URL of the API (default: https://api.factuplan.com/api/v1) */
+    /** Base URL of the API (default: https://api-rest.factuplan.com.ec/v1) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -231,6 +240,7 @@ declare class InvoicesResource {
     getStatus(id: string): Promise<InvoiceStatus>;
     downloadXml(id: string): Promise<DownloadUrlResponse>;
     downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    importByAccessKey(input: ImportByAccessKeyInput): Promise<Invoice>;
 }
 
 type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
@@ -286,4 +296,4 @@ declare class RateLimitError extends FactuplanError {
     constructor(message?: string);
 }
 
-export { AuthenticationError, type CertificateStatus, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCustomerInput, type UpdateProductInput, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type WebhookEvent, type WebhookReceiptData };
+export { AuthenticationError, type CertificateStatus, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type ImportByAccessKeyInput, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCustomerInput, type UpdateProductInput, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type WebhookEvent, type WebhookReceiptData };

package/dist/index.d.ts

@@ -115,6 +115,10 @@ interface CreateInvoiceInput {
     paymentMethod?: string;
     additionalInfo?: Record<string, string>;
 }
+interface ImportByAccessKeyInput {
+    /** 49-digit SRI access key (claveAcceso) of an already-authorized invoice */
+    accessKey: string;
+}
 interface Invoice {
     id: string;
     accessKey: string;
@@ -130,8 +134,13 @@ interface InvoiceStatus {
     authorizationDate?: string;
 }
 interface DownloadUrlResponse {
+    /** URL pre-firmada de S3 — expira en 5 minutos */
     url: string;
-    s3Key?: string;
+    /**
+     * URL permanente de visualización del comprobante en Factuplan.
+     * No expira. Formato: https://app.factuplan.com.ec/verify?clave={accessKey}
+     */
+    previewUrl?: string;
 }
 interface SignAndAuthorizeInput {
     /** Unsigned XML string */
@@ -201,7 +210,7 @@ interface WebhookReceiptData {
     customerIdentification: string;
 }
 interface FactuplanOptions {
-    /** Base URL of the API (default: https://api.factuplan.com/api/v1) */
+    /** Base URL of the API (default: https://api-rest.factuplan.com.ec/v1) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -231,6 +240,7 @@ declare class InvoicesResource {
     getStatus(id: string): Promise<InvoiceStatus>;
     downloadXml(id: string): Promise<DownloadUrlResponse>;
     downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    importByAccessKey(input: ImportByAccessKeyInput): Promise<Invoice>;
 }
 
 type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
@@ -286,4 +296,4 @@ declare class RateLimitError extends FactuplanError {
     constructor(message?: string);
 }
 
-export { AuthenticationError, type CertificateStatus, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCustomerInput, type UpdateProductInput, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type WebhookEvent, type WebhookReceiptData };
+export { AuthenticationError, type CertificateStatus, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type ImportByAccessKeyInput, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCustomerInput, type UpdateProductInput, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type WebhookEvent, type WebhookReceiptData };

package/dist/index.js

@@ -104,6 +104,9 @@ var InvoicesResource = class {
   async downloadPdf(id) {
     return this.request("GET", `/developer/receipts/${id}/pdf`);
   }
+  async importByAccessKey(input) {
+    return this.request("POST", "/developer/invoices/import", input);
+  }
 };
 
 // src/resources/products.ts
@@ -151,7 +154,7 @@ var WebhooksResource = class {
 };
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api-rest.factuplan.com.ec/api/v1";
+var DEFAULT_BASE_URL = "https://api-rest.factuplan.com.ec/v1";
 var DEFAULT_TIMEOUT = 3e4;
 var Factuplan = class {
   constructor(apiKey, options) {

package/dist/index.mjs

@@ -75,6 +75,9 @@ var InvoicesResource = class {
   async downloadPdf(id) {
     return this.request("GET", `/developer/receipts/${id}/pdf`);
   }
+  async importByAccessKey(input) {
+    return this.request("POST", "/developer/invoices/import", input);
+  }
 };
 
 // src/resources/products.ts
@@ -122,7 +125,7 @@ var WebhooksResource = class {
 };
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api-rest.factuplan.com.ec/api/v1";
+var DEFAULT_BASE_URL = "https://api-rest.factuplan.com.ec/v1";
 var DEFAULT_TIMEOUT = 3e4;
 var Factuplan = class {
   constructor(apiKey, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factuplan",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Official Factuplan SDK for JavaScript & TypeScript — Create electronic invoices for Ecuador (SRI)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",