{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"fb536079-8bf5-4b9f-85f3-fe0ec00b15fb","name":"Integraciones por API","description":"API REST para integraciones emisiones de nuestros productos desde sistemas externos.\n\n**Funciones:**\n\n- **Autenticar (Authentication)**\n    \n- **Cotizar (Quote)**\n    \n- **Cotizar Addons (Quote Addons)**\n    \n- **Emitir (Issuance)**:\n    \n    - **Emisión en modo Cuenta Corriente (Issuance/checking-account/vouchers)**.\n        \n    - **Emisión generando Link de Pago (Issuance/payment-button/vouchers)**.\n        \n    - **Emisión con pago online Tarjeta de Crédito Gateway AC (Issuance/credit-card/vouchers).** Para utilizar esta función se requiere validar PCI Compliance por parte del sistema externo (documentación AOC/SAQ-D).\n        \n- **Consultar (Search)**:\n    \n    - **Consulta por Código de Voucher (Voucher/searchByVoucherCode)**.\n        \n    - **Consulta por Código GrupoVoucher (Voucher/searchByVoucherGroup)**.\n        \n    - **Consulta por Documento Identidad (Voucher/searchByDocumentNumber)**.\n        \n    - **Consulta por Código Reserva (Voucher/searchByBookingCode)**.\n        \n- **Cancelar (CancelVoucher)**.\n    \n- **Modificar Inicio Vigencia de Voucher (RectifyValidity).**\n    \n- **Re-Enviar Email de Confirmación Emisión (ResendEkit).**\n    \n\n**AUTENTICAR (AUTHENTICATION)**  \nEsta función se utiliza para generar el token de autenticación a ser utilizado en las llamadas a las demás funciones.\n\n**COTIZAR PRODUCTOS (QUOTE/Product)**  \nEsta función se utiliza para obtener los distintos planes de productos-tarifas ASSIST CARD que se encuentran disponibles en cierto Punto Emisor AC definido para el negocio y que podrán ser utilizados para emitir los Vouchers AC a los pasajeros.\n\n**COTIZAR ADDONS (QUOTE/Addons)**  \nEsta función se utiliza para obtener las distintas opciones de ampliaciones de coberturas o upgrades (Add Ons) que estarían disponibles a para cierto plan de producto-tarifa base seleccionado en la cotización anterior (quote). Los planes de AddOns o Upgrades se encuentran asociados en nuestro sistema para a cada plan de producto-tarifa de forma independiente.\n\n**EMITIR (ISSUANCE)**\n\nEsta función realiza la emisión de los Vouchers para cada pasajero en nuestro sistema.  \nSe cuenta con diversas opciones o funciones diferentes para realizar la emisión, cada una de ellas relacionada a un método de pago diferente. La emisión debe seguir inmediatamente a la cotización. Se debe realizar la cotización y emisión dentro de una misma instancia de transacción. Es decir, primero el método cotizar para obtener la disponibilidad de planes de productos y tarifas habilitados para el negocio, el pasajero seleccionar plan de producto-tarifa, y a continuación -dentro de la misma instancia de transacción- realizar la emisión de los vouchers con el plan de producto-tarifa que se haya seleccionado.\n\n**Cuenta Corriente**  \nLa función **Issuance/checking-account/vouchers** “emitir” se utiliza para emitir o registrar los Vouchers ASSIST CARD de cada pasajero en nuestro sistema en modo Cuenta Corriente. En este modo de emisión, todo lo relacionado al pago online de los vouchers por parte del pasajero final queda del lado del sistema externo.\n\n**Link de Pago**  \nLa función **Issuance/payment-button/vouchers** se utiliza para emitir voucher generando Link de Pago online con Tarje de Crédito (Gateway de AC). El link de pago se puede enviar por email/wapp o incluir dentro de la misma respuesta de la función para emitir. El o los vouchers de la transacción se registran en estado “anulado” en nuestro sistema y pasarán a quedar en estado activo o válido una vez se confirme satisfactoriamente el pago online a través del link de pago generado.\n\nPara la implementación de esta modalidad de emisión se requiere previamente validar y coordinar con equipo soporte AC que el esquema País emisor cuenta con gateway local habilitado para este tipo de emisión con los parámetros correspondientes configurados, así como los datos de tarjetas de crédito a poder utilizar en ambiente Sandbox.\n\n**Tarjeta Crédito**  \nLa función **Issuance/credit-card/vouchers** se utiliza para emitir vouchers aplicando directo pago online con tarjeta de crédito a través de un Gateway propio de AC. Para poder utilizar este modo de emisión se **requiere validar certificación PCI Compliance por parte del sistema externo (documentación AOC/SAQ-D)**, ya que se trabaja con datos de tarjeta de crédito tokenizados y nuestro ambiente es PCI Compliance. Verificar en Anexo lista de países esquemas emisores con Gateway AC habilitados para estos efectos.\n\nPara la implementación de esta modalidad de emisión se requiere previamente validar y coordinar con equipo soporte AC que el esquema País emisor cuenta con gateway local habilitado para este tipo de emisión con los parámetros correspondientes configurados, así como los datos de tarjetas de crédito a poder utilizar en ambiente Sandbox.\n\n**CONSULTAR VOUCHER (SEARCH)**  \nContamos con varias funciones para poder consultar datos de vouchers emitidos según distintos criterios:  \n. por código de voucher individual.  \n. por código grupoVoucher.  \n. por documento de identidad del pasajero.  \n. por código de reserva registrado dentro del voucher emitido.\n\n**CANCELAR VOUCHER (CANCEL)**  \nLa función CancelVoucher “cancelar” se utiliza para poder Cancelar un voucher emitido previamente, siempre y cuando no haya aún iniciado vigencia y no cuente con servicio de Asistencia en nuestro sistema (estos dos puntos se validan automáticamente en nuestro sistema).\n\n**MODIFICAR INICIO VIGENCIA DE VOUCHER (rectifyValidity)**\n\nPermite modificar la fecha de inicio de vigencia de un voucher, manteniendo siempre la misma cantidad de días que se emitió originalmente, siempre y cuando no haya aún iniciado vigencia, y hacia una fecha posterior a la fecha corriente en que se este realizando la transacción.\n\n**RE-ENVIAR EMAIL DE CONFIRMACION EMISION (resendEkit)**\n\nPermite re-enviar el email de Confirmación Emisión que se envia automáticamente desde nuestro sistema con la emisión de cada Voucher, a misma casilla de correo del voucher emitido u a otras casillas de correo diferentes.\n\n**ANEXOS**  \nIncluimos sección ANEXOS donde se detallan distintos catálogos de parámetros para las distintas funciones de la API, códigos de respuestas con sus descripciones, ejemplos de peticiones, ejemplos de peticiones para distintos casos, y detalles a tener en cuenta para ciertos mercados en los cuales se deben contemplar particularidades específicas como por ejemplo:\n\n. mercado **Brasil,** requiere emitir con ciertos tipos de documento de identidad específicos para este mercado, registrar domicilio verdadero en función del código postal, e incluir opción para completar campos nombre/apellido social.\n\n.mercado **España**, requiere emitir con ciertos tipos de documento de identidad específicos para este mercado, emitir con datos de tomador de póliza y registrar datos domicilios verdaderos.\n\n.mercado **Filipinas,** requiere emitir registrando datos adicionales para cada pasajero requeridos por la regulación sobre Lavado de Dinero.\n\n**Endpoints ambiente Sandbox (pruebas) y Producción:**\n\n**Sandbox**: [https://sandbox.assistcard.com](https://sandbox.assistcard.com)\n\nLas credenciales de acceso deberán solicitarse al equipo de Soporte de Web Services a través de [webservices@assistcard.com](https://mailto:webservices@assistcard.com).\n\n**Producción**: [https://api.assistcard.com](https://api.assistcard.com)\n\nLas credenciales se otorgan una vez finalizado el proceso de certificación de la integración. Su gestión se realiza a través del equipo de Soporte de Web Services [webservices@assistcard.com](https://mailto:webservices@assistcard.com), en conjunto con Seguridad Informática. Para la habilitación del acceso se deberán informar y validar las IPs públicas fijas desde las cuales se realizarán las conexiones a la API.\n\n**DIAGRAMA GENERAL DE LA INTEGRACIÓN**\n\n<img src=\"https://content.pstmn.io/033cfdd6-3810-41b8-a7d9-23ae3674523c/aW1hZ2UucG5n\" width=\"1005\" height=\"530\">\n\nSi bien las funciones Cotizar, CotizarAddons (opcional) y Emitir son independientes, deben ser utilizadas en secuencia una a continuación de la otra. Es decir, primero enviar petición al método Cotizar para obtener la disponibilidad de productos-tarifas, seleccionar alguno de ellos por parte del pasajero, opcional cotizar Addons para cada pasajero, e inmediatamente a continuación enviar la petición al método Emitir para registrar el o los Vouchers ASSIST CARD de cada pasajero en nuestro sistema.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"34901935","team":25867811,"collectionId":"fb536079-8bf5-4b9f-85f3-fe0ec00b15fb","publishedId":"2sA3e2e91Z","public":true,"publicUrl":"https://developers.assistcard.com","privateUrl":"https://go.postman.co/documentation/34901935-fb536079-8bf5-4b9f-85f3-fe0ec00b15fb","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EE0029"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/5f6630f4-08fa-4dae-947f-29a224ee20c9/Q2xhaW09U2ksIElkaW9tYT1FUywgQ29sb3I9Um9qbywgU2l6ZT1NZC5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"EE0029"}},{"name":"light","logo":"https://content.pstmn.io/5f6630f4-08fa-4dae-947f-29a224ee20c9/Q2xhaW09U2ksIElkaW9tYT1FUywgQ29sb3I9Um9qbywgU2l6ZT1NZC5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EE0029"}}]}},"version":"8.12.8","publishDate":"2024-07-22T16:19:03.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/5f6630f4-08fa-4dae-947f-29a224ee20c9/Q2xhaW09U2ksIElkaW9tYT1FUywgQ29sb3I9Um9qbywgU2l6ZT1NZC5wbmc=","logoDark":"https://content.pstmn.io/5f6630f4-08fa-4dae-947f-29a224ee20c9/Q2xhaW09U2ksIElkaW9tYT1FUywgQ29sb3I9Um9qbywgU2l6ZT1NZC5wbmc="}},"statusCode":200},"environments":[{"name":"Sandbox","id":"061723a4-d613-4490-8d38-866f4c4ea040","owner":"34901935","values":[{"key":"token","value":"","enabled":true,"type":"default"},{"key":"collectionName","value":"","enabled":true,"type":"default"},{"key":"collectionSchemaUrl","value":"","enabled":true,"type":"default"},{"key":"accessKey","value":"","enabled":true,"type":"default"},{"key":"workspaceId","value":"","enabled":true,"type":"default"},{"key":"collectionId","value":"","enabled":true,"type":"default"},{"key":"HostIntegraciones","value":"https://sandbox.assistcard.com","enabled":true,"type":"default"},{"key":"baseUrl","value":"https://sandbox.assistcard.com","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://assistcard.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Sandbox","value":"34901935-061723a4-d613-4490-8d38-866f4c4ea040"}],"canonicalUrl":"https://developers.assistcard.com/view/metadata/2sA3e2e91Z"}