Caja Vecina
Acepta pagos vía Caja Vecina
Disponible para
ChileWEBSERVICE 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
Updated almost 3 years ago