ER_PCREQ-4322_Importación_de_factura

Información general

   Leyenda: 1 – Innovación 2 – Mantenimiento (Los demás campos se deben completar para ambos procesos). 

Objetivo

Desarrollar una rutina para registrar las facturas enviadas por los diversos proveedores de la agencia de viajes. Además de las operaciones estándar de inclusión, modificación y borra, la rutina debe realizar la importación de los archivos TXT, conteniendo los datos de las facturas, enviados por las compañías aéreas o por consolidadores de facturación (ejemplo: BSP). 

Definición de la regla de negocio

La rutina de Inclusión/Importación será el archivo que recibirá uno o más archivos, referente a las facturas enviadas por las compañías aéreas o consolidadoras. Estos análisis y declaración de facturación de agente pueden enviarse de dos formas: electrónica y física; pero, independiente de ello, ambas deben incluirse/importarse por medio de este archivo.

Las facturas electrónicas pueden agruparse trayendo ítems de diversas compañías y, generalmente, se envían a la agencia mediante una consolidadora financiera o de facturación (BSP, por ejemplo), o puede enviarlas la propia compañía aérea. En ambos casos, el sistema generará solo un registro de inclusión/importación, donde la clave es el número de la factura.

Cada compañía aérea o consolidadora tiene su layout propio, pero, independiente de ello, los ítems de las facturas se importarán a una sola tabla del sistema con los datos debidamente verificados. Es decir, de acuerdo con el layout informado, se realizará un proceso de identificación de los atributos de la factura con los respectivos atributos de esta tabla. 

Como algunas compañías envían varios archivos electrónicos del mismo período, separados por puesto de atención (IATA), el sistema dejará disponible una funcionalidad donde el usuario podrá importar todos los archivos de un directorio, y vale resaltar que se creará un registro en la tabla de Facturas para cada archivo importado, referente a las facturas enviadas, y cada ítem importado se relacionará a su archivo de origen.

El(los) archivo(s) de una factura podrá(n) importarse varias veces. Para que acontezca, el registro de la factura incluida/importada anteriormente tendrá que borrarse y, consecuentemente, también se borrarán sus respectivos ítems. Pero una factura sólo podrá borrarse, cuando ningún ítem relacionado con ella haya sido aprobado. Para atender a esta necesidad, en este registro habrá la posibilidad de deshacer los procesos de aprobación de los ítems.

Al incluir o importar una factura, se mostrará al usuario una interfaz de parametrización donde él debe informar el tipo de importación, el proveedor (pudiendo ser de informe), mes, año, periodicidad, período, fecha de emisión, fecha de vencimiento, el número, el valor total y el layout de la factura, siendo que estos datos se almacenarán en una tabla del sistema. 

Para las facturas electrónicas, el usuario no necesitará informar los datos de la factura, pues el proceso de Integración mencionado antes será el responsable por identificar esta información. En el caso de facturas que no tengan su número informado, el sistema generará un número provisorio que el usuario podrá modificarlo o no. Después de efectivar la conciliación de la factura, este número no se podrá modificar.

Además, cuando sea una factura electrónica, el sistema importará los ítems automáticamente a una tabla del módulo Turismo. Con relación a las facturas físicas, deben incluirse normalmente, por medio de la misma interfaz e, independiente de ser física, el nombre del archivo de la factura podrá almacenarse en el archivo. Pero, diferente de una factura electrónica, los ítems de la factura física deben incluirse manualmente y, después de incluirlos, el usuario ejecutará el proceso de Asociación por medio del botón disponible en la pantalla de importación.

Los layouts disponibles para inclusión o importación de facturas consideran la información referente a las facturas de los proveedores aéreos y de otros tipos de productos comercializados por la agencia de viaje. Al incluir o importar una factura habrá un campo en el encabezado para registrar el layout originario, que puede ser: Aéreo localizador (GOL), Aéreo boleto (BSP) y Aéreo manual.  

En las facturas de las compañías aéreas o consolidadoras se enviará información de las emisiones y reemisiones referentes a las ventas de productos aéreos, realizadas por la agencia de viajes. Una vez concluido el proceso de importación, la rutina debe realizar la asociación de los ítems de la Factura con los posibles y respectivos Documentos de reserva. Para ello, se utilizará la información del Número de boleto y/o de localizador, conforme el layout seleccionado.

La rutina de importación se elaborará por medio de la herramienta MILE. Para efecto de implantación del módulo SIGATUR, deben estar disponibles las configuraciones previas de importación de los layouts en formato XML, para la incorporación de los layouts en el entorno del cliente. La importación en el Mile utilizará un adapter estándar MVC cuyo Model se comparte con una rutina de inclusión de Facturas para permitir el asiento manual (vía digitación por parte del usuario) para los casos en que la compañía aérea o consolidadora no envía archivos de interfaz, como es el caso de Azul Líneas Aéreas. El mismo proceso se utilizará cuando sea una factura.    

Operaciones

Definición técnica

• Desarrollar el fuente TURA038 en Model View Controller (MVC) para realizar el registro de Facturas aéreas en el formato de encabezado e ítems, utilizando el diccionario de datos de las tablas G6H y G6I.
• Crear la tabla G6H - Facturas Prov. Aéreo turismo.
  • G6H_FATURA - Código de la factura.
  • G6H_TIPO - Tipo de archivo/importación.
  • G6H_LAYOUT - Layout de la factura registrada/importada.
  • G6H_MES - Mes de referencia de la factura.
  • G6H_ANO - Año de referencia de la factura.
  • G6H_PERCID - Periodicidad de envío de la factura.
  • G6H_PERIOD - Período del mes de referencia de la factura.
  • G6H_FATFOR - Número de la factura.
  • G6H_EMISSA - Fecha de emisión de la factura.
  • G6H_VENCTO - Fecha de vencimiento de la factura.
  • G6H_VALOR - Valor de la factura.
  • G6H_FORNEC - Código del proveedor que envió la factura.
  • G6H_LOJA - Tienda del proveedor que envió la factura.
  • G6H_NREDUZ - Razón social del proveedor que envió la factura.
  • G6H_REPORT - Informa si el proveedor es de informe.
  • G6H_EFETIV - Informa si la factura se hizo efectiva.
  • G6H_DTIMP - Fecha de registro/importación de la factura.
  • G6H_ARQUIV - Nombre del archivo de la factura.

• Crear a tabla G6I - Ítems Factura Prov. Aéreo Turismo.
  • G6I_FATURA - Código de la factura.
  • G6I_ITEM - Código del ítem de la factura.
  • G6I_TIPOIT - Tipo del ítem.
  • G6I_NUMLIN - Número de la línea del ítem dentro de la factura.
  • G6I_NUMCIA - Número de la compañía aérea referente al ítem.
  • G6I_SRBILH - Serie del boleto.
  • G6I_BILHET - Número del boleto.
  • G6I_DGBILH - Dígito verificador del boleto.
  • G6I_LOCALI - Número del localizador.
  • G6I_EMISSA - Fecha de emisión del boleto.
  • G6I_TARIFA - Valor del boleto.
  • G6I_TAXAS - Valor de las tasas.
  • G6I_TAXADU - Valor de la Tasa DU.
  • G6I_PERCOM - Porcentaje de comisión.
  • G6I_VLRCOM - Valor de la comisión.
  • G6I_VLRINC - Valor del incentivo.
  • G6I_VLRREE - Valor del reembolso.
  • G6I_VLRLIQ - Valor neto.
  • G6I_TPOPER - Tipo de la operación.
  • G6I_TOURCD - Número del Tour Code.
  • G6I_DIVERG - Informa si el ítem tiene alguna divergencia.
  • G6I_CODDIV - Código de la divergencia encontrada.
  • G6I_ACERTO - Informa si se generó ajuste debido a divergencia.
  • G6I_SITUAC - Situación del ítem en la conciliación.
  • G6I_CONCIL - Código del proceso de conciliación al que se vinculó el ítem.
  • G6I_CODTAX - Código de la tasa aplicada en la reserva.
  • G6I_NUMID - Número único de identificación del registro de venta al que se vinculó el ítem.
  • G6I_IDITEM - Número secuencial del ítem de venta del registro de venta al que se vinculó el ítem.
  • G6I_NUMSEQ - Secuencia de identificación del ítem de venta al que se vinculó el ítem (reúne ítems relacionados).

• Desarrollar la función TURA038IMP en Model View Controller (MVC) para realizar la importación de Facturas aéreas y grabar el encabezado (G6H) y los ítems (G6I), donde se debe utilizar el siguiente layout MILE y función: 
  • Cuando la importación sea Aéreo boleto (BSP): utilice el layout MULE TURA038B.
  • Cuando la importación sea Aéreo localizador (GOL): utilice la user function U_TURA038G.
• El campo G6H_FATURA será clave de la tabla, no pudiéndose repetirse, pues será secuencial y completado automáticamente.
• El campo G6H_PERIOD se verificará mediante la cumplimentación del campo G6H_PERCID. A saber:

• El campo G6H_TIPO de la importación determinará la obligatoriedad de los campos G6H_ARQUIV, G6H_LAYOUT, G6H_FATFOR, G6I_EMISSA, G6H_VENCTO y G6I_TARIFA, en contrapartida, todos los demás atributos tienen complemento obligatorio. Validaciones:

• Cuando el campo G6H_TIPO se seleccione como “Directorio” o “Archivo”, mediante la integración el sistema completará automáticamente los atributos G6H_FATFOR, G6I_EMISSA, G6H_VENCTO y G6I_TARIFA.
• Cuando el campo G6H_TIPO se seleccione como “Físico”, el campo G6H_LAYOUT se completará automáticamente con la opción "Aéreo manual" y no se podrá modificar.
• Los campos G6H_FORNEC y G6H_LOJA estarán vinculados al registro de Proveedor y, cuando se informen, el campo G6H_NREDUZ se completará automáticamente con la razón social del proveedor seleccionado.
• El campo G6H_DTIMP se complementa automáticamente por el sistema con la fecha en que se realiza la importación.

El layout de la factura GOL comprende las ventas de aéreo, identificadas por el número de la factura, código PNR y número del boleto emitido.

La estructura del archivo de factura de GOL es del tipo CSV, con número de líneas variable, conforme la cantidad de ventas del período al que pertenece el archivo, tanto de los movimientos de ventas domésticas como de ventas internacionales y reintegros. Los trechos que contienen los movimientos no tienen un tipo de separador específico, solo un identificador de que, en determinado punto, hay un trecho con ventas internacionales, domésticas o reintegro.

De esta forma, tenemos la siguiente estructura del archivo GOL en la siguiente tabla:

Las primeras diez líneas del archivo de facturas del layout GOL se presentan de la misma manera, o sea, independiente del archivo recibido, la estructura inicial se compondrá de las diez líneas descritas en la tabla anterior. De la décima primera línea en adelante se presentarán las ventas contenidas en la factura, pudiendo ser ventas domésticas, internacionales o reintegros.

Para identificar las ventas que se presentarán, las líneas de ventas domésticas e internacionales se presentarán de la siguiente forma:

• Ventas domésticas.
• Ventas internacionales.

 Cada uno de estos bloques se divide con una línea, conteniendo el subtotal referente a los tipos de venta, por ejemplo:

• Subtotal ventas domésticas.
• Subtotal ventas internacionales.

 En cada bloque, tanto de ventas domésticas como de ventas internacionales, el trecho de reintegro se incluirá dentro de cada bloque de ventas, conteniendo los movimientos de reembolso de este período.

La presentación de los movimientos de venta en el archivo se hará conforme el siguiente ejemplo (cada columna en de/a corresponde al ID GOL010A hasta el ID GOL010L):

Ventas domésticas:

ABK85P;2134473232;22/10/2014;0,00;856,90;107,26;-85,69;2,36;0,00;0,00;-83,33;CA 5314************

AB9U6C;2135286244;31/10/2014;0,00;1818,80;220,40;-181,88;5,00;0,00;0,00;-176,88;CA 5314************

ADCSKM;2135187290;30/10/2014;0,00;1395,80;175,19;-139,58;3,84;0,00;0,00;-135,74;CA 5314************

AEUBNW;2134582030;23/10/2014;0,00;446,90;66,26;-44,69;1,23;0,00;0,00;-43,46;CA 5314************

AEUZNW;2134384482;21/10/2014;0,00;235,90;64,03;-40,00;1,10;0,00;0,00;-38,90;CA 5314************

AM4ENB;2134712095;24/10/2014;0,00;1589,90;180,56;-158,99;4,37;0,00;0,00;-154,62;CA 5314************

BCG6QP;2134405329;21/10/2014;0,00;114,90;63,37;-40,00;1,10;0,00;0,00;-38,90;CA 5314************

BCG7QP;2134405330;21/10/2014;0,00;511,90;72,76;-51,19;1,41;0,00;0,00;-49,78;CA 5314************

BDHV2J;2134504079;22/10/2014;0,00;362,90;64,03;-40,00;1,10;0,00;0,00;-38,90;CA 5314************

BHZ4SQ;2134415609;21/10/2014;0,00;904,90;112,06;-90,49;2,49;0,00;0,00;-88,00;CA 5314************

BL6GPE;2134460302;22/10/2014;0,00;1415,80;187,18;-141,58;3,89;0,00;0,00;-137,69;CA 5314************

BMGZWB;2134631036;23/10/2014;0,00;836,80;126,82;-83,68;2,30;0,00;0,00;-81,38;CA 5314************

BYIKNV;2134632703;23/10/2014;0,00;409,80;84,12;-40,98;1,13;0,00;0,00;-39,85;CA 5314************

B9DDFY;2134401509;21/10/2014;0,00;172,90;63,37;-40,00;1,10;0,00;0,00;-38,90;CA 5314************

B9DDFY;2135189377;30/10/2014;0,00;0,00;0,00;0,00;0,00;0,00;0,00;0,00;VI 4108************

En el ejemplo anterior es posible identificar que el mismo localizador puede ocurrir varias veces, indicando que hubo remarcación, modificación y etc. para aquel localizador, generando boletos diferentes.

Después de algunas líneas, ciertas tasas y multas se muestran utilizando los siguientes identificadores en las líneas, así:

Cuando el bloque sea de ventas internacionales, el bloque se iniciará de la siguiente forma:

OS;;;;;20,00;;;;;;;;;

AA;;;;;240,00;;;;;;;;;

DT;;;;;-1,80;;;;;;;;;

XC;;;;;100,00;;;;;;;;;

DP;;;;;-24,02;;;;;;;;;

OCDiffs;;;;;-45,00;;;;;;;;;

OCPenalty;;;;;467,90;;;;;;;;;

OCNoShow;;;;;150,00;;;;;;;;;

OCReemb;;;;;64,12;;;;;;;;;

Observando las líneas anteriores, todos los valores presentados están dispuestos en la columna “Tasas”, que es la sexta columna de la izquierda para la derecha.

En la siguiente tabla hay una descripción de todos los tipos de tasas que pueden ocurrir en el archivo de integración GOL y sus descripciones:

Las tasas se importarán con el Tipo de ítem (G6I_TIPOIT) tipo "4" (Reemisión). Con base en la tabla G6K, se realizará 

un DE/A de los códigos de Tasas GOL para los códigos de tasas internas registradas en la tabla G3A. Este código de tasa
se almacena en el campo G6I_CODTAX.

Dentro de un bloque con ventas domésticas y/o ventas internacionales, se iniciarán los bloques de reembolso, conforme siguiente ejemplo:

Reembolsos

A8I9WY;2408052045;22/10/2014;0,00;0,00;0,00;0,00;0,00;0,00;0,00;0,00;AX 376************

DP;;;;;-24,02;;;;;;;;;

DFKQMG;2135195565;31/10/2014;0,00;-1175,80;-38,52;0,00;0,00;0,00;0,00;0,00;CA 5314************

OCPenalty;;;;;467,90;;;;;;;;;

XC;;;;;240,00;;;;;;;;;

EEQ8QJ;2134625747;24/10/2014;0,00;-1280,90;-21,57;0,00;0,00;0,00;0,00;0,00;CA 5314************

OCPenalty;;;;;116,09;;;;;;;;;

XC;;;;;120,00;;;;;;;;;

GYQ6KV;2134673065;25/10/2014;0,00;-1201,90;-21,57;0,00;0,00;0,00;0,00;0,00;CA 5314************

OCPenalty;;;;;540,95;;;;;;;;;

XC;;;;;120,00;;;;;;;;;

Dentro de esta estructura, las columnas presentadas van a contener los siguientes datos de las facturas:

• PNR – número del localizador.
• Boleto – número del boleto generado para el localizador.
• Fecha – fecha de generación del boleto.
• Tarifa de contado.
• Tarifa crédito.
• Tasas.
• Tarifa DU.
• CC DU/SU.
• Comisiones.
• Incentivo.
• Neto.
• Observaciones.

De esta forma, tenemos en las primeras 10 líneas los datos del “encabezado” de la factura y, de la 11ª línea en adelante, los datos referentes a los ítems de esta factura, sus tasas, reembolsos y multas. Estos datos alimentarán las tablas de facturas aéreas, permitiendo que la rutina de conciliación haga el procesamiento de los datos recibidos versus los movimientos realizados en el sistema.

Los entes alimentados por los registros incluidos en el archivo serán “Factura” e “Ítems de la factura”:

En la generación de la factura a partir de los archivos con layout GOL, el número de la factura debe generarse con la concatenación del código IATA enviado en el ID GOL005B más el número secuencial que se genera y controla por la rutina del backoffice. Ejemplo:

-          Código IATA: 57518016

-          Número generado: 000001

-          Número de la factura: 8016000001 (8016 + 000001)

• Detalle del layout MILE TURA038B:

El layout BSP IATA se estructura en bloques, cuyas líneas contienen los datos de las facturas generadas delimitados en tamaño fijo, sin uso de separador. Lo que diferencia el layout normal del layout simplificado es la presencia de todos o de solo algunos tipos de registros en el archivo. Todo archivo BSP IATA puede contener la siguiente estructura, conforme el siguiente ejemplo: 

Header record (Registro de encabezado)

El header (encabezado) del archivo se define en la siguiente estructura:

Transaction Record (Registro de transacción)

El registro de transacción del archivo se define en la siguiente estructura:

Credit Form of Payment Record (Registro de crédito de forma de pago)

El registro de crédito de forma de pago se define en la siguiente estructura:

Related document record (Registro de documentos relacionados)

El registro de crédito de forma de pago se define en la siguiente estructura: 

Conjunction Document Record (Registro de documento conjunto)

El registro de documento conjunto se define en la siguiente estructura:

Trailer Record (Registro de trailer) 

El Trailer del archivo se define en la siguiente estructura: 

El archivo se desarrollará en el formato de encabezado (factura) y solapas, cada solapa con su respectiva funcionalidad. A saber: 

• • ENCABEZAdO: local donde se grabará la información proporcionada por el usuario al incluir o importar la Factura y donde constará el atributo que controlará su estatus. El atributo de estatus también se utilizará por la leyenda; 
    
    
  • SOLAPA - BOLETOS / DOCUMENTOS – en esta solapa se podrán visualizar todos los ítems importados o incluidos, pudiendo filtrarlos, identificando si cada ítem ya se asoció y/o aprobó. En esta solapa, cuando el atributo “Layout” sea igual “Análisis y declaración de facturación de agente manual” u “Otros”, estará disponible una acción referente al proceso de generación de las conciliaciones, a través de un botón disponible al lado derecho de la pantalla (vea prototipo - Importación de facturas – Boletos / Documentos). Cuando el usuario ejecute esta acción, se realizarán los procesos de asociación y, caso necesario, ajustes. El resultado final de esta acción es la generación de uno o más procesos de conciliación, separadas por IATA’s  y por el tipo de ítem de la factura.

Atributos

(*) – Campos obrigatórios

(**) – Campos chaves da tabela 

Ítems de la factura (validar los ítems junto con el proceso de integración) 

Consideraciones:

• Los atributos “Cód. Factura” e “Ítem” son claves de la tabla y no se podrán repetir.
• El atributo “Ítem” será un número secuencial, por factura, de control interno del sistema y completado automáticamente.
• Al asociar un ítem y si se encuentra una divergencia, el valor del atributo “Divergente” debe modificarse para “Sí” y el atributo “Obs. Diverg.” deberá completarse con una breve descripción sobre la divergencia encontrada.

Diccionario de datos

TABLA G6H – Encabezados de las facturas

• Achivo SIX – Índices

• Archivo SX2 – Tabla

• Archivo SX3 – Campos de la tabla

TABLA G6I – Ítems de las facturas

• Archivo SIX – Índices

• Archivo SX2 – Tabla

• Archivo SX3 – Campos de la tabla

Prototipos de pantalla

Factura de proveedor – Browser 

Atributos de la interfaz de parametrización para importación

Factura de proveedor – Encabezado 

Factura de proveedor – ABA: Boletos / Documentos – Layout: BSP Simplificado

Factura de proveedor – Boletos / Documentos – Layout: Aéreo localizador

Flujo del proceso

Ente y relación

Casos de pruebas

Un caso de prueba contiene informaciones generales que determinan cómo pruebas anteriormente especificados por el Plan de pruebas deben conducirse. Generalmente, se agrupan por requisito. Sin embargo, es posible agrupar casos de pruebas por conjunto de requisitos, cuando las pruebas estén verificando de forma integrada lo requisitos que pertenecen a este conjunto.

Los casos de pruebas mencionados a seguir deben ejecutarse para garantizar la calidad del producto, atendiendo a la finalidad del proyecto y los resultados esperados.

1. 1.       Caso(s) de pruebas reutilizable(s)

1. 2.       Caso(s) de pruebas específica(s) del proyecto