________________________________________________________________________________

ESPECIFICACIONES TÉCNICAS PARA EL PROCESO DE

PAGO DE IMPUESTO PREDIAL, INDUSTRIA, RENTAS
VARIAS Y DEMÁS IMPUESTOS VÍA WEB SERVICES –
RECAUDO EN LÍNEA SUCURSAL BANCARIA

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com
________________________________________________________________________________
DOCUMENTO DE ESPECIFICACIÓN DE SERVICIOS
RECAUDO EN CATALOGO

Entidad Informática y Tributos S.A.S.

Área Dirección de Tecnología y Operaciones
Proyecto Entidades Municipales y Departamentales
Nombre de la función del Servicio Servicio Estándar de Recaudo de Bases Externas
Fecha Elaboración 16/01/2020
Autor Rubén Darío González Mendoza
Código Proyecto 14

1. CONTROL DE CAMBIOS

Versión Fecha Descripción Autor Aprobó Fecha aprobación

Nelson José Yi
1.0 16/01/2020 Creación del documento 16/01/2020
Ardila Romani
Actualización en la descripción Nelson Rubén
1.0 30/03/2020 16/01/2020
funcional de los métodos Ardila Gonzalez

2. DESCRIPCIÓN DEL SERVICIO

Se brinda una estructura de mensaje estándar, que se expone del lado del cliente
del orden territorial (alcaldía y/o gobernación), el cual desea que cualquier entidad
bancaria y/o recaudadora reporte en línea la consulta y notificación de recaudo de
facturas o declaraciones.

Esta estructura está alineada a la información que actualmente maneja el cliente

con el Banco recaudador con el cual ya se tiene el convenio, para las consultas de
operaciones de consulta de factura, notificación de pago de factura, reverso de pago
y consulta de datos del recaudo.

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com
________________________________________________________________________________
3. DIAGRAMA DEL SERVICIO

1. El usuario pagador se dirige a una sucursal o canal del Banco recaudador y

suministra la información necesaria para consultar la información de la factura
a cancelar.
2. El canal de servicios consume el servicio web del cliente recaudador (entidad
territorial), con la estructura definida en este documento, con el fin de obtener
por parte del Banco la información necesaria de la factura a pagar.
3. El canal del banco informa al usuario el valor a pagar.
4. El canal del banco le entrega un soporte de pago de la factura al usuario.
5. El canal de servicios notifica al cliente recaudador (entidad territorial) el pago de
la factura por medio del servicio web consumido.

4. MODELO DE SEGURIDAD

A continuación, se indican las especificaciones de seguridad en la comunicación

entre el cliente recaudador (entidad territorial) y el Banco, requeridas para el
consumo de los servicios web expuestos:

1. Confidencialidad
La conexión entre el cliente recaudador (entidad territorial) y el Banco será por
VPN site to site.

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com
________________________________________________________________________________
En el caso que sea de manera obligatoria por parte del Banco se implementará
HTTPS (SSL).

2. Control de acceso a la red

Se habilitará y creará en el firewall las reglas correspondientes para permitir el
consumo y exposición de los servicios en los puertos asignados y las reglas NAT
definidas para proteger el direccionamiento interno.

3. Auditoria
Las transacciones procesadas por el cliente recaudador (ente territorial) dejarán
registro en log transaccional que permita conocer la trazabilidad de la
transacción.

5. DESCRIPCIÓN DE LA INTERFAZ DEL SERVICIO

5.1. OPERACIÓN: Validación de Factura

Nombre Operación Validación de factura

Nombre del Servicio ValidarFactura
Descripción Validación de factura por identificador de la factura
(número)
Patrón de Request – Response
Comunicación

ESPECIFICACIÓN
El mensaje de request se va a componer de los campos definidos a continuación:

Nombre Campo Descripción Longitud Dominio

COD_EAN Código EAN del impuesto a 13 Alfanumérico
pagar
NMRO_DCMNTO Número de recibo o 12 Alfanumérico
declaración a pagar.
VLOR_PGO Valor de la factura a pagar 14 Alfanumérico
FCHA_VENCI Fecha de vencimiento de la 8 Alfanumérico
factura a cancelar, en formato
“yyyymmdd” Ej.20150330

El mensaje de response se va a componer de los campos definidos a continuación:

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com
________________________________________________________________________________
Nombre Campo Descripción Longitud Dominio
ValidarFacturaResponse Código y Texto del mensaje 100 Alfanumérico
en el momento de la
verificación de la autenticidad
del documento a pagar.

5.2. OPERACIÓN: Recaudar Pago

Nombre Operación Recaudar Pago

Nombre del Servicio RecaudarPago
Descripción Registra los datos de la factura por identificador de la
factura (número)
Patrón de Request – Response
Comunicación

ESPECIFICACIÓN
El mensaje de request se va a componer de los campos definidos a continuación:

Nombre Campo Descripción Longitud Dominio

COD_EAN Código EAN del impuesto a 13 Alfanumérico
pagar
NMRO_DCMNTO Número de recibo o 12 Alfanumérico
declaración a pagar.
VLOR_PAGO Valor de la factura a pagar 14 Alfanumérico
FCHA_VENCI Fecha de vencimiento de la 8 Alfanumérico
factura a cancelar, en
formato “yyyymmdd”
Ej.20150330
FCHA_PAGO Fecha de pago de la factura 8 Alfanumérico
a pagar, en formato
“yyyymmdd” Ej. 20150330
FOR_PAGO Medio de pago que aplicó la 2 Alfanumérico
transacción
COD_BANCO Código de la entidad 2 Alfanumérico
bancaria que notifica el
pago.
REF_SUC Código de la sucursal 4 Alfanumérico
bancaria que notifica el
pago.

El mensaje de response se va a componer de los campos definidos a continuación:

Nombre Campo Descripción Longitud Dominio

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com
________________________________________________________________________________
RecaudoPagoResponse Código y Texto del 100 Alfanumérico
mensaje en el momento
de la notificación del
documento pagado

6. LISTA DE VALORES
6.1. Código de respuestas

Código de Respuesta Descripción de Respuesta

Respuesta
101 101+Numero de Número de documento no
documento no valido, válido por no ser un dato
verifique que sea un dato numérico
numérico
102 102+Monto a pagar no Monto a Pagar no válido por
valido, verifique que sea no ser un dato numérico
un dato numérico
103 103+Fecha de Fecha de Vencimiento no
vencimiento no valida, valida por no tener formato
verifique que sea un dato fecha (YYYYMMDD)
fecha o se encuentre en
formato YYYYMMDD.
104 104+Diligenciar todos los Se debe completar todos los
campos campos en el consumo del
método
105 105+Recibo no valido Recibo no válido para procesar
para procesar. (No existe o no es el formato)
100 100|Ok La transacción de verificación
ha sido exitosa
100 100|Pago Almacenado. La transacción de recaudo de
pago ha sido exitosa.

1.1. Código de bancos

Código de Descripción de Respuesta
Banco
0 Banco República
1 Banco de Bogotá
2 Banco Popular
6 Banco Santander
7 Bancolombia
8 The Royal Banck Of Scotland
9 Citibank | Scotiabank Colpatria

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com
________________________________________________________________________________
10 HSBC
12 Banco GNB Sudameris
13 Banco BBVA Colombia
14 Helm Bank
19 Banco Colpatria
23 Banco de Occidente
31 Bancoldex
32 Banco BCSC
40 Banco Agrario
51 Banco Davivienda

1.2. Tipo de Pagos

Tipo de Pago Descripción de Respuesta

EF Efectivo
CH Cheque
T Tarjeta (Débito o Crédito)
M Mixto
DC Débito en cuenta

Barranquilla
Carrera 68 No. 81 – 163
Tel: (575) 3858004
www.infortributos.com
rgonzalez@infortributos.com