API de PDF (dte-sdk/pdf)

import { parsePrintableDocuments, renderPrintedSample } from 'dte-sdk/pdf'

npm install pdf-lib bwip-js

// Los documentos imprimibles de un XML: un sobre `EnvioDTE`, `EnvioDTEB`, `EnvioDTETraslado` o
// `EnvioBOLETA`, un `SetDTE` suelto o un `DTE` suelto (lo que trae `SignedDocument.xml`).
// Cualquier otra raíz devuelve lista vacía.
function parsePrintableDocuments(xml: string): readonly PrintableDocument[]

// El timbre PDF417 de un TED como PNG: nivel de corrección 5, los bytes del TED exactamente como
// se firmaron. El renderizador lo incrusta bajo los totales; quien arma su propia diagramación lo
// usa directo.
function renderTedBarcode(tedXml: string): Promise<Uint8Array>
 
// True cuando el documento impreso lleva copia cedible: 33, 34, 43 y 46 siempre; 52 solo cuando el
// traslado es venta (tipo 1 o 9, 1 si falta), porque el manual excluye los traslados que no son
// venta; nunca notas ni boletas.
function needsTransferableCopy(doc: PrintableDocument): boolean
 
// La muestra impresa de un documento como PDF de una página según el manual de muestras impresas
// del SII: emisor y recuadro rojo del tipo, fecha de emisión, receptor, tipo de traslado (guías),
// referencias, detalle, totales, el acuse de recibo y la marca `CEDIBLE` en una copia cedible, y
// el timbre PDF417 con sus leyendas.
function renderPrintedSample(
  doc: PrintableDocument,
  options?: RenderPrintedSampleOptions,
): Promise<Uint8Array>

import { SII_OFFICES, siiOfficeForCommune } from 'dte-sdk/pdf'
 
siiOfficeForCommune(' ÑUÑOA ') // 'S.I.I. - ÑUÑOA'
siiOfficeForCommune('Nunoa') // 'S.I.I. - ÑUÑOA'
siiOfficeForCommune('Atlantis') // null

// La oficina del SII de cada comuna: 355 nombres de comuna en 40 oficinas, con todas las comunas
// oficiales. Las claves son la leyenda que se imprime bajo el recuadro del tipo (`S.I.I. - {oficina}`);
// los valores son las comunas que atiende esa oficina, en minúsculas, sin tildes y con un solo espacio.
const SII_OFFICES: Readonly<Record<string, readonly string[]>>
 
// La leyenda para una comuna (la `CmnaOrigen` del emisor), o null si la tabla no la tiene. Se
// ignoran mayúsculas, espacios alrededor y tildes.
function siiOfficeForCommune(commune: string): string | null

// Genera cada documento de cada envío, en memoria: una muestra por documento y, con
// `transferable`, una segunda por cada documento que admite copia cedible.
function renderPrintedSamples(input: PrintedSamplesInput): Promise<PrintedSamplesResult>

// Los archivos de envío bajo una ruta: el archivo mismo, o todo `.xml` bajo un directorio
// (recursivo) cuyo nombre contenga `envio-set-`, `envio-simulacion` o `envioboleta`, así se saltan
// las respuestas y los envíos de recibos del intercambio, que no traen DTE.
function findEnvelopeFiles(inputPath: string): Promise<readonly string[]>
 
// Todo `.pdf` bajo un directorio, recursivo, en orden de nombre en cada nivel, así la carpeta del
// set de pruebas (`SET-PRUEBAS`) va antes que la de la simulación (`SET-SIMULACION`) como las deja
// `writePrintedSamples`; cada uno con su nombre base y sus bytes, listos para el paso de muestras
// impresas.
function readPrintedSamples(dir: string): Promise<readonly PrintedSampleFile[]>
 
// Genera las muestras de cada archivo en `{outDir}/SET-PRUEBAS` y `{outDir}/SET-SIMULACION`, un
// PDF por muestra con su nombre de muestra.
function writePrintedSamples(input: WritePrintedSamplesInput): Promise<WritePrintedSamplesResult>