2. Linea Captura

Linea Captura

Introducción

El objetivo del documento es explicar el proceso de implementación del servicio web, sus métodos existentes y los parámetros de entrada y salida para la recepción del pago de impuestos/derechos estatales vía ventanilla bancaria o tiendas de autoservicio.

Los métodos con los que el servicio web trabaja son:

  • LineaCaptura

Método quevalida la referencia mediante la cual se realizará el pago.

Url del Web service

https://apifinanzas.col.gob.mx/API/wsLineaCaptura

Autenticación del Web service.

Para su correcto funcionamiento, el servicio web cuenta con autenticación de usuarios. Para ello, a cada responsable de la implementación de dicho servicio, se le proporcionarán los datos de usuario y contraseña.

Parámetros de entrada

El método del servicio web requiere invariablemente de los campos de usuario y contraseña, pero de manera independiente requiere de diferentes parámetros de entrada necesarios, los cuales se especifican a continuación:

Parámetros Tipo de dato Tamaño Descripción
LineaDeCaptura String 20 max. Referencia del pago
Parámetros de salida
Parámetros Tipo de dato Tamaño Descripción
info json Máximo

Muestra el resultado de los siguientes parametros

  • FechaVencimiento.- Fecha de vencimiento de la referencia
  • Descripcion.- Breve descripción de lo que se va a pagar con esa referencia.
  • Importe.- Importe a pagar
  • Codigo_Respuesta.- Código de respuesta del método. 0 = Correcto; Diferente de 0 = Error
  • Descripcion_Codigo.- Breve descripción del código de respuesta. En caso de algún error, aquí viajará la descripción del error.
  • Sucursal.- Si la referencia es incorrecta, debido a que ya fue pagada con anterioridad y se pagó en el mismo banco/tienda, aquí se mostrará la sucursal en la cual se realizó el pago.