Introducción

dte-sdk crea, timbra y firma DTE (Documento Tributario Electrónico) de Chile como los espera el SII, los envía por los servicios web del SII y les hace seguimiento. También cubre lo que rodea a la emisión: la verificación de los documentos que te envían tus proveedores, los libros del SII, el portal del SII autenticado con certificado (folios, el registro de compras y ventas, el respaldo MIPYME, la verificación de actividades), el proceso de certificación y las muestras impresas. La API está en inglés legible, con documentación bilingüe (EN/ES) en cada campo.

Qué cubre#

Todo está probado contra respuestas sintéticas del SII, con una barrera de cobertura de 100 % en CI. La página de estado del proyecto dice, área por área, qué ya se probó contra el SII real.

Dos propiedades valen para todo lo anterior. El modelo de dominio está en inglés (totalAmount, issuer.businessName) y se traduce a las etiquetas oficiales del SII (MntTotal, RznSoc) mediante un códec. Los errores son valores DteError tipados, con códigos estables y sin datos personales en sus mensajes (Errores).

El ciclo de vida de un vistazo#

Todo documento pasa por los mismos pasos. Cada función recibe el resultado de la anterior y los tipos impiden saltarse un paso: no puedes firmar un documento que no se ha timbrado.

El mismo patrón se repite para los libros (createPurchaseSalesBook(), signPurchaseSalesBook(), uploadBook()) y el reporte de consumo de folios. El Inicio rápido recorre todo el camino.

Ejemplo rápido#

import { readFileSync } from 'node:fs'
import { loadCertificateFromPkcs12, parseCaf, issueDocument, createEnvelope, signEnvelope, encodeLatin1 } from 'dte-sdk'
 
const certificate = loadCertificateFromPkcs12(readFileSync('firma.pfx'), process.env.PFX_PASSWORD!)
const caf = parseCaf(readFileSync('caf-33.xml', 'utf8'))
 
const invoice = issueDocument({
  document: {
    type: 33,
    folio: 1,
    issuer: {
      rut: '76543210-3',
      businessName: 'Comercial Andina SpA',
      businessActivity: 'Software',
      address: 'Av. Los Aromos 1540',
      commune: 'Santiago',
      activityCode: 620200,
    },
    receiver: {
      rut: '12345678-5',
      businessName: 'Comercializadora Rapel Ltda',
      businessActivity: 'Comercio',
      address: 'Pasaje Los Olmos 88',
      commune: 'Providencia',
    },
    items: [{ name: 'Plan anual', quantity: 1, unitPrice: 100000 }],
  },
  caf,
  certificate,
})
 
invoice.header.totals // { netAmount: 100000, vatRate: 19, vatAmount: 19000, totalAmount: 119000 }
invoice.xml // <DTE> firmado, con su TED
 
const envelope = signEnvelope(
  createEnvelope({
    kind: 'dte',
    documents: [invoice],
    cover: {
      issuerRut: '76543210-3',
      senderRut: certificate.rut!,
      resolutionDate: '2024-01-15',
      resolutionNumber: 123,
    },
  }),
  certificate,
)
 
encodeLatin1(envelope.xml) // bytes ISO-8859-1, tal como los recibe el SII

El Inicio rápido continúa desde aquí: envía el sobre al ambiente de certificación del SII y lee la respuesta.

Qué necesitas#

El paquete se ocupa del formato, la criptografía y el transporte. Para emitir documentos que el SII acepte necesitas además tres cosas que solo entregan el SII y un proveedor de certificados:

• Un CAF (Código de Autorización de Folios) por cada tipo de documento que emitas: el archivo que autoriza un rango de folios. Contiene una llave privada, así que es un secreto.
• Un certificado digital, como archivo .pfx o .p12 o como PEM, de una persona autorizada para firmar por la empresa. También es un secreto.
• Autorización como emisor electrónico: el número y la fecha de la resolución del SII, o el proceso de certificación (el ambiente de pruebas del SII) mientras validas tu sistema.

Conceptos básicos explica cada uno. Lee Seguridad antes de ponerlos en un servidor.

Puntos de entrada#

El paquete tiene cuatro entradas, separadas según lo que necesitan del entorno de ejecución. DteError y isDteError vienen de dte-sdk y reconocen lo que lanza cualquier entrada. Puntos de entrada explica la separación.

Siguientes pasos#

Licencia#

MIT © Arrow Software. Uso libre personal y comercial, incluso en productos cerrados y de pago, sin más obligación de atribución que conservar el aviso de licencia.