Features

dte-sdk covers the whole life of a Chilean electronic tax document with nine typed functions: build it, total it, stamp it, sign it, send it to the SII, follow its status and serialize it. Each step returns a new immutable object, so you can stop at any stage, inspect it, and continue.

The Functions#

The other three public functions live on the page of the step they support: parseCaf() with stampDte(), loadCertificate() with signDte(), and getStatus() with sendToSii(). Every signature, type and constant is also listed in the API Reference.

How They Compose#

A document moves through five steps. Each one takes the output of the previous step:

In code:

import { createDte, getStatus, sendToSii, signDte, stampDte } from 'dte-sdk'
 
const dte = createDte(input)                        // Dte
const stamped = stampDte(dte, caf)                  // StampedDte
const signed = await signDte(stamped, certificate)  // SignedDte
 
const { trackId } = await sendToSii(signed, {
  certificate,
  environment: 'certification',
  senderRut: '15.234.567-4',
  resolution: { number: 0, date: '2026-09-01' },
})
 
const status = await getStatus(trackId, {
  certificate,
  environment: 'certification',
  issuerRut: '76.123.456-0',
})

calculateTotals() and toXml() are helpers you can use at any point: totals for a cart before a document exists, XML for a preview or an archive.

Shared Behavior#

All functions:

• ✅ Are fully typed - each stage has its own type, so sending an unsigned document is a compile error
• ✅ Are immutable - every step returns a new object and never changes its input
• ✅ Throw one error class - DteError, with a stable code to branch on
• ✅ Emit generic messages - errors never include RUTs, amounts, CAF private keys or certificate passwords
• ✅ Run everywhere - Node 20 or later, the browser, Deno and Bun, using Web Crypto
• ✅ Add no dependencies - zero runtime dependencies, tree-shakeable ESM and CJS

Next Steps#

• Follow a complete flow in Issue an Invoice
• Learn the moving parts (folios, CAF, certificates) in Concepts
• Keep your CAF and certificate safe with the Security guide