Componente Sankhya - Obter Itens do Carrinho

O componente Obter Itens do Carrinho permite recuperar o estado atual do carrinho de compras durante a execução do fluxo do bot.

Esse componente é somente leitura e não altera os dados do carrinho. Ele serve para que o fluxo tenha acesso aos itens já adicionados anteriormente, permitindo:

• exibir o carrinho ao usuário

• validar itens antes de criar o pedido

• calcular totais

• revisar produtos antes da finalização da compra

Índice:

• Objetivo do componente
• Interface do componente (leitura da tela)
• Consulta de estado
• Estrutura do retorno
• Descrição dos campos retornados
• Comportamento do componente
• Exemplos de uso no bot
• 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 consulte os dados mais recentes do carrinho de compras, sem realizar alterações ou transações.

Interface do componente (leitura da tela)

Armazenamento

Exemplo:

carrinho

Quando executado, o componente retorna o estado completo do carrinho, contendo todos os itens adicionados anteriormente.

Consulta de estado

Este componente é classificado como uma consulta de estado.

Este componente é apenas de leitura. Ele garante que o fluxo tenha acesso aos dados mais recentes do carrinho sem realizar alterações ou transações.

Estrutura do retorno

Exemplo de resposta

{
  "items": [
    {
      "product": {
        "code": 1185,
        "referenceCode": 91185,
        "defaultUnit": {
          "code": "UN",
          "description": "Unidade"
        },
        "description": "BALAS SORTIDAS",
        "complementaryDescription": null,
        "characteristics": null,
        "brand": "ERLAN"
      },
      "quantity": 5,
      "locationCode": 0,
      "unitCode": "UN",
      "controlCode": "MACA VERDE",
      "price": 4.3
    },
    {
      "product": {
        "code": 1185,
        "referenceCode": 91185,
        "defaultUnit": {
          "code": "UN",
          "description": "Unidade"
        },
        "description": "BALAS SORTIDAS",
        "complementaryDescription": null,
        "characteristics": null,
        "brand": "ERLAN"
      },
      "quantity": 10,
      "locationCode": 0,
      "unitCode": "UN",
      "controlCode": "UVA",
      "price": 4.6
    },
    {
      "product": {
        "code": 1236,
        "referenceCode": 91236,
        "defaultUnit": {
          "code": "UN",
          "description": "Unidade"
        },
        "description": "GUARANÁ SANTANA",
        "complementaryDescription": null,
        "characteristics": "Teste Caracteristicas",
        "brand": "MINEIRO"
      },
      "quantity": 10,
      "locationCode": 0,
      "unitCode": "CX",
      "controlCode": "1L",
      "price": 192
    }
  ],
  "error": null,
  "total": 1987.5
}

Descrição dos campos retornados

Comportamento do componente

O componente sempre retorna o estado atual do carrinho, incluindo todos os itens adicionados ou alterados anteriormente no fluxo.

Exemplo de carrinho:

Total:

1987.5

Exemplos de uso no bot

Mostrar resumo do carrinho

Seu carrinho possui:

{{carrinho.items[0].product.description}} - {{carrinho.items[0].quantity}}
{{carrinho.items[1].product.description}} - {{carrinho.items[1].quantity}}

Mostrar total da compra

Total do pedido:

R$ {{carrinho.total}}

Validar se o carrinho possui itens

Se {{carrinho.items}} existir
→ continuar para criação do pedido

Tratamento de erros

Boas práticas

• Utilizar esse componente antes de Criar Pedido

• Exibir resumo do carrinho para confirmação do usuário

• Validar se existem itens antes de finalizar a compra

• Permitir revisão ou alteração de quantidades

Consistência com o ERP

O carrinho representa uma estrutura temporária da venda, mantida no contexto do bot.

Os dados somente serão enviados ao Sankhya quando o componente:

Criar Pedido

for executado.

Posição do componente no fluxo

Fluxo típico da jornada de venda digital:

Busca de Produto
↓
Detalhe do Produto
↓
Locais de Estoque
↓
Estoque do Produto
↓
Preço do Produto
↓
Adicionar ao Carrinho
↓
Alterar Quantidade no Carrinho
↓
Obter Itens do Carrinho
↓
Criar Pedido

• 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