...
Permitir o recebimento de itens do parceiro integrador com Imagem+EAN para registro no PDV.
O AcruxPDV Broker Services, recebe o JSON enviado pelo parceiro contendo as informações do produto e armazena estas informações em tabelas de cache que serão acessadas pelo AcruxPDV para registro do produto na venda.
Para enviar o JSON o parceiro deve usar o comando POST e a URL http://XX.XXX.XX.XXX:4015, onde XX.XXX.XX.XXX corresponde ao IP da máquina do PDV, a porta será sempre a 4015.
No AcruxPDV quando o novo parâmetro, "Ativo" do grupo "Receber Operações", está ativado, é iniciada uma rotina que verifica constantemente a existência de produto nas tabelas de cache, e caso exista, tenta fazer o registro do mesmo na venda automaticamente.
Caso o produto enviado no JSON pelo parceiro não tenha a informação do BarCode(Código de barras do produto (EAN)), significa o produto não foi identificado. Nesta situação o PDV irá exibir uma mensagem com a imagem capturada informando que o produto não foi identificado, e o operador de caixa deverá realizar o registro do produto manualmente, ou solicitar liberação do registro do produto, o PDV só continuará o registro dos próximos produtos automaticamente, após o operador de caixa registrar o produto não identificado manualmente e confirmar que o item registrado é referente ao produto não identificado, ou o supervisor liberar o registro.
Se o operador de caixa acionar a opção SubTotal enquanto ainda existir item a ser registrado será exibida uma mensagem de aguarde.
Obs.: o envio da imagem não é obrigatório. Porém, se a imagem não for enviada, o parceiro precisa garantir que identificou o produto e que o mesmo possui cadastro, para que não ocorra a trava na operação do PDV.
Imagem 1 - Produto não identificado
Imagem 2 - Confirmação do registro do produto não identificado
Imagem 3 - Acionamento da opção SubTotal enquanto ainda há item a ser registrado
1. No Monitor de PDV, menu: Configurações → Configurações de PDVs , localize o grupo "Integrações externas" → "Receber Operações":
Imagem 4 - Configurações Receber Operações
2. No Monitor de PDV, menu: Cadastros → Usuários e grupos → Permissões, conceda permissão ao método Custom Operação - Liberar produto não identificado
Imagem 5 - Conceder permissão
POST {url} porta 4015
PARÂMETRO | TIPO | OBRIGATÓRIO | DESCRIÇÃO |
---|---|---|---|
x-authtoken | String | Sim | Token de autenticação do parceiro |
PARÂMETRO | TIPO | TAMANHO | OBRIGATÓRIO | DESCRIÇÃO |
---|---|---|---|---|
Operation | string | Sim | Tipo da operação: opSellItem | |
SellItem | Array object Json | Sim | Lista de itens vendidos | |
SellItem[0].ExternalCode | string | 25 | Sim | Códido externo criado pelo parceiro para identificação do item (seqitem do parceiro) |
SellItem[0].BarCode | string | 25 | Não | Código de barras do produto (EAN) |
SellItem[0].Image | Object Json | Sim | Dados da imagem capturada | |
SellItem[0].Image.Type | string | Sim | Tipo da imagem imtJPG - jpeg imtBMP - bmp | |
SellItem[0].Image.Image | blob | Sim | Imagem, em base 64, do produto capturado na base 64capturado |
...
{
"Operation":"opSellItem",
"SellItem":[
{
"ExternalCode":"001",
"BarCode":"7891000100103",
"Image":{
"Type":"imtJPG",
"Image":"data:image/jpeg;base64,/9j/4AAQSkZJRg continue..."
}
},
{
"ExternalCode":"002",
"BarCode":"7896024050328",
"Image":{
"Type":"imtJPG",
"Image":"data:image/jpeg;base64,/9j/4AAQSkZJRgA continue..."
}
},
{
"ExternalCode":"003",
"BarCode":"7896272000830",
"Image":{
"Type":"imtBMP",
"Image":"data:image/bmp;base64,Qk2WAQAAAAAAAHYA continue..."
}
}
]
}
...