Factuplan SDK

const cliente = await factuplan.customers.create({
  identificationType: 'RUC',          // RUC | CEDULA | PASSPORT | FINAL_CONSUMER
  identification: '0000000000001',    // RUC=13 dígitos | CEDULA=10 dígitos
  legalName: 'Empresa Demo S.A.',
  email: 'contacto@empresa.com',      // opcional
  address: 'Guayaquil, Ecuador',      // opcional
  phone: '+593000000000',             // opcional — ej. +593 EC, +1 US, +44 UK
});

const { data: clientes, meta } = await factuplan.customers.list({
  page: 1,
  limit: 20,
  search: 'empresa',
});
console.log(meta.total, 'clientes encontrados');

const cliente = await factuplan.customers.get('id');

await factuplan.customers.update('id', { email: 'nuevo@email.com' });

await factuplan.customers.delete('id');

const producto = await factuplan.products.create({
  code: 'SERV-001',
  name: 'Servicio de consultoría',
  unitPrice: 150.00,
  type: 'SERVICE',          // PRODUCT | SERVICE
  taxType: 'IVA_RATE',      // IVA_0 | IVA_RATE | NOT_TAXABLE | EXEMPT
  description: 'Hora de consultoría técnica',
});

const { data: productos } = await factuplan.products.list({ search: 'consultoría' });

await factuplan.products.update('id', { unitPrice: 175.00 });

await factuplan.products.delete('id');

const factura = await factuplan.invoices.create({
  // Punto de emisión: elige UNA de estas 3 opciones
  // Opción 1: por UUID
  emissionPointId: 'ep_id',
  // Opción 2: por códigos SRI
  // establishment: '001',
  // emissionPoint: '001',
  // Opción 3: omitir todo (auto-detecta si solo hay un punto de emisión activo)

  customer: {
    identificationType: 'RUC',
    identification: '0000000000001',    // RUC=13 dígitos | CEDULA=10 dígitos
    legalName: 'Cliente S.A.',
    email: 'cliente@email.com',
    saveToContacts: true,
  },
  items: [
    {
      code: 'SERV-001',
      description: 'Servicio de consultoría',
      quantity: 1,
      unitPrice: 1.00,
      discount: 0,
      taxType: 'IVA_RATE',  // IVA_0 | IVA_RATE | NOT_TAXABLE | EXEMPT
      tax: 15,              // Tarifa IVA: 0, 5, 8, 12, 14, 15 (default: 15)
    },
  ],
  payments: [
    {
      method: '20',
      amount: 1.15,
      term: 30,
      timeUnit: 'dias',
    },
  ],
  additionalInfo: { 'Vendedor': 'Juan Pérez' },
  // sendEmail: false,  // opcional: omite el envío de correo al cliente (default: true)
});

console.log(factura.id);         // ID del comprobante
console.log(factura.accessKey);  // Clave de acceso (49 dígitos)
console.log(factura.sequential); // Número secuencial

// Usar códigos SRI del establecimiento y punto de emisión
const factura = await factuplan.invoices.create({
  establishment: '001',
  emissionPoint: '001',
  customer: { ... },
  items: [ ... ],
});

// Si solo tienes un punto de emisión activo, no necesitas enviarlo
const factura = await factuplan.invoices.create({
  customer: { ... },
  items: [ ... ],
});

items: [
  {
    code: 'PROD-001',
    description: 'Producto con IVA reducido',
    quantity: 1,
    unitPrice: 100.00,
    taxType: 'IVA_RATE',
    tax: 5,  // IVA 5% en lugar del 15% por defecto
  },
]

const estado = await factuplan.invoices.getStatus('factura_id');
// estado.status: PROCESSING | AUTHORIZED | COMPLETED | ERROR | REJECTED

if (estado.status === 'COMPLETED') {
  console.log(estado.authorizationNumber);
}

const { url: xmlUrl } = await factuplan.invoices.downloadXml('id');
const { url: pdfUrl } = await factuplan.invoices.downloadPdf('id');

const factura = await factuplan.invoices.importByAccessKey({
  accessKey: '0104202601099337815000110010010000000011234567890',
});

console.log(factura.id);
console.log(factura.sequential);

import { Factuplan } from 'factuplan';

const factuplan = new Factuplan(process.env.FACTUPLAN_API_KEY!);

async function crearFactura() {
  // 1. Buscar o crear cliente
  const { data: clientes } = await factuplan.customers.list({
    search: '0993378150001',
  });
  let cliente = clientes[0] ?? await factuplan.customers.create({
    identificationType: 'RUC',
    identification: '0993378150001',
    legalName: 'Mi Cliente S.A.',
    email: 'cliente@email.com',
  });

  // 2. Crear factura (sin emissionPointId → auto-detecta)
  const factura = await factuplan.invoices.create({
    customer: {
      identificationType: cliente.identificationType,
      identification: cliente.identification,
      legalName: cliente.legalName,
      email: cliente.email,
    },
    items: [
      {
        code: 'PROD-001',
        description: 'Laptop Dell XPS 15',
        quantity: 1,
        unitPrice: 1500.00,
        taxType: 'IVA_RATE',
        tax: 15,
      },
    ],
    payments: [
      {
        method: '19',
        amount: 1725.00, // Total con IVA
        term: 6,
        timeUnit: 'meses',
      },
    ],
  });

  // 3. Esperar autorización
  let estado;
  do {
    await new Promise((r) => setTimeout(r, 3000));
    estado = await factuplan.invoices.getStatus(factura.id);
  } while (!['COMPLETED', 'ERROR', 'REJECTED'].includes(estado.status));

  if (estado.status === 'COMPLETED') {
    const { url } = await factuplan.invoices.downloadPdf(factura.id);
    console.log('PDF:', url);
  }
}

crearFactura();

const result = await factuplan.invoices.signAndAuthorize({
  xml: xmlString, // XML sin firmar como string
});

console.log(result.id);        // ID del comprobante
console.log(result.accessKey); // Clave de acceso SRI
console.log(result.status);    // Estado inicial

import { Factuplan } from 'factuplan';
import { readFileSync } from 'fs';

const factuplan = new Factuplan(process.env.FACTUPLAN_API_KEY!);

async function firmarYAutorizar() {
  // 1. Leer XML sin firmar
  const xml = readFileSync('./factura-sin-firmar.xml', 'utf-8');

  // 2. Enviar a firmar y autorizar
  const result = await factuplan.invoices.signAndAuthorize({ xml });

  console.log('Clave de acceso:', result.accessKey);

  // 3. Esperar autorización
  let estado;
  do {
    await new Promise((r) => setTimeout(r, 3000));
    estado = await factuplan.invoices.getStatus(result.id);
  } while (!['COMPLETED', 'ERROR', 'REJECTED'].includes(estado.status));

  // 4. Descargar documentos
  if (estado.status === 'COMPLETED') {
    const { url: xmlUrl } = await factuplan.invoices.downloadXml(result.id);
    const { url: pdfUrl } = await factuplan.invoices.downloadPdf(result.id);
    console.log('XML firmado:', xmlUrl);
    console.log('PDF (RIDE):', pdfUrl);
  }
}

firmarYAutorizar();

const { signedXml } = await factuplan.invoices.signOnly({
  xml: xmlString, // XML sin firmar como string
});

console.log(signedXml); // XML firmado

const { valid, errors } = await factuplan.invoices.validateXml({
  xml: xmlString,
});

if (!valid) {
  console.log('Errores:', errors);
}

const result = await factuplan.invoices.verify(
  '0104202601099337815000110010010000000011234567890'
);

console.log(result.authorized);         // true/false
console.log(result.authorizationNumber); // Número de autorización

const receipt = await factuplan.webhooks.verifyReceipt('receipt_id');

console.log(receipt.id);
console.log(receipt.status);    // PROCESSING | AUTHORIZED | COMPLETED | ERROR | REJECTED
console.log(receipt.accessKey); // Clave de acceso SRI (49 dígitos)

const uso = await factuplan.usage();

console.log(uso.requestsUsed, '/', uso.requestsLimit);
console.log('Costo estimado: $' + uso.estimatedCost);

const cert = await factuplan.certificateStatus();

console.log(cert.valid);       // true = vigente
console.log(cert.expiresAt);   // Fecha de vencimiento (ISO 8601)
console.log(cert.taxpayerId);  // RUC del titular
console.log(cert.commonName);  // Nombre en el certificado