Saltar al contenido principal

¿Qué necesitas implementar para integrar tu software?

Requisitos previos​

Para poder integrar con la solución de Wolters Kluwer necesitas implementar un desarrollo en la nube que incluya un endpoint que nos permita conectar con tu software.

info

Cuando cierres el acuerdo con Wolters Kluwer y recibas tus credenciales para el acceso a nuestra plataforma de APIs, deberás proporcionarnos este endpoint, que será el punto de comunicación entre tu software y nuestra solución.

El endpoint debe tener el formato https://{baseaddress}/{basedomain}/{baseendpoint}

Los parámetros que recibirás serán:

  • bulletin: Identificador del pedido
  • idCda: Identificador único de la licencia aprovisionada
  • applicationName: Nombre del módulo a vincular
  • registerToken: Token temporal para configurar la licencia aprovisionada

Ejemplo:

{
  "idCda": "string",
  "applicationName": "string",
  "bulletin": "string",
  "registerToken": "string"
}

Es necesario que configures tu endpoint para recibir las peticiones HTTP POST que se van a realizar. Algunos aspectos básicos que requerimos son:

  • Debe utilizar HTTPS sobre el puerto estándar 443
  • Tiene que responder a la petición HTTP POST antes de 5 segundos con una respuesta HTTP 2xx.
  • Los headers de respuesta no deben contener cookies.
  • Si la firma es inválida, deberás devolver un error HTTP 401.

Flujo de pedido de licencia​

Una vez nosotros te demos de alta en nuestra plataforma técnica, y usando las credenciales de las APIs que te habremos entregado, al hacer un pedido de a3factura Conectia usando nuestra API se activará un flujo automático y secuencial:

  1. Realiza un pedido de licencia de a3factura Conectia
    Te devolverá un identificador único (bulletin) de pedido en la respuesta de la API de pedidos
  2. El proceso de pedido llamará automáticamente a tu endpoint con toda la información de la licencia de a3factura Conectia aprovisionada para que puedas conectarla con tu software:
    • bulletin: Identificador del pedido
    • idCda: Identificador único de la licencia aprovisionada
    • applicationName: Nombre del módulo a vincular
    • registerToken: Token temporal para configurar la licencia aprovisionada
  3. Con el registerToken, podrás configurar la licencia de a3factura aprovisionada.
    Acepta los términos y condiciones de uso de la aplicación a3factura para la licencia aprovisionada
    Obtendrás en la respuesta las CREDENTIALS para la API en esa licencia, que deberás guardar para siempre.
  4. Con las CREDENTIALS y el applicationName, podrá autenticarte en la API de a3factura
    Autenticarte para esa licencia
    Obtendrás un token de aplicación con una duración temporal limitada que podrás renovar.
  5. Con el token de aplicación, ya podrás trabajar con la API funcional de a3factura

Una vez formalizados estos pasos iniciales, ya podrás trabajar con la API funcional de a3factura Conectia renovando tu token de aplicación cada vez que caduque usando las CREDENCIALES y el applicationName otorgados para esa licencia.

image

Última actualización en