Agora o FoodSoul pode ser integrado a qualquer um dos seus sistemas

Adicionámos tokens de acesso à API. Isso significa que agora é possível conectar o FoodSoul diretamente ao seu sistema de gestão, 1C, estoque, análise, bot ou desenvolvimento próprio. Não é mais necessário exportar e transferir dados manualmente.

Antes, só era possível conectar integrações prontas da nossa lista. Agora, você pode criar a sua própria.

Para que servem os tokens de acesso à API do FoodSoul?

Com um token, é possível trabalhar com a maioria das seções do CRM. Os acessos permitidos para a sua integração dependem do papel que você escolher para o token.

Por exemplo, um token com o papel de “Operador” terá os seguintes direitos:

✅ Permitido: alterar produtos, categorias, listas de bloqueio, saldos de estoque, pedidos, avaliações e endereços, trabalhar com pagamentos.
❌ Não permitido: visualizar relatórios contábeis e contrapartes.

Esse token é adequado, por exemplo, para um sistema de gestão de estoque que atualiza automaticamente os saldos e listas de bloqueio. Para cada integração, escolha o papel que contenha apenas os direitos necessários: quanto menos permissões o token tiver, mais seguro será.

Para os participantes do programa de parceiros, há solicitações separadas: empresas conectadas, relatórios e retirada de fundos.

Como conectar?

1. No CRM, abra a seção “Tokens de acesso à API” e crie um token. O token é a chave pela qual o seu sistema acessará o FoodSoul. Não é necessário login ou senha de funcionário.

2. Escolha um papel para o token. O token receberá os direitos desse papel, mas não mais do que você mesmo possui.

3. Se necessário, defina restrições:

• acesso apenas a uma rede ou a todas as redes da conta;
• prazo de validade: temporário ou permanente;
• lista de endereços IP autorizados para solicitações. Solicitações de outros endereços serão rejeitadas.

4. Adicione o token em cada solicitação do seu sistema:
Authorization: Bearer fs_api_...
Se o token não estiver vinculado a uma única rede, especifique a desejada no cabeçalho:
Chain: chain_id

As configurações do token podem ser alteradas a qualquer momento, mantendo o mesmo token. Ele também pode ser bloqueado, desbloqueado ou excluído.

❗️ Importante sobre segurança

• O token completo é exibido apenas uma vez, no momento da criação. Salve-o imediatamente. Nós armazenamos o token de forma criptografada, sem possibilidade de recuperação, portanto, se o token for perdido, não será possível recuperá-lo. Será necessário criar um novo e substituí-lo na integração.
• Crie um token separado para cada integração. Assim, se necessário, você poderá desativar uma integração sem afetar as demais.

Onde encontrar mais informações:

📖 Instruções de configuração no WIKI: https://wiki.foodsoul.ru/ru/public/api
📄 A descrição de todos os métodos (especificação OpenAPI) pode ser solicitada ao suporte técnico. Em breve, teremos um portal para desenvolvedores.

Atenciosamente, equipe FoodSoul! Trabalhamos para você!