Caja Vecina

Disponible para

Chile

WEBSERVICE CAJA VENCINA

Mikrowisp viene integrado con un webservice específico para Banco estado, a este webservice Banco Estado podrá consultar Las facturas pendientes de pago de un cliente y podrá Pagarla utilizando el webservice.

La url del webservices es http://misistema.com/bancoestado/web/?wdsll donde misistema.com es el dominio de nuestro sistema mikrowisp.

El modelo de Integración es: Webservice
Tipo de Integración: En Línea

Se debe solicitar a Banco estado como Requerimiento el campo: IDCLIENTE el cual va identificar al cliente al momento de realizar sus pagos.

📘
FORMATO IDENTIFICACION CLIENTE/RUT
El número de identificación del cliente en mikrowisp debe ser el formato 12345678-9

El webservice cuenta con 2 metodos:

consultarCliente: Permite consultar las facturas del cliente.
registrarPago: Permite Pagar una factura.

🚧
HTTPS
Para utilizar el webservice en HTTPS nuestro servidor debe contar con un certificado SSL de pago, los certificados gratis no son aceptados por Banco Estado.

ESTRUCTURA XML

Estos datos son importantes para completar nuestro ATO.

CONSULTAR CLIENTE
Estructura 1: Estructura XML consultarCliente

<consultarC1iente>
<rutCliente>l036l0761</rutC1iente>
</consultarC1iente>

ATRIBUTO	TIPO	LARGO	Descripción.
ConsultarCliente	Función
rutCliente	String	10	Rut a consultar, formato sin guión.

Estructura 2: Estructura XML respuesta (Consulta)

<RESPUESTA>
<CLIENTE>
<ID_CLIENTE>000001</ID_CLIENTE>
<RUT_CLIENTE>169845727</RUT_CLIENTE>
<FECHA_VENCIMIENTO>2019-02-28</FECHA_VENCIMIENTO>
<TOTAL>100.00</TOTAL>
</CLIENTE>
<ERRORES>
<CODIGO_ERROR>0</CODIGO_ERROR>
<DESCRIPCION_ERROR></DESCRIPCION_ERROR>
</ERRORES>
</RESPUESTA>

ATRIBUTO	TIPO	LARGO	Descripción
Tag consultarCliente	Element
CODIGO_ERROR	Numeric	1	Corresponde al código que identifica el error. 0= Sin errores 1= Problema con el servicio. 2= No hay factura por pagar. 3= No existe ningún cliente con Rut indicado.
DESCRIPCION_ERROR	STRING	1000	Corresponde a la descripción del error.

ATRIBUTO	TIPO	LARGO	Descripción
TAG CLIENTE	ELEMENT
ID_CLIENTE	NUMERIC	9	ID del cliente
RUT_CLIENTE	STRING	10	RUT cliente, formato sin guión.
FECHA_VENCIMIENTO	DATE		Fecha de vencimiento formato AAAA-MM-DD
TOTAL	NUMERIC	18	Monto total a pagar

REALIZAR PAGO
Estructura 3: Estructura XML realizarPago

<registrarPago>
<rutCliente>l03610765</rutC1iente>
<factura>00000005</factura>
<monto>l000</monto>
<descripcion>l158627</descripcion>
<pasare1a>web</pasare1a>
<transaccion>594012</transaccion>
</registrarPago>

ATRIBUTO	TIPO	LARGO	Descripción
rutCliente	string	10	Rut del cliente sin guiones
factura	numeric	8	ID factura a pagar
monto	numeric	18	monto a pagar
descripcion	string	18	Alguna nota sobre el pago
pasarela	string	18	tipo de pago(oficina,web,etc)
transaccion	Numeric	18	Nº de transacción (Opcional)

<RESPUESTA>
<ID_CLIENTE>000003</ID_CLIENTE>
<RUT_CLIENTE>11252128</RUT_CLIENTE>
<FECHA_ENVIO>20l8-12-04Tl9:01: 29+00:00</FECHA_ENVIO>
<ESTADO>aceptado</ESTADO>
<MENSAJE>Pago registindo correctamente</MENSAJE>
</RESPUESTA

ATRIBUTO	TIPO	LARGO	Descripción
ID_CLIENTE	NUMERIC		ID DEL CLIENTE
RUT_CLIENTE	STRING		Se informa rut del cliente sin formato guión
FECHA_ENVIO	DATETIME		fecha en en formato aaaa-mm-ddTHH:MM:SS
ESTADO	STRING	10	Estado de la operación
MENSAJE	STRING	255	Mensaje descriptivo del estado del comercio.

SSL

Si nuestro sistema mikrowisp ya tiene instalado certificado SSL gratis (Lets script SSL) podemos excluir el webservice para que este solo utilice HTTP y sea válido para Banco estado.

Para Aplicar nuestro cambio debemos editar nuestra configuración Apache del servidor debian ubicado en /etc/apache2/sites-available/000-default.conf y Buscar el siguiente bloque de configuración que debe estar al final haciendo referencia a su dominio (Ejm midominio.com):

RewriteEngine on
RewriteCond %{SERVER_NAME} =midominio.com
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]

Aquí debemos agregar una nueva línea debajo de "RewriteEngine on" agregar "RewriteCond %{REQUEST_URI} !^/bancoestado" quedando así la nueva configuración

RewriteEngine on
RewriteCond %{REQUEST_URI} !^/bancoestado
RewriteCond %{SERVER_NAME} =midominio.com
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]

Para aplicar esta nueva configuración debe reiniciar nuestro servidor Apache con el comando:

service apache2 restart

de esta forma el webservice será accesible vía http, por ejemplo: http://misistema.com/bancoestado/web/?wdsll