
Importante: as integrações com o User API deixarão de funcionar a partir de 1º de janeiro de 2027
Estamos desativando o User API — a antiga API do FoodSoul, através da qual anteriormente eram alterados os status dos pedidos, atualizados os preços e áreas de entrega, e gerenciados os entregadores. Ela não recebe atualizações há muito tempo: todas as novas funcionalidades são adicionadas ao CRM API.
Se a sua integração funciona através do User API, é necessário migrá-la para o CRM API até 1º de janeiro. Caso contrário, após essa data, o FoodSoul responderá com erro a todas as solicitações feitas por ela. Abaixo explicamos como se preparar para a transição.
Como verificar a integração
Um desenvolvedor pode verificar se sua integração utiliza o User API. Essa integração envia solicitações para endereços como:
- https://foodsoul.ru/api/user/v1/ (assim como by.) — primeira versão;
- https://foodsoul.ru/api/user/v2/ (assim como by.) — segunda versão.
Se não tiver certeza, pergunte a quem mantém sua integração ou entre em contato com o suporte.
Vantagens da migração
O CRM API oferece muito mais recursos do que o User API: nele é possível trabalhar com pedidos e seus cartões, cardápio, lista de indisponibilidade e estoques, clientes, promoções e relatórios.
Vale destacar os webhooks. Com eles, o CRM informa automaticamente o seu sistema sobre eventos — por exemplo, um novo pedido ou mudança de status — e a integração não precisa consultar a API constantemente.
Outra vantagem é a possibilidade de gerar tokens de acesso individuais. Cada integração pode receber seu próprio token com as permissões necessárias, podendo ser bloqueado ou removido a qualquer momento, se necessário.
Como migrar
- Crie um token de API no CRM: “Integrações” → “Tokens de acesso à API”. Salve-o imediatamente: o token é exibido apenas uma vez, no momento da criação.
- Envie o token e o link para a documentação do CRM API ao seu desenvolvedor.
- O desenvolvedor migrará a integração para o CRM API. Apenas trocar o endereço não é suficiente: agora a ação é especificada na URL da solicitação, e a lista de campos enviados nas solicitações e respostas foi alterada.
Lembramos que isso deve ser feito até 1º de janeiro de 2027.
A documentação completa do CRM API está no portal FoodSoul: docs.foodsoul.ru. Se precisar de ajuda com a migração, entre em contato com o suporte.
Atenciosamente, equipe FoodSoul! Trabalhamos para você!