Modelo de datos — Generador

Este es el contrato de datos usado por la función generateXmlInvoice(...) para generar comprobantes tipo Factura válidos para el SRI.

Modelo de la factura

class InfoTributariaModel {
  ambiente: ENV_ENUM;
  razonSocial: string;
  nombreComercial?: string;
  ruc: string;
  estab: string;
  ptoEmi: string;
  secuencial: string;
  dirMatriz: string;
  agenteRetencion?: string;
  contribuyenteRimpe?: CONTRIBUYENTE_RIMPE_ENUM;
}

class TotalImpuestoModel {
  codigo: TAX_CODE_ENUM;
  codigoPorcentaje: number;
  baseImponible: number;
  valor: number;
  descuentoAdicional?: number;
}

class TotalConImpuestosModel {
  totalImpuesto: TotalImpuestoModel[];
}

class PagoModel {
  formaPago: PAYMENT_METHOD_CODE_ENUM;
  total: number;
  plazo?: number;
  unidadTiempo?: string;
}

class PagosModel {
  pago: PagoModel[];
}

class InfoFacturaModel {
  fechaEmision: Date;
  dirEstablecimiento: string;
  contribuyenteEspecial?: string;
  obligadoContabilidad?: OBLIGADO_CONTABILIDAD_ENUM;
  tipoIdentificacionComprador: IDENTIFICATION_CODE_ENUM;
  guiaRemision?: string;
  razonSocialComprador: string;
  identificacionComprador: string;
  direccionComprador?: string;
  totalSinImpuestos: number;
  totalDescuento: number;
  totalConImpuestos: TotalConImpuestosModel;
  propina: number;
  importeTotal: number;
  moneda?: string;
  pagos: PagosModel;
  valorRetIva?: number;
  valorRetRenta?: number;
}

class DetAdicionalModel {
  nombre: string;
  valor: string;
}

class ImpuestoDetalleModel {
  codigo: TAX_CODE_ENUM;
  codigoPorcentaje: number;
  tarifa: number;
  baseImponible: number;
  valor: number;
}

class DetallesAdicionalesModel {
  detAdicional: DetAdicionalModel[];
}

class ImpuestosModel {
  impuesto: ImpuestoDetalleModel[];
}

class DetalleModel {
  codigoPrincipal: string;
  codigoAuxiliar?: string;
  descripcion: string;
  cantidad: number;
  precioUnitario: number;
  descuento: number;
  precioTotalSinImpuesto: number;
  detallesAdicionales?: DetallesAdicionalesModel;
  impuestos: ImpuestosModel;
}

class CampoAdicionalModel {
  nombre: string;
  value: string;
}

class InfoAdicionalModel {
  campoAdicional: CampoAdicionalModel[];
}

class DetallesModel {
  detalle: DetalleModel[];
}

class RetencionModel {
  codigo: IMPUESTO_A_RETENER_ENUM;
  codigoPorcentaje: CODIGO_RETENCION_ENUM;
  tarifa: number;
  valor: number;
}

class RetencionesModel {
  retencion: RetencionModel[];
}

class ComprobanteModel {
  infoTributaria: InfoTributariaModel;
  infoFactura: InfoFacturaModel;
  detalles: DetallesModel;
  retenciones?: RetencionesModel;
  infoAdicional?: InfoAdicionalModel;
  /** Anexo 26 — RUC del proveedor del sistema de facturación (13 dígitos) */
  rucProveedor?: string;
}

type ComprobanteType = InstanceType<typeof ComprobanteModel>;

Enums

enum ENV_ENUM {
  TEST = 1,
  PROD = 2,
}
enum TAX_CODE_ENUM {
  VAT = 2,
  ICE = 3,
  IRBPNR = 5,
}
enum CONTRIBUYENTE_RIMPE_ENUM {
  RIMPE_GENERAL = "CONTRIBUYENTE RÉGIMEN RIMPE",
  RIMPE_POPULAR = "CONTRIBUYENTE NEGOCIO POPULAR - RÉGIMEN RIMPE",
}
enum OBLIGADO_CONTABILIDAD_ENUM {
  SI = "SI",
  NO = "NO",
}
enum PAYMENT_METHOD_CODE_ENUM {
  SIN_UTILIZACION_DEL_SISTEMA_FINANCIERO = "01",
  COMPENSACION_DE_DEUDAS = "15",
  TARJETA_DE_DEBITO = "16",
  DINERO_ELECTRONICO = "17",
  TARJETA_PREPAGO = "18",
  TARJETA_DE_CREDITO = "19",
  OTROS_CON_SISTEMA_FINANCIERO = "20",
  ENDOSO_DE_TITULOS = "21",
}
enum IDENTIFICATION_CODE_ENUM {
  RUC = "04",
  CEDULA = "05",
  PASAPORTE = "06",
  CONSUMIDOR_FINAL = "07",
  EXTERIOR = "08",
}
enum CODIGO_RETENCION_ENUM {
  IVA_CIENTO_POR_CIENTO_RESOLUCION = 3,
  IVA_DOCE_POR_CIENTO_PRESUNTIVO_EDITORES = 4,
  IVA_CIENTO_POR_CIENTO_DISTRIBUIDORES = 5,
  IVA_CIENTO_POR_CIENTO_VOCEADORES = 6,
  RENTA_DOS_POR_MIL = 327,
  RENTA_TRES_POR_MIL = 328,
}
enum IMPUESTO_A_RETENER_ENUM {
  IVA_PRESUNTIVO_Y_RENTA = 4,
}

Respuesta de `generateXmlInvoice(...)`

Esta función devuelve una promesa con el XML generado como cadena, y además el objeto convertido a JSON con la estructura del comprobante.

interface ResponseGenerateXmlModel {
  generatedXml: string;
  invoiceJson: InvoiceSriBuilder;
}

interface InvoiceSriBuilder {
  factura: FacturaInfo;
}

interface FacturaInfo {
  $: {
    id: string;
    version: string;
  };
  infoTributaria: InfoTributaria;
  infoFactura: InfoFactura;
  detalles: Detalles;
  retenciones: Retenciones;
  infoAdicional: InfoAdicional;
}

class Retenciones {
  retencion: Retencion[];
}

class Retencion {
  codigo: IMPUESTO_A_RETENER_ENUM;
  codigoPorcentaje: CODIGO_RETENCION_ENUM;
  tarifa: string;
  valor: string;
}

interface InfoTributaria {
  ambiente: number;
  tipoEmision: string;
  razonSocial: string;
  nombreComercial: string;
  ruc: string;
  claveAcceso: string;
  codDoc: string;
  estab: string;
  ptoEmi: string;
  secuencial: string;
  dirMatriz: string;
  contribuyenteRimpe?: string;
  agenteRetencion?: string;
}

interface InfoFactura {
  fechaEmision: string;
  dirEstablecimiento: string;
  contribuyenteEspecial?: string;
  obligadoContabilidad?: "SI" | "NO";
  comercioExterior?: string;
  incoTermFactura?: string;
  lugarIncoTerm?: string;
  paisOrigen?: string;
  puertoEmbarque?: string;
  puertoDestino?: string;
  paisDestino?: string;
  paisAdquisicion?: string;
  tipoIdentificacionComprador: string;
  guiaRemision?: string;
  razonSocialComprador: string;
  identificacionComprador: string;
  direccionComprador: string;
  totalSinImpuestos: string;
  incoTermTotalSinImpuestos?: string;
  totalDescuento: string;
  totalConImpuestos: {
    totalImpuesto: TotalImpuesto[];
  };
  propina: string;
  fleteInternacional?: number;
  seguroInternacional?: number;
  gastosAduaneros?: number;
  gastosTransporteOtros?: number;
  importeTotal: string;
  moneda: string;
  pagos: { pago: Pago[] };
  valorRetIva?: string;
  valorRetRenta?: string;
}

interface TotalImpuesto {
  codigo: TAX_CODE_ENUM;
  codigoPorcentaje: string;
  baseImponible: string;
  valor: string;
  descuentoAdicional?: string;
}

interface Detalles {
  detalle: Detalle[];
}

interface Pago {
  formaPago: string;
  total: string;
  plazo: number;
  unidadTiempo: string;
}

interface Detalle {
  codigoPrincipal: string;
  codigoAuxiliar: string;
  descripcion: string;
  cantidad: string;
  precioUnitario: string;
  descuento: string;
  precioTotalSinImpuesto: string;
  detallesAdicionales?: {
    detAdicional: DetAdicional[];
  };
  impuestos: {
    impuesto: ImpuestoDetalle[];
  };
}

interface DetAdicional {
  $: {
    nombre: string;
    valor: string;
  };
}

interface ImpuestoDetalle {
  codigo: TAX_CODE_ENUM;
  codigoPorcentaje: string;
  tarifa: string;
  baseImponible: string;
  valor: string;
}

interface InfoAdicional {
  campoAdicional: CampoAdicional[];
}

interface CampoAdicional {
  $: {
    nombre: string;
  };
  _: string;
}