Até então, o módulo de Promoções não contava com integração via API, exigindo que todas as campanhas, condições e cupons fossem cadastrados manualmente no painel administrativo. Clientes com grande volume promocional ou que centralizam a governança de campanhas em sistemas externos (como ERP, OMS ou plataformas de agências) ficavam limitados ao trabalho manual ou dependiam do apoio direto do time técnico para cadastros em massa — como em cenários de criação de milhares de promoções para uma única ação.
Com esta entrega, disponibilizamos a Admin API de Promoções, permitindo que sistemas parceiros e integradores realizem o gerenciamento completo das promoções diretamente na loja, contando com as mesmas regras, flexibilidade e opções já consolidadas no painel administrativo.
Como funciona?
- Gestão do Ciclo Completo: A API suporta de ponta a ponta as ações de criar, consultar, listar com filtros avançados, atualizar, duplicar, ativar, inativar e excluir promoções.
- Paridade de Recursos com o Admin: As promoções criadas via integração contemplam todos os elementos disponíveis no painel: informações gerais, gestão de cupons (único ou múltiplos), condições de elegibilidade, descontos, regras adicionais, selos de vitrine, textos de divulgação e políticas de acúmulo.
- Endpoints de Apoio: Rota dedicada para consultar as regras, condições e tipos de desconto aceitos na loja, além de consultas auxiliares para composição dinâmica das regras (clientes, estados, cidades, produtos, categorias, marcas, etc.).
- Governança e Perfis de Acesso: O lojista gera a credencial na nova tela API Admin do painel e define, por meio de perfis de acesso granulares, o escopo de atuação de cada integração (por exemplo: apenas consulta ou permissão completa para cadastrar e ativar campanhas).
- Tratamento de Inconsistências e Auditoria: Mensagens de erro claras apontam o campo exato e a causa da falha para agilizar o suporte técnico. Além disso, todas as alterações são registradas no histórico da promoção, identificando a credencial e a integração responsável.
Acesso:
- Novas Solicitações: Clientes interessados devem ser direcionados ao respectivo Gerente de Sucesso (CS), que fará o alinhamento de viabilidade com o time de Produto antes de qualquer liberação.
Principais Benefícios:
- Automação de Campanhas em Escala: Promoções em alto volume podem ser criadas e atualizadas diretamente pelo ERP ou OMS, eliminando cadastros manuais.
- Agilidade Comercial: Mudanças estratégicas no mix promocional passam a ser aplicadas em tempo real pelos sistemas do próprio lojista.
- Independência Operacional: Eliminação da dependência de suporte interno para execuções e cadastros massivos.
- Segurança e Rastreabilidade: Acessos delimitados por credencial com registro auditável de todas as modificações realizadas no catálogo promocional.
Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:
🔗 API Admin: credenciais para integrar sistemas à sua loja
🔗 Referência Técnica da API de Promoções
Publicado em 16/11/2026
Comentários
0 comentário
Por favor, entre para comentar.