Solicitar acceso a la API¶
Para usar la API necesitas credenciales: los datos con los que tu sistema se identifica ante Centria. Las credenciales solo las entrega el equipo de soporte de Centria; no se generan desde la Suite.
Requisitos¶
- Tu empresa debe tener el plan Centria Plus o Centria Pro. Ver Mis datos de facturación.
- Necesitas el correo de un usuario de tu empresa en Centria, es decir, un usuario que ya exista en Seguridad → Usuarios del mismo entorno (empresa) para el que pides la API. Ver Usuarios.
El correo debe ser de un usuario de tu empresa
Un correo externo (que no corresponde a un usuario de tu empresa en Centria) no sirve. Si la persona que hará la integración no tiene usuario, créalo primero en Seguridad → Usuarios.
El usuario no necesita ningún permiso especial: alcanza con que pertenezca a la empresa.
¿Conviene crear un usuario solo para la API?
No es obligatorio, pero ayuda. Los envíos hechos por API quedan registrados a nombre del usuario de las credenciales (columna Agente Nombre en Histórico de Envíos). Con un usuario dedicado, por ejemplo Integración ERP, distingues fácilmente lo que se hizo por API de lo que hizo tu equipo.
Cómo solicitarlas¶
- Elige el usuario cuyo correo vas a usar (o crea uno dedicado).
- Escribe a soporte de Centria por WhatsApp o por correo a soporte@megadigital.com.py e indica:
- El nombre de tu empresa.
- El correo del usuario elegido.
- Soporte te responde con tus credenciales.
Escribir a soporte por WhatsApp Escribir a soporte por correo
Qué datos recibes¶
| Dato | Qué es |
|---|---|
| claveApi | Clave secreta de acceso. Funciona como una contraseña. |
| empresaId | Número que identifica a tu empresa en Centria. |
| usuario | El correo del usuario que indicaste al pedir el acceso. |
Las mismas credenciales sirven para la v1 y la v2 de la API. Con estos tres datos tu sistema obtiene el token que usa en cada llamada. Los detalles están en la Documentación técnica.
Cuida tu claveApi
Quien tenga la claveApi puede enviar mensajes y modificar datos de tu empresa en nombre del usuario. No la compartas por chat, no la publiques en capturas y guárdala solo en el sistema que hace la integración. Si crees que se expuso, avisa a soporte: te generan una clave nueva y la anterior deja de servir.