HISTÓRICO DE REVISIONES

Fecha	Versión	Descripción	Autor	
25/11/2005	1.0	Versión Inicial	Ruffo Pinilla	
01/12/2005	2.0	Inclusión Registro de control	Fernando Plazas	
27/02/2006	3.0	Modificación Archivo de Pago

Incluir reporte de operaciones Debito y Crédito	Fernando Plazas	
28/02/2006	3.1	Modificación Archivos de usuarios autorizados se cambiaron las longitudes de los campos Membcode y PerTypeDoc	Ruffo Pinilla	
7/06/2006	3.2	Se agrega información del Pagador en el archivo de pagos para tener información del tercero cuando es un usuario nuevo que esta realizando el pago.	Ruffo Pinilla	
04/07/2006	3.3	Se incluye la descripción del campo ITEM del archivo de cartera si se va a presentar el detalle de la factura.	Fernando Plazas	
07/07/2006	3.4	Se  incluye el campo  DETCOURT en  el  registro tipo  uno  del archivo de entrada de Ecollect. Para clientes que cargan más de un archivo por periodo.	Fernando Plazas	
09/10/2006	3.5	Se incluye ejemplo de presentación de factura	Fernando Plazas	
07/12/2006	3.6	Se incluye los  Formatos de Cartera avisor y usuarios  separados por comas (CSV).

Se le agrego al documento del formato cartera avisor las columnas POS INI y POS FIN que indica la posición   donde comienza el campo y la posición donde termina.	Fernando Plazas	
12/01/2007	3.7	Se aclara manejo del campo DetCourt	Ruffo Pinilla	
10/05/2007	3.8	Se  incluye  el  formato  archivo  de  Pagos  avisor  separado  por comas (CSV).	Fernando Plazas	
19/08/2007	3.9	Se  modifica  la  estructura  del  archivo  de  Cartera  Formato
AVISOR CSV para agregar referencias adicionales.

Se  modifica  la  estructura  del  archivo  de  Clientes    Formato
AVISOR CSV  para agregarle nuevos campos.

Se modifica la estructura del archivo de Pagos  Formato AVISOR
para agregarle nuevos campos	Fernando Plazas	
05/12/2007	3.10	Se modificar la estructura del archivo de cliente para agregarle nuevos campos.

Se agregan códigos de Ítem en el archivo de cartera   para el manejo de moras, descuentos, impuestos   reportados por la empresa.	Fernando Plazas	
20/09/2008	3.11	Se modificar la estructura del archivo de cliente para agregarle nuevos campos.	Fernando Plazas	

09/02/2010	3.12	Se agrega campos al archivo de pagos	Fernando Plazas	
06/04/2010	3.13	Se  agrega nuevos códigos del campo ítem en el archivo  de cartera.

Al archivo de Pagos se le agrega el campo fecha contable y el ciclo de transacción para PSE, se cambia la longitud del campo PaymentChannel a 3 caracteres	Fernando Plazas	
03/08/2010	3.14	Se adiciona los campos hora de transacción	Fernando Plazas	
18/09/2012	3.15	Se adiciona un formato de archivo de cartera para actualizacion de informacion. CARTERA ACT CSV	Fernando Plazas	

TABLA DE CONTENIDO

DISEÑO ARCHIVO ENTRADA PARA FORMATO CARTERA AVISOR ...........................4
DISEÑO ARCHIVO ENTRADA PARA  FORMATO CARTERA AVISOR  (CSV) ...............9
DISEÑO ARCHIVO ENTRADA PARA  FORMATO CARTERA ACT AVISOR  (CSV) ...13
DISEÑO ARCHIVO PAGOS EFECTUADOS CON ...............................................................15
DISEÑO ARCHIVO PAGOS EFECTUADOS CON FORMATO CSV ..................................18
ARCHIVO DE USUARIOS AUTORIZADOS..........................................................................21
ARCHIVO DE USUARIOS AUTORIZADOS (CSV) ..............................................................23

DISEÑO ARCHIVO ENTRADA PARA                        FORMATO CARTERA AVISOR

NOMBRE DEL ARCHIVO DETXXXXX_ AAAAMMDD donde:
(XXXXX: Código Entidad, AAAA:Año, MM:mes, DD:día)

REGISTRO TIPO 1: ENCABEZADO	
NOMBRE	DESCRIPCIÓN	LONG	TIPO	POS
INI	POS
FIN	
RecordType	Registro de control (Valor = 1)	1	numeric	1	1	

CycleDate	Fecha de corte del archivo. (Formato: AAAAMMDD)	
8	
date	
2	
9	

TransCount	Cantidad total de registros tipo 2 en el archivo.	
6	
numeric	
10	
15	

TotTransValue	Valor total de transacciones en el archivo. (suma del campo ValueDate1) (Formato: 16e2d)	

18	

decimal	

16	

33	

DetCourt	Permite identificar el ciclo de
facturación en el mes. Enviar los siguientes códigos:

00 = Cuando se maneja un solo ciclo o solo cierre de facturación en el mes o cuando se maneja facturación díaria. Borra toda la información que exista previamente de todos los ciclos de facturación.

01 = Indica el primer ciclo de facturación.
02 = Indica el segundo ciclo de facturación
0n = n-ésimo ciclo de facturación.	

2	

numeric	

34	

35	

Filler	Espacios para completar la longitud del registro.	
527	
string	
36	
562	

REGISTRO TIPO 2: DETALLE	
NOMBRE	DESCRIPCIÓN	LONG	TIPO	POS
INI	POS
FIN	REQUERIDO	
RecordType	Registro detalle (Valor = 2)	1	numeric	1	1	SI	
EtyCode	Código interno de entidad asignado por Avisor. Valor constante en
todos los registros.	35	numeric	2	36	SI	
SrvCode	Código interno asignado por la
Empresa para clasificar el servicio que se recauda.	35	numeric	37	71	SI	
Reference1	Corresponde a la primera
referencia de pago. Identifica quién paga. Ej. Cedula, NIT, Código Cliente, Código Estudiante, Código Familia, Código Afiliado, etc.	80	string	72	151	SI	
Reference2	Segunda referencia de pago. Identifica qué está pagando. Ej. Nro
Factura, Nro Crédito, Nro Recibo, Nro Tarjeta, etc.	80	string	152	231	NO	
Reference3	Tercera referencia de pago. Adicional para identificar qué está pagando.	80	string	232	311	NO	
Item	Código de ítem cuando el servicio
es de tipo Estado de cuenta. Aplica cuando se quiere desglosar un pago. (Ver descripción)	40	string	312	351	NO	
ItemDesc	Descripción de ítem cuando el
servicio es de tipo Estado de cuenta.	80	string	352	431	NO	
FlagDbCr	0 = Nota débito
(Deuda del Usuario)	

1	

numeric	

432	

432	

SI	
	1 = Nota crédito
(A favor del Usuario)						
MaxDate1	Primera fecha de vencimiento	8	date	433	440	SI	
ValueDate1	Valor primera fecha	18	decimal	441	458	SI	
MaxDate2	Segunda fecha de vencimiento	8	date	459	466	NO	
ValueDate2	Valor segunda fecha	18	decimal	467	484	NO	
MaxDate3	Tercera fecha de vencimiento	8	date	485	492	NO	
ValueDate3	Valor tercera fecha	18	decimal	493	510	NO	

MaxDate4	Cuarta fecha de vencimiento ó
Fecha de emisión del documento a pagar.	8	date	511	518	NO	
ValueDate4	Valor Cuarta fecha	18	decimal	519	536	NO	
MaxDate5	Quinta fecha de vencimiento	8	date	537	544	NO	
ValueDate5	Valor quinta fecha ó
Saldo total de esta obligación. Esto aplica si el servicio se ha configurado para que muestre al usuario el saldo de crédito o tarjeta de crédito, por ejemplo. En este caso el valor de la cuota a pagar y sus vencimientos se reportan en
los campos ValueDate1 a
ValueDate4.	18	decimal	545	562	NO	

Descripción del campo ITEM

Los valores que puede tener este campo serian:

Valor	Descripción	
00	Valor total de la factura	
01	Concepto	
02	IVA	
03	Valor Retención en la fuente	
04	Valor Retención IVA	
05	Valor Retención ICA	
10	Pagos electrónicos realizados a este documento. (En el caso de pagos parciales por
eCollect)	
11	Otros valores que afectan al total del documento. Ej. Notas crédito.	
30	Valor Retención en la Fuente mostrar aparte en el registro total.	
40	Valor de la mora calcula por la empresa y debe ser presentada al cliente.	
50	Valor del descuento calcula por la empresa y debe ser presentada al cliente.	
60	Valor en otra moneda. Hace parte del cálculo del valor total	
70	Otros conceptos no facturables	

Ejemplo:

Se envía un registro por cada valor que se utilice, por Ej.  Si una factura tiene:

Concepto 1
Concepto 2
Concepto 3
IVA
Valor Retención en la fuente
Total

Se envían 6 registros para esta factura.

Esto aplica para el caso que se quiera presentar el detalle de la factura de lo contrario solo se utilizaría el  valor 00.

REGLAS:

·    El archivo debe tener extensión txt.
·    La longitud del registro es de 562.
·    Los Códigos de Servicio deben estar definidos en el módulo administrativo de PSE.
·    Los campos “numeric” y “decimal” deben venir justificados a la derecha y rellenar con
ceros a la izquierda.
·    Los  campos  “decimal”  deben  venir  en  formato  16e2d  (16  enteros  2  decimales)  sin
carácter de punto ni coma.
·    Los campos “string” deben venir justificados a la izquierda y rellenar con espacios a la
derecha.
·    Los campos “date”  deben enviarse en formato “AAAAMMDD”.
·    Las fechas deben venir en orden de menor a mayor.
·    Las fechas deben venir en campos consecutivos.
·    Es requerido al menos la primera fecha y valor de corte correspondiente.
·    El archivo debe enviarse en formato plano sin formato, sin separadores entre campos.
Los campos se deben enviar con longitud fija.

·	La referencia1 cuando es NIT o CC debe venir sin puntos ni comas ni guiones solo debe venir el número del documento.
·    Cuando no se utilicen los campos MaxDateX y ValueDateX se deben enviar en ceros.
·	Cuando se envíen registros con código de ítem 30,40,50 no se presentaran en el detalle si no como parte del registro total.
·	Cuando se envíen registros con código de ítem 60 , en el campo ItemDesc debe venir el código de la moneda en estándar ISO 4217 del valor enviado, de la siguiente forma:

XXX#ZZZZZZZZZZZZZZZZZZZZZZZZZZZ

Donde:

o	XXX:  Es  el       código  de  moneda  en  estándar  ISO  4217    ej.:  USD  (Dólar estadounidense) COP (Peso Colombiano).
o ZZZZZZZZZZZZZZZZZZZZZZZZZZZ : Es la descripción del ítem.

DISEÑO ARCHIVO ENTRADA PARA                        FORMATO CARTERA AVISOR  (CSV)

NOMBRE DEL ARCHIVO DETXXXXX_ AAAAMMDDYY donde:
(XXXXX: Código Entidad, AAAA:Año, MM:mes, DD:día)

REGISTRO TIPO 1: ENCABEZADO	
NOMBRE	DESCRIPCIÓN	LONG.	TIPO	
RecordType	Registro de control (Valor = 1)	1	Numeric	
Separador	caracter de separación coma(,)	1	string	
CycleDate	Fecha de corte del archivo. (Formato: AAAAMMDD)	8	Date	
Separador	caracter de separación coma(,)	1	string	
TransCount	Cantidad total de registros tipo 2 en el archivo.	6	Numeric	
Separador	caracter de separación coma(,)	1	string	
TotTransValue	Valor   total de transacciones en el archivo. (suma del campo ValueDate1)
(Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	String	

DetCourt	Permite identificar el ciclo de facturación en el mes. Enviar
los siguientes códigos:

00 = Cuando se maneja un solo ciclo o solo cierre de facturación en el mes o cuando se maneja facturación diaria. Borra toda la información que exista previamente de todos los ciclos de facturación.

01 = Indica el primer ciclo de facturación.
02 = Indica el segundo ciclo de facturación
0n = n-ésimo ciclo de facturación.	2	Numeric	

REGISTRO TIPO 2: DETALLE	
NOMBRE	DESCRIPCIÓN	LONG	TIPO	
RecordType	Registro detalle (Valor = 2)	1	numeric	
Separador	caracter de separación coma(,)	1	string	
EtyCode	Código interno de entidad asignado por Avisor. Valor
constante en todos los registros.	35	numeric	
Separador	caracter de separación coma(,)	1	string	
SrvCode	Código interno asignado por la Empresa para clasificar el
servicio que se recauda.	35	numeric	
Separador	caracter de separación coma(,)	1	string	
Reference1	Corresponde a la primera referencia de pago. Identifica
quién paga. Ej. Cedula, NIT, Código Cliente, Código
Estudiante, Código Familia, Código Afiliado, etc.	80	string	
Separador	caracter de separación coma(,)	1	string	
Reference2	Segunda referencia de pago.	80	string	
	Identifica qué está pagando. Ej. Nro Factura, Nro Crédito,
Nro Recibo, Nro Tarjeta, etc.			

Separador	caracter de separación coma(,)	1	string	
Reference3	Tercera referencia de pago.	80	string	
	Adicional para identificar qué está pagando.			
Separador	caracter de separación coma(,)	1	string	
Item	Código de ítem cuando el servicio es de tipo Estado de
cuenta. Aplica cuando se quiere desglosar un pago. (Ver descripción)	40	string	
Separador	caracter de separación coma(,)	1	string	
ItemDesc	Descripción de ítem cuando el servicio es de tipo Estado de cuenta.	80	string	
Separador	caracter de separación coma(,)	1	string	
FlagDbCr	0 = Nota débito (Deuda del Usuario)	1	numeric	
	1 = Nota crédito (A favor del Usuario)			
Separador	caracter de separación coma(,)	1	string	
MaxDate1	Primera fecha de vencimiento	8	date	
Separador	caracter de separación coma(,)	1	string	
ValueDate1	Valor primera fecha	18	decimal	
Separador	caracter de separación coma(,)	1	string	
MaxDate2	Segunda fecha de vencimiento	8	date	
Separador	caracter de separación coma(,)	1	string	
ValueDate2	Valor segunda fecha	18	decimal	
Separador	caracter de separación coma(,)	1	string	
MaxDate3	Tercera fecha de vencimiento	8	date	
Separador	caracter de separación coma(,)	1	string	
ValueDate3	Valor tercera fecha	18	decimal	
Separador	caracter de separación coma(,)	1	string	
MaxDate4	Cuarta fecha de vencimiento ó	8	date	
	Fecha de emisión del documento a pagar.			
Separador	caracter de separación coma(,)	1	string	
ValueDate4	Valor Cuarta fecha	18	decimal	
Separador	caracter de separación coma(,)	1	string	
MaxDate5	Quinta fecha de vencimiento	8	date	
Separador	caracter de separación coma(,)	1	string	
ValueDate5	Valor quinta fecha ó Saldo total de esta obligación. Esto
aplica si el servicio se ha configurado para que muestre al usuario el saldo de crédito o tarjeta de crédito, por ejemplo. En este caso el valor de la cuota a pagar y sus vencimientos se reportan en los campos ValueDate1 a ValueDate4.	18	decimal	
Separador	caracter de separación coma(,)	1	string	
NroRef	Numero de referencias adicionales	2	numeric	
Separador	caracter de separación coma(,)	1	string	
ValueRef1	Valor referencia adicional uno	80	string	
Separador	caracter de separación coma(,)	1	string	
ValueRef2	Valor referencia adicional dos	80	string	
Separador	caracter de separación coma(,)	1	string	
				
Separador	caracter de separación coma(,)	1	string	
ValueRefn	Valor referencia adicional n	80	string	

Descripción del campo ITEM

Los valores que puede tener este campo serian:

Valor	Descripción	
00	Valor total de la factura	
01	Concepto	
02	IVA	
03	Valor Retención en la fuente	
04	Valor Retención IVA	
05	Valor Retención ICA	
10	Pagos electrónicos realizados a este documento. (En el caso de pagos parciales por eCollect)	
11	Otros valores que afectan al total del documento. Ej. Notas crédito.	
30	Valor Retención en la Fuente mostrar aparte en el registro total.	
40	Valor de la mora calcula por la empresa y debe ser presentada al cliente.	
50	Valor del descuento calcula por la empresa y debe ser presentada al cliente.	
60	Valor en otra moneda. Hace parte del cálculo del valor total	
70	Otros conceptos no facturables	

Ejemplo:

Se envía un registro por cada valor que se utilice, por Ej.  Si una factura tiene: Concepto 1
Concepto 2
Concepto 3
IVA
Valor Retención en la fuente
Total

Se envían 6 registros para esta factura.

Esto aplica para el caso que se quiera presentar el detalle de la factura de lo contrario solo se utilizaría el  valor 00.

REGLAS:

·    El archivo debe tener extensión txt.
·    Los campos deben venir separados por coma
·    Si el campo no tiene valor se debe enviar vacio.
·    Los Códigos de Servicio deben estar definidos en el módulo administrativo de PSE.
·	Los  campos  “decimal”  deben  venir  en  formato  16e2d  (16  enteros  2  decimales)  sin carácter de punto ni coma.
·    Los campos “date”  deben enviarse en formato “AAAAMMDD”.
·    Las fechas deben venir en orden de menor a mayor.
·    Las fechas deben venir en campos consecutivos.
·    Es requerido al menos la primera fecha y valor de corte correspondiente.
·	La referencia1 cuando es NIT o CC debe venir sin puntos ni comas ni guiones solo debe venir el número del documento.
·    Cuando no se utilicen los campos MaxDateX y ValueDateX se deben enviar en ceros.
·	Cuando no se utilicen las referencias adicionales el campo NroRef debe venir con valor cero. O de lo contrario con el número de referencias adicionales que se reportan.
·	Cuando se envíen registros con código de ítem 30, 40,50 no se presentaran en el detalle si no como parte del registro total.
·	Cuando se envíen registros con código de ítem 60 , en el campo ItemDesc debe venir el código de la moneda en estándar ISO 4217 del valor enviado, de la siguiente forma:

XXX#ZZZZZZZZZZZZZZZZZZZZZZZZZZZ

Donde:

o	XXX:  Es  el       código  de  moneda  en  estándar  ISO  4217    ej.:  USD  (Dólar estadounidense) COP (Peso Colombiano).
o ZZZZZZZZZZZZZZZZZZZZZZZZZZZ : Es la descripción del ítem.

DISEÑO ARCHIVO ENTRADA PARA                        FORMATO  CARTERA ACT AVISOR (CSV)

NOMBRE DEL ARCHIVO ACTXXXXX_ AAAAMMDDYY donde:
(XXXXX: Código Entidad, AAAA:Año, MM:mes, DD:día)

REGISTRO TIPO 3: DETALLE	
NOMBRE	DESCRIPCIÓN	LONG	TIPO	
RecordType	Registro detalle (Valor = 3)	1	numeric	
Separador	caracter de separación coma(,)	1	string	
EtyCode	Código interno de entidad asignado por Avisor. Valor
constante en todos los registros.	35	numeric	
Separador	caracter de separación coma(,)	1	string	
SrvCode	Código interno asignado por la Empresa para clasificar el
servicio que se recauda.	35	numeric	
Separador	caracter de separación coma(,)	1	string	
Reference1	Corresponde a la primera referencia de pago. Identifica quién paga. Ej. Cedula, NIT, Código Cliente, Código
Estudiante, Código Familia, Código Afiliado, etc.	80	string	
Separador	caracter de separación coma(,)	1	string	
Reference2	Segunda referencia de pago.	80	string	
	Identifica qué está pagando. Ej. Nro Factura, Nro Crédito,
Nro Recibo, Nro Tarjeta, etc.			
Separador	caracter de separación coma(,)	1	string	
Reference3	Tercera referencia de pago.	80	string	
	Adicional para identificar qué está pagando.			
Separador	caracter de separación coma(,)	1	string	
Item	Código de ítem cuando el servicio es de tipo Estado de
cuenta. Valor 00	2	string	
Separador	caracter de separación coma(,)	1	string	
ItemDesc	Descripción de ítem cuando el servicio es de tipo Estado
de cuenta.	80	string	
Separador	caracter de separación coma(,)	1	string	
FlagDbCr	0 = Nota débito (Deuda del Usuario)	1	numeric	
	1 = Nota crédito (A favor del Usuario)			
Separador	caracter de separación coma(,)	1	string	
MaxDate1	Primera fecha de vencimiento	8	date	
Separador	caracter de separación coma(,)	1	string	
ValueDate1	Valor primera fecha	18	decimal	
Separador	caracter de separación coma(,)	1	string	

REGLAS:

·    Si se quiere eliminar el registro se debe enviar el valor cero en el campo ValueDate1.

·	Si  el valor del campo ValueDate1 es mayor a cero. Se buscara la informacion con las referencias enviadas, si existe informacion se actualiza el registro encontrado de lo contrario lo crea.
·	Para borrado y actualizacion ,si existe más de un registro con la información   de las referencias enviadas no se realizara la actualización.
·     Este archivo es una medida temporal , mientra se carga el archivo con todos los registros.

                      DISEÑO ARCHIVO PAGOS EFECTUADOS CON

NOMBRE DEL ARCHIVO PAGXXXXX_ AAAAMMDD donde:
(XXXXX: Código Entidad, AAAA:Año, MM:mes, DD:día)

REGISTRO TIPO 1: ENCABEZADO	
NOMBRE	DESCRIPCIÓN	LONG	POS
INI	POS
FIN	TIPO	
RecordType	Registro de control (Valor = 1)	1	1	1	Numeric	
CycleDate	Fecha de corte del archivo.
(Formato: AAAAMMDD)	8	2	9	Date	
TransCount	Cantidad   total   de   transacciones   en   el
archivo.	6	10	15	Numeric	
TotTransValue	Valor total de transacciones en el archivo.
(Formato: 16e2d)	18	16	33	Decimal	
TotTransVatValue	Impuesto a las ventas – IVA en el archivo.
(Formato: 16e2d)	18	34	51	Decimal	
Filler	Espacios  para  completar  la  longitud  del
registro.	1229	52	1281	string	

REGISTRO TIPO 2: DETALLE	
NOMBRE	DESCRIPCIÓN	LONG.	POS INI	POS FIN	TIPO	
RecordType	Registros de detalle (Valor = 2)	1	1	1	Numeric	
TicketId	Consecutivo    interno    del    número    de transacción generado por la Empresa.	35	2	36	Numeric	
TrazabilityCode	Código Único de Seguimiento en el sistema
PSE.     Corresponde     al     número     de confirmación que se le presenta al Usuario.	35	37	71	Numeric	
ServiceCode	Código Servicio asignado por la Empresa.
Identifica  el  servicio  que  se  está recaudando, está asociado a la cuenta recaudadora en PSE.	35	72	106	Numeric	
TransValue	Valor pagado.

(Formato: 16e2d)	18	107	124	Decimal	
						
TransVatValue	Valor IVA pagado. Si no se especificó en el
momento del pago este campo estará en ceros.

(Formato: 16e2d)	18	125	142	Decimal	

	Primera referencia de pago.	80						
Reference2	Segunda referencia de pago.	80	223	302	String	
Reference3	Tercera referencia de pago.	80	303	382	String	
FIName	Nombre     de     la     Entidad     Financiera
Autorizadora	50	383	432	String	
BankProcessDate	Fecha  Proceso  del  pago  en  la  Entidad
Financiera Autorizadora. (Formato: AAAAMMDD)	8	433	440	Date	
						
PaymentChannel	Canal de pago :
0 para pagos por PSE
1 para pagos por TARJETA CREDITO
100 para pagos por CUPON	3	441	443	Numeric	
CodeOper1	Código Operación	6	444	449	Numeric	
ValueOper1	Valor Operación (Formato: 16e2d)	18	450	467	Decimal	
CodeOper2	Código Operación	6	468	473	Numeric	
ValueOper2	Valor Operación (Formato: 16e2d)	18	474	491	Decimal	
CodeOper3	Código Operación	6	492	497	Numeric	
ValueOper3	Valor Operación (Formato: 16e2d)	18	498	515	Decimal	
codeoper4	Código Operación	6	516	521	Numeric	
ValueOper4	Valor Operación (Formato: 16e2d)	18	522	539	Decimal	
CodeOper5	Código Operación	6	540	545	Numeric	
ValueOper5	Valor Operación (Formato: 16e2d)	18	546	563	Decimal	
Información del pagador. Solo se envía cuando es un usuario/cliente nuevo que se registra en eCollect y
realiza un pago. Corresponde al “Tercero” para realizar la contabilización del pago.

El número de Identificación del Tercero se envía en el campo “Reference1”	
PerTypeDoc	Tipo de documento de
identificación. (Estos códigos se
configuran de acuerdo a
la entidad)	2	564	565	Numeric	

Reference1

143          222         String

PerName	Nombre del Usuario o
Nombre de Empresa					
PerLast	Apellidos del Usuario o
blanco para empresas	50	616	665	string	
PerAddress	Dirección del Usuario	80	666	745	string	
FlagDbCr	0 = Nota débito (Deuda del Usuario)	1	746	746	numeric	
	1 = Nota crédito (A favor
del Usuario)					

Comment	Comentarios del pago	
500	747	1246	
string	
TipCta	Tipo de cuenta recaudadora
01 = Ahorros
02=Corriente	

2	1247	1248	

string	

NroCta	Número de cuenta
recaudadora	
20	
1249	
1268	
string	

CodBanco	Código Asobancaria
banco recaudador	
3	
1269	
1271	
numeric	

FechCont	Fecha contable
(Formato: AAAAMMDD)	
8	
1272	
1279	
Date	
Ciclo	Ciclo transacción PSE	2	
1280	
1281	numeric	
Hora	Hora  de  la  transacción
Formato 24HH:MI	5	
1282	
1286	string	

50          566         615               string

NOTAS:

1.  El archivo debe tener extensión txt.
2.  La longitud del registro es de 1286.
3.  Cuando varios registros tienen el mismo valor en el campo “TrazabilityCode” significa que hacen parte de un pago múltiple. En la consulta que se efectúe en ACH se verá una sola transacción por el valor total de los Ítems que hacen parte del pago múltiple, en ACH no se verá detallado cada uno de los Ítems, ya que ACH solo recibe una transacción por referencia de pago.
4.  Para pagos múltiples el Ítem pagado se puede identificar por la combinación de los
campos “Reference1” y “Reference2”. Ej: Nro. Cédula, Nro Factura.
5.  Cuando el registro hace parte de un pago múltiple, los campos “TransValue” y
“TransVatValue” corresponden a los valores pagados para el Ítem, no al total de la transacción, ya que en la transacción se pagaron otros Ítems.
6.  Los campos “numeric” y “decimal” están justificados a la derecha con ceros a la izquierda.
7.  Los  campos  “decimal”  deben  están  en formato  16e2d  (16  enteros  2  decimales)  sin carácter de punto ni coma.
8.  Los campos “string” deben están justificados a la izquierda con espacios a la derecha.
9.  Los campos “date”  están  en formato “AAAAMMDD”.
10. El archivo debe enviarse en formato plano sin formato, sin separadores entre campos.
Los campos se deben enviar con longitud fija.

11. Si la información del Tercero no es enviada, estos campos son enviados en ceros o blancos según el tipo de cada campo.

DISEÑO ARCHIVO PAGOS EFECTUADOS CON                        FORMATO CSV

NOMBRE DEL ARCHIVO PAGXXXXX_ AAAAMMDD donde:
(XXXXX: Código Entidad, AAAA:Año, MM:mes, DD:día)

REGISTRO TIPO 1: ENCABEZADO	
NOMBRE	DESCRIPCIÓN	LONG.	TIPO	
RecordType	Registro de control (Valor = 1)	1	Numeric	
Separador	caracter de separación coma(,)	1	char	
CycleDate	Fecha de corte del archivo. (Formato: AAAAMMDD)	8	Date	
Separador	caracter de separación coma(,)	1	char	
TransCount	Cantidad total de transacciones en el archivo.	6	Numeric	
Separador	caracter de separación coma(,)	1	char	
TotTransValue	Valor total de transacciones en el archivo. (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
TotTransVatValue	Impuesto a las ventas – IVA en el archivo.
(Formato: 16e2d)	18	Decimal	

REGISTRO TIPO 2: DETALLE	
NOMBRE	DESCRIPCIÓN	LONG.	TIPO	
RecordType	Registros de detalle (Valor = 2)	1	Numeric	
Separador	caracter de separación coma(,)	1	char	
TicketId	Consecutivo  interno  del  número  de  transacción
generado por la Empresa.	35	Numeric	
Separador	caracter de separación coma(,)	1	char	
TrazabilityCode	Código Único de Seguimiento en el sistema PSE.
Corresponde al número de confirmación que se le presenta al Usuario.	35	Numeric	
Separador	caracter de separación coma(,)	1	char	
ServiceCode	Código Servicio asignado por la Empresa. Identifica
el servicio que se está recaudando, está asociado a la cuenta recaudadora en PSE.	35	Numeric	
Separador	caracter de separación coma(,)	1	char	
TransValue	Valor pagado.
(Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
TransVatValue	Valor  IVA  pagado.  Si  no  se   especificó  en  el
momento del pago este campo estará en ceros. (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
Reference1	Primera referencia de pago.	80	String	
Separador	caracter de separación coma(,)	1	char	
Reference2	Segunda referencia de pago.	80	String	
Separador	caracter de separación coma(,)	1	char	
Reference3	Tercera referencia de pago.	80	String	
Separador	caracter de separación coma(,)	1	char	
FIName	Nombre de la Entidad Financiera Autorizadora	50	String	
Separador	caracter de separación coma(,)	1	char	

BankProcessDate	Fecha Proceso del pago en la Entidad Financiera
Autorizadora.
(Formato: AAAAMMDD)	8	Date	
Separador	caracter de separación coma(,)	1	char	
PaymentChannel	Canal de pago :
0 para pagos por PSE
1 para pagos por TARJETA CREDITO
100 para pagos por CUPON	3	Numeric	
Separador	caracter de separación coma(,)	1	char	
CodeOper1	Código Operación	6	Numeric	
Separador	caracter de separación coma(,)	1	char	
ValueOper1	Valor Operación (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
CodeOper2	Código Operación	6	Numeric	
Separador	caracter de separación coma(,)	1	char	
ValueOper2	Valor Operación (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
CodeOper3	Código Operación	6	Numeric	
Separador	caracter de separación coma(,)	1	char	
ValueOper3	Valor Operación (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
codeoper4	Código Operación	6	Numeric	
Separador	caracter de separación coma(,)	1	char	
ValueOper4	Valor Operación (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
CodeOper5	Código Operación	6	Numeric	
Separador	caracter de separación coma(,)	1	char	
ValueOper5	Valor Operación (Formato: 16e2d)	18	Decimal	
Separador	caracter de separación coma(,)	1	char	
Información del pagador. Solo se envía cuando es un usuario/cliente nuevo que se registra en eCollect
y realiza un pago. Corresponde al “Tercero” para realizar la contabilización del pago.
El número de Identificación del Tercero se envía en el campo “Reference1”	
PerTypeDoc	Tipo de documento de identificación.
(Estos códigos se configuran de acuerdo a la entidad)	2	Numeric	
Separador	caracter de separación coma(,)	1	char	
PerName	Nombre del Usuario o Nombre de Empresa	50	string	
Separador	caracter de separación coma(,)	1	char	
PerLast	Apellidos del Usuario o blanco para empresas	50	string	
Separador	caracter de separación coma(,)	1	char	
PerAddress	Dirección del Usuario	80	string	
Separador	caracter de separación coma(,)	1	char	
FlagDbCr	0 = Nota débito (Deuda del Usuario)	1	numeric	
	1 = Nota crédito (A favor del Usuario)			
Separador	caracter de separación coma(,)	1	char	
Comment	Comentarios del pago	500	string	
Separador	carácter de separación coma(,)	1	char	
TipCta	Tipo de cuenta recaudadora
01 = Ahorros
02=Corriente	2	String	
Separador	carácter de separación coma(,)	1	char	
NroCta	Número de cuenta recaudadora	20	string	
Separador	carácter de separación coma(,)	1	char	
CodBanco	Código Asobancaria banco recaudador	3	numeric	

Separador	carácter de separación coma(,)	1	char	
FechCont	Fecha contable (Formato: AAAAMMDD)	8	Date	
Separador	carácter de separación coma(,)	1	char	
Ciclo	Ciclo transacción PSE	2	numeric	
Separador	carácter de separación coma(,)	1	char	
Hora	Hora de la transacción Formato 24HH:MI	5	char	

NOTAS:

1.  El archivo debe tener extensión txt.
2.  Los campos están separados por coma.
3.  Cuando varios registros tienen el mismo valor en el campo “TrazabilityCode” significa que hacen parte de un pago múltiple. En la consulta que se efectúe en ACH se verá una sola transacción por el valor total de los Ítems que hacen parte del pago múltiple, en ACH no se verá detallado cada uno de los Ítems, ya que ACH solo recibe una transacción por referencia de pago.
4.  Para pagos múltiples el Ítem pagado se puede identificar por la combinación de los
campos “Reference1” y “Reference2”. Ej: Nro. Cédula, Nro Factura.
5.  Cuando el registro hace parte de un pago múltiple, los campos “TransValue” y “TransVatValue” corresponden a los valores pagados para el Ítem, no al total de la transacción, ya que en la transacción se pagaron otros Ítems.
6.  Los campos “numeric” y “decimal” están justificados a la derecha con ceros a la izquierda.
7.  Los  campos  “decimal”  deben  están  en formato  16e2d  (16  enteros  2  decimales)  sin carácter de punto ni coma.
8.  Los campos “string” deben están justificados a la izquierda con espacios a la derecha.
9.  Los campos “date”  están  en formato “AAAAMMDD”.
10. El archivo debe enviarse en formato plano sin formato, sin separadores entre campos.
Los campos se deben enviar con longitud fija.
11. Si la información del Tercero no es enviada, estos campos son enviados en ceros o blancos según el tipo de cada campo.

ARCHIVO DE USUARIOS AUTORIZADOS

Permite validar los Usuarios que van a ingresar al sistema para efectuar pagos.

NOMBRE DEL ARCHIVO USUXXXXX_ AAAAMMDD.txt donde:
(XXXXX: Código Entidad, AAAA:Año, MM:mes, DD:día)

NOMBRE	DESCRIPCIÓN	LONG	TIPO	POS
INI	POS
FIN	
PerId	Identifica al usuario autorizado. Debe corresponder con el campo Reference1 del
archivo de entrada.	80	string	1	80	
MembCode	Indicador del tipo de usuario.
Debe corresponder con los tipos de usuarios que se configuren en el sistema eCollect.

Si solo se maneja un perfil de usuario enviar el código 01.	2	numeric	81	82	
PerId2	Segundo criterio de
autenticación del usuario para ingresar a efectuar pagos. Si no se utiliza enviar en blancos.	35	string	83	117	
PerTypeDoc	Tipo de documento de identificación. Es opcional, solo
si se requiere para la validación del usuario. Si no se utiliza
enviar el código 00.	2	numeric	118	119	
PerName	Nombre del Usuario o Nombre
de Empresa. En caso de no poder separar nombres y apellidos en los dos campos, entonces enviar en PerName el nombre completo.	50	string	120	169	
PerLast	Apellidos del Usuario o blanco para empresas	50	string	170	219	
Email	Dirección de correo Electrónico
para confirmarle el pago al usuario.	50	string	220	269	
PerAddress	Dirección del usuario	80	string	270	349	
PerCity	Ciudad del usuario	50	string	350	399	
PerTel	Teléfono del usuario	50	string	400	449	
PerGruop	Numero de perid al cual pertenece	80	string	450	529	
PerTypeRol	Rol del usuario
Valores que puede tener	2	number	530	531	

REQUERIDO

SI

SI

NO

NO

SI

SI

NO

NO NO
NO

NO

	0 : NO APLICA
1 :  AUTORIZADOR
2 :  PAGADOR						
PerTypePer	Tipo de Persona
Valores que puede tener
N : Natural
J :  Jurídica	1	string	532	532	NO	

Comentarios:

El campo MembCode permite perfilar diferentes tipos de usuarios que puedan ingresar al sistema de recaudo electrónico eCollect, con base en estos tipos de usuario se configuran que servicios (SrvCode) están disponibles para cada tipo de usuario. Ejemplos

01= Aspirante
02= Estudiante
03= Egresado
04= Docente	01= Cliente
02= Distribuidor
03= Mayorista	01= Afiliados
02= No Afiliados	01= Acudiente	

El campo PerGroup permite   integrar  a un cliente    varios  usuarios  para  manejar  el concepto de Autorizador y Pagador  Ej:
El cliente  A puede tener varios usuarios: Usuario 1      Autorizador
Usuario 2      Autorizador
Usuario 3      Pagador

Autorizador: Tiene el rol de seleccionar las facturas a pagar. No puede realizar el proceso de pago.

Pagador: Tiene el rol de realizar el proceso de pago  de las facturas que seleccionar el autorizador.

El campo PerGroup  también permite  asociar a un cliente varios clientes para manejar el concepto Grupos corporativos Ej:

El cliente  A tiene un grupo de empresas las cuales tiene una empresa principal

Empresa 1   principal
Empresa 2   Asociada 1
Empresa 3   Asociada 2

Si el cliente ingresa por la empresa principal puede  también ver y pagar las facturas de las empresas asociadas a esta.

ARCHIVO DE USUARIOS AUTORIZADOS (CSV)

Permite validar los Usuarios que van a ingresar al sistema para efectuar pagos.

NOMBRE	DESCRIPCIÓN	LONG	TIPO	
PerId	Identificación de la persona. Ej Nro. de NIT. Debe corresponder con el campo Reference1 del archivo de
entrada.	80	string	
Separador	caracter de separación coma(,)	1	string	
MembCode	Indicador del tipo de usuario. Debe
corresponder con los tipos de usuarios que se configuren en el sistema eCollect.	2	numeric	
Separador	caracter de separación coma(,)	1	string	
PerId2	Segundo criterio de autenticación
del usuario para ingresar a efectuar pagos. Ej. Blancos.	35	string	
Separador	caracter de separación coma(,)	1	string	
PerTypeDoc	Tipo de documento de
identificación. Ej “2” que indica NIT.	2	numeric	
Separador	caracter de separación coma(,)	1	string	
PerName	Nombre del Usuario o Nombre de
Empresa	50	string	
Separador	caracter de separación coma(,)	1	string	
PerLast	Apellidos del Usuario o blanco para
empresas	50	string	
Separador	caracter de separación coma(,)	1	string	
Email	Dirección de correo Electrónico	50	string	
Separador	caracter de separación coma(,)	1	string	
Peraddress	Dirección del usuario	80	string	
Separador	caracter de separación coma(,)	1	string	
PerCity	Ciudad dirección del usuario	50	string	
Separador	caracter de separación coma(,)	1	string	
PerTel	Numero telefónico usuario	50	string	
Separador	carácter de separación coma(,)	1	string	
PerGroup	Numero de perid al cual pertenece	80	string	
Separador	carácter de separación coma(,)	1	string	
PerTypeRol	Rol del usuario
Valores que puede tener
00 :  NO APLICA
01 :  AUTORIZADOR
02 :  PAGADOR	2	number	
Separador	carácter de separación coma(,)	1	string	
PerTypePer	Tipo de persona
Valores que puede tener: N: Natural
J: Jurídica	1	string	

Comentarios:

El campo MembCode permite perfilar diferentes tipos de usuarios que puedan ingresar al sistema de recaudo electrónico eCollect, con base en estos tipos de usuario se configuran que servicios (SrvCode) están disponibles para cada tipo de usuario. Ejemplos

1= Aspirante
2= Estudiante
3= Egresado
4= Docente	1= Cliente
2= Distribuidor
3= Mayorista	1= Afiliados
2= No Afiliados	1= Acudiente	

El campo PerGroup permite   integrar  a un cliente    varios  usuarios  para  manejar  el concepto de Autorizador y Pagador  Ej:
El cliente  A puede tener varios usuarios: Usuario 1      Autorizador
Usuario 2      Autorizador
Usuario 3      Pagador

Autorizador: Tiene el rol de seleccionar las facturas a pagar. No puede realizar el proceso de pago.

Pagador: Tiene el rol de realizar el proceso de pago  de las facturas que seleccionar el autorizador.

El campo PerGroup  también permite  asociar a un cliente varios clientes para manejar el concepto Grupos corporativos Ej:

El cliente  A tiene un grupo de empresas las cuales tiene una empresa principal

Empresa 1   principal
Empresa 2   Asociada 1
Empresa 3   Asociada 2

Si el cliente ingresa por la empresa principal puede  también ver y pagar las facturas de las empresas asociadas a esta.