@timbra-ec/sri 0.1.0

package/src/xml/builder.ts

@@ -0,0 +1,344 @@
+import { create } from 'xmlbuilder2'
+import type { Invoice, InvoiceItem, Organization, PaymentDetail } from '@timbra-ec/types'
+import type { XMLBuilder } from 'xmlbuilder2/lib/interfaces'
+import type {
+  NotaCreditoInput,
+  NotaDebitoInput,
+  GuiaRemisionInput,
+  RetencionInput,
+  AtsInput,
+} from './types'
+import {
+  money,
+  toSriDate,
+  aggregateTaxTotals,
+  buildInfoTributaria,
+  buildInfoAdicional,
+  buildDetalles,
+} from './shared'
+
+/** Build pagos section */
+function buildPagos(parent: XMLBuilder, pagos: PaymentDetail[]): void {
+  const pagosEle = parent.ele('pagos')
+  for (const pago of pagos) {
+    const pagoEle = pagosEle.ele('pago')
+    pagoEle.ele('formaPago').txt(pago.formaPago)
+    pagoEle.ele('total').txt(money(pago.total))
+    if (pago.plazo !== undefined) {
+      pagoEle.ele('plazo').txt(pago.plazo.toString())
+      pagoEle.ele('unidadTiempo').txt(pago.unidadTiempo ?? 'dias')
+    }
+  }
+}
+
+/** Build totalConImpuestos section from aggregated tax totals */
+function buildTotalConImpuestos(parent: XMLBuilder, items: InvoiceItem[]): void {
+  const taxTotals = aggregateTaxTotals(items)
+  const totalConImpuestos = parent.ele('totalConImpuestos')
+  for (const tax of taxTotals) {
+    const totalImpuesto = totalConImpuestos.ele('totalImpuesto')
+    totalImpuesto.ele('codigo').txt(tax.codigo)
+    totalImpuesto.ele('codigoPorcentaje').txt(tax.codigoPorcentaje)
+    totalImpuesto.ele('baseImponible').txt(money(tax.baseImponible))
+    totalImpuesto.ele('valor').txt(money(tax.valor))
+  }
+}
+
+/**
+ * Build SRI-compliant factura XML (codDoc=01, version 2.1.0).
+ *
+ * The returned XML has `id="comprobante"` on the root element,
+ * which is required for XAdES-BES signing to reference.
+ */
+export function buildFacturaXml(invoice: Invoice, org: Organization): string {
+  const doc = create({ version: '1.0', encoding: 'UTF-8' })
+  const factura = doc.ele('factura', { id: 'comprobante', version: '2.1.0' })
+
+  // --- infoTributaria ---
+  buildInfoTributaria(factura, {
+    ambiente: invoice.ambiente,
+    tipoEmision: invoice.tipoEmision,
+    ruc: org.ruc,
+    claveAcceso: invoice.claveAcceso,
+    codDoc: invoice.codDoc,
+    estab: invoice.estab,
+    ptoEmi: invoice.ptoEmi,
+    secuencial: invoice.secuencial,
+    razonSocial: org.razonSocial,
+    nombreComercial: org.nombreComercial,
+    direccionMatriz: org.direccionMatriz,
+    regimenRimpe: org.regimenRimpe,
+  })
+
+  // --- infoFactura ---
+  const infoFact = factura.ele('infoFactura')
+  infoFact.ele('fechaEmision').txt(toSriDate(invoice.fechaEmision))
+  infoFact.ele('obligadoContabilidad').txt(org.obligadoContabilidad ? 'SI' : 'NO')
+  infoFact.ele('tipoIdentificacionComprador').txt(invoice.tipoIdentificacionComprador)
+  infoFact.ele('razonSocialComprador').txt(invoice.razonSocialComprador)
+  infoFact.ele('identificacionComprador').txt(invoice.identificacionComprador)
+  infoFact.ele('totalSinImpuestos').txt(money(invoice.totalSinImpuestos))
+  infoFact.ele('totalDescuento').txt(money(invoice.totalDescuento))
+  buildTotalConImpuestos(infoFact, invoice.items)
+  infoFact.ele('propina').txt(money(invoice.propina ?? 0))
+  infoFact.ele('importeTotal').txt(money(invoice.importeTotal))
+  infoFact.ele('moneda').txt(invoice.moneda)
+  buildPagos(infoFact, invoice.pagos)
+
+  // --- detalles ---
+  buildDetalles(factura, invoice.items)
+
+  // --- infoAdicional ---
+  buildInfoAdicional(factura, invoice.infoAdicional)
+
+  return doc.end({ prettyPrint: false })
+}
+
+/**
+ * Build SRI-compliant Nota de Credito XML (codDoc=04, version 1.1.0).
+ */
+export function buildNotaCreditoXml(input: NotaCreditoInput): string {
+  const doc = create({ version: '1.0', encoding: 'UTF-8' })
+  const root = doc.ele('notaCredito', { id: 'comprobante', version: '1.1.0' })
+
+  buildInfoTributaria(root, input.infoTributaria)
+
+  const info = root.ele('infoNotaCredito')
+  info.ele('fechaEmision').txt(toSriDate(input.fechaEmision))
+  info.ele('obligadoContabilidad').txt(input.obligadoContabilidad ? 'SI' : 'NO')
+  info.ele('tipoIdentificacionComprador').txt(input.tipoIdentificacionComprador)
+  info.ele('razonSocialComprador').txt(input.razonSocialComprador)
+  info.ele('identificacionComprador').txt(input.identificacionComprador)
+  info.ele('codDocModificado').txt(input.codDocModificado)
+  info.ele('numDocModificado').txt(input.numDocModificado)
+  info.ele('fechaEmisionDocSustento').txt(toSriDate(input.fechaEmisionDocSustento))
+  info.ele('totalSinImpuestos').txt(money(input.totalSinImpuestos))
+  buildTotalConImpuestos(info, input.items)
+  info.ele('motivo').txt(input.motivo)
+  info.ele('importeTotal').txt(money(input.importeTotal))
+  buildPagos(info, input.pagos)
+
+  buildDetalles(root, input.items)
+  buildInfoAdicional(root, input.infoAdicional)
+
+  return doc.end({ prettyPrint: false })
+}
+
+/**
+ * Build SRI-compliant Nota de Debito XML (codDoc=05, version 1.0.0).
+ */
+export function buildNotaDebitoXml(input: NotaDebitoInput): string {
+  const doc = create({ version: '1.0', encoding: 'UTF-8' })
+  const root = doc.ele('notaDebito', { id: 'comprobante', version: '1.0.0' })
+
+  buildInfoTributaria(root, input.infoTributaria)
+
+  const info = root.ele('infoNotaDebito')
+  info.ele('fechaEmision').txt(toSriDate(input.fechaEmision))
+  info.ele('obligadoContabilidad').txt(input.obligadoContabilidad ? 'SI' : 'NO')
+  info.ele('tipoIdentificacionComprador').txt(input.tipoIdentificacionComprador)
+  info.ele('razonSocialComprador').txt(input.razonSocialComprador)
+  info.ele('identificacionComprador').txt(input.identificacionComprador)
+  info.ele('codDocModificado').txt(input.codDocModificado)
+  info.ele('numDocModificado').txt(input.numDocModificado)
+  info.ele('fechaEmisionDocSustento').txt(toSriDate(input.fechaEmisionDocSustento))
+  info.ele('totalSinImpuestos').txt(money(input.totalSinImpuestos))
+
+  const impuestosEle = info.ele('impuestos')
+  for (const imp of input.impuestos) {
+    const impuesto = impuestosEle.ele('impuesto')
+    impuesto.ele('codigo').txt(imp.codigo)
+    impuesto.ele('codigoPorcentaje').txt(imp.codigoPorcentaje)
+    impuesto.ele('tarifa').txt(money(imp.tarifa))
+    impuesto.ele('baseImponible').txt(money(imp.baseImponible))
+    impuesto.ele('valor').txt(money(imp.valor))
+  }
+
+  info.ele('importeTotal').txt(money(input.importeTotal))
+  buildPagos(info, input.pagos)
+
+  const motivos = root.ele('motivos')
+  for (const m of input.motivos) {
+    const motivo = motivos.ele('motivo')
+    motivo.ele('razon').txt(m.razon)
+    motivo.ele('valor').txt(money(m.valor))
+  }
+
+  buildInfoAdicional(root, input.infoAdicional)
+
+  return doc.end({ prettyPrint: false })
+}
+
+/**
+ * Build SRI-compliant Guia de Remision XML (codDoc=06, version 1.1.0).
+ */
+export function buildGuiaRemisionXml(input: GuiaRemisionInput): string {
+  const doc = create({ version: '1.0', encoding: 'UTF-8' })
+  const root = doc.ele('guiaRemision', { id: 'comprobante', version: '1.1.0' })
+
+  buildInfoTributaria(root, input.infoTributaria)
+
+  const info = root.ele('infoGuiaRemision')
+  info.ele('dirEstablecimiento').txt(input.infoTributaria.direccionMatriz)
+  info.ele('dirPartida').txt(input.dirPartida)
+  info.ele('razonSocialTransportista').txt(input.razonSocialTransportista)
+  info.ele('tipoIdentificacionTransportista').txt(input.tipoIdentificacionTransportista)
+  info.ele('rucTransportista').txt(input.rucTransportista)
+  info.ele('obligadoContabilidad').txt(input.obligadoContabilidad ? 'SI' : 'NO')
+  info.ele('fechaIniTransporte').txt(toSriDate(input.fechaIniTransporte))
+  info.ele('fechaFinTransporte').txt(toSriDate(input.fechaFinTransporte))
+  info.ele('placa').txt(input.placa)
+
+  const destinatarios = root.ele('destinatarios')
+  for (const dest of input.destinatarios) {
+    const destinatario = destinatarios.ele('destinatario')
+    destinatario.ele('identificacionDestinatario').txt(dest.identificacionDestinatario)
+    destinatario.ele('razonSocialDestinatario').txt(dest.razonSocialDestinatario)
+    destinatario.ele('dirDestinatario').txt(dest.dirDestinatario)
+    destinatario.ele('motivoTraslado').txt(dest.motivoTraslado)
+
+    if (dest.codDocSustento) {
+      destinatario.ele('codDocSustento').txt(dest.codDocSustento)
+    }
+    if (dest.numDocSustento) {
+      destinatario.ele('numDocSustento').txt(dest.numDocSustento)
+    }
+    if (dest.numAutDocSustento) {
+      destinatario.ele('numAutDocSustento').txt(dest.numAutDocSustento)
+    }
+    if (dest.fechaEmisionDocSustento) {
+      destinatario.ele('fechaEmisionDocSustento').txt(toSriDate(dest.fechaEmisionDocSustento))
+    }
+
+    const detalles = destinatario.ele('detalles')
+    for (const item of dest.detalles) {
+      const detalle = detalles.ele('detalle')
+      detalle.ele('codigoInterno').txt(item.codigoInterno)
+      detalle.ele('descripcion').txt(item.descripcion)
+      detalle.ele('cantidad').txt(money(item.cantidad))
+    }
+  }
+
+  buildInfoAdicional(root, input.infoAdicional)
+
+  return doc.end({ prettyPrint: false })
+}
+
+/**
+ * Build SRI-compliant Comprobante de Retencion XML (codDoc=07, Version ATS format).
+ */
+export function buildRetencionXml(input: RetencionInput): string {
+  const doc = create({ version: '1.0', encoding: 'UTF-8' })
+  const root = doc.ele('comprobanteRetencion', { id: 'comprobante', version: '2.0.0' })
+
+  buildInfoTributaria(root, input.infoTributaria)
+
+  const info = root.ele('infoCompRetencion')
+  info.ele('fechaEmision').txt(toSriDate(input.fechaEmision))
+  info.ele('obligadoContabilidad').txt(input.obligadoContabilidad ? 'SI' : 'NO')
+  info.ele('tipoIdentificacionSujetoRetenido').txt(input.tipoIdentificacionSujetoRetenido)
+  info.ele('razonSocialSujetoRetenido').txt(input.razonSocialSujetoRetenido)
+  info.ele('identificacionSujetoRetenido').txt(input.identificacionSujetoRetenido)
+  info.ele('periodoFiscal').txt(input.periodoFiscal)
+
+  const docsSustento = root.ele('docsSustento')
+  // Group retention details by sustaining document
+  const byDoc = new Map<string, typeof input.impuestos>()
+  for (const imp of input.impuestos) {
+    const key = `${imp.codDocSustento}-${imp.numDocSustento}-${imp.fechaEmisionDocSustento}`
+    const group = byDoc.get(key) ?? []
+    group.push(imp)
+    byDoc.set(key, group)
+  }
+
+  for (const [, retenciones] of byDoc) {
+    const first = retenciones[0]!
+    const docSustento = docsSustento.ele('docSustento')
+    docSustento.ele('codSustento').txt('01')
+    docSustento.ele('codDocSustento').txt(first.codDocSustento)
+    docSustento.ele('numDocSustento').txt(first.numDocSustento)
+    docSustento.ele('fechaEmisionDocSustento').txt(toSriDate(first.fechaEmisionDocSustento))
+
+    const retencionesEle = docSustento.ele('retenciones')
+    for (const ret of retenciones) {
+      const retencion = retencionesEle.ele('retencion')
+      retencion.ele('codigo').txt(ret.codigo)
+      retencion.ele('codigoRetencion').txt(ret.codigoRetencion)
+      retencion.ele('baseImponible').txt(money(ret.baseImponible))
+      retencion.ele('porcentajeRetener').txt(money(ret.porcentajeRetener))
+      retencion.ele('valorRetenido').txt(money(ret.valorRetenido))
+    }
+  }
+
+  buildInfoAdicional(root, input.infoAdicional)
+
+  return doc.end({ prettyPrint: false })
+}
+
+/**
+ * Build ATS (Anexo Transaccional Simplificado) XML for monthly filing.
+ * This is NOT an electronic document — it's a report XML uploaded to SRI portal.
+ */
+export function buildAtsXml(input: AtsInput): string {
+  const doc = create({ version: '1.0', encoding: 'UTF-8' })
+  const iva = doc.ele('iva')
+
+  iva.ele('TipoIDInformante').txt(input.tipoIDInformante)
+  iva.ele('IdInformante').txt(input.idInformante)
+  iva.ele('razonSocial').txt(input.razonSocial)
+  iva.ele('Anio').txt(input.anio)
+  iva.ele('Mes').txt(input.mes)
+  iva.ele('numEstabRuc').txt(input.numEstabRuc)
+  iva.ele('totalVentas').txt(money(input.totalVentas))
+  iva.ele('codigoOperativo').txt(input.codigoOperativo)
+
+  if (input.compras.length > 0) {
+    const compras = iva.ele('compras')
+    for (const c of input.compras) {
+      const detalle = compras.ele('detalleCompras')
+      detalle.ele('codSustento').txt(c.codSustento)
+      detalle.ele('tpIdProv').txt(c.tpIdProv)
+      detalle.ele('idProv').txt(c.idProv)
+      detalle.ele('tipoComprobante').txt(c.tipoComprobante)
+      detalle.ele('parteRel').txt(c.parteRel)
+      detalle.ele('fechaRegistro').txt(c.fechaRegistro)
+      detalle.ele('establecimiento').txt(c.establecimiento)
+      detalle.ele('puntoEmision').txt(c.puntoEmision)
+      detalle.ele('secuencial').txt(c.secuencial)
+      detalle.ele('fechaEmision').txt(c.fechaEmision)
+      detalle.ele('autorizacion').txt(c.autorizacion)
+      detalle.ele('baseNoGraIva').txt(money(c.baseNoGraIva))
+      detalle.ele('baseImponible').txt(money(c.baseImponible))
+      detalle.ele('baseImpGrav').txt(money(c.baseImpGrav))
+      detalle.ele('montoIva').txt(money(c.montoIva))
+      detalle.ele('valRetBien10').txt(money(c.valRetBien10))
+      detalle.ele('valRetServ20').txt(money(c.valRetServ20))
+      detalle.ele('valorRetBienes').txt(money(c.valorRetBienes))
+      detalle.ele('valRetServ50').txt(money(c.valRetServ50))
+      detalle.ele('valorRetServicios').txt(money(c.valorRetServicios))
+      detalle.ele('valRetServ100').txt(money(c.valRetServ100))
+      detalle.ele('totbasesImpReemb').txt(money(c.totbasesImpReemb))
+    }
+  }
+
+  if (input.ventas.length > 0) {
+    const ventas = iva.ele('ventas')
+    for (const v of input.ventas) {
+      const detalle = ventas.ele('detalleVentas')
+      detalle.ele('tpIdCliente').txt(v.tpIdCliente)
+      detalle.ele('idCliente').txt(v.idCliente)
+      detalle.ele('tipoComprobante').txt(v.tipoComprobante)
+      detalle.ele('tipoEmision').txt(v.tipoEmision)
+      detalle.ele('numeroComprobantes').txt(v.numeroComprobantes.toString())
+      detalle.ele('baseNoGraIva').txt(money(v.baseNoGraIva))
+      detalle.ele('baseImponible').txt(money(v.baseImponible))
+      detalle.ele('baseImpGrav').txt(money(v.baseImpGrav))
+      detalle.ele('montoIva').txt(money(v.montoIva))
+      detalle.ele('montoIce').txt(money(v.montoIce))
+      detalle.ele('valorRetIva').txt(money(v.valorRetIva))
+      detalle.ele('valorRetRenta').txt(money(v.valorRetRenta))
+    }
+  }
+
+  return doc.end({ prettyPrint: false })
+}

package/src/xml/shared.ts

@@ -0,0 +1,110 @@
+import type { XMLBuilder } from 'xmlbuilder2/lib/interfaces'
+import type { InvoiceItem } from '@timbra-ec/types'
+import type { InfoTributariaInput } from './types'
+
+/** Format a number to exactly 2 decimal places */
+export function money(value: number): string {
+  return value.toFixed(2)
+}
+
+/** Convert ISO date (YYYY-MM-DD) to SRI format (dd/MM/yyyy) */
+export function toSriDate(isoDate: string): string {
+  const [year, month, day] = isoDate.split('-')
+  return `${day}/${month}/${year}`
+}
+
+/** Aggregate tax totals by codigoPorcentaje across all items */
+export function aggregateTaxTotals(items: InvoiceItem[]) {
+  const totals = new Map<
+    string,
+    { codigo: string; codigoPorcentaje: string; baseImponible: number; valor: number }
+  >()
+
+  for (const item of items) {
+    for (const imp of item.impuestos) {
+      const key = `${imp.codigo}-${imp.codigoPorcentaje}`
+      const existing = totals.get(key)
+      if (existing) {
+        existing.baseImponible += imp.baseImponible
+        existing.valor += imp.valor
+      } else {
+        totals.set(key, {
+          codigo: imp.codigo,
+          codigoPorcentaje: imp.codigoPorcentaje,
+          baseImponible: imp.baseImponible,
+          valor: imp.valor,
+        })
+      }
+    }
+  }
+
+  return Array.from(totals.values())
+}
+
+/** Build the infoTributaria section (common to all SRI documents) */
+export function buildInfoTributaria(parent: XMLBuilder, input: InfoTributariaInput): void {
+  const infoTrib = parent.ele('infoTributaria')
+  infoTrib.ele('ambiente').txt(input.ambiente)
+  infoTrib.ele('tipoEmision').txt(input.tipoEmision)
+  infoTrib.ele('razonSocial').txt(input.razonSocial)
+  if (input.nombreComercial) {
+    infoTrib.ele('nombreComercial').txt(input.nombreComercial)
+  }
+  infoTrib.ele('ruc').txt(input.ruc)
+  infoTrib.ele('claveAcceso').txt(input.claveAcceso)
+  infoTrib.ele('codDoc').txt(input.codDoc)
+  infoTrib.ele('estab').txt(input.estab)
+  infoTrib.ele('ptoEmi').txt(input.ptoEmi)
+  infoTrib.ele('secuencial').txt(input.secuencial)
+  infoTrib.ele('dirMatriz').txt(input.direccionMatriz)
+
+  if (input.regimenRimpe === 'emprendedor') {
+    infoTrib.ele('contribuyenteRimpe').txt('CONTRIBUYENTE RÉGIMEN RIMPE')
+  } else if (input.regimenRimpe === 'negocio_popular') {
+    infoTrib.ele('contribuyenteRimpe').txt('CONTRIBUYENTE NEGOCIO POPULAR - RÉGIMEN RIMPE')
+  }
+}
+
+/** Build infoAdicional section */
+export function buildInfoAdicional(
+  parent: XMLBuilder,
+  infoAdicional?: Record<string, string>,
+): void {
+  if (infoAdicional && Object.keys(infoAdicional).length > 0) {
+    const section = parent.ele('infoAdicional')
+    for (const [nombre, valor] of Object.entries(infoAdicional)) {
+      section.ele('campoAdicional', { nombre }).txt(valor)
+    }
+  }
+}
+
+/** Build detalles section from InvoiceItems */
+export function buildDetalles(parent: XMLBuilder, items: InvoiceItem[]): void {
+  const detalles = parent.ele('detalles')
+  for (const item of items) {
+    const detalle = detalles.ele('detalle')
+    detalle.ele('codigoPrincipal').txt(item.codigoPrincipal)
+    detalle.ele('descripcion').txt(item.descripcion)
+    detalle.ele('cantidad').txt(money(item.cantidad))
+    detalle.ele('precioUnitario').txt(money(item.precioUnitario))
+    detalle.ele('descuento').txt(money(item.descuento))
+    detalle.ele('precioTotalSinImpuesto').txt(money(item.precioTotalSinImpuesto))
+
+    const impuestos = detalle.ele('impuestos')
+    for (const imp of item.impuestos) {
+      const impuesto = impuestos.ele('impuesto')
+      impuesto.ele('codigo').txt(imp.codigo)
+      impuesto.ele('codigoPorcentaje').txt(imp.codigoPorcentaje)
+      impuesto.ele('tarifa').txt(money(imp.tarifa))
+      impuesto.ele('baseImponible').txt(money(imp.baseImponible))
+      impuesto.ele('valor').txt(money(imp.valor))
+    }
+
+    if (item.detallesAdicionales && item.detallesAdicionales.length > 0) {
+      const detAdicionales = detalle.ele('detallesAdicionales')
+      for (const da of item.detallesAdicionales) {
+        detAdicionales.ele('detAdicional', { nombre: da.nombre }).txt(da.valor)
+      }
+    }
+  }
+}

package/src/xml/types.ts

@@ -0,0 +1,195 @@
+import type {
+  DocumentTypeCode,
+  EmissionType,
+  InvoiceItem,
+  PaymentDetail,
+  SriEnvironment,
+} from '@timbra-ec/types'
+
+/** Common fields for all SRI documents (used in infoTributaria) */
+export interface InfoTributariaInput {
+  ambiente: SriEnvironment
+  tipoEmision: EmissionType
+  ruc: string
+  claveAcceso: string
+  codDoc: DocumentTypeCode
+  estab: string
+  ptoEmi: string
+  secuencial: string
+  razonSocial: string
+  nombreComercial?: string
+  direccionMatriz: string
+  regimenRimpe?: 'emprendedor' | 'negocio_popular' | null
+}
+
+/** Input for building a Nota de Credito XML (codDoc=04) */
+export interface NotaCreditoInput {
+  infoTributaria: InfoTributariaInput
+  /** Date in YYYY-MM-DD format */
+  fechaEmision: string
+  obligadoContabilidad: boolean
+  tipoIdentificacionComprador: string
+  identificacionComprador: string
+  razonSocialComprador: string
+  /** codDoc of the modified document (e.g. '01' for factura) */
+  codDocModificado: DocumentTypeCode
+  /** Document number being modified: estab-ptoEmi-secuencial (e.g. '001-001-000000001') */
+  numDocModificado: string
+  /** Emission date of the modified document in YYYY-MM-DD */
+  fechaEmisionDocSustento: string
+  /** Reason for the credit note */
+  motivo: string
+  totalSinImpuestos: number
+  importeTotal: number
+  items: InvoiceItem[]
+  pagos: PaymentDetail[]
+  infoAdicional?: Record<string, string>
+}
+
+/** Motivo entry for a Nota de Debito */
+export interface MotivoDebito {
+  razon: string
+  valor: number
+}
+
+/** Input for building a Nota de Debito XML (codDoc=05) */
+export interface NotaDebitoInput {
+  infoTributaria: InfoTributariaInput
+  fechaEmision: string
+  obligadoContabilidad: boolean
+  tipoIdentificacionComprador: string
+  identificacionComprador: string
+  razonSocialComprador: string
+  codDocModificado: DocumentTypeCode
+  numDocModificado: string
+  fechaEmisionDocSustento: string
+  totalSinImpuestos: number
+  importeTotal: number
+  impuestos: {
+    codigo: string
+    codigoPorcentaje: string
+    tarifa: number
+    baseImponible: number
+    valor: number
+  }[]
+  motivos: MotivoDebito[]
+  pagos: PaymentDetail[]
+  infoAdicional?: Record<string, string>
+}
+
+/** Destinatario for a Guia de Remision */
+export interface Destinatario {
+  identificacionDestinatario: string
+  razonSocialDestinatario: string
+  dirDestinatario: string
+  motivoTraslado: string
+  /** Optional: referencing a factura or liquidacion */
+  codDocSustento?: DocumentTypeCode
+  numDocSustento?: string
+  numAutDocSustento?: string
+  fechaEmisionDocSustento?: string
+  detalles: {
+    codigoInterno: string
+    descripcion: string
+    cantidad: number
+  }[]
+}
+
+/** Input for building a Guia de Remision XML (codDoc=06) */
+export interface GuiaRemisionInput {
+  infoTributaria: InfoTributariaInput
+  fechaEmision: string
+  obligadoContabilidad: boolean
+  dirPartida: string
+  razonSocialTransportista: string
+  tipoIdentificacionTransportista: string
+  rucTransportista: string
+  placa: string
+  fechaIniTransporte: string
+  fechaFinTransporte: string
+  destinatarios: Destinatario[]
+  infoAdicional?: Record<string, string>
+}
+
+/** Retention line item */
+export interface RetencionDetalle {
+  /** '1' = renta, '2' = IVA, '6' = ISD */
+  codigo: string
+  codigoRetencion: string
+  baseImponible: number
+  porcentajeRetener: number
+  valorRetenido: number
+  /** codDoc of the sustaining document */
+  codDocSustento: DocumentTypeCode
+  numDocSustento: string
+  fechaEmisionDocSustento: string
+}
+
+/** Input for building a Comprobante de Retencion XML (codDoc=07, Version ATS) */
+export interface RetencionInput {
+  infoTributaria: InfoTributariaInput
+  fechaEmision: string
+  obligadoContabilidad: boolean
+  tipoIdentificacionSujetoRetenido: string
+  identificacionSujetoRetenido: string
+  razonSocialSujetoRetenido: string
+  periodoFiscal: string
+  impuestos: RetencionDetalle[]
+  infoAdicional?: Record<string, string>
+}
+
+/** Purchase detail for ATS */
+export interface AtsCompra {
+  codSustento: string
+  tpIdProv: string
+  idProv: string
+  tipoComprobante: string
+  parteRel: 'SI' | 'NO'
+  fechaRegistro: string
+  establecimiento: string
+  puntoEmision: string
+  secuencial: string
+  fechaEmision: string
+  autorizacion: string
+  baseNoGraIva: number
+  baseImponible: number
+  baseImpGrav: number
+  montoIva: number
+  valRetBien10: number
+  valRetServ20: number
+  valorRetBienes: number
+  valRetServ50: number
+  valorRetServicios: number
+  valRetServ100: number
+  totbasesImpReemb: number
+}
+
+/** Sales detail for ATS */
+export interface AtsVenta {
+  tpIdCliente: string
+  idCliente: string
+  tipoComprobante: string
+  tipoEmision: 'E' | 'F'
+  numeroComprobantes: number
+  baseNoGraIva: number
+  baseImponible: number
+  baseImpGrav: number
+  montoIva: number
+  montoIce: number
+  valorRetIva: number
+  valorRetRenta: number
+}
+
+/** Input for building ATS XML */
+export interface AtsInput {
+  tipoIDInformante: 'R' | 'C'
+  idInformante: string
+  razonSocial: string
+  anio: string
+  mes: string
+  numEstabRuc: string
+  totalVentas: number
+  codigoOperativo: string
+  compras: AtsCompra[]
+  ventas: AtsVenta[]
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@timbra-ec/config-ts/library.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}