Ejemplos

Flujos completos que puedes copiar y adaptar. Cada uno va desde el input crudo hasta un documento aceptado por el SII, incluyendo almacenamiento, reintentos y manejo de errores.

Empieza por la factura: la nota de crédito reutiliza sus módulos y corrige la factura que ahí se emite.

Tres reglas que siguen ambos ejemplos#

Nunca reutilices un folio#

Cada documento de un tipo recibe su propio folio del rango del CAF. Asígnalo en la misma transacción que guarda el documento, para que un error de validación no consuma uno:

const signed = await db.transaction(async (tx) => {
  const folio = await tx.folios.next(33)
  const signed = await buildInvoice({ folio, receiver, items })
  await tx.invoices.insert({ folio, xml: signed.xml, state: 'signed' })
  return signed
})

Guarda antes de enviar#

El XML firmado es el documento legal. Guárdalo primero, luego envía, y después guarda el track ID:

const { trackId } = await sendToSii(signed, { certificate, ...SII })
await db.invoices.update(signed.folio, { trackId, state: 'sent' })

Decide según el código#

Toda falla es un DteError con un code estable. Los mensajes son genéricos y nunca incluyen RUTs ni montos, así que no los parsees:

import { DteError } from 'dte-sdk'
 
if (error instanceof DteError && error.code === 'SII_UNAVAILABLE') {
  // keep the document as 'signed' and retry the upload later
}