- Created by Rosana Fagundes dos Santos Matos, last modified on Oct 09, 2026
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 11 Next »
Produto: maxPedido
Disponível a partir da versão 4.057.0
Índice
O que é o Pedido Fácil com IA?
O Pedido Fácil utiliza inteligência artificial para ler um arquivo enviado pelo vendedor, seja uma imagem, PDF ou planilha XLS/XLSX e transformar automaticamente o seu conteúdo em itens já lançados no pedido, sem que ninguém precise digitar código por código.
Como funciona
Montar um pedido grande, item por item, é uma das tarefas mais repetitivas do dia do vendedor. Quando o cliente manda a lista de compras por foto, por PDF escaneado ou em uma planilha própria, o caminho tradicional é o mesmo de sempre: abrir o arquivo, ler item a item e digitar tudo de novo dentro do maxPedido.
Esse processo manual consome tempo, é sujeito a erro de digitação e atrasa o fechamento do pedido — especialmente quando a lista tem dezenas de itens.
O Pedido Fácil nasce para responder a uma pergunta simples:
"Por que digitar de novo uma lista de produtos que o próprio cliente já me mandou pronta, em algum formato de arquivo?"
O que utilizamos para montar o pedido
- Arquivo enviado pelo vendedor: uma foto da lista de compras, um PDF (como um pedido escaneado) ou uma planilha XLS/XLSX.
- Inteligência artificial de interpretação de documentos: um modelo de IA especializado lê o conteúdo do arquivo e identifica os produtos e as quantidades descritas, mesmo em formatos livres ou não padronizados. Livres ou não padronizados (Para a maior efetividade da IA, é necessário que o produto tenha o EAN13 e Código de fábrica).
- Base de produtos do pedido em edição (SPDV): os itens interpretados pela IA são conferidos contra o pedido de venda em andamento, garantindo que o que for identificado seja efetivamente incluído no pedido corretamente.
A IA na prática: do arquivo ao pedido pronto
O processo acontece em poucos passos, direto na tela do maxPedido:
1. Escolha do arquivo: o vendedor toca na opção "Pedido Fácil" no menu ações na aba tabela e seleciona um arquivo XLS, XLSX, JPEG ou PDF com a lista de produtos.
2. Envio e leitura pela IA: o app envia o arquivo para processamento; a tela mostra "Adicionando produtos..." enquanto a inteligência artificial interpreta o conteúdo do documento.
3. Inclusão automática no pedido: os itens reconhecidos são incluídos diretamente no pedido em edição, com código, quantidade e valores já preenchidos.

4. Confirmação: ao final, o app exibe "Produtos adicionados com sucesso", com um botão para visualizar o pedido já montado.

Caso apesente na tela do aplicativo mensagem informando que a Credencial de IA não foi encontrada, verifique se a chave de API (API Key) foi gerada através do openrouter e vinculada corretamente ao maxSoluções.

Disponibilização no maxPedido
Antes de o vendedor conseguir usar o recurso, é necessário, na central maxSoluções, cadastrar uma credencial de IA para o maxPedido, informando a funcionalidade ("Pedido Fácil com IA"), o provedor e o modelo de inteligência artificial, além da API Key que será usada nas interpretações dos arquivos.
ATENÇÃO
Atualmente, para o recurso Pedido fácil com IA, é necessário utilizar uma API Key GPT- 5.4 vinculada ao openrouter.
Para gerar uma API Key para o OpenRouter, siga estes passos:
1 - Acesse o site oficial do OpenRouter: https://openrouter.ai/.
2 - Crie uma conta, se ainda não tiver uma, ou faça login na sua conta existente.
3 - Navegue até a seção de chaves de API no painel da conta.
4 - Clique em "Create Key", dê um nome reconhecível para a nova chave e configure os limites de cobrança.
5 - Copie o valor da chave gerada e guarde com segurança.
6 - Vá no menu Credits e adicione uma forma de pagamento ou créditos para o uso da API Key, pois o uso da chave é cobrado.
Passo a passo para poder gerar o token

Com a API Key em mãos, basta entrar na central maxSoluções > Cadastros > Credenciais > + Cadastrar e inserir sua API Key no campo API Key.

Após isso, na central do maxPedido Habilitar o parâmetro HABILITA_PEDIDO_FACIL_IA para que o aplicativo apresente a opção "Pedido Fácil - IA" no menu de ações do pedido.
1- Clique no Menu lateral> Configurações> Parâmetros
2- Busque pelo parâmetro em filtro avançado e clique em pesquisar
3- Clique no ícone de edição da coluna Ações e habilite o parâmetro.

O valor no dia a dia da operação
Em vez de perder minutos digitando uma lista que o próprio cliente já enviou pronta, o vendedor tira uma foto, anexa o PDF ou sobe a planilha, e o Pedido Fácil devolve o pedido já montado. Menos tempo digitando, menos erro de digitação e mais tempo para o que realmente importa: a conversão de venda.

Artigos Relacionados
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
Artigo criado por João Pedro Alves
- No labels