Introducción

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.

Descripción
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
Por qué utilizar este manual de integración
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.

Servicios Web
3.1 URL de Producción y Sandbox
Ingresa el REFERENCEID que te enviaron (pruebas o produccion) y descarga el correspondiente JSON del Postman Collection.
URL Api Estado Backoffice Sistema REFERENCEID Postman Collection
https://api.assist1.com.co Producción https://sistema.assist1.com.co
Obtener JSON
https://api-sandbox.assist1.com.co Sandbox-Test https://sistematest.assist1.com.co
Obtener JSON
El usuario y clave para acceso al sistema de sandbox o productivo sera entregado via email.
Función GetEmission

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
Emissionid int Identificación de la orden de compra realizada.
[URL]/api/saleprocessexpress.aspx?action=GetEmission&referenceid=[ReferenceId]
Datos de salida json
Parámetro Tipo Descripción
ExternalReference string Utilizado por el cliente para proveer una referencia del viajero registrado de su lado
OperationStateId int

{
    "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
}
Función GetCurrencies

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=GetCurrencies&referenceid=[ReferenceId]
Datos de salida json

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

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
CultureId [opcional] string Identificación de cultura para que lo retornado se encuentre trasladado a la cultura sugerida
[URL]/api/saleprocessexpress.aspx?action=GetCountries&referenceid=[ReferenceId]&cultureid=[es-ES]
Datos de salida json

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

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
CultureId [opcional] string Identificación de cultura para que lo retornado se encuentre trasladado a la cultura sugerida
[URL]/api/saleprocessexpress.aspx?action=GetRegions&referenceid=[ReferenceId]&cultureid=[es-ES]
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"
}]
Función GetProducts

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
CultureId [opcional] string Identificación de cultura para que lo retornado se encuentre trasladado a la cultura sugerida
[URL]/api/saleprocessexpress.aspx?action=GetProducts&referenceid=[ReferenceId]&cultureid=[es-ES]
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",
               }]
}]
                                         
Función GetCultures

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

Datos de entradahtml
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=GetCultures&referenceid=[ReferenceId]
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"
}]
Función GetTripTypes

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=GetTripTypes&referenceid=[ReferenceId]
Datos de salida json

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

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

Datos de entradahtml
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=GetTripTypesAnnual&referenceid=[ReferenceId]
Datos de salida json

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

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

Datos de entradahtmljson
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=GetQuote&referenceid=[ReferenceId]

{
    "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
                }
            ]
        }
    ]
}

Función GetEmissionStatus

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

Datos de entradahtml
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
EmissionId int Identificación de la orden de compra realizada.
CultureId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=GetEmissionStatus&referenceid=[ReferenceId]&EmissionId=[EmissionId]&cultureid=[es-ES]
Datos de salida json

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

Función CancelEmission

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
[URL]/api/saleprocessexpress.aspx?action=CancelEmission&referenceid=[ReferenceId]

{
   "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)."
}

Función CheckAddVouchers

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
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
PaymentType string CURRENTACCOUNT: Cuenta Corriente; PREPURCHASE: Precompra
[URL]/api/saleprocessexpress.aspx?action=CheckAddVouchers&referenceid=[ReferenceId]

{
"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."
}
Función AddVoucher

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".

Datos de entradahtmljson
Parámetro Tipo Descripción
ReferenceId string Identificación de referencia para la cuenta que desea obtener datos
PaymentType string CURRENTACCOUNT: Cuenta Corriente; PREPURCHASE: Precompra
[URL]/api/saleprocessexpress.aspx?action=addvouchers&referenceid=[ReferenceId]

{
"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

{
"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
}
4. Proceso de Integración
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”)

[URL]/api/getvoucher.aspx?voucherid=[VoucherId]&cultureid=[es-ES]

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 (*)

Según el idioma , el valor será:
  • es-es = Español (valor por defecto si no se especifica otro)
  • en-us = inglés
  • pt-br = portugués
5. Mensajes de Error más frecuentes

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

6. SandBox: Pruebas de los Web Services
6.1. Introducción

El sistema de emisión cuenta con un área de pruebas llamada “SandBox” que permitirá realizar pruebas de transacciones en tiempo real, simulando la emisión de vouchers de asistencia, consultas y cualquier tarea o función que los Web Services provean.

6.2. Configuración requerida para realizar las pruebas

Para configurar la información necesaria en el Sandbox (área de pruebas), debe contactar con el área de sistemas (sistemas@assist1.com.co) , quiénes le ayudarán en ese proceso.

Glosario
Preguntas Frecuentes
  • details 8.1 Existe un sitio web donde se puedan ver en funcionamiento los webservices?
    Si, tenemos en nuestro sitio web, implementando los sistemas de ecommerce y éstos utilizan los webservices del Sistema de Emisión para el proceso de emisión de asistencia al viajero online.
  • details8.2 Cómo solicitar asistencia técnica o soporte acerca del uso de los web services?
    Puede crear un ticket en https://soporte.assist1.com.co dejando constancia en el asunto el nombre de fantasía o razón social del cliente. En la sección Integraciones de Sistemas
  • details8.3 Qué nivel de conocimientos técnicos se requieren para integrar en nuestro sitio web la posibilidad de mostrar y eventualmente emitir directamente utilizando las funciones de los webservices?
    Si bien la implementación es muy sencilla y relativamente rápida, se requiere un nivel de programador para integrar las páginas de su sitio web. Utilizando éste manual de integración, un programador con poca experiencia, fácilmente podrá integrar estos servicios en su sitio web: emitir desde su web o intranet, mostrar productos, cotizar, mostrar coberturas, etc.
  • details8.4 En nuestra compañía tenemos una Intranet y queremos poder emitir vouchers de asistencia desde la misma usando los web services del sistema de emisión, podemos hacer eso?
    Si, los webservices se pueden utilizar en cualquier aplicación web : sitios web de viajes, de agencias de viajes, portales de turismo, intranets corporativas de compañías de seguros o de viajes, etc.
  • details8.5 Ante una petición, en que formato la API nos devuelve los datos solicitados?
    Los webservices funcionan mediante peticiones con el método POST por HTTP y retorna datos en formato JSON en codificación UTF-8.
  • details8.6 Cuál es la dirección (URL) del ambiente de pruebas “Sandbox” del Sistema de emisión?
    La URL del ambiente de pruebas (llamado “Sandbox”) puede encontrarla en la sección "3.1 Servicios".
  • details8.7 Cuál es la dirección (URL) del ambiente de Producción?
    La URL del ambiente de Producción puede encontrarla en la sección "3.1 Servicios".
Actualizaciones
Version Mes Cambios
0.1 Abril-2019 Se crea nuevo manual para servicio web Dicho servicio web está destinado a clientes que tengan la necesidad de procesar sus ventas de asistencia en viaje en sus propias plataformas de gestión o sitios web
menu