PDF API (dte-sdk/pdf)

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

npm install pdf-lib bwip-js

// The printable documents of an XML: an `EnvioDTE`, `EnvioDTEB`, `EnvioDTETraslado` or
// `EnvioBOLETA` envelope, a bare `SetDTE`, or a bare `DTE` (what `SignedDocument.xml` holds). Any
// other root yields an empty list.
function parsePrintableDocuments(xml: string): readonly PrintableDocument[]

// The PDF417 stamp of a TED as a PNG: error correction level 5, the TED bytes exactly as they were
// signed. The renderer embeds it under the totals; callers with a layout of their own use it
// directly.
function renderTedBarcode(tedXml: string): Promise<Uint8Array>
 
// True when the printed document carries a transferable copy: 33, 34, 43 and 46 always; 52 only
// when the transfer is a sale (reason 1 or 9, 1 assumed when absent), as the manual excludes
// transfers that are not sales; never for notes or receipts.
function needsTransferableCopy(doc: PrintableDocument): boolean
 
// The printed sample of one document as a single-page PDF per the SII printed-samples manual:
// issuer and the red type box, issue date, receiver, transfer reason (guides), references, detail,
// totals, the acknowledgement box and the `CEDIBLE` mark on a transferable copy, and the PDF417
// stamp with its legends.
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

// The SII office of each commune: 355 commune names in 40 offices, every official commune included.
// Keys are the legend printed under the type box (`S.I.I. - {office}`); values are the communes
// that office serves, in lowercase, without accents and with single spaces.
const SII_OFFICES: Readonly<Record<string, readonly string[]>>
 
// The legend for a commune (the issuer's `CmnaOrigen`), or null when the table does not have it.
// Case, surrounding spaces and accents are ignored.
function siiOfficeForCommune(commune: string): string | null

// Renders every document of every envelope, in memory: one sample per document and, with
// `transferable`, a second one for each document that admits a transferable copy.
function renderPrintedSamples(input: PrintedSamplesInput): Promise<PrintedSamplesResult>

// The envelope files under a path: the file itself, or every `.xml` under a directory
// (recursively) whose name contains `envio-set-`, `envio-simulacion` or `envioboleta`, so the
// responses and receipt envelopes of the exchange, which carry no DTE, are skipped.
function findEnvelopeFiles(inputPath: string): Promise<readonly string[]>
 
// Every `.pdf` under a directory, recursively, in name order at every level, so the test set's
// folder (`SET-PRUEBAS`) comes before the simulation's (`SET-SIMULACION`) as `writePrintedSamples`
// lays them out; each with its base name and its bytes, ready for the printed samples step.
function readPrintedSamples(dir: string): Promise<readonly PrintedSampleFile[]>
 
// Renders the samples of every file into `{outDir}/SET-PRUEBAS` and `{outDir}/SET-SIMULACION`, one
// PDF per sample under its sample name.
function writePrintedSamples(input: WritePrintedSamplesInput): Promise<WritePrintedSamplesResult>