Receber Itens Vendidos - POST

Objetivo

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

Passo a Passo

1. No Monitor de PDV, menu: Configurações → Configurações de PDVs , localize o grupo "Integrações externas" → "Receber Operações":

• Configurar o campo "Ativo" como "Sim";
• Configurar o campo "Código do parceiro" com o código do parceiro cadastrado;
• Configurar o campo "Permitir venda de itens avulsos" como "Sim" caso seja permitido incluir também produtos de forma manual (e não apenas através API).

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

Chamada

POST {url} porta 4015

Informações da Requisição (Request Information)

Parâmetros do Header (Header Parameters)

Parâmetros do Corpo (Body Parameters)

Formatos de Requisição (Request Formats)

application/json

Exemplo (Sample)

{
   "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..."
         }
      }
   ]
}