En API y webhooks creás las llaves de API con las que el sistema de tu tienda o tu ERP se conecta con Parner sin que nadie inicie sesión. La pantalla está en Configuraciones y solo la ve la persona de tu empresa que puede invitar usuarios con Invitar usuario en Equipo. Si no la ves, pedíselo a esa persona o escribinos por WhatsApp: el equipo de Parner también puede crear la llave por vos.

Por ahora la pantalla solo tiene llaves de API. Para la documentación técnica de la API, escribinos por WhatsApp.

Qué hace una llave

Con una llave, tu sistema consulta cualquier pedido de tu empresa, venga del canal que venga: su estado, sus productos, la transportadora, la guía, el enlace de seguimiento que recibe tu cliente y su historial. Cada llave tiene un permiso:

Solo lectura: Consulta pedidos. No puede crear ni cancelar nada.
Lectura y escritura: Además de consultar, puede crear y cancelar pedidos.

Por ahora la API solo consulta pedidos, con cualquiera de los dos permisos. Para una herramienta de reportes elegí Solo lectura.

Crear una llave

En API y webhooks, tocá Nueva llave.
En Nombre poné el sistema que la va a usar (Ej.: Tienda en línea, ERP), para reconocerla después.
Elegí el Permiso y tocá Crear llave.
Aparece Copia la llave ahora con la Llave de API completa. Es la única vez que la ves: copiala, guardala donde tu equipo técnico guarda sus contraseñas y tocá Ya la guardé.

Si la perdés, no hay forma de volver a verla. Creá otra y revocá la perdida.

La lista de llaves

La tabla muestra cada llave activa con su Nombre, el comienzo de la Llave para reconocerla, el Permiso, cuándo fue Creada y su Último uso. El último uso dice Nunca si nadie la ha usado, y se actualiza como mucho una vez por minuto. Una llave que dice Nunca o que lleva mucho sin usarse probablemente sobra: revocala.

Cambiar una llave sin cortar la conexión

Podés tener varias llaves activas a la vez. Para cambiar una, creá la nueva, ponela en tu sistema, revisá que su Último uso cambie y después revocá la vieja.

Revocar una llave

Tocá Revocar en su fila y confirmá en Revocar llave de API. La llave deja de funcionar de inmediato, los sistemas que la usen reciben un error 401 y la llave desaparece de la lista. Revocá enseguida cualquier llave que se haya filtrado.

Mientras tu empresa esté congelada en Parner, ninguna llave funciona, igual que pasa con los usuarios.