Para poder emitir vouchers de asistencia, cotizar cualquier plan de asistencia, consultar coberturas para cada plan y otras tareas, su empresa puede conectar sus sistemas, sitios web, o intranets al sistema de transacciones (Sistema de Emisión). A este proceso lo denominaremos "integración".

Una vez finalizado, su empresa, a través de su sitio web, portal web o intranet, podrá emitir tarjetas (vouchers) de asistencia en viaje desde cualquier punto del planeta, en la moneda y en el idioma que se requiera.

Los WebServices se desarrollaron utilizando estándares que garantizan la seguridad y confiabilidad de cada transacción y tambien que se adaptan a cualquier plataforma de desarrollo existente.

El sistema de emisión es un sistema basado en web que permitirá la emisión de vouchers de asistencia en viaje.

El presente manual de integración está dirigido a los usuarios de perfil técnico (analistas, ingenieros o programadores) que son quienes podrán llevar adelante la integración de vuestros sistemas con nuestro sistema de emisión.

Este manual de integración desde su sitio Web, portal web o intranet proporciona información sobre la mayoría de las funciones que los servicios web proveen, así como explicaciones de cómo utilizarlas para cubrir sus necesidades en la venta automatizada de asistencia en viaje.

2.1. Qué es el Sistema de Emisión

El sistema de emisión es en esencia, un sistema muy flexible de emisión de asistencias al viajero que además posee la característica de ser escalable. También ofrece al usuario múltiples funciones, consultas y reportes y posee la característica de ser un sistema de muy fácil uso, tanto para un usuario de administración como para los usuarios de una agencia de viajes que desea emitir una asistencia en viaje a su cliente.

2.2. Qué es un web service

Un Web service es básicamente un conjunto de protocolos y estándares que sirven para el intercambio de datos entre aplicaciones. Distintas aplicaciones de software desarrolladas en lenguajes de programación diferentes, y ejecutadas sobre cualquier plataforma, pueden utilizar los Web Services para intercambiar datos tanto en redes de computadores como Internet. La interoperabilidad se logra mediante la adopción de estándares abiertos. En el caso de nuestros Web Services , utilizaremos JSON que será el formato estándar para los datos que se vayan a intercambiar.

2.3. Ventajas de los Web Services

• Aportan interoperabilidad entre aplicaciones de software independientemente de sus propiedades o de las plataformas sobre las que se instalen.
• Los Web Services fomentan los estándares y protocolos basados en texto, que hacen más fácil acceder a su contenido y la comprensión de su funcionamiento.
• Al apoyarse en HTTP, los servicios Web pueden aprovecharse de los sistemas de seguridad firewall sin necesidad de cambiar las reglas de filtrado.
• Permiten que servicios y software de diferentes compañías ubicadas en diferentes lugares geográficos puedan ser combinados fácilmente para proveer servicios integrados.
• Permiten la interoperabilidad entre plataformas de distintos fabricantes por medio de protocolos estándar y abiertos, entonces se garantiza la plena interoperabilidad entre aplicaciones.

2.4. A quién están dirigidas estas herramientas (web services)

Este manual está dirigido a las áreas de desarrollo de programación de empresas que deseen integrar sus sistemas o sitios web a nuestros sistema de emisión mediante el uso de los Web Services. En estas empresas se podrían incluir:

• Portales de viajes que ya ofrecen reservas de pasajes aéreos o terrestres y que quieran añadir a sus servicios la opción de vender asistencias en viaje.
• Sitios web de agencias de viaje: que podrán agregar la opción de ofrecer asistencias en viaje a las opciones que ya ofrecen en su sitio web.
• Sistemas informáticos en agencias de viaje que deseen poder integrar a sus aplicaciones la venta de tarjetas de asistencia al viajero en forma automatizada.
• Intranets o Extranets corporativas de una empresa que necesite integrar estos servicios en sus sistemas.
• Sitios web de líneas aéreas: que ofrecen reservas online y podrían agregar un servicio al pasajero en dónde podrán adquirir en el mismo momento de su reserva, su asistencia en viaje, con un sólo click.
• Sitios web especializados en venta de asistencias en viaje que deseen agregar la opción de venta de asistencia en viaje en forma totalmente automatizada.
• Cualquier portal web que ofrezca servicios al viajero y quiera agregar la opción de comercializar asistencia al viajero

3.0.1 Utilice este manual de integración de los Web Services para:

• Poder programar o desarrollar la integración de manera rápida y sin inconvenientes, aprovechando al máximo la funcionalidad que los Web Service le proveen.
• Conocer las técnicas y herramientas (funciones) más avanzadas para sacar el máximo partido a los servicios provistos por los Web Services.
• Conocer que información debe enviar a, y recibir de los web services
• Conocer el funcionamiento de los web services para visualizar mejor el flujo de los datos.

3.0.2 Este manual de integración incluye información e instrucciones del uso de las siguientes funciones

• Emitir un voucher de asistencia.
• Obtener datos de un voucher emitido.
• Obtener el detalle de un producto o plan de asistencia.
• Obtener la lista de beneficios de un plan de asistencia.
• Cotizar un plan de asistencia (obtener el precio para un determinado rango de fechas).
• Obtener la lista de tarifas día a día para un plan de asistencia.
• Obtener el precio de un determinado voucher emitido.
• Poder solicitar la anulación de un voucher ya emitido.
• Obtener el status de un voucher.
• Obtener los tipos de documento que maneja el sistema de Emisión.
• Obtener las monedas en que se representan los valores de las asistencias en viaje.
• Obtener lista de países desde donde se puede comercializar asistencia al viajero.
• Obtener regiones de validez de un plan de asistencia.

2.6. Cómo funcionan los Web Services

Los webservices funcionan mediante peticiones con el método POST por HTTP y retorna datos en formato json en codificación UTF-8.

El sistema usa autenticación web para el control de los usuarios del servicio.

El uso de estos web services es totalmente independiente de la plataforma tecnológica que su empresa haya utilizado en sus sistemas (ASP.NET, PHP, Java, etc.). Es decir, no importa el tipo de servidores dónde corra la aplicación de su empresa, no importan el lenguaje de programación o las tecnologías que se utilizaron para desarrollar los sistemas.

Como describimos más arriba, los web services utilizan json para devolver la información que se solicita. Para ello se proveen una amplia cantidad de funciones que permitirán: emitir vouchers, solicitar anulación de un voucher, obtener los productos disponibles para la venta, los países y regiones del sistema, cotizar, etc.

3.1 URL de Producción y Sandbox

Obtener los datos de una emisión.
Tener en cuenta que la emisión tiene todos los vouchers, uno para cada uno de los viajeros.

Datos de entradahtml

Datos de salida json

{
    "EmissionId": 135833,
    "EmissionStateId": 5,
    "ccgg": "",
    "Vouchers": [
        {
            "ExternalReference": "",
            "VoucherId": "CL201012000001",
            "VoucherUrl": "",
            "ProductId": 5555,
            "CCGGUrl": "",
            "FirstName": "John",
            "LastName": "Doe",
            "BirthDate": "1972-02-01T00:00:00",
            "Passport": "AB123456"
        },
        {
            "ExternalReference": "",
            "VoucherId": "CL201012000002",
            "VoucherUrl": "",
            "ProductId": 5555,
            "CCGGUrl": "",
            "FirstName": "Mary",
            "LastName": "Doe",
            "BirthDate": "1971-01-21T00:00:00",
            "Passport": "AB123457"
        }
    ],
    "Error": null
}

Obtener un listado de las monedas y sus conversiones dentro del sistema de emisión.
Las monedas y sus conversiones ayudan a mostrar el valor de los productos en una cotización en la moneda deseada.
Se usan por otra parte estas conversiones monetarias debido al compromiso de pago en la moneda y conversión del dia y hora de emisión.

Datos de entrada html

Datos de salida json

[{
"Id": 1,
"TranslateValue": 1.132993536, 
"Symbol": "€",
"Iso": "EUR"
},
{"Id": 2,
"TranslateValue": 0.025510204, 
"Symbol": "AR$",
"Iso": "ARS"
}]

Obtener la lista de países de salida del viaje.
Tener en cuenta que en principio la comercialización solo podra efectuarse en el país de residencia de la cuenta.
Si tiene intenciones de comercializar en otros países deberá comunicarse con su asesor comercial.

Datos de entradahtml

Datos de salida json

[{
"Id": 170,
"Name": "Colombia",
"IsoCode": "CO"
},
{
"Id": 171,
"Name": "Mexico",
"IsoCode": "MX"
},
{
"Id": 172,
"Name": "Ecuador",
"IsoCode": "EC"
}]

Obtener la lista de regiones admitidas para la venta de asistencias en viaje.
Las regiones representan zonas de destino de sus viajes.

Datos de entradahtml

Datos de salida json

[{
"Id": 1003,
"Name": "África"
},
{
"Id": 1001,
"Name": "América Central"
},
{
"Id": 1000,
"Name": "América del Norte"
},
{
"Id": 1002,
"Name": "América del Sur"
},
{
"Id": 1005,
"Name": "Asia"
},
{
"Id": 1004,
"Name": "Europa"
},
{
"Id": 1013,
"Name": "Receptivos"
},
{
"Id": 1006,
"Name": "Resto del Mundo"
}]

Obtener los productos disponibles para comercializar.
Estos productos describen ademas todas las coberturas que poseen.
1** : Recomendamos CACHING de esta información de su lado con el fin de agilizar los procesos.
2** : Recomendamos tambien actualizarlos diariamente.

Datos de entradahtml

Datos de salida json

[{
"Id": 3525,
"Name": "Work & Travel Premium", 
"ccgg": "Url_CCGG",
"TripTypeId": 1,
"TripTypeAnnualId": 0,
"CurrencyId": 0,
"Residences": [
    {
        "Id": 152,
        "Name": "Chile",
        "IsoCode": "CL"
    }
],
"Destinations": [
    {
        "Id": 1001,
        "Name": "América Central"
    },
    {
        "Id": 1002,
        "Name": "América del Sur"
    },
    {
        "Id": 1012,
        "Name": "Países limítrofes"
    }
],
"Coverages": [{
              "Id": 5413,
                "Name": "Asistencia Médica en caso de accidente", "Value": "USD 100.000",
                "ProductId": 0
               },
               {"Id": 5463,
                "Name": "Asistencia Médica en caso de enfermedad", "Value": "USD 100.000",
                "ProductId": 0
                }]
},
{
"Id": 3531,
"Name": "Gold",
"ccgg": "Url_CCGG", 
"TripTypeId": 1,
"TripTypeAnnualId": 0,
"CurrencyId": 0,
"Coverages": [{
               "Id": 5413,
               "Name": "Asistencia Médica en caso de accidente",
               "Value": "USD 40.000",
               },
               {
               "Id": 5463,
               "Name": "Asistencia Médica en caso de enfermedad",
               "Value": "USD 40.000",
               }]
}]
                                         

Obtener la lista de culturas para luego mostrar consultas en la cultura correspondiente.

Datos de entradahtml

Datos de salida json

[{
"Id": "en-US",
"Language": "Ingles",
"Country": "Estados Unidos"
},
{   
"Id": "es-ES",
"Language": "Español",
"Country": "España"
},
{
"Id": "pt-BR",
"Language": "Portugues",
"Country": "Brasil"
}]

Obtener los tipos de productos que podemos comercializar.
Tener en cuenta lo siguiente:
Los productos pueden ser de viajes único o de multiples viajes es una vigencia de 1 ano.
Viaje Único: La cobertura de un producto comienza en una fecha de salida y finaliza a la fecha de regreso del viaje.
Anual Múultiples Viajes: La Vigencia sera anual (Durante un año se podra utilizar pero no tendra cobertura todo el año. Solo los días en destino tendrán cobertura).
Los multi-viajes tendrán días en destino (hasta 30, hasta 60, hasta 90) en los que tendrán cobertura.
Luego a su regreso en país de residencia carece de cobertura.
De esta manera un viajero de negocios podría viajar hasta 30, 60, 90 días con cobertura. Regresa a su país y puede volver a utilizarlo.

Datos de entradahtml

Datos de salida json

[{
"Id": 1,
"Name": "Viaje Único"
},
{
"Id": 2,
"Name": "Anual Multiples Viajes"
}]

Obtener la lista de "días de cobertura" para un producto anual de multiples viajes.

Datos de entradahtml

Datos de salida json

[
{
"Id": 1,
"Name": "30 días"
},
{
"Id": 2,
"Name": "60 días"
},
{
"Id": 3,
"Name": "90 días"
}]

Obtener a partir de una cotización, las tarifas para todos los producto que se adapten a su destino.

Datos de entradahtmljson

{
    "Email":"test@test.com",
    "CultureId": "es-ES", 
    "CurrencyId":2,
    "TripTypeId": 1,
    "TripTypeAnnualId": 0,
    "Ages":[20,23,45],
    "Trip":{
            "ResidenceId":152,
            "DestinyId": 1000,
            "DateFrom": "2022-05-01",
            "DateTo": "2022-05-11",
            "TripTypeId": 1,
            "TripTypeIdAnnual": 0
            }
}

Datos de salida json

{
    "QuotedProducts": [
        {
            "ProductId": 2556,
            "Quotes": [
                {
                    "Age": 45,
                    "Discount": 0.0,
                    "DiscountName": "50% OFF del 2do. al 5to. viajero",
                    "CurrencyId": 3,
                    "Cost": 97.000000000
                },
                {
                    "Age": 23,
                    "Discount": 50.0,
                    "DiscountName": "50% OFF del 2do. al 5to. viajero",
                    "CurrencyId": 3,
                    "Cost": 97.000000000
                },
                {
                    "Age": 20,
                    "Discount": 50.0,
                    "DiscountName": "50% OFF del 2do. al 5to. viajero",
                    "CurrencyId": 3,
                    "Cost": 97.000000000
                }
            ]
        },


        ...


        ,
        {
            "ProductId": 3232,
            "Quotes": [
                {
                    "Age": 45,
                    "Discount": 50.0,
                    "DiscountName": "50% de Descuento",
                    "CurrencyId": 3,
                    "Cost": 137.000000000
                },
                {
                    "Age": 23,
                    "Discount": 50.0,
                    "DiscountName": "50% de Descuento",
                    "CurrencyId": 3,
                    "Cost": 137.000000000
                },
                {
                    "Age": 20,
                    "Discount": 50.0,
                    "DiscountName": "50% de Descuento",
                    "CurrencyId": 3,
                    "Cost": 137.000000000
                }
            ]
        }
    ]
}

Se utiliza para obtener el estado actual de una emisión.
Devolverá cuatro valores posibles: Cerrada Pendiente de anulación Anulada

Datos de entradahtml

Datos de salida json

[próxima actualización del manual de integración]

Solicitud de cancelación de emisión.
Se podrá Anular una emisión que aún no entró en vigencia.
En las primeras 24hs se podrá anular sin restricciones.
Desde las 24hs hasta el inicio de vigencia se podrá hacer un pedido de anulación.
Recordar que es necesario siempre poner la descripción y el tipo de razón o motivo de anulación.

Los ids válidos para el motivo de anulación (ReasonTypeId) son los siguientes:
2 : Reemisión
3 : Cancelación de viaje
4 : Enfermedad o fallecimiento del pax o familiar directo
6 : Decisión del pasajero
7 : Acuerdos Comerciales
8 : Prueba
9 : Error

Datos de entradahtmljson

{
   "EmissionId": 123456,
   "ReasonTypeId": 1,
   "ReasonDescription": "Aquí va el motivo por el cual se requiere la cancelación"
}

Datos de salida json

Anulación Correcta

{
   "success": true,
   "message": "La emisión se ha anulado."
}
{
   "success": true,
   "message": "Se ha creado un pedido de anulación sobre la emisión."
}

Anulación Incorrecta

{
   "success": false,
   "message": "La cuenta no es válida."
}
{
   "success": false,
   "message": "La emisión no es válida (EmissionId)."
}
{
   "success": false,
   "message": "Debe ingresar el id de motivo de anulación (ReasonTypeId)."
}
{
   "success": false,
   "message": "La cuenta no se encuentra habilitada."
}
{
   "success": false,
   "message": "El id de motivo de anulación (ReasonTypeId) no es válido."
}
{
   "success": false,
   "message": "Debe ingresar el motivo de anulación (ReasonDescription)."
}

Antes de procesar la emisión, verifica que toda la información sera aceptada por el sistema de emisión. De esta manera puedes informar al cliente o realizar las correcciones de información para poder hacer la verificación y el envío nuevamente.

Datos de entradahtmljson

{
"CultureId" : "es-ES"
,"Email": "email@test.com"
,"CurrencyId" : 3
,"ProductId" : 2556
,"PaymentType": "CURRENTACCOUNT"
,"Trip":{
        "DateFrom" : "2021-12-01"
        ,"DateTo" : "2021-12-10"
        ,"ResidenceId" : 152
        ,"DestinyId" : 1000
        ,"TripTypeId" : 1
        ,"TripTypeAnnualId" : 0
        }
,"Travelers":
            [{
            "ExternalReference" : "j0001"
            ,"FirstName" : "Juan"
            ,"LastName" : "Perez"
            ,"BirthDate" : "1980-03-20"
            ,"Passport" : "12345678"
            ,"City" : "Bahia Blanca"
            ,"State" : "Buenos Aires"
            ,"Country" : "Argentina"
            ,"Address" : "Alem 444"
            ,"Phone" : "555-1234"
            ,"Email" : "juan.perez@gmail.com"
            ,"EmergencyFirstName" : "Lucia"
            ,"EmergencyLastName" : "Pacheco"
            ,"EmergencyPhone" : "555-9876"
            ,"EmergencyEmail" : "lucia.pacheco@gmail.com"
            }
            ,{
            "ExternalReference" : "g0001"
            ,"FirstName" : "Guillermina"
            ,"LastName" : "Perez"
            ,"BirthDate" : "2015-06-10"
            ,"Passport" : "50123123"
            ,"City" : "Bahia Blanca"
            ,"State" : "Buenos Aires"
            ,"Country" : "Argentina"
            ,"Address" : "Alem 444"
            ,"Phone" : "555-1234"
            ,"Email" : "juan.perez@gmail.com"
            ,"EmergencyFirstName" : "Lucia"
            ,"EmergencyLastName" : "Pacheco"
            ,"EmergencyPhone" : "555-9876"
            ,"EmergencyEmail" : "lucia.pacheco@gmail.com"
            }]
}

Datos de salida json

Checkeo Correcto

{
"success": true
,"message": "Los datos son correctos."
}

Checkeos Incorrectos

{
"success": false,
"message": "El id de producto ingresado no es válido"
}

{
"success": false
,"message" : "El email ingresado no es válido"
}

{
"success": false,
"message": "El pasaporte del viajero (<apellido>, <nombre>) figura en un voucher dentro del período consultado."
}

{
"success": false,
"message": "La cuenta no tiene habilitada ninguna forma de pago válida para la ejecución de este servicio."
}

Una vez realizada la verificación a traves de CheckAddVouchers podremos EMITIR en el sistema.
Recuerde que para poder realizar una emisión se deberá tener como medio de pago la posibilidad de tener "crédito"/"cuenta corriente" en el sistema.
Debes contactarte con tu ejecutivo para lograr un acuerdo y obtener "crédito".

Los métodos CheckAddVoucher y AddVoucher admiten el valor MERCADOPAGO en el parámetro PaymentType del body de la solicitud POST.

Para el caso de AddVoucher:
   - Si la cuenta tiene habilitado el medio de pago MercadoPago, el servicio devuelve en la respuesta un campo llamado PaymentLink, que contiene la URL para realizar el pago.
   - Una vez finalizado el pago en MercadoPago, el usuario es redirigido a la URL de retorno configurada en nuestros datos de cuenta.
   - Además, cuando MercadoPago confirma el resultado de la operación, nos notifica a nosotros, y a su vez nosotros notificamos a la cuenta en la URL webhook que nos haya sido informada previamente.

Es importante tener en cuenta que en algunos casos MercadoPago puede demorar varias horas en autorizar un pago.
Si no se recibe confirmación dentro de los primeros 5 minutos, la cuenta puede consultar el estado de la emisión mediante el método GetEmission.

Datos de entradahtmljson

{
"CultureId" : "es-ES"
,"Email": "email@test.com"
,"CurrencyId" : 3
,"ProductId" : 2556
,"PaymentType": "CURRENTACCOUNT"
,"Trip":{
        "DateFrom" : "2021-12-01"
        ,"DateTo" : "2021-12-10"
        ,"ResidenceId" : 152
        ,"DestinyId" : 1000
        ,"TripTypeId" : 1
        ,"TripTypeAnnualId" : 0
        }
,"Travelers":
            [{
            "ExternalReference" : "j0001"
            ,"FirstName" : "Juan"
            ,"LastName" : "Perez"
            ,"BirthDate" : "1980-03-20"
            ,"Passport" : "12345678"
            ,"City" : "Bahia Blanca"
            ,"State" : "Buenos Aires"
            ,"Country" : "Argentina"
            ,"Address" : "Alem 444"
            ,"Phone" : "555-1234"
            ,"Email" : "juan.perez@gmail.com"
            ,"EmergencyFirstName" : "Lucia"
            ,"EmergencyLastName" : "Pacheco"
            ,"EmergencyPhone" : "555-9876"
            ,"EmergencyEmail" : "lucia.pacheco@gmail.com"
            }
            ,{
            "ExternalReference" : "g0001"
            ,"FirstName" : "Guillermina"
            ,"LastName" : "Perez"
            ,"BirthDate" : "2015-06-10"
            ,"Passport" : "50123123"
            ,"City" : "Bahia Blanca"
            ,"State" : "Buenos Aires"
            ,"Country" : "Argentina"
            ,"Address" : "Alem 444"
            ,"Phone" : "555-1234"
            ,"Email" : "juan.perez@gmail.com"
            ,"EmergencyFirstName" : "Lucia"
            ,"EmergencyLastName" : "Pacheco"
            ,"EmergencyPhone" : "555-9876"
            ,"EmergencyEmail" : "lucia.pacheco@gmail.com"
            }]
}

Datos de salida (en caso de CURRENTACCOUNT o PREPURCHASE) json

{
"EmissionId" : 12345
"EmissionStateId" : 1
"ccgg" : ""
"Vouchers" :[{
            "ExternalReference" : ""
            ,"VoucherId" : "AR200824123"
            ,"VoucherUrl" : "[URL]/reps/provider/96/vouchers/2020/08/v_xxxxxxxxxxxxxxxxxxxxx.pdf?version=20200824110221012"
            ,"ProductId" : 3456
            ,"CCGGUrl" : "[URL]/reps/providers/96/cg_es-ES.pdf"
            ,"FirstName" : "Juan"
            ,"LastName" : "Perez"
            ,"BirthDate" : "1980-03-20"
            ,"Passport" : "12345678"
            }
            ,{
            "ExternalReference" : ""
            ,"VoucherId" : "AR200824124"
            ,"VoucherUrl" : "[URL]/reps/provider/96/vouchers/2020/08/v_yyyyyyyyyyyyyyyyyyyy.pdf?version=20200824110221012"
            ,"ProductId" : 3456
            ,"CCGGUrl" : "[URL]/reps/providers/96/cg_es-ES.pdf"
            ,"FirstName" : "Guillermina"
            ,"LastName" : "Perez"
            ,"BirthDate" : "2015-06-10"
            ,"Passport" : "50123123"
            }]
,"Error":null
}

Datos de salida (en caso de MERCADOPAGO) json

{
    "EmissionId": 123456,
    "EmissionStateId": 8,
    "ccgg": "",
    "Vouchers": [],
    "Error": {
        "success": true,
        "message": ""
    },
    "PaymentLink": <LINK_DE_PAGO>
}

EmissionStateId: 8 significa que la emision se encuentra en estado "En Gestion de Cobro".
PaymentLink: es el link de pago

4.1. Pasos a seguir

• 1 - Peticionar al área de Sistemas (o a su comercial) la apertura de ID de referencia de su agencia, que es la identificación de su cuenta en el proceso de venta a realizar.
• 2 - Desarrollar la programación necesaria para integración del sitio web de su empresa, utilizando las funciones que se proveen en los Web Services.
• 3 - Desarrollar la programación que procese los resultados que los web services devuelven, ya sean errores o resultados de finalización exitosa de las transacciones.
• 4 - Adecuar el diseño del sitio web de su empresa para que incluya la opción de emisión o venta de asistencias en viaje.
• 5 - Testing en el área de pruebas o “SandBox”
• 6 - Puesta en marcha en los servidores de producción.

4.2.Cómo obtener el link para descarga del voucher en formato PDF

La función AddVouchers retornará, una vez emitida la compra, información acerca de los vouchers de cada viajero. El enlace para descarga del voucher en formato PDF variará dependiendo si se está trabajando en el servidor de Producción o en el servidor de pruebas (“Sandbox”)

Este link puede ser utilizado tanto para presentar la opción de descargar el voucher al pasajero, como para guardarlo en su base de datos para procesarlo más adelante. El parámetro “cultureid” es opcional y define el idioma en que se verá el voucher. El voucher puede visualizarse en español (valor por defecto si no se especifica nada en el parámetro “cultureid”), inglés o portugués (*)

• es-es = Español (valor por defecto si no se especifica otro)
• en-us = inglés
• pt-br = portugués

Detallamos a continuación los mensajes de error más comunes
[próxima actualización del manual de integración]

• 7.1 API
  Es una interfaz de programación de aplicaciones o API (del inglés Application Programming Interface) es el conjunto de funciones y procedimientos (o métodos, en la programación orientada a objetos) que ofrece cierta biblioteca para ser utilizado por otro software como una capa de abstracción.
• 7.2 ASP.NET
  Es un framework para aplicaciones web desarrollado y comercializado por Microsoft. Es usado por programadores para construir sitios web dinámicos, aplicaciones web y servicios web XML. Apareció en enero de 2002 con la versión 1.0 del .NET Framework, y es la tecnología sucesora de la tecnología Active Server Pages (ASP). ASP.NET esta construido sobre el Common Language Runtime, permitiendo a los programadores escribir código ASP.NET usando cualquier lenguaje admitido por el .NET Framework.
• 7.3 HTTP
  Hypertext Transfer Protocol o HTTP (en español protocolo de transferencia de hipertexto) es el protocolo usado en cada transacción de la World Wide Web. HTTP fue desarrollado por el World Wide Web Consortium y la Internet Engineering Task Force, colaboración que culminó en 1999.
• 7.4 JAVA
  Java es un lenguaje de programación orientado a objetos desarrollado por Sun Microsystems a principios de los años 90. El lenguaje en sí mismo toma mucha de su sintaxis de C y C++, pero tiene un modelo de objetos más simple y elimina herramientas de bajo nivel, que suelen inducir a muchos errores, como la manipulación directa de punteros o memoria.
• 7.5 Métodos POST y GET
  Son métodos de envío de información en formularios HTML. Ambos métodos, POST y GET, realizan una transacción mediante el protocolo HTTP, la diferencia radica en que el primer método envía los parámetros ocultos, mientras que el segundo los muestra en la barra de navegación.
• 7.6 PHP
  PHP es un acrónimo recursivo que significa PHP Hypertext Pre-processor. Es un lenguaje de programación interpretado, diseñado originalmente para la creación de páginas web dinámicas. Es usado principalmente en interpretación del lado del servidor (server-side scripting).
• 7.7 Sitio Web
  Un portal de Internet o portal web es un sitio web cuya característica fundamental es la de servir de Puerta de entrada (única) para ofrecer al usuario, de forma fácil e integrada, el acceso a una serie de recursos y de servicios relacionados a un mismo tema. Incluye: enlaces, buscadores, foros, documentos, aplicaciones, compra electrónica, etc. Principalmente un portal en Internet está dirigido a resolver necesidades de información específica de un tema en particular.
• 7.8 Sandbox
  Plabra que del inglés significa caja de arena («Sand»+«box»), y se refiere a un entorno de pruebas (en el contexto de desarrollo de software o desarrollo web), que aísla los cambios en el código, fruto de la experimentación, del propio entorno de producción o entorno de edición.
• 7.9 UTF-8
  Se describe como 8-bit Unicode Transformation Format. Es un formato de codificación de caracteres Unicode e ISO 10646 utilizando símbolos de longitud variable. UTF-8 fue creado por Robert C. Pike y Kenneth L. Thompson. Está definido como estándar por la RFC 3629 de la Internet Engineering Task Force (IETF).1 Actualmente es una de las tres posibilidades de codificación reconocidas por Unicode y lenguajes web, o cuatro en ISO 10646.
• 7.10 Voucher
  Documento impreso o electrónico (generalmente en PDF) donde se encuentran los datos del pasajero, la asistencia en viaje contratada y su vigencia, así como también las condiciones generales de uso. Pueden eventualmente incluir precios totales, descuentos y/o impuestos. Es utilizado para dejar constancia por parte de una empresa de que fue lo que el cliente exactamente compró o reservó.
• 7.11 SOAP
  Es un protocolo que permite la comunicación entre aplicaciones a través de mensajes por medio de Internet. Es independiente de la plataforma, y del lenguaje. Está basado en XML y es la base principal de los Web Services.
• 7.12 Escalabilidad
  Es la propiedad deseable de un sistema, una red o un proceso, que indica su habilidad para extender el margen de operaciones sin perder calidad, o bien manejar el crecimiento continuo de trabajo de manera fluida, o bien para estar preparado para hacerse más grande sin perder calidad en los servicios ofrecidos.