Archivos de intercambio para el recaudo de Facturas

Anuncio
Archivos de intercambio para el
recaudo de Facturas
Versión 2.4.1: 2009-05-26
Presentado por: EGM Ingeniería sin fronteras
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
Introducción
PlacetoPay es una plataforma que se comunica directamente con las redes financieras
permitiéndole un recaudo expedito de sus facturas. Al usar PlacetoPay usted puede habilitar el
recaudo con todos los medios de pago disponibles en Colombia así mismo obvia los procesos de
integración o desarrollo con las diferentes redes.
Definición de los archivos de intercambio
Estos archivos contienen la relación de las facturas o los cobros autorizados para que sean
recaudados a través de PlacetoPay.
Estos formatos permiten que la información sea consultada cuando se realice el recaudo
independientemente del medio (Internet, sistema de audio respuesta o punto de atención).
Archivo de facturación [ Formato Asobancaria 2001 ]
A continuación se describe el formato de cargue de la información para recaudo, este formato
está basado en la especificación de Asobancaria del 2001 con unas modificaciones usando el
campo de llenado.
Como regla general los archivos son de longitud fija, por lo cual para los valores numéricos el
valor debe tener un relleno de ceros a la izquierda para completar la longitud. En tanto que para
valores alfanuméricos el relleno debe ser con blancos a la derecha.
El formato posee la siguiente estructura:
Registro de encabezado de archivo
Registro de encabezado de lote No. 1
Registro de detalle 1
….
Registro de detalle n
Registro de control de lote No. 1
Registro de encabezado de lote No. n
Registro de detalle 1
….
Registro de detalle n
Registro de control de lote No. n
Registro de control de archivo
La longitud de cada registro es 220 caracteres y su contenido se precisa a continuación:
Registro de encabezado de archivo
Campo
1
Nombre
Tipo de registro
Long
2
Tipo
NUM
Req
SI
2
NIT empresa
recaudadora
NIT recaudador
adicional
10
NUM
SI
10
NUM
NO
Código de la
3
NUM
NO
3
4
PLACETOPAY
Valor
01
[constante]
WWW.PLACETOPAY.COM
Descripción
Indica el tipo de registro
NIT de la empresa que presenta
la facturación
NIT de la empresa adicional que
factura conjuntamente con la
principal. No usado por
PlacetoPay.
Código de la entidad financiera
PÁGINA 2
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
entidad
originadora
5
6
Fecha del archivo
Hora de grabación
del archivo
8
4
NUM
NUM
SI
SI
AAAAMMDD
HHMM
7
Modificador
de archivo
1
ALF
SI
A-Z,0-9
8
Reservado
182
ALF
donde la Empresa tiene cuenta y
desea que se le abone el recaudo
por domiciliación. Este campo
corresponde al código de tránsito
de la entidad financiera. No usado
por PlacetoPay.
Fecha de creación del archivo
Hora de grabación del archivo en
formato de hora militar, es decir
de 0001 hasta las 2400 horas.
Caracter que refleja el orden
cronológico de grabación de los
archivos y permite diferenciar
varios archivos generados en un
mismo día. Se debe emplear
primero las letras mayúsculas (AZ) y posteriormente los números.
Registro de encabezado de lote
Campo
1
Nombre
Tipo de registro
Long
2
Tipo
NUM
Req
SI
2
Código del
servicio facturado
13
NUM
SI
3
Número de lote
4
NUM
SI
4
Descripción del
servicio
Facturado
Reservado
15
ALF
SI
186
ALF
Long
2
Tipo
NUM
Req
SI
5
Valor
05
[constante]
Código EAN
o NIT
Descripción
Indica el tipo de registro
Valor
06
[constante]
Descripción
Indica el tipo de registro
El código EAN 13 es asignado por
el IAC y se usa cuando la
empresa factura dos o más
servicios que deban ser
diferenciados o discriminados
ante el cliente receptor. El código
EAN 13 identifica el país (3
posiciones), la empresa principal
que factura (6), el tipo de servicio
facturado (3) y características
propias de cada convenio (1). El
NIT solo puede ser empleado por
aquellas Empresas que facturan
un único servicio o que no
manejen código EAN-13.
Consecutivo del lote dentro del
archivo. Cada archivo tiene su
propia secuencia de numeración
de lotes.
Nombre del servicio facturado que
se le muestra al cliente receptor.
Registro de detalle
Campo
1
Nombre
Tipo de registro
2
Referencia
principal
del usuario
48
NUM
SI
3
Referencia
30
ALF
NO
PLACETOPAY
WWW.PLACETOPAY.COM
Es el código principal con el cual
el documento a pagar es
identificado en cada Empresa.
Puede referirse al número de
factura o al que designe la
Empresa Originadora.
Es el código con el cual el cliente
PÁGINA 3
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
4
secundaria del
usuario
Períodos
facturados
Ciclo
Valor principal del
servicio
es identificado en la Empresa.
2
NUM
NO
Indica el período facturado
3
14
ALF
NUM
NO
SI
Código del
servicio
facturado por
Empresa adicional
Valor de servicio
Adicional
13
NUM
NO
14
NUM
NO
Fecha de
Vencimiento
Identificación de
la EFR (banco del
cliente)
8
NUM
SI
8
NUM
NO
11
No. cuenta del
cliente pagador
17
ALF
NO
12
Tipo de cuenta del
cliente pagador
2
NUM
NO
13
No. Identificación
del cliente
pagador
Nombre del
cliente pagador
Código de Entidad
Financiera
Originadora
10
ALF
NO
Indica el ciclo / zona
Valor de la factura del servicio de
la Empresa principal. 12 enteros,
2 decimales.
En los casos de empresas con
facturación conjunta, se identifica
la empresa adicional y su servicio.
No usado por PlacetoPay.
Valor de la factura del servicio de
la Empresa adicional. 12 enteros,
2 decimales. No usado por
PlacetoPay.
Fecha de vencimiento de la
factura sin recargo
Código que identifica la entidad
financiera donde el cliente
domiciliado tiene su cuenta. No
usado por PlacetoPay.
Número de cuenta o de tarjeta de
crédito del cliente que paga el
servicio. No usado por
PlacetoPay.
Indica si el número de cuenta
corresponde a ahorros, corriente
o tarjeta de crédito. No usado por
PlacetoPay.
No. Identificación del cliente.
22
ALF
NO
3
NUM
NO
16
Incremento al
vencimiento
10
NUM
SI
17
Fecha de corte
8
NUM
SI
AAAAMMDD
18
Tipo de
1
NUM
SI
0/1
5
6
7
8
9
10
14
15
PLACETOPAY
Código
EAN13
AAAAMMDD
WWW.PLACETOPAY.COM
Código de la entidad financiera
donde la Empresa tiene cuenta y
desea que se le abone el recaudo
por domiciliación. Este campo
corresponde al código de tránsito
de la entidad financiera. Para
recaudos por otros canales, este
campo debe ir con espacios. No
usado por PlacetoPay.
Valor del incremento diario a la
factura, cuando es pagada
después del vencimiento y hasta
el corte. 6 enteros, 4 decimales.
Si el valor es inferior a uno se
supone porcentual, en caso
contrario un valor fijo aplicado
diariamente.
Ej: 0000000150, representa el
1,5%.
Corresponde a la fecha hasta la
cual se recibe el pago de la
factura. Esta fecha debe ser
superior o igual a la fecha de
vencimiento.
Indica si el incremento al
PÁGINA 4
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
19
incremento al
vencimiento
Reservado
vencimiento es un valor fijo [1] o si
es un valor diario [0].
5
ALF
NO
Long
2
Tipo
NUM
Req
SI
9
NUM
SI
18
NUM
SI
Registro de control de lote
Campo
1
Nombre
Tipo de registro
2
Total registros del
lote
Valor de servicio
Principal
3
4
Valor de servicio
Adicional
18
NUM
NO
5
Número de lote
4
NUM
SI
6
Reservado
169
ALF
Valor
08
[constante]
Descripción
Indica el tipo de registro
Número total de registros
grabados en el lote.
Valor de la facturación de la
empresa principal para el lote. 16
enteros, 2 decimales.
Valor de la facturación de la
empresa adicional para el lote. 16
enteros, 2 decimales. No usado
por PlacetoPay.
Consecutivo del lote dentro del
archivo. Cada archivo tiene su
propia secuencia de numeración
de lotes. Debe ser igual al campo
3, del registro de encabezado de
lote.
Registro de control de archivo
Campo
1
Nombre
Tipo de registro
2
Total registros de
detalle
Valor de servicio
Principal
3
Long
2
Tipo
NUM
Req
SI
9
NUM
SI
18
NUM
SI
NO
4
Valor de servicio
Adicional
18
NUM
5
Reservado
173
ALF
Valor
09
[constante]
Descripción
Indica el tipo de registro
Número total de registros tipo "6"
grabados en el archivo.
Valor de la facturación de la
empresa principal para el lote. 16
enteros, 2 decimales.
Valor de la facturación de la
empresa adicional para el lote. 16
enteros, 2 decimales. No usado
por PlacetoPay.
Archivo de recaudo [ Formato Asobancaria 2001 ]
A continuación se describe el formato correspondiente a la información generada como resultado
del proceso de recaudo, cuyo destinatario es la empresa facturadora.
Como regla general los archivos son de longitud fija, por lo cual para los valores numéricos el
valor debe tener un relleno de ceros a la izquierda para completar la longitud. En tanto que para
valores alfanuméricos el relleno debe ser con blancos a la derecha.
El formato posee la siguiente estructura:
Registro de encabezado de archivo
Registro de encabezado de lote No. 1
Registro de detalle 1
PLACETOPAY
WWW.PLACETOPAY.COM
PÁGINA 5
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
….
Registro de detalle n
Registro de control de lote No. 1
Registro de encabezado de lote No. n
Registro de detalle 1
….
Registro de detalle n
Registro de control de lote No. n
Registro de control de archivo
La longitud de cada registro es de 162 caracteres y su contenido se detalla a continuación:
Registro de encabezado de archivo
Campo
1
Nombre
Tipo de registro
Long
2
Tipo
NUM
Req
SI
2
NIT empresa
facturadora
Fecha del
recaudo
Código entidad
financiera
recaudadora
Número de cuenta
10
NUM
SI
8
NUM
SI
AAAAMMDD
3
NUM
SI
TTT
17
ALF
SI
6
7
Fecha del archivo
Hora de grabación
del archivo
8
4
NUM
NUM
SI
SI
AAAAMMDD
HHMM
8
Modificador
de archivo
1
ALF
SI
A-Z,0-9
9
Tipo de cuenta
2
NUM
10
Reservado
107
ALF
3
4
5
Valor
01
[constante]
Descripción
Indica el tipo de registro
NIT de la empresa a la cual se le
realiza el recaudo
Fecha de la operación de
recaudo.
Código de compensación
(tránsito) de la entidad financiera
recaudadora.
Cuenta en la cual la entidad
recaudadora le abona los dineros
recaudados a la Empresa
Fecha de creación del archivo
Hora de grabación del archivo en
formato de hora militar, es decir
de 0001 hasta las 2400 horas.
Caracter que refleja el orden
cronológico de grabación de los
archivos y permite diferenciar
varios archivos generados en un
mismo día. Se emplean primero
las letras mayúsculas (A-Z) y
posteriormente los números.
Indica si el número de cuenta
corresponde a ahorros o
corriente.
01 AHORROS
02 CORRIENTE
03 TARJETA DE CRÉDITO
Registro de encabezado de lote
Campo
1
Nombre
Tipo de registro
2
Código del
servicio
recaudado
PLACETOPAY
Long
2
Tipo
NUM
Req
SI
13
NUM
SI
Valor
05
[constante]
Código EAN
o NIT
WWW.PLACETOPAY.COM
Descripción
Indica el tipo de registro
El código EAN 13 es asignado por
el IAC y se usa cuando la
empresa factura dos o más
servicios que deban ser
diferenciados o discriminados
ante el cliente receptor. El código
PÁGINA 6
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
3
Número de lote
4
Reservado
4
NUM
143
ALF
Long
2
Tipo
NUM
Req
SI
EAN 13 identifica el país (3
posiciones), la empresa principal
que factura (6), el tipo de servicio
facturado (3) y características
propias de cada convenio (1). El
NIT solo puede ser empleado por
aquellas Empresas que facturan
un único servicio o que no
manejen código EAN-13.
Consecutivo del lote dentro del
archivo. Cada archivo tiene su
propia secuencia de numeración
de lotes.
SI
Registro de detalle
Campo
1
Nombre
Tipo de registro
2
Referencia
principal
del usuario
48
NUM
SI
3
Valor recaudado
14
NUM
SI
4
Procedencia del
pago
2
NUM
SI
5
Medios de pago
2
NUM
SI
6
No de operación
6
NUM
NO
PLACETOPAY
Valor
06
[constante]
WWW.PLACETOPAY.COM
Descripción
Indica el tipo de registro
Es el código principal con el cual
el documento a pagar es
identificado en cada Empresa.
Puede referirse al número de
factura o al que designe la
Empresa Originadora.
Valor recaudo. 12 enteros, 2
decimales.
Indica el tipo de institución que
recibió el pago del cliente.
01 PAGO A TRAVÉS DE
BANCOS
02 PAGO A TRAVÉS DE
CORPORACIÓN DE AHORRO Y
VIVIENDA
03 PAGO A TRAVÉS DE ACH
COLOMBIA
04 PAGO A TRAVÉS DE
ASCREDIBANCO
05 PAGO A TRAVÉS DE ATH
06 PAGO A TRAVES DE CENIT
07 PAGO A TRAVÉS DE RED
MULTICOLOR
08 PAGO A TRAVÉS DE
SERVIBANCA
Indica el medio por el cual se
recibió el pago.
11 DÉBITO EN CUENTA POR
SISTEMA DE
AUDIORESPUESTA
15 DÉBITO EN CUENTA POR
INTERNET
21 TARJETA CRÉDITO POR
SISTEMA DE
AUDIORESPUESTA
25 TARJETA CRÉDITO POR
INTERNET
Número de cheque o número que
identifica la transacción
en los dispositivos electrónicos.
Corresponde al número o
PÁGINA 7
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
7
No de
autorización
6
NUM
NO
8
Código de la
entidad
financiera
debitada
Código de
sucursal
3
NUM
NO
000
4
NUM
SI
0000
10
Secuencia
7
NUM
SI
11
Causal de
devolución
Reservado
3
ALF
NO
65
ALF
NO
Long
2
Tipo
NUM
Req
SI
9
NUM
SI
18
NUM
SI
4
NUM
SI
129
ALF
9
12
consecutivo asignado por los
dispositivos electrónicos.
Número de autorización dada por
la entidad del cliente
(emisora o autorizadora), cuando
el pago se efectúa por
canales electrónicos (ATM, POS,
audioservicio).
Código de compensación de la
entidad financiera del cliente
donde se efectuó el débito. No
usado por PlacetoPay.
Código que identifica la sucursal,
ciudad o terminal (ATM,
POS) donde se efectuó el pago.
PlacetoPay siempre reportará
000.
Secuencia de grabación de
registro; inicia en 2
No usado por PlacetoPay.
Registro de control de lote
Campo
1
Nombre
Tipo de registro
2
Total registros del
lote
Valor total
recaudado en lote
3
4
Número de lote
5
Reservado
Valor
08
[constante]
Descripción
Indica el tipo de registro
Número total de registros
grabados en el lote.
Suma total de los valores de pago
de los registros de detalle en el
lote. 16 enteros, 2 decimales.
Consecutivo del lote dentro del
archivo. Cada archivo
tiene su propia secuencia de
numeración de lotes.
Registro de control de archivo
Campo
1
Nombre
Tipo de registro
Long
2
Tipo
NUM
Req
SI
2
Total registros
recaudados en
archivo
Valor total
recaudado en
archivo
Reservado
9
NUM
SI
Número total de registros tipo "6"
grabados en el archivo.
18
NUM
SI
Suma total de los valores de pago
de los registros de detalle. 16
enteros, 2 decimales.
133
ALF
3
4
Valor
09
[constante]
Descripción
Indica el tipo de registro
Archivo de facturación [ Formato CSV-propietario ]
Este formato nace del requerimiento de nuestros clientes por facilitar el cargue de facturas, en un
mecanismo más intuitivo y que pueda ser fácilmente ajustado al tamaño de la compañía que lo
PLACETOPAY
WWW.PLACETOPAY.COM
PÁGINA 8
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
desea cargar, sin implicar mayores esfuerzos y con la posibilidad de usar una hoja de cálculo
como motor de generación.
En sí mismo el archivo contiene los campos básicos usados por la plataforma para el proceso del
pago de una factura.
Como regla general el archivo es de longitud variable, usando la coma (,) como separador de
campo y la comilla doble como delimitador de campo para las cadenas de caracteres. En los
casos en que un campo no posea valor este deberá dejarse en blanco (,,). Cuando requiera
para un valor númerico establecer una cifra decimal, debe usar el punto. Una posible variación a
este formato es usar el punto y coma (;) para separar los campos y la coma (,) para las cifras
decimales. Tenga en cuenta que el orden de los campos es estricto.
El formato posee la siguiente estructura:
Registro de control de archivo
Registro de detalle 1
….
Registro de detalle n
Registro de control de archivo
Campo
1
2
Nombre
Fecha del archivo
Hora de grabación
del archivo
3
4
5
6
7
8
Long
8
4
Tipo
NUM
NUM
Req
SI
SI
Modificador
de archivo
1
ALF
SI
NIT empresa
recaudadora
Total de registros
en archivo
Código del
servicio facturado
10
NUM
SI
9
NUM
SI
13
NUM
SI
Descripción del
servicio
Facturado
Valor total
facturado en el
archivo
15
ALF
SI
18
NUM
SI
PLACETOPAY
Valor
AAAAMMDD
HHMM
A-Z,0-9
Código EAN
o NIT
WWW.PLACETOPAY.COM
Descripción
Fecha de creación del archivo
Hora de grabación del archivo en
formato de hora militar, es decir
de 0001 hasta las 2400 horas.
Caracter que refleja el orden
cronológico de grabación de los
archivos y permite diferenciar
varios archivos generados en un
mismo día. Se debe emplear
primero las letras mayúsculas (AZ) y posteriormente los números.
NIT de la empresa que presenta
la facturación
Número total de registros de
detalle grabados en el archivo.
El código EAN 13 es asignado por
el IAC y se usa cuando la
empresa factura dos o más
servicios que deban ser
diferenciados o discriminados
ante el cliente receptor. El código
EAN 13 identifica el país (3
posiciones), la empresa principal
que factura (6), el tipo de servicio
facturado (3) y características
propias de cada convenio (1). El
NIT solo puede ser empleado por
aquellas Empresas que facturan
un único servicio o que no
manejen código EAN-13.
Nombre del servicio facturado que
se le muestra al cliente receptor.
Suma total de los valores de pago
de los registros de detalle. 16
enteros, 2 decimales.
PÁGINA 9
DEFINICIÓN DE ARCHIVOS DE INTERCAMBIO PARA EL RECAUDO DE FACTURAS
Registro de detalle
Campo
1
Nombre
Referencia
principal
del usuario
2
3
4
5
6
7
Long
48
Tipo
NUM
Req
SI
Referencia
secundaria del
usuario
No. Identificación
del cliente
pagador
Nombre del
cliente pagador
Valor principal del
servicio
30
ALF
NO
10
ALF
NO
22
ALF
NO
14
NUM
SI
Fecha de
Vencimiento
Incremento al
vencimiento
8
NUM
SI
10
NUM
SI
Valor
Descripción
Es el código principal con el cual
el documento a pagar es
identificado en cada Empresa.
Puede referirse al número de
factura o al que designe la
Empresa Originadora.
Es el código con el cual el cliente
es identificado en la Empresa.
No. Identificación del cliente.
AAAAMMDD
8
Fecha de corte
8
NUM
SI
AAAAMMDD
9
Tipo de
incremento al
vencimiento
1
NUM
SI
0/1
Valor de la factura del servicio de
la Empresa principal. 12 enteros,
2 decimales.
Fecha de vencimiento de la
factura sin recargo
Valor del incremento diario a la
factura, cuando es pagada
después del vencimiento y hasta
el corte. 6 enteros, 4 decimales.
Si el valor es inferior a uno se
supone porcentual, en caso
contrario un valor fijo aplicado
diariamente.
Ej: 0000000150, representa el
1,5%.
Corresponde a la fecha hasta la
cual se recibe el pago de la
factura. Esta fecha debe ser
superior o igual a la fecha de
vencimiento.
Indica si el incremento al
vencimiento es un valor fijo [1] o si
es un valor diario [0].
Archivo de facturación [ Formato UBL-Invoice 1.0 ]
Desde su aprobación como una recomendación de la W3C en 1998, XML ha sido adoptado en
una serie de industrias como marco para la definición de los mensajes de intercambio en el
comercio electrónico. El uso generalizado de XML ha conducido al desarrollo de múltiples
versiones en XML de documentos básicos, tales como órdenes de compra, notas de envío y
facturas.
Si bien el uso de formatos específicos para cada industria o necesidad tiene la ventaja de la
máxima optimización para el contexto del negocio, la existencia de diferentes formatos para
lograr el mismo fin en diferentes ámbitos de negocio genera una serie de desventajas.
El OASIS Universal Business Language (UBL) se destina a ayudar a resolver estos problemas
mediante la definición de un formato genérico de intercambio XML para documentos de negocio
que puede ampliarse para satisfacer las necesidades de determinadas industrias
PlacetoPay usa el modelo propuesto OASIS en su implementación de UBL-Invoice en la versión
1.0.
PLACETOPAY
WWW.PLACETOPAY.COM
PÁGINA 10
Descargar