Emitir una nota de crédito

import { mkdir, readFile, writeFile } from 'node:fs/promises'
import {
  REFERENCE_CODES,
  createEnvelope,
  createSiiClient,
  encodeLatin1,
  isDteError,
  issueDocument,
  loadCertificateFromPkcs12,
  parseCaf,
  queryDocumentStatus,
  signEnvelope,
  uploadEnvelope,
  waitForUploadStatus,
  type DocumentInput,
  type ReferenceCode,
} from 'dte-sdk'
import { createDirectoryCapture, createDirectoryFolioRegistry, createDirectoryUploadArchive } from 'dte-sdk/node'
 
const COMPANY_RUT = '76543210-3'
const ENVIRONMENT = 'certification'
const resolution = {
  date: process.env.SII_RESOLUTION_DATE!, // AAAA-MM-DD
  number: Number(process.env.SII_RESOLUTION_NUMBER ?? 0),
}
 
// La factura a la que se refieren las notas: la del ejemplo de la factura
const INVOICE = { type: 33, folio: 1, date: '2026-11-05', totalAmount: 286350 } as const
 
const issuer = {
  rut: COMPANY_RUT,
  businessName: 'Comercial Andina SpA',
  businessActivity: 'Software',
  activityCode: 620200,
  address: 'Av. Los Aromos 1540',
  commune: 'Santiago',
}
 
// El receptor de la factura, tal como estaba en la factura
const receiver = {
  rut: '12345678-5',
  businessName: 'Comercializadora Rapel Ltda',
  businessActivity: 'Comercio',
  address: 'Pasaje Los Olmos 88',
  commune: 'Providencia',
}
 
const invoiceItems: DocumentInput['items'] = [
  { name: 'Plan anual', quantity: 1, unitPrice: 100000, discountPercent: 10 },
  { name: 'Horas de soporte', quantity: 3, unit: 'HRS', unitPrice: 25000 },
  { name: 'Curso de capacitación', quantity: 2, unitPrice: 45000, exempt: true },
]
 
const referenceToInvoice = (code: ReferenceCode, reason: string) => [
  { documentType: INVOICE.type, folio: INVOICE.folio, date: INVOICE.date, code, reason },
]
 
type NoteCase = Pick<DocumentInput, 'type' | 'items' | 'references'> & Partial<Pick<DocumentInput, 'receiver' | 'totals'>>
 
const CASES: Record<string, NoteCase> = {
  // Código 1: la nota deshace toda la factura, así que repite cada línea
  cancel: {
    type: 61,
    items: invoiceItems,
    references: referenceToInvoice(REFERENCE_CODES.cancels, 'Anula factura 1'),
  },
  // Código 2: la factura tiene un texto equivocado. Una línea que nombra la corrección, sin montos
  'correct-text': {
    type: 61,
    items: [{ name: 'Corrige giro del receptor' }],
    receiver: { ...receiver, businessActivity: 'Comercio al por menor' }, // el texto corregido
    totals: { totalAmount: 0 },
    references: referenceToInvoice(REFERENCE_CODES.correctsText, 'Corrige giro del receptor'),
  },
  // Código 3: cambian los montos. La nota lleva solo lo que se acredita: aquí, una de las tres horas de soporte
  'correct-amounts': {
    type: 61,
    items: [{ name: 'Horas de soporte', quantity: 1, unit: 'HRS', unitPrice: 25000 }],
    references: referenceToInvoice(REFERENCE_CODES.correctsAmounts, 'Devolución parcial: 1 hora de soporte'),
  },
}
 
const chosen = CASES[process.argv[2] ?? 'cancel']
if (chosen === undefined) throw new Error(`Unknown case. Use one of: ${Object.keys(CASES).join(', ')}`)
 
const certificate = loadCertificateFromPkcs12(await readFile('firma.pfx'), process.env.PFX_PASSWORD!)
// Cada tipo de documento tiene su propio CAF: caf-61.xml para notas de crédito, caf-56.xml para notas de débito
const caf = parseCaf(await readFile(`caf-${chosen.type}.xml`, 'latin1'))
 
const folios = createDirectoryFolioRegistry({ dir: './data/folios' })
const scope = { companyRut: COMPANY_RUT, type: chosen.type, range: caf.range, environment: ENVIRONMENT } as const
 
const sii = createSiiClient({
  environment: ENVIRONMENT,
  certificate,
  companyRut: COMPANY_RUT,
  capture: createDirectoryCapture({ dir: './data/capture' }),
  archive: createDirectoryUploadArchive({ dir: './data/uploads' }),
})
 
try {
  const folio = await folios.reserve(scope)
 
  const note = issueDocument({
    document: { folio, issuer, receiver, ...chosen }, // chosen trae el tipo, las líneas y la referencia
    caf,
    certificate,
  })
  console.log(`note ${chosen.type} folio ${folio}`, JSON.stringify(note.header.totals))
  console.log('reference', JSON.stringify(note.references))
 
  const envelope = signEnvelope(
    createEnvelope({
      kind: 'dte',
      documents: [note],
      cover: {
        issuerRut: COMPANY_RUT,
        senderRut: certificate.rut!,
        resolutionDate: resolution.date,
        resolutionNumber: resolution.number,
      },
    }),
    certificate,
  )
  await mkdir('./data/signed', { recursive: true })
  await writeFile(`./data/signed/${chosen.type}-${folio}.xml`, encodeLatin1(envelope.xml))
 
  const upload = await uploadEnvelope(sii, { envelope })
  await folios.markSent(scope, folio, { trackId: upload.trackId })
  const status = await waitForUploadStatus(sii, { trackId: upload.trackId })
  console.log(`envelope ${status.code} ${status.status}: ${status.message}`)
 
  if (status.status === 'accepted' || status.status === 'acceptedWithObjections') {
    // El SII ya conoce la nota: preguntar por la factura a la que se refiere
    const invoice = await queryDocumentStatus(sii, {
      receiverRut: receiver.rut,
      type: INVOICE.type,
      folio: INVOICE.folio,
      issueDate: INVOICE.date,
      totalAmount: INVOICE.totalAmount,
    })
    console.log(`invoice ${INVOICE.folio}: ${invoice.code} ${invoice.status}: ${invoice.message}`)
  } else {
    process.exitCode = 1
  }
} catch (error) {
  if (!isDteError(error)) throw error
  console.error(error.code, error.details)
  process.exitCode = 1
}

node credit-note.ts cancel
node credit-note.ts correct-text
node credit-note.ts correct-amounts

note 61 folio 1 {"netAmount":165000,"exemptAmount":90000,"vatRate":19,"vatAmount":31350,"totalAmount":286350}
reference [{"lineNumber":1,"documentType":33,"folio":"1","date":"2026-11-05","code":1,"reason":"Anula factura 1"}]
envelope EPR accepted: Envío procesado
invoice 1: ANC cancelled: Existe nota de crédito que anula el documento

note 61 folio 1 {"totalAmount":0}
reference [{"lineNumber":1,"documentType":33,"folio":"1","date":"2026-11-05","code":2,"reason":"Corrige giro del receptor"}]
envelope EPR accepted: Envío procesado
invoice 1: TMC modified: Existe nota de crédito que modifica textos

note 61 folio 1 {"netAmount":25000,"vatRate":19,"vatAmount":4750,"totalAmount":29750}
reference [{"lineNumber":1,"documentType":33,"folio":"1","date":"2026-11-05","code":3,"reason":"Devolución parcial: 1 hora de soporte"}]
envelope EPR accepted: Envío procesado
invoice 1: MMC modified: Existe nota de crédito que modifica montos

  // una nota de débito (tipo 56) que sube el monto: dos horas de soporte más
  debit: {
    type: 56,
    items: [{ name: 'Horas de soporte adicionales', quantity: 2, unit: 'HRS', unitPrice: 25000 }],
    references: referenceToInvoice(REFERENCE_CODES.correctsAmounts, 'Horas de soporte no facturadas'),
  },
  // una nota de débito que anula una nota de crédito: apunta a la nota (61) y no tiene montos
  'cancel-credit-note': {
    type: 56,
    items: [{ name: 'Anula nota de crédito 1' }],
    totals: { totalAmount: 0 },
    references: [
      { documentType: 61, folio: 1, date: '2026-11-06', code: REFERENCE_CODES.cancels, reason: 'Anula nota de crédito 1' },
    ],
  },