Componente Sankhya - Alterar Quantidade no Carrinho

O componente Alterar Quantidade no Carrinho permite atualizar a quantidade de um item já existente no carrinho de compras durante a jornada de venda digital.

Esse componente é utilizado quando o usuário deseja:

• alterar a quantidade de um produto selecionado

• aumentar ou reduzir itens no carrinho

• substituir a quantidade atual por uma nova quantidade

A alteração ocorre sobre um item que já esteja presente no carrinho, identificado pelo produto, unidade e controle.

bot-server: versão 1.7.0

Índice:

• Objetivo do componente
• Interface do componente (leitura da tela)
• Parâmetros
• Código do produto
• Código do volume (unidade)
• Controle do produto
• Estratégia de alteração
• Nova quantidade final
• Armazenamento
• Estrutura do retorno
• Exemplo de resposta
• Descrição dos campos retornados
• Comportamento do carrinho
• Exemplos de uso no bot
• Confirmar alteração da quantidade
• Mostrar total atualizado
• Mostrar resumo do carrinho
• Tratamento de erros
• Boas práticas
• Consistência com o ERP
• Posição do componente no fluxo

• Dados do Cliente

• Obter pedidos

• Itens do Pedido

• Criar Pedido

• Preço do Produto

• Estoque do Produto

• Locais de Estoque

• Volumes Alternativos

• Obter Preferência

• Tabela de Preço

• Tipo de Operação

• Tipos de Negociação

• Detalhe do Produto

• Busca de Produto

• Adicionar ao Carrinho

• Alterar Quantidade no Carrinho

• Obter Itens do Carrinho

Objetivo do componente

Permitir que o fluxo do bot modifique a quantidade de um item previamente adicionado ao carrinho, mantendo a consistência dos dados antes da criação do pedido no Sankhya.

Interface do componente (leitura da tela)

Parâmetros

Configuração do item que será alterado no carrinho

Código do produto

Identifica o item do carrinho que será alterado.

Exemplo:

ou

⚠️ O produto precisa existir no carrinho para que a alteração seja aplicada.

Código do volume (unidade)

Define qual unidade do produto está sendo alterada.

Exemplo:

Caso o produto possua múltiplas unidades, a alteração ocorrerá na unidade correspondente.

Controle do produto

Identificação da variação do produto.

Exemplos:

Esse campo é necessário quando o produto possui controle ativo.

Estratégia de alteração

Define como a nova quantidade será aplicada ao item.

Exemplo:

Se o item possui quantidade 5 e a nova quantidade é 10, o resultado será:

Nova quantidade final

Quantidade que será aplicada ao item no carrinho.

Exemplo:

ou

Armazenamento

Exemplo:

Estrutura do retorno

Exemplo de resposta

Descrição dos campos retornados

Comportamento do carrinho

O carrinho sempre mantém o estado atualizado dos itens após a alteração.

Exemplo antes da alteração:

Após alterar:

Exemplos de uso no bot

Confirmar alteração da quantidade

Mostrar total atualizado

Mostrar resumo do carrinho

Tratamento de erros

Boas práticas

• Sempre validar se o produto existe no carrinho antes de alterar

• Garantir que controle e unidade estejam corretos

• Atualizar a interface do usuário após a alteração

• Permitir revisão do carrinho antes de finalizar a compra

Consistência com o ERP

A alteração da quantidade ocorre apenas no carrinho do bot, e não diretamente no Sankhya.

Os dados atualizados serão enviados ao ERP apenas quando o componente:

for executado.

Posição do componente no fluxo

Fluxo típico da jornada de venda digital:

• Dados do Cliente

• Obter pedidos

• Itens do Pedido

• Criar Pedido

• Preço do Produto

• Estoque do Produto

• Locais de Estoque

• Volumes Alternativos

• Obter Preferência

• Tabela de Preço

• Tipo de Operação

• Tipos de Negociação

• Detalhe do Produto

• Busca de Produto

• Adicionar ao Carrinho

• Alterar Quantidade no Carrinho

• Obter Itens do Carrinho