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
