Modulo isisystem-soap

Modulo `isisystem-soap`

Este modulo es la fuente unica de verdad sobre la comunicacion SOAP/XML entre ms-credigestion y los servicios WCF de ISISYSTEM. Todos los modulos de negocio (Consumo, Pagos) consumen este modulo en lugar de hablar directamente con los servicios remotos.

Quien usa este modulo: Consumo y Pagos.

Vision General

isisystem-soap es un modulo global de NestJS que encapsula toda la comunicacion SOAP/XML con ISISYSTEM. El resto de la aplicacion solo trabaja con objetos TypeScript tipados.

ServicioDeNegocio (Consumo / Pagos)
    |
    +-- buildXml(params)                    <-- xml-templates.ts
    |
    +-- soap.callSoap({url, action, xml})   <-- isisystem-soap.service.ts
    |       |
    |       +-- fetch() POST text/xml
    |       +-- AbortController timeout
    |       `-- fast-xml-parser -> parse
    |
    `-- parseResponse(body)                 <-- response-parsers.ts

Estructura de Archivos

src/isisystem-soap/
|-- isisystem-soap.module.ts     # @Global() module - exporta IsisystemSoapService
|-- isisystem-soap.service.ts    # Cliente SOAP generico (fetch + timeout + XML parsing)
|-- xml-templates.ts             # Funciones puras que generan XML SOAP completo
`-- response-parsers.ts          # Parsers tipados que extraen datos de respuestas SOAP

Servicios WCF de ISISYSTEM

ISISYSTEM expone dos servicios WCF con distintas operaciones. Ambos viven en el mismo host pero con paths diferentes.

Servicio	URL	Operaciones
Cartera	`http://186.5.126.42:8092/Cartera/ServicioCartera.svc`	ConsultarTarjeta, GrabarAutorizacion, GrabarConsumo, GrabarReversoAutorizacion, GrabarReversoConsumo, ConsultarDeudaTarjeta, GrabarPagoTarjeta, GrabarReversoPagoTarjeta
Central	`http://186.5.126.42:8092/Central/ServicioCentral.svc`	ConsultarAlternativaFinanciacion

El stack upstream esta desarrollado en Visual Studio MVC 5 sobre .NET Framework 4.7.2.

Constantes Inyectadas Automaticamente

Estas constantes se inyectan en cada llamada SOAP y no se aceptan desde el body del request del cliente.

Constante	Valor por defecto	Variable de entorno
Usuario	`USUARIOASI`	`ISISYSTEM_USUARIO`
Codigo Empresa	`000598`	`ISISYSTEM_CODIGO_EMPRESA`
Terminal	`NOVISUITE-01`	`ISISYSTEM_TERMINAL`
Timeout	`30` segundos	`ISISYSTEM_TIMEOUT`

`IsisystemSoapService`

Servicio inyectable que:

Recibe SoapCallOptions { serviceUrl, soapAction, xmlBody }
Hace fetch() POST con Content-Type: text/xml;charset=UTF-8 y header SOAPAction
Maneja timeout con AbortController (por defecto 30 s)
Parsea la respuesta XML con fast-xml-parser (removeNSPrefix: true)
Extrae el <Body> del envelope SOAP
Devuelve un objeto JavaScript plano

Getters publicos: carteraUrl, centralUrl, usuario, codigoEmpresa, terminal.

Metodo checkSoapError(result, operation): detecta lError: true en la respuesta y lanza BadGatewayException (HTTP 502) con el detalle del error.

`xml-templates.ts` — Builders XML

Funciones puras que generan SOAP envelopes completos con los namespaces exactos de ISISYSTEM.

Funcion	SOAPAction	Servicio	Estado
`buildConsultarTarjetaXml`	`http://tempuri.org/IServicioCar/ConsultarTarjeta`	Cartera	Implementada
`buildConsultarAlternativaFinanciacionXml`	`http://tempuri.org/IServicioCen/ConsultarAlternativaFinanciacion`	Central	Implementada
`buildGrabarAutorizacionXml`	`http://tempuri.org/IServicioCar/GrabarAutorizacion`	Cartera	Implementada
`buildGrabarConsumoXml`	`http://tempuri.org/IServicioCar/GrabarConsumo`	Cartera	Implementada
`buildGrabarReversoAutorizacionXml`	`http://tempuri.org/IServicioCar/GrabarReversoAutorizacion`	Cartera	Implementada
`buildGrabarReversoConsumoXml`	`http://tempuri.org/IServicioCar/GrabarReversoConsumo`	Cartera	Implementada
`buildConsultarDeudaTarjetaXml`	`http://tempuri.org/IServicioCar/ConsultarDeudaTarjeta`	Cartera	Pendiente
`buildGrabarPagoTarjetaXml`	`http://tempuri.org/IServicioCar/GrabarPagoTarjeta`	Cartera	Pendiente
`buildGrabarReversoPagoTarjetaXml`	`http://tempuri.org/IServicioCar/GrabarReversoPagoTarjeta`	Cartera	Pendiente

Namespaces Utilizados

xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
xmlns="http://tempuri.org/" (operaciones)
xmlns:d4p1="http://schemas.datacontract.org/2004/07/Car.Data.LineaCredito" (Cartera DTOs de credito)
xmlns:d4p1="http://schemas.datacontract.org/2004/07/Car.Data.Pago" (Cartera DTOs de pago)
xmlns:d5p1="http://schemas.datacontract.org/2004/07/Cen.Data.General" (Central DTOs y articulos)

Todas las funciones usan esc() para sanitizar XML entities (&, <, >, ", ').

`response-parsers.ts` — Parsers de Respuesta

Funciones tipadas que extraen datos de las respuestas SOAP parseadas:

Funcion	Interfaz resultado	Estado
`parseConsultarTarjetaResponse`	`ConsultarTarjetaParsed`	Implementada
`parseAlternativaFinanciacionResponse`	`FinanciacionOpcion[]`	Implementada
`parseGrabarAutorizacionResponse`	`GrabarAutorizacionParsed`	Implementada
`parseGrabarConsumoResponse`	`GrabarConsumoParsed`	Implementada
`parseGrabarReversoResponse`	`GrabarReversoParsed`	Implementada
`parseGrabarReversoConsumoResponse`	`GrabarReversoConsumoParsed`	Implementada
`parseConsultarDeudaTarjetaResponse`	`ConsultarDeudaTarjetaParsed`	Pendiente
`parseGrabarPagoTarjetaResponse`	`GrabarPagoTarjetaParsed`	Pendiente
`parseGrabarReversoPagoTarjetaResponse`	`GrabarReversoPagoTarjetaParsed`	Pendiente

Manejo de Errores ISISYSTEM

Todas las respuestas SOAP de ISISYSTEM incluyen estos campos de control:

Campo	Tipo	Descripcion
`lError`	boolean	`false` = exito, `true` = error
`cTextoError`	string	Detalle del error presentado
`nNumeroError`	number	Nivel de error: `0` = exito, `1` = error de proceso, `2` = validacion controlada

Cuando lError = true, el servicio lanza BadGatewayException (HTTP 502) con:

{
  "message": "ISISYSTEM rechazo la operacion: <nombre_operacion>",
  "upstreamMessage": "<cTextoError>",
  "operation": "<nombre_operacion>",
  "errorCode": "<nNumeroError>"
}

Errores de Conectividad

Escenario	HTTP	Detalle
Timeout (no responde en 30 s)	504	`GatewayTimeoutException`
HTTP no-200	502	`BadGatewayException` con el status code de ISISYSTEM
Error de conexion (red caida)	502	`BadGatewayException` con el mensaje del error

Detalle de Operaciones SOAP

`ConsultarTarjeta`

Devuelve la informacion de la linea de credito (cupo, saldos, datos del cliente).

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/ConsultarTarjeta

Parametros de Entrada

Campo	Tipo	Obligatorio	Descripcion
`cNumeroTarjeta`	Texto(20)	Condicional	Obligatorio si no viene `cNumeroIdentificacion`
`cNumeroIdentificacion`	Texto(20)	Condicional	Obligatorio si no viene `cNumeroTarjeta`
`cUsuario`	Texto(10)	Si	Usuario asignado
`cCodigoEmpresa`	Texto(6)	Si	Codigo de empresa asignado

Request de Ejemplo

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <ConsultarTarjeta xmlns="http://tempuri.org/">
      <cNumeroTarjeta></cNumeroTarjeta>
      <cUsuario>USUARIOASI</cUsuario>
      <cCodigoEmpresa>000598</cCodigoEmpresa>
      <cNumeroIdentificacion>0916884245</cNumeroIdentificacion>
    </ConsultarTarjeta>
  </s:Body>
</s:Envelope>

Parametros de Salida

Campo	Tipo	Descripcion
`cTextoError`	Texto(250)	Motivo del error
`lError`	Booleano	`true` = no es valida para consumir, `false` = exito
`nNumeroError`	Numerico(3)	Nivel de error
`cCodigoDactilar`	Texto(10)	Codigo dactilar si esta registrado
`cCodigoEmpresaOpeBase`	Texto(6)	Empresa de la linea de credito
`cNombreCliente`	Texto(100)	Apellidos y nombres del cliente
`cNumeroTarjeta`	Texto(20)	Numero de tarjeta de la linea de credito
`dFechaActivacion`	Fecha	Fecha de activacion de la linea
`dFechaUltimaCompra`	Fecha	Fecha de la ultima compra
`dFechaUltimoPago`	Fecha	Fecha del ultimo pago
`nCodigoCliente`	Numerico(18)	Codigo interno del cliente
`oTipoCupo`	Subclase	Lista de cupos del cliente (ver subclases)
`oSubCupo`	Subclase	Sub cupos por tipo de operacion (ver subclases)

Response de Ejemplo

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <ConsultarTarjetaResponse xmlns="http://tempuri.org/">
      <ConsultarTarjetaResult xmlns:a="http://schemas.datacontract.org/2004/07/Car.Data.LineaCredito" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <cTextoError xmlns="http://schemas.datacontract.org/2004/07/Cen.Data.General"/>
        <lError xmlns="http://schemas.datacontract.org/2004/07/Cen.Data.General">false</lError>
        <nNumeroError xmlns="http://schemas.datacontract.org/2004/07/Cen.Data.General">0</nNumeroError>
        <a:cCodigoEmpresaOpeBase>000598</a:cCodigoEmpresaOpeBase>
        <a:cNombreCliente>PATERNO MATERNO NOMBRE SEGUNDO</a:cNombreCliente>
        <a:cNumeroTarjeta>0916884245</a:cNumeroTarjeta>
        <a:dFechaActivacion>2024-02-23T00:00:00</a:dFechaActivacion>
        <a:dFechaUltimaCompra>2026-03-25T00:00:00</a:dFechaUltimaCompra>
        <a:dFechaUltimoPago>2024-06-19T00:00:00</a:dFechaUltimoPago>
        <a:nCodigoCliente>409912</a:nCodigoCliente>
        <a:oTipoCupo>
          <a:oTipoCupoVm>
            <a:cCodigoTipoCupo>003</a:cCodigoTipoCupo>
            <a:cDescripcionTipoCupo>Tarjeta Credito General</a:cDescripcionTipoCupo>
            <a:cFrecuenciaCupo>Mensual</a:cFrecuenciaCupo>
            <a:nCupoAsignado>0</a:nCupoAsignado>
            <a:nCupoDisponible>850</a:nCupoDisponible>
            <a:nCupoUtilizado>0</a:nCupoUtilizado>
          </a:oTipoCupoVm>
        </a:oTipoCupo>
      </ConsultarTarjetaResult>
    </ConsultarTarjetaResponse>
  </s:Body>
</s:Envelope>

`ConsultarAlternativaFinanciacion`

Calcula las cuotas disponibles segun el producto financiero y el cupo del cliente.

URL: http://186.5.126.42:8092/Central/ServicioCentral.svc
SOAPAction: http://tempuri.org/IServicioCen/ConsultarAlternativaFinanciacion

Parametros de Entrada

Campo	Tipo	Obligatorio	Descripcion
`cCodigoEmpresa`	Texto(6)	Si	Codigo de empresa asignado
`cCodigoProducto`	Texto(3)	Si	Producto financiero a consultar
`cCodigoTipoCupo`	Texto(3)	Si	Codigo de tipo de cupo
`cCodigoTipoOperacion`	Texto(3)	No	Codigo del tipo de operacion
`cTarjeta`	Texto(20)	Si	Numero de tarjeta o linea de credito
`cUsuario`	Texto(10)	Si	Usuario asignado
`lGarantiaExtendida`	Booleano	No	`true` para incluir garantia extendida
`nCupoDisponible`	Numerico(18,2)	Si	Enviar `0`
`nValorConsumo`	Numerico(9,2)	Si	Valor a diferir
`nValorVenta`	Numerico(9,2)	No	Valor de venta total
`ArticulosConsumoVm`	Subclase	No	Solo si se manejan articulos (ver subclases)

Request de Ejemplo

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <ConsultarAlternativaFinanciacion xmlns="http://tempuri.org/">
      <oFinan xmlns:d4p1="http://schemas.datacontract.org/2004/07/Cen.Data.General">
        <d4p1:cCodigoEmpresa>000598</d4p1:cCodigoEmpresa>
        <d4p1:cCodigoProducto>004</d4p1:cCodigoProducto>
        <d4p1:cCodigoTipoCupo>003</d4p1:cCodigoTipoCupo>
        <d4p1:cCodigoTipoOperacion />
        <d4p1:cTarjeta>0916884245</d4p1:cTarjeta>
        <d4p1:cUsuario>USUARIOASI</d4p1:cUsuario>
        <d4p1:lGarantiaExtendida>false</d4p1:lGarantiaExtendida>
        <d4p1:nCupoDisponible>0</d4p1:nCupoDisponible>
        <d4p1:nValorConsumo>400</d4p1:nValorConsumo>
        <d4p1:nValorVenta>400</d4p1:nValorVenta>
      </oFinan>
    </ConsultarAlternativaFinanciacion>
  </s:Body>
</s:Envelope>

Parametros de Salida (varios registros `oFinanciacionVm`)

Campo	Tipo	Descripcion
`cTextoError`	Texto(250)	Texto del error
`lError`	Booleano	`true` = error
`nNumeroError`	Numerico(3)	Nivel de error
`cNovedad`	Texto(250)	Vacio
`fCuotaGarantiaExtendida`	Numerico(9,2)	Valor de la cuota mas garantia extendida
`fCuotaMensual`	Numerico(9,2)	Valor de la cuota mensual
`fInteresTotal`	Numerico(9,2)	Interes total
`fdeudaTotal`	Numerico(9,2)	Capital mas interes
`iPlazo`	Numerico(3)	Plazo de cada opcion
`nCuotaEntradaMinima`	Numerico(9,2)	Cuota inicial minima

`GrabarAutorizacion`

Genera un numero de autorizacion y compromete el cupo del cliente.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/GrabarAutorizacion

Parametros de Entrada

Campo	Tipo	Obligatorio	Descripcion
`cCodigoEmpresa`	Texto(6)	Si	Codigo de empresa asignado
`cCodigoProducto`	Texto(3)	Si	Producto seleccionado
`cCodigoTipoCupo`	Texto(3)	No	Tipo de cupo
`cCodigoTipoOperacion`	Texto(3)	No	Codigo del tipo de operacion
`cNumeroTarjeta`	Texto(20)	Si	Numero de la linea de credito
`cTerminal`	Texto(15)	Si	Nombre del equipo del usuario
`cUsuario`	Texto(10)	Si	Usuario asignado
`lGarantiaExtendida`	Booleano	No	`true` para incluir garantia extendida
`nCuotaInicial`	Numerico(9,2)	No	Valor de anticipo (puede ser `0`)
`nPlazo`	Numerico(3)	Si	Plazo seleccionado
`nValorConsumo`	Numerico(9,2)	Si	Valor del consumo
`ArticulosConsumoVm`	Subclase	No	Detalle de articulos (ver subclases)

Parametros de Salida

Campo	Tipo	Descripcion
`cTextoError`	Texto(250)	Texto del error
`lError`	Booleano	`true` = error
`nNumeroError`	Numerico(3)	Nivel de error
`cImagenQR`	Base64 string	QR del link de prueba de vida
`cNumeroAutorizacion`	Texto(20)	Numero de autorizacion generado
`lCodigoSeguridadEnviado`	Booleano	`true` = esperar prueba de vida del cliente
`nNumeroOperacion`	Numerico(9)	Numero de operacion generada
`nNumeroOperacionGEX`	Numerico(9)	Numero de operacion de garantia extendida

Response de Ejemplo

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <GrabarAutorizacionResponse xmlns="http://tempuri.org/">
      <GrabarAutorizacionResult xmlns:a="http://schemas.datacontract.org/2004/07/Car.Data.LineaCredito">
        <cTextoError xmlns="http://schemas.datacontract.org/2004/07/Cen.Data.General"/>
        <lError xmlns="http://schemas.datacontract.org/2004/07/Cen.Data.General">false</lError>
        <nNumeroError xmlns="http://schemas.datacontract.org/2004/07/Cen.Data.General">0</nNumeroError>
        <a:cNumeroAutorizacion>14022</a:cNumeroAutorizacion>
        <a:lCodigoSeguridadEnviado>false</a:lCodigoSeguridadEnviado>
        <a:nNumeroOperacion>3433019</a:nNumeroOperacion>
        <a:nNumeroOperacionGEX>0</a:nNumeroOperacionGEX>
      </GrabarAutorizacionResult>
    </GrabarAutorizacionResponse>
  </s:Body>
</s:Envelope>

`GrabarReversoAutorizacion`

Anula una autorizacion antes de facturar y libera el cupo en transito.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/GrabarReversoAutorizacion

Parametros de Entrada

Campo	Tipo	Obligatorio	Descripcion
`cNumeroAutorizacion`	Texto(20)	Si	Sin espacios a la izquierda
`cNumeroIdentificacion`	Texto(20)	No	Sin espacios a la izquierda
`cNumeroTarjeta`	Texto(20)	No	Sin espacios a la izquierda
`cTerminal`	Texto(15)	Si	Nombre del equipo del usuario
`cUsuario`	Texto(10)	Si	Usuario asignado
`lAjusteConciliacion`	Booleano	No	Enviar `false`

Parametros de Salida

Campo	Tipo	Descripcion
`cTextoError`	Texto(250)	Texto del resultado o error
`lError`	Booleano	`true` = error, `false` = reverso realizado
`nNumeroError`	Numerico(3)	Nivel de error

`GrabarConsumo`

Confirma el consumo asociandolo a un numero de factura. Si la autorizacion requirio OTP, este se envia en cCodigoOtp. ISISYSTEM valida el OTP en este paso.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/GrabarConsumo

Parametros de Entrada

Campo	Tipo	Obligatorio	Descripcion
`cCodigoMoneda`	Texto(3)	Si	`USD`
`cCodigoOtp`	Texto(6)	No	Codigo OTP del cliente
`cCodigoProducto`	Texto(3)	Si	Producto financiero
`cCodigoTipoCupo`	Texto(3)	No	Tipo de cupo
`cCodigoTipoOperacion`	Texto(3)	No	Tipo de operacion
`cNumeroAutorizacion`	Texto(20)	Si	Sin espacios a la izquierda
`cNumeroDocumento`	Texto(20)	Si	Numero de factura
`cNumeroIdentificacion`	Texto(20)	No	Sin espacios a la izquierda
`cNumeroTarjeta`	Texto(20)	Si	Sin espacios a la izquierda
`cTerminal`	Texto(15)	Si	Nombre del equipo
`cUsuario`	Texto(10)	Si	Usuario asignado
`dFechaConsumo`	Fecha	Si	Formato `yyyy-mm-dd`
`nCuotaInicial`	Numerico(18,2)	No	Anticipo
`nPlazo`	Numerico(2)	Si	Plazo del consumo
`nTotalVenta`	Numerico(18,2)	No	Total de la venta
`nValorComision`	Numerico(18,2)	No	Comision
`nValorConsumo`	Numerico(18,2)	Si	Capital incluido IVA
`nValorIVA`	Numerico(9,2)	No	Valor del IVA

Parametros de Salida

Campo	Tipo	Descripcion
`cTextoError`	Texto(250)	Texto del error o novedad
`lError`	Booleano	`true` = error, `false` = consumo realizado
`nNumeroError`	Numerico(3)	Nivel de error
`dFechaMaxPago`	Fecha	Fecha maxima del pago minimo
`nNumeroOperacion`	Numerico(9)	Numero de operacion generada
`nPagoMinimo`	Numerico(18,2)	Pago minimo a la fecha de corte
`nSaldoActual`	Numerico(18,2)	Deuda total del cliente
`nValorCuota`	Numerico(18,2)	Monto de la primera cuota
`oCuotasOperacionVm`	Subclase	Tabla de amortizacion (ver subclases)
`oTiposCupoVm`	Subclase	Cupos afectados (ver subclases)

`GrabarReversoConsumo`

Reversa un consumo ya confirmado y restituye el cupo del cliente.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/GrabarReversoConsumo

Parametros de Entrada

Campo	Tipo	Obligatorio	Descripcion
`cNumeroReferencia`	Texto(20)	Si	Numero de factura
`cNumeroTarjeta`	Texto(20)	Si	Numero de tarjeta o cedula
`cTerminal`	Texto(15)	Si	Nombre del equipo
`cUsuario`	Texto(10)	Si	Usuario asignado
`lAjusteConciliacion`	Booleano	No	Enviar `false`

Parametros de Salida

Campo	Tipo	Descripcion
`cTextoError`	Texto(250)	Texto del resultado o error
`lError`	Booleano	`true` = error, `false` = reverso realizado
`nNumeroError`	Numerico(3)	Nivel de error

`ConsultarDeudaTarjeta` (pendiente de implementar)

Consulta el valor a pagar de un cliente. Incluye pago de contado, pago minimo, mora, gestion y vencidos.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/ConsultarDeudaTarjeta

Ver detalle completo en Pagos.

`GrabarPagoTarjeta` (pendiente de implementar)

Aplica un pago al cliente segun la prelacion parametrizada por la empresa. Recalcula mora, gestion y descuentos por pago anticipado.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/GrabarPagoTarjeta

Ver detalle completo en Pagos.

`GrabarReversoPagoTarjeta` (pendiente de implementar)

Reversa un pago previamente aplicado y devuelve los rubros para emision de NC en MBA3.

URL: http://186.5.126.42:8092/Cartera/ServicioCartera.svc
SOAPAction: http://tempuri.org/IServicioCar/GrabarReversoPagoTarjeta

Ver detalle completo en Pagos.

Subclases Reutilizables

Estas subclases aparecen en multiples respuestas. Se documentan aqui una sola vez y se referencian desde Consumo y Pagos.

`oTipoCupoVm`

Cupos del cliente, devuelto por ConsultarTarjeta, GrabarConsumo y GrabarPagoTarjeta.

Campo	Tipo	Descripcion
`cCodigoTipoCupo`	Texto(3)	Tipo de cupo (lista homologada)
`cDescripcionTipoCupo`	Texto(50)	Descripcion del tipo de cupo
`cFrecuenciaCupo`	Texto(20)	Frecuencia del cupo
`cAutorizaImpresionTC`	Texto(1)	Bandera de autorizacion de impresion
`cDescripcionTipoTarjeta`	Texto(50)	Descripcion de la tarjeta
`cNombreCliente`	Texto(50)	Nombre del cliente
`cNumeroIdentificacion`	Texto(20)	Identificacion del cliente
`cNumeroTarjeta`	Texto(20)	Numero de tarjeta
`nCupoAsignado`	Decimal	Cupo asignado
`nCupoDisponible`	Decimal	Cupo disponible
`nCupoUtilizado`	Decimal	Cupo utilizado
`nValorExtracupo`	Decimal	Valor de extracupo

`oSubCupo`

Sub cupos por tipo de operacion devueltos por ConsultarTarjeta.

Campo	Tipo	Descripcion
`cCodigoTipoOperacion`	Texto(3)	Codigo del tipo de operacion (lista homologada)
`cDescripcionTipoOperacion`	Texto(50)	Descripcion del tipo de operacion
`cFrecuenciaCupo`	Texto(20)	Frecuencia del subcupo
`nCupoDisponibleOpe`	Numerico(10,2)	Cupo disponible por tipo de operacion
`nPlazoMaximo`	Numerico(3)	Plazo maximo

`ArticulosConsumoVm`

Articulos enviados en ConsultarAlternativaFinanciacion y GrabarAutorizacion.

Campo	Tipo	Obligatorio	Descripcion
`cCodigoArticulo`	Texto(20)	No	Codigo del articulo
`cTextoArticulo`	Texto(100)	Si	Descripcion del articulo
`nCantidad`	Numerico(3)	Si	Cantidad
`nPrecio`	Numerico(9,2)	Si	Precio incluyendo impuestos
`cCodigoTipoArticulo`	Texto(3)	No	Tipo del articulo (lista homologada)
`cCaracteristicas`	Texto(200)	No	Codigos y caracteristicas concatenados (`025:AZUL-026:23x45`)

`oCuotasOperacionVm`

Tabla de amortizacion devuelta por GrabarConsumo.

Campo	Tipo	Descripcion
`nNumeroCuota`	Numerico(3)	Numero de cuota
`nDiasVista`	Numerico(5)	Dias entre cuotas
`dFechaVencimiento`	Fecha	Fecha de vencimiento
`nValorCapital`	Numerico(18,2)	Valor del capital
`nValorInteres`	Numerico(18,2)	Valor del interes
`nValorCuota`	Numerico(18,2)	Total de la cuota
`nCapitalReducido`	Numerico(18,2)	Capital remanente

`iFormaPagoVm`

Detalle de forma de pago para GrabarPagoTarjeta.

Campo	Tipo	Obligatorio	Descripcion
`cCodigoFormaPago`	Texto(3)	Si	Codigo de la forma de pago
`nValorFormaPago`	Numerico(18,2)	Si	Valor de la forma de pago
`cInstitucionFinanciera`	Texto(20)	Condicional	Codigo de banco (cheque)
`cNumeroDocumento`	Texto(20)	Condicional	Numero de cheque
`cNumeroCuenta`	Texto(20)	Condicional	Numero de cuenta (cheque)
`cIdentCuentaCorrentista`	Texto(20)	Condicional	Identificacion del cuenta correntista
`cNombreCuentaCorrentista`	Texto(20)	Condicional	Nombre del cuenta correntista

Regla: los campos condicionales se llenan solo cuando la forma de pago es Cheque. En Efectivo deben venir vacios.

`oFacturaAfectadaVm`

Resumen de facturas afectadas por un pago. Devuelto por GrabarPagoTarjeta y GrabarReversoPagoTarjeta.

Campo	Tipo	Descripcion
`cNumeroFactura`	Texto(20)	Numero de factura aplicada
`nValor`	Numerico(18,2)	Valor aplicado

`oRubroAplicadoVm`

Detalle de rubros aplicados en un pago. Devuelto por GrabarPagoTarjeta y GrabarReversoPagoTarjeta.

Campo	Tipo	Descripcion
`cCodigoRubro`	Texto(3)	Codigo del rubro (lista homologada)
`cTipoDocumento`	Texto(3)	`F` = Factura, `D` = Nota de Debito, `N` = Nota de Credito
`nValor`	Numerico(18,2)	Valor aplicado

Modulo isisystem-soap

Modulo isisystem-soap

Vision General

Estructura de Archivos

Servicios WCF de ISISYSTEM

Constantes Inyectadas Automaticamente

IsisystemSoapService

xml-templates.ts — Builders XML

Namespaces Utilizados

response-parsers.ts — Parsers de Respuesta

Manejo de Errores ISISYSTEM

Errores de Conectividad

Detalle de Operaciones SOAP

ConsultarTarjeta

Parametros de Entrada

Request de Ejemplo

Parametros de Salida

Response de Ejemplo

ConsultarAlternativaFinanciacion

Parametros de Entrada

Request de Ejemplo

Parametros de Salida (varios registros oFinanciacionVm)

GrabarAutorizacion

Parametros de Entrada

Parametros de Salida

Response de Ejemplo

GrabarReversoAutorizacion

Parametros de Entrada

Parametros de Salida

GrabarConsumo

Parametros de Entrada

Parametros de Salida

GrabarReversoConsumo

Parametros de Entrada

Parametros de Salida

ConsultarDeudaTarjeta (pendiente de implementar)

GrabarPagoTarjeta (pendiente de implementar)

GrabarReversoPagoTarjeta (pendiente de implementar)

Subclases Reutilizables

oTipoCupoVm

oSubCupo

ArticulosConsumoVm

oCuotasOperacionVm

iFormaPagoVm

oFacturaAfectadaVm

oRubroAplicadoVm

Modulo `isisystem-soap`

`IsisystemSoapService`

`xml-templates.ts` — Builders XML

`response-parsers.ts` — Parsers de Respuesta

`ConsultarTarjeta`

`ConsultarAlternativaFinanciacion`

Parametros de Salida (varios registros `oFinanciacionVm`)

`GrabarAutorizacion`

`GrabarReversoAutorizacion`

`GrabarConsumo`

`GrabarReversoConsumo`

`ConsultarDeudaTarjeta` (pendiente de implementar)

`GrabarPagoTarjeta` (pendiente de implementar)

`GrabarReversoPagoTarjeta` (pendiente de implementar)

`oTipoCupoVm`

`oSubCupo`

`ArticulosConsumoVm`

`oCuotasOperacionVm`

`iFormaPagoVm`

`oFacturaAfectadaVm`

`oRubroAplicadoVm`