1. 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. El desarrollo de los WebServices de SEC (que en adelante nombraremos como SEC-WS) se desarrolló utilizando estándares que garantizan la seguridad y confiabilidad de cada transacción, al tiempo 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 los SEC-WS. 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 SEC-WS proveen, así como explicaciones de cómo utilizarlas para cubrir sus necesidades en la venta automatizada de asistencia en viaje.

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

        2.5. Para qué utilizar este manual de integración


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


            2.5.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 SEC.
                • 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.

Entre las funciones implementadas actualmente, citamos algunas que describiremos en detalle más adelante en este manual:

getEmission getCurrencies getCountries getRegions getProducts getCultures getTripTypes getTripTypesAnnual getQuote getEmissionStatus checkAddVouchers addVouchers

        3.0 URL DE PRODUCCIÓN Y SANDBOX
PRODUCCIÓN

https://sistemacoris.com/api/

SANDBOX -TEST

https://sistematest.coris.com.ar/api/

        3.1 Función GetEmission

            3.1.1 Descripción
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.

            3.1.2 Datos de entrada
referenceid (string) : api secret
emissionid (int) : Numero de emisión de la compra realizada.
EmissionId (int) EmissionStateId (int) ccgg (string)
Vouchers (Listado de Voucher)
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida

            3.1.3 Datos de Salida - JSON Retornado

{
EmissionId:’5674’ OperationStateId:1,
ccgg:’/url/donde_se_encuentra/ccgg.pdf’,
Vouchers[{
ExternalReference:’’, VoucherId:’AR265315625’,
VoucherUrl:’/url_voucher/voucher.pdf’ ProductId:24
CCGGUrl:’/url_pdf/ccgg.pdf’ FirstName:’John’ LastName:’Doe’
BirthDate:’2000-01-16’ Passport:’AB4562512’
}
{
ExternalReference:’’, VoucherId:’AR265315626’,
VoucherUrl:’/url_voucher/voucher.pdf’, ProductId:24,
CCGGUrl:’/url_pdf/ccgg.pdf’, FirstName:’Mary’, LastName:’Doe’,
BirthDate:’2000-04-16’, Passport:’AB42312343’,
}
]}


        3.2 Función GetCurrencies

            3.2.1 Descripción
Obtener un listado de las monedas

            3.2.2 Datos de entrada
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida

[URL]/api/saleprocessexpress.aspx?action=GetCurrencies&referenceid=[ReferenceId]


            3.2.3 Datos de Salida - JSON Retornado
[
{
"Id": 1,
"TranslateValue": 1.132993536, "Symbol": "€",
"Iso": "EUR"
},
{
"Id": 2,
"TranslateValue": 0.025510204, "Symbol": "AR$",
"Iso": "ARS"
}
]




        3.3 Función GetCountries

            3.3.1 Descripción
Obtener la lista de países .


            3.3.2 Datos de entrada
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida

[URL]/api/saleprocessexpress.aspx?action=GetCountries&referenceid=[ReferenceId]
o si se quiere retornar con cultura
[URL]/api/saleprocessexpress.aspx?action=GetCountries&referenceid=[ReferenceId]&cultureid=[es-ES]

3.3.4 Datos de Salida - JSON Retornado
[
{
"Id": 170,
"Name": "Colombia",
"IsoCode": "CO"
},
{
"Id": 171,
"Name": "Mexico",
"IsoCode": "MX"
},
{
"Id": 172,
"Name": "Ecuador",
"IsoCode": "EC"
}
]


        3.4 Función GetRegions

            3.4.1 Descripción
Obtener la lista de regiones admitidas para la venta de asistencias en viaje.

            3.4.2 Datos de entrada
ReferenceId (string) :  Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida

[URL]/api/saleprocessexpress.aspx?action=GetRegions&referenceid=[ReferenceId]
o si se quiere retornar con cultura
[URL]/api/saleprocessexpress.aspx?action=GetRegions&referenceid=[ReferenceId]&cultureid=[es-ES]

3.4.4 Datos de salida - JSON Retornado
[
{
"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"
}
]


        3.5 Función GetProducts

            3.5.1 Descripción
Obtener los productos disponibles para vender


            3.5.2 Datos de entrada
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida

[URL]/api/saleprocessexpress.aspx?action=GetProducts&referenceid=[ReferenceId]
o si se quiere retornar en otra cultura
[URL]/api/saleprocessexpress.aspx?action=GetProducts&referenceid=[ReferenceId]&cultureid=[es-ES]

            3.5.3 Datos de salida - JSON Retornado
[
{
"Id": 3525,
"Name": "Work & Travel Premium", "ccgg": "Url_CCGG",
"TripTypeId": 1,
"TripTypeAnnualId": 0,
"CurrencyId": 0, "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",
}
]
}
]


        3.6 Función GetCultures

            3.6.1 Descripción
Obtener la lista de Culturas para luego mostrar consultas en la cultura correspondiente.

            3.6.2 Datos de entrada
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos

[URL]/api/saleprocessexpress.aspx?action=GetCultures&referenceid=[ReferenceId]

            3.6.3 Datos de salida - JSON Retornado

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




        3.7 Función GetTripTypes

            3.7.1 Descripción
Obtener la lista de Culturas para luego mostrar consultas en la cultura correspondiente.

            3.7.2 Datos de entrada
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida

[URL]/api/saleprocessexpress.aspx?action=GetTripTypes&referenceid=[ReferenceId]
o si se quiere retornar en otra cultura
[URL]/api/saleprocessexpress.aspx?action=GetTripTypes&referenceid=[ReferenceId]&culturaid=[es-ES]

            3.7.3 Datos de salida - JSON Retornado
[
{
"Id": 1,
"Name": "Viaje Único"
},
{
"Id": 2,
"Name": "Anual Multiples Viajes"
}
]


        3.8 Función GetTripTypeAnnuals

            3.8.1 Descripción
Obtener la lista de Culturas para luego mostrar consultas en la cultura correspondiente.


            3.8.2 Datos de entrada
ReferenceId (string) : Identificacion de referencia para la cuenta que desea obtener datos CultureId(string) [opcional] : Identificacion de Cultura para que lo retornado se encuentre trasladado a la cultura sugerida.

[URL]/api/saleprocessexpress.aspx?action=GetTripTypesAnnual&referenceid=[ReferenceId]
o si se quiere retornar en otra cultura [URL]/api/saleprocessexpress.aspx?action=GetTripTypesAnnual&referenceid=[ReferenceId]&cultureid=[es- ES]

            3.8.3 Datos de salida - JSON Retornado

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





        3.9 Función GetQuote

            3.9.1 Descripción
Obtener las tarifas para determinado producto


            3.9.2 Datos de entrada

[URL]/api/saleprocessexpress.aspx?action=GetQuote&referenceid=[ReferenceId]

Ejemplo de entrada [
{
"CultureId": "es-ES", "CurrencyId":2, "TripTypeId": 1,
"TripTypeAnnualId": 0,
"CurrencyId": 0, "Ages":"20,23,45",
"Trip":
{
"ResidenceId":32 "DestinyId": 1000,
"DateFrom": "2019-05-01",
"DateTo": "2019-05-11",
"TripTypeId": 1,
"TripTypeIdAnnual": 0,
}
}
]



            3.9.3 Datos de salida - JSON Retornado

        3.10 Función GetEmissionStatus

            3.10.1 Descripción

Se utiliza para obtener el estado actual de una emisión.

Devolverá cuatro valores posibles: "Cerrada” , “Pendiente de anulación”, “Anulada"

            3.10.2 Datos de entrada
[URL]/api/saleprocessexpress.aspx?action=GetEmissionStatus&referenceid=[ReferenceId]&EmissionId=[E missionId]
o si se quiere retornar en otra cultura [URL]/api/saleprocessexpress.aspx?action=GetEmissionStatus&referenceid=[ReferenceId]&EmissionId=[E missionId]&cultureid=[es-ES]

Ejemplo de entrada [
{
"CultureId": "es-ES", "CurrencyId":2, "TripTypeId": 1,
"TripTypeAnnualId": 0,
"CurrencyId": 0, "Ages":"20,23,45",
"Trip":
{
"ResidenceId":32 "DestinyId": 1000,
"DateFrom": "2019-05-01",
"DateTo": "2019-05-11",
"TripTypeId": 1,
"TripTypeIdAnnual": 0,
}
}
]

            3.10.3 Datos de salida - JSON Retornado

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



        3.10 Función CancelEmission

            3.10.1 Descripció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.


            3.10.2 Datos de entrada

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


            3.10.3 Datos de salida - JSON Retornado

{
    "success": true,
    "message": "La emisión se ha anulado."
}
{
    "success": true,
    "message": "Se ha creado un pedido de anulación sobre la emisión."
}
{
    "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)."
}
...



    4. Proceso de Integración
En este capítulo, detallaremos el proceso de integración de un sitio web con los Web Services, describiendo los pasos o etapas a seguir y explicando el uso para algunas funciones con ejemplos de uso en cada caso.

        4.1. Pasos a seguir

            ▪ 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.
            ▪ Desarrollar la programación necesaria para integración del sitio web de su empresa, utilizando las funciones que se proveen en los Web Services.
            ▪ 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.
            ▪ 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.
            ▪ Testing en el área de pruebas o “SandBox”
            ▪ Puesta en marcha en los servidores de producción.


4.2.[deprecated] 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, quiénes le ayudarán en ese proceso.


    7. Apéndice A: Glosario

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


    8. Apéndice B: Preguntas Frecuentes

        8.1 Existe un sitio web donde se puedan ver en funcionamiento los webservices?
Si, tenemos en su 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.

        8.2 Cómo solicitar asistencia técnica o soporte acerca del uso de los web services?
Puede crear un ticket en soporte.coris.com.ar dejando constancia en el asunto el nombre de fantasía o razón social del cliente. En la sección Integraciones de Sistemas

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


        8.4 En nuestra compañía tenemos una Intranet y queremos poder emitir vouchers de asistencia desde la misma usando los web services del SEC, 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.

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

        8.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”) es https://sistematestcoris.com/ y la URL de acceso a la API de los webservices es : https://sistematest.coris.com.ar/api/


        8.7 Cuál es la dirección (URL) del ambiente de Producción?
La URL del ambiente de Producción es https://sistemacoris.com/ y la URL de acceso a la API de los webservices en producción es : https://sistemacoris.com/api/

    9. Apéndice C: Actualizaciones
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