Lapachos Lending : Integración con BeSmart

El Servicio de Consulta al Motor de Decisión ofrece una interfaz basada en SOAP
para acceder a un motor de decisiones de alta precisión y eficiencia. Este servicio
permite a los usuarios enviar consultas sobre diversos aspectos de la información de
clientes mediante un mensaje SOAP estructurado, y recibir respuestas detalladas en un
formato igualmente estructurado.

Protocolo: SOAP sobre HTTPS

Endpoints Principales

Entorno	URL SOAP
Pruebas	http://motorxia_test.besmart.com.ar:8074/WS_CES_Security_PAC/WS_Informacion.svc
Producción	https://motorxia.besmart.com.ar:8073/WS_CES_Security_PAC/WS_Informacion.svc

Estructura de la solicitud

<x:Envelope
  xmlns:x="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:tem="http://tempuri.org/"
  xmlns:bes="http://schemas.datacontract.org/2004/07/besmart_ws">
  <x:Header/>
  <x:Body>
    <tem:Consulta>
    <tem:Campos_Consulta>
    <bes:IdConsulta>EF-UNIQUE-ID</bes:IdConsulta>
    <bes:Password>PASS_PROVIDED</bes:Password>
    <bes:TramaConsulta>CAMPO1|CAMPO2|...|CAMPO63</bes:TramaConsulta>
    <bes:Usuario>USER_PROVIDED</bes:Usuario>
    </tem:Campos_Consulta>
    </tem:Consulta>
  </x:Body>
</x:Envelope>

Campos críticos de la consulta

Campo	Descripción
IdConsulta	Este campo representa una referencia generada en el momento en que se realiza la consulta. Será devuelto sin modificaciones. Su propósito es vincular la consulta con la respuesta en escenarios asincrónicos.
Usuario	Proporcionado por el proveedor del servicio.
Password	Proporcionado por el proveedor del servicio.
TramaConsulta	Cadena concatenada de los campos acordados con el usuario del sistema, necesarios para realizar la consulta. Cada campo tiene una posición fija dentro de la trama. Los campos no obligatorios pueden ser nulos, respetando su posición en la trama y dejando el valor vacío. El delimitador de los campos es el carácter “\|” , por lo que este carácter no debe ser utilizado dentro de los valores o contenidos de los campos de la trama.

Manejo de Respuestas
1. Estructura Exitosa (Estado=0)
  1. <a:Estado>0</a:Estado>
2. Códigos de Error (Estado ≠ 0)

<s:Envelope
xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ConsultaResponse
xmlns="http://tempuri.org/">
<ConsultaResult
xmlns:a="http://schemas.datacontract.org/2004/07/besmart_ws"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Estado></a:Estado>
<a:IdConsulta></a:IdConsulta>
<a:Referencia/>
<a:TramaRespuesta> </a:TramaRespuesta>
</ConsultaResult>
</ConsultaResponse>
</s:Body>
</s:Envelope>

Códigos de Estado:
• 0: Respuesta generada exitosamente.
• 1: El mensaje está incompleto o el formato no es válido según el WSDL.
• 2: El IdConsulta no puede ser nulo.
• 3: Usuario o contraseña incorrectos.

• 4: Usuario o contraseña no pueden ser nulos.
• 5: La TramaConsulta no está bien formada.
• 9: Consulta duplicada (repetida en los últimos 4 segundos).

Headers

Clave	Valor
Content-Type	text/xml; charset=utf-8
SOAPAction	http://tempuri.org/IWS_Informacion/Consulta

Diagrama de Proceso

Código Mermaid

sequenceDiagram
    participant Lend2B
    participant BeSmart as Motorxia (BeSmart)

    Lend2B->>Lend2B: Construye TramaConsulta (63 campos)
    Lend2B->>BeSmart: Envía solicitud SOAP
    Note over Lend2B,BeSmart: Campos clave:<br/>- CUIL (pos4)<br/>- DOC.NRO (pos5)<br/>- INGRESO_DEMOSTRADO (pos18)
    BeSmart-->>Lend2B: Respuesta SOAP (Estado, TramaRespuesta)
    alt Estado == 0
        Lend2B->>Lend2B: Procesa respuesta<br/>- Dictamen (pos64)<br/>- ScoreNosis (pos105)<br/>- NivelRiesgo (pos76)
    else Estado > 0
        Lend2B->>Lend2B: Maneja error<br/>(Código: 1-9)
    end

Documentación BeSmart

Lapachos Lending : Integración con BeSmart

Attachments: