Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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.


Image Added

Imagem 1 - Produto não identificado


Imagem 4 - Confirmação do registro do produto não identificadoImage Added

Imagem 2 - Confirmação do registro do produto não identificado


Imagem 5 - Acionamento da opção SubTotal enquanto ainda há item a ser registradoImage Added

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).


Image Added

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 7 - Conceder permissãoImage Added

Imagem 5 - Conceder permissão


Chamada

POST {url} porta 4015

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

Parâmetros do Header (Header Parameters)

PARÂMETROTIPOOBRIGATÓRIODESCRIÇÃO
x-authtokenStringSim

Token de autenticação do parceiro

Parâmetros do Corpo (Body Parameters)

PARÂMETROTIPOTAMANHOOBRIGATÓRIODESCRIÇÃO
Operationstring
SimTipo da operação: opSellItem
SellItem Array object Json
SimLista de itens vendidos
SellItem[0].ExternalCodestring25SimCódido externo criado pelo parceiro para identificação do item (seqitem do parceiro)
SellItem[0].BarCodestring25NãoCódigo de barras do produto (EAN)
SellItem[0].ImageObject Json
SimDados da imagem capturada
SellItem[0].Image.Typestring
Sim

Tipo da imagem

imtJPG - jpeg

imtBMP - bmp

SellItem[0].Image.Imageblob
SimImagem, em base 64, do produto capturado na base 64capturado 

Formatos de Requisição (Request Formats)

...

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

...