Preguntas frecuentes

Los números que acompañan los nombre de las APIs y los productos de APIs, son su versión, por ejemplo, Bancolombia Button 2.0.4; el número siempre es visible, dado que todos están versionados. 

Es importante que, al momento de consumir una API o un producto de APIs, se tenga presente su versión, porque un cambio de versión puede significar un ajuste para su consumo. 

El número de versión tiene una estructura: X.Y.Z, estos números son enteros no negativos. 

Cada número clasifica su impacto: 

•  X es la versión Mayor, con ella se introducen modificaciones importantes en la funcionalidad (Interna o Externa) de la API o del producto producto de APIs, que rompen la compatibilidad de las dependencias. 
• Y la versión Menor, estas modificaciones no rompen la compatibilidad de las dependencias y adicionan funcionalidades a las APIs.  
• Z la versión Parche significan correcciones puntuales en la API o producto de APIs, corresponde a un cambio interno. 

Para versionar una API o un producto de APIs, se tienen en cuenta las siguientes variables: las APIs o Productos de APIs (si es nuevo o existente), los métodos (si son nuevos o existentes) y los campos (si son obligatorios y/u opcionales). 

Posteriormente bajo los siguientes criterios se clasifica su impacto: 

• Se asigna la versión mayor en dos ocasiones.
  • 1) si el componente y la operación son nuevas y tiene campos obligatorios y/u opcionales 
  • 2) si el componente y la operación son existentes y si se agrega o modifica un campo obligatorio. 

• Se asigna la versión menor.
  • si el componente es existente, la operación es nueva y tiene campos obligatorios y/u opcionales 

• O se asigna la versión parche.
  • si el componente y la operación son existentes y se agrega un nuevo campo opcional. 

Debido a la incompatibilidad retroactiva, es posible que una nueva versión de una API o un producto de APIs conviva con la versión obsoleta. Máximo conviven 2 versiones a la vez (La que se va a jubilar y la superior que evolucionó). 

También te puede interesar conocer ¿Cuánto tiempo se mantiene una versión que va a ser jubilada?

El tiempo en el que se deja disponible una versión que se va a jubilar y a retirar varía y se comunica a través de los medios establecidos por el Banco, este es máximo de un (1) año. 

Si estás consumiendo una versión anterior realiza los ajustes a las implementaciones respectivas, después de ese periodo, la API o producto de APIs quedará sin funcionalidad. 

Te puede interesar leer ¿Qué pasa si sale una nueva versión de unas APIs?

Cuando la versión de una API o un producto de APIs evoluciona debes actualizar tus aplicativos con la versión más reciente de la API, ya que la versión que consumes se jubila y retira. 

Ante estos cambios te estaremos notificando de la salida de la versión, sus características y/o cambios, así como, la fecha tentativa en la que se dará de baja la versión que estas consumiendo. Te puede interesar leer ¿Cuánto tiempo se mantiene una versión que va a ser jubilada?

Recuerda que, si las APIs que consumes ya se jubilaron, tu producto de APIs queda sin funcionalidad. 

Si necesitas más información, te invitamos a ver el reglamento que firmaste. 

Es un espacio virtual donde tú y otros interesados en productos de APIs pueden acceder a documentación e información de interés, así como a los siguientes canales de contacto: 

Chat: puedes generar una conversación con un asesor de Bancolombia en el caso que tu solicitud no la puedas atender con la información expuesta en el Centro de Ayuda APIs Bancolombia. 

Formulario contáctanos: puedes radicar el caso de soporte que requieras, el cual uno de nuestros asesores atenderá y brindará respuesta lo más pronto posible.  

La comunidad Devs: puedes interactuar, compartir información, exponer inquietudes, participar en discusiones y estar informado de la actividad reciente en el mundo de las APIs. 

Te puede interesar leer el artículo ¿Cómo creo una solicitud? 

El portal de soporte soportedevs.bancolombia.com  permite conectarse con nosotros, en caso que necesites ayuda con nuestras APIs, ver ¿Qué es el centro de ayuda?, estés o no autenticado; sin embargo, si quieres ver las solicitudes de soporte que has hecho o deseas publicar contenido en nuestra comunidad, es necesario que inicies sesión. 

Si, puedes relacionar un correo electrónico personal para dar respuesta a tus inquietudes; sin embargo, si requieres soporte de alguna falla de las APIs en ambiente productivo es importante que relaciones el correo autorizado en el contrato. 

A través de nuestro de Centro de Ayuda APIs Bancolombia, tienes dos mecanismos de contacto con nosotros:

                                         Formulario de contáctanos

En el menú desplegable del Centro de Ayuda APIs Bancolombia, haz clic en Enviar una solicitud

Los datos solicitados son:​   - Nombre o razón social, Correo electrónico, Tipo de identificación, Número de identificación: datos que dependerán de quien nos contacte, ten presente que puedes ver tu historial.​ Te puede interesar ¿Para qué autenticarse al Centro de Ayuda APIs Bancolombia?   - Motivo del caso: selecciona consulta si requieres asesoría, solicitud cuando necesites algún insumo para consumo, por ejemplo, si requieres acceso a Sandbox, o problema si presentas alguna fricción que no te permita dar continuidad al consumo de nuestras APIs.​   - Seleccionándolo en el menú desplegable el producto y ambiente.​   - Asunto: aquí de forma breve indícanos el tema principal de contacto.​   - Descripción:escribe detalladamente por que te contactas con nosotros.​   - Recuerda aceptar los términos y condiciones y autorizareltratamiento de datos personales.​   - Así mismo, adjunta pantallas, código o evidencias que permitandiagnosticar posibles errores que presentes.​   - Por último, haz clic en el botón de Enviar.

                                                          Chat 

Haz clic en el icono chat, el cual se encuentra en la parte inferior derecha de la pantalla.

Los datos solicitados son:​   - Nombre, Correo electrónico: estos datos dependerán de quien nos contacte, ten presente que puedes crear una cuenta en el Centro de Ayuda APIs Bancolombia para ver el historial de las solicitudes hechas y su estado.​   - Departamento: selecciona en el menú una opción en el menú desplegable, especificando porque producto de APIs nos contactas o elije “sin producto”, en caso de ser una consulta o solicitud general.​   - Mensaje: aquí de forma breve indícanos el tema principal de contacto.​   - Por último, debes dar clic en el botón “iniciar chat”.​

Ten en cuenta que:

- Si tu contacto está relacionado con la plataforma o con los bienes y/o servicios de un comercio, debes ponerte en contacto directamente con el comercio a través de sus canales de atención. 

- Si las solicitudes están relacionadas con la cuenta Bancolombia con la que celebraste un negocio con un comercio podrás dirigirlas a través de nuestra línea telefónica.

Las solicitudes que pongas a través del formulario contáctanos, serán contestadas por medio del correo electrónico que nos registres; sin embargo, si requieres hacer seguimiento o ver un caso que pusiste previamente lo puedes hacer, así: 

• Inicia sesión con tu correo electrónico y tu contraseña. Si no tienes usuario puedes ver Para qué autenticarse al ingresar al portal.   
• En la parte superior derecha de la pantalla encontrarás tu usuario y una flecha hacia abajo que despliega un menú.
• Ingresa por la opción de “mis actividades” y en la siguiente pantalla te van a registrar todas las solicitudes que has enviado, con su estado.