En BillMySales, la emisión de documentos tributarios depende de la interacción con dos servicios externos a través de APIs: el facturador y la fuente de datos (en este caso, Multivende). La conexión con estos servicios es fundamental para garantizar el correcto funcionamiento de nuestra plataforma. Sin embargo, si alguno de estos servicios presenta problemas, puede afectar la generación de los documentos tributarios, ya sea impidiendo su creación o generándolos de forma incorrecta.
Lamentablemente esta situación escapa a nuestra plataforma BillMySales y es algo que, si bien tratamos de controlar, en algún momento puede ocurrir por problemas con dichos servicios que impidan la creación de los documentos tributarios.
Uno de estos problemas que pueden ocurrir es la desconexión entre BillMySales y Multivende. Este tipo de problema ocurre porque el token de conexión para la API de Multivende expira y no logra ser actualizado debido a intermitencias en el servicio de la plataforma de Multivende.
Explicación técnica del problema
La API de Multivende utiliza el protocolo OAuth para la autenticación y conexión, lo que implica el uso de dos tipos de tokens:
- Token de conexión: Es el que permite realizar solicitudes a la API. Tiene una duración limitada y debe renovarse periódicamente.
- Token de actualización: Es el que se utiliza exclusivamente para renovar el token de conexión cuando este expira. Cada token de actualización solo puede utilizarse una vez.
El problema detectado en la API de Multivende se produce durante el proceso de renovación del token de conexión. Cuando nuestra plataforma solicita la actualización del token de conexión usando el token de actualización, la API de Multivende en ocasiones no responde, generando un error por “tiempo de espera agotado” (timeout).
Este error tiene dos consecuencias graves:
- La solicitud para obtener un nuevo token de conexión falla debido al timeout.
- El token de actualización se marca como "usado" por parte de la API de Multivende, a pesar de que la operación no se completó correctamente.
Como resultado, en el siguiente intento de renovación, el token de actualización ya no es válido, y el token de conexión no se puede renovar. Una vez que el token de conexión expira, se pierde la comunicación entre BillMySales y Multivende por un error en la API de Multivende que es externo a BillMySales.
¿Cómo identificar una desconexión por token expirado?
Es muy sencillo identificarlo siguiendo estos pasos:
- Ingresar a la configuración de la pasarela desde: https://billmysales.com/billing_gateways
- Haz clic en “Actualizar Token de Multivende”.
- Si el problema está relacionado, la pasarela mostrará el siguiente mensaje: “Error al ejecutar la petición POST sobre https://app.multivende.com/oauth/access-token: OAuthInvalidParametersError”.
¿Cómo solucionar el problema de conexión?
Para resolver este inconveniente, sigue estos pasos:
- Desconecta BillMySales de Multivende.
- Vuelve a conectar la pasarela. Puedes encontrar una guía detallada sobre cómo realizar este proceso en el manual de configuración.
Lamentablemente esta es la única solución en este caso, pues el token de conexión ya no puede ser actualizado a través de BillMySales debido a la expiración del token de actualización provocado por el error en la API de Multivende.