- Created by Rosana Fagundes dos Santos Matos, last modified on Oct 16, 2026
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

Passo a passo para poder adicionar uma forma de pagamento

Boas práticas de envio de arquivo e economia de tokens:
- Não envie arquivos com mais de um pedido (O consumo de token é aumentado significativamente);
- Caso o arquivo tenha itens repetidos, só serão adicionados caso esteja ativada a parametrização de Chave Tripla;
- Recomendável sempre todos os produtos terem código de fabricação e EAN13 para melhor efetividade da IA;
- Quanto maior o tamanho do pedido, maior o processamento da IA e consequentemente o custo;
- Acompanhe sempre o dashboard do OpenRouter para o consumo de tokens;
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