Para realizar o cadastro da maquineta do POS, será necessário realizar a permissão no cadastro de grupo de usuários.

Vá até o menu Cadastros > Usuários > Grupo de Usuários. na aba Módulos no campo de pesquisa digite POS, e serão localizadas as 2 opções que necessitam ser liberadas, conforme Figura abaixo:

Figura 01 - Cadastro Grupo de Usuários

Troque o"N" pelo "S" e seta para cima ou para baixo para registrar a alteração.

Integração POS Connect no Linx Big Farma

Com a permissão liberada, vá até o menu Configurações > Cadastro de Maquineta (POS).

Para incluir um novo POS basta clicar no botão e insira as informações solicitadas na tela.

Figura 02 - Cadastro de Maquineta POS

• Número de Série: O número de série é encontrado em uma etiqueta no POS ou em suas configurações;

• Credenciadora: Defina a credenciadora do cartão, que será carregada a partir do cadastro de credenciadoras;

• Descrição: Texto livre para identificação da máquineta no módulo de entregas.

O botão seleciona uma cor específica para o cadastro, facilitando assim no momento de seleção da maquineta na tela de controle de entregas.

O campo "Este POS é capaz de se comunicar com o Validador Fiscal é restrito à lojas localizadas na UF do Ceará (CE), para comunicação com o MF-e.

A situação mostra se o cadastro está ativo ou não.

Integração POS Connect no Linx Big Farma

Após realizar o cadastro das maquinetas, e ter o serviço liberado, basta ir ao menu Configurações > Filiais > Integrações na aba POS Connect (Invoice Layer - Stone) para realizar a configuração da integração.

Figura 03 - Configuração Filiais - Integração POS Connect

Dentro dessa aba foram criados os seguintes campos:

• Habilitar a Integração: Por padrão virá desabilitada e vai ter como funcionalidade habilitar a integração junto ao POS Connect e assim ativando o serviço;

• : Interrogação azul para que se acesse essa página de artigo do share referente a integração do POS Connect;

• Chave Privada: Essa chave privada é passada pela pagar.me (Stone);

• URL de Comunicação: Esse campo virá preenchido com o URL padrão que é https://api.pagar.me;

• ID da Conta: Esse campo tem como funcionalidade fazer a comunicação com o webhook, que é um recebimento automático, tal informação é passada também pelo pagar.me (Stone);

• Tipo Integração: Virá com as opções de Listagem de Pedido e Venda Direta no PDV, o campo já vai estar pronto para ser selecionado;

• - Esse botão testa a comunicação com a URL junto ao WS, esse botão só estará disponível após a integração estar habilitada e salva;

Abaixo dessas configurações, foram incluídas três sub abas chamadas de Terminais POS, Tipos de Pagamento e Bandeiras .

Terminais POS

Essa aba abriga os POS cadastrados e ativos.

Pode ser localizado através do filtro na grade por descrição e também através do botão acessando o cadastro de POS (Maquineta).

Abaixo do filtro e botão, existe a grade que possui três colunas que são elas:

• Descrição do Terminal POS: Será exibida exatamente de descrição que está no cadastro;

• Número de Série: Será exibida exatamente o numero de série que está no cadastro;

• Situação: Será exibido o status de ativo por padrão. Só serão exibidos POS ativos. 

Será permitido marcar mais de um POS a ser utilizado para a entrega através do botão de atalho Ctrl+F5, isso é o usuário poderá realizar a marcação de 1 ou mais POS cadastrados, e essa lista de pedidos será replicada para todos e com isso essas identificações irão através do WS para entregar a lista de pedidos feitas para a entrega. 

Tipos de Pagamento

Figura 04 - Aba Tipos de Pagamento

Nessa aba exibirá a identificação de tipos de pagamento a serem considerados quando uma venda efetuada pelo POS Connect for finalizada pelo Controle de Entregas, isso é, será identificado um tipo de pagamento que será considerado quando o WS fizer o retorno das informações e consequentemente identificado será feito a baixa dessa venda.

Por Exemplo

Venda registrada com o pagamento em forma de Crédito, porém no POS foi recebido como Débito (o valor do pagamento recebido em debito é exatamente o que era para ser recebido em crédito), com isso o ERP vai considerar o que foi configurado pelo o usuário na sub aba de "Tipos de pagamento" e considerar o tipo de pagamento configurado para recebimento em debito e fazer a baixa, com isso fazendo a troca do tipo de pagamento Crédito para Debito. 

Bandeiras

Figura 05 - Aba Bandeiras

Essa aba tem como finalidade fazer a associação de bandeiras que o POS Connect aceita, juntamente com as bandeiras que estão cadastradas no ERP Linx Big Farma.

Com isso, essas informações já virão pré cadastradas.

Na grade será possível adicionar novas bandeiras e também excluir bandeiras. 

Não será permitido a inclusão de bandeiras POS com a mesma descrição. 

Após preencher as informações necessárias e obrigatórias é necessário que o usuário salve as informações dessa aba para que dê início à integração.

Integração POS Connect no Linx Big Farma

No controle de entregas foram adicionadas novas opções para o envio, e gerenciamento dessa lista de pedidos.

Figura 06 - Atalhos Controle de Entregas

→ Enviar para POS (Ctrl + J) : Esta opção somente estará habilitada se:

• O serviço POS Connect estiver liberado para a Filial Física atualmente configurada;

• Se a integração estiver habilitada, e

• Se o parâmetro Integração estiver definido como Listagem de pedido.

O sistema verifica se:

• Há entregas marcadas;

• Se entre elas existem entregas que não são de comércio eletrônico;

• Que tenham sido faturadas/iniciadas, e

• Que atualmente não estão em nenhum POS.

→ Atualizar situação POS (Ctrl + L) : Nessa opção o sistema verifica:

• Se há registros marcados;

• Se entre os marcados há registros com Situação POS igual a Pendente, Recebido ou Recebido com divergências;

• Se entre os marcados há transações cuja Situação POS esteja definida como Pendente, Recebido ou Recebido com divergências, e

• Se entre os marcados houver transações com Situação POS diferente de Pendente, Recebido e Recebido com divergências.

A situação atualizada será exibida na coluna Situação POS da grade principal do Controle de entregas.

Nessa coluna serão visualizados os status de: Pendente, Recebido, Recebido com divergências.

E também foi adicionado o filtro de status POS no botão .

→ Gerenciador POS (Ctrl + M) : Esta opção será habilitada apenas:

• Se o serviço POS Connect estiver liberado para a Filial Física atualmente configurada;

• Se a integração estiver habilitada, e

• Se o parâmetro Integração estiver definido como Listagem de pedido.

Ao ser acionada, o Linx Big Farma vai apresentar a tela manutenção Gerenciador POS Connect que também poderá ser acessada através do menu Utilitários > Integrações > Gerenciador POS Connect (Invoice Layer - Stone).

Integração POS Connect no Linx Big Farma

Marque as entregas com as teclas de seleção padrão do sistema e selecione a opção Enviar para POS (Ctrl + J) (destaque da Figura 06 acima).

O sistema filtra somente as entregas que estão associadas a um tipo de pagamento cartão ou PIX.

Se não existir registros que atendam as condições de filtro, o sistema notificará o usuário com a mensagem abaixo e abortará a operação.

Figura 07 - Mensagem POS

O sistema vai identificar qual o POS que receberá as entregas.

Apenas estarão aptos para receber as entregas os POS que estão configurados e ativos na configuração da integração como definido na Figura 03 acima.

Figura 08 - Seleção de POS

Ao selecionar um lançamento enviado para o terminal POS, é possível visualizar as informações de Valor à Receber T.E., Valor Recebido POS Connect, a Situação/Status do lançamento, o Terminal POS Connect que o lançamento foi enviado e informações de Última consulta dos recebimentos realizada pelo sistema.

A lista de entregas à serem recebidas em cartão, serão listadas no terminal POS na opção Pagamento.

O POS permite o recebimento em Débito, Crédito e PIX.

Figura 09 - POS

Após selecionar o lançamento no POS e realizar o recebimento, o mesmo ficará listado em tela como PAGO.

O Linx Big Farma irá receber automaticamente as informações e ajustar o status POS no controle de entregas como Recebido. 

Integração POS Connect no Linx Big Farma

No Controle de Entregas

Ao ser realizado o pagamento através da maquineta POS no cliente, a entrega será identificada como Pago (na maquineta) e na tela do Controle de Entregas a coluna Status POS (destaque na Figura 06 acima) será identificado como Recebido ou Recebido com Divergências.

É necessário que a entrega seja finalizada no controle de entregas como já é feita atualmente, ou seja, através da opção Finalizar entrega (F3).

Ao finalizar uma entrega, o sistema poderá identificar eventuais diferenças entre os tipos/modalidades/valores de pagamento existentes na entrega, e os tipos/modalidades/valores de recebimento registrados no POS.

A identificação dessas diferenças é essencial, pois ela dará origem a redefinição dos tipos de pagamento da entrega.

Exemplo de Divergências no Pagamento e da Redefinição

Figura 10 - Exemplo de Divergências

No exemplo da imagem acima as colunas:

• Pagamento entrega - refere-se ao tipo de pagamento enviado para o POS;

• Recebimento POS - refere-se ao tipo de pagamento efetivamente registrado na maquineta POS, e

• Fechamento entrega - refere-se ao que deve ser registrado na finalização da entrega no controle de entregas de acordo com a associação realizada na Figura 04 (Tipos de pagamento) acima.

Os Tipos de pagamento que aparecem na coluna Fechamento entrega são aqueles que devem ter um valor associado na tela de Pagamento da venda que é exibida no momento do fechamento da entrega.

Figura 11 - Tipo de Pagamento na Finalização da Entrega

Ao clicar no botão , o sistema verifica se o pagamento é igual a soma dos valores recebidos no POS também agrupada por tipo e modalidade de pagamento.

Se as somas forem iguais, o sistema grava automaticamente as transações de cartão, independentemente da existência de configurações para que sejam informados tais dados, preenchendo automaticamente dados como NSU, Bandeira, etc.

Agora se as somas forem diferentes, o sistema descarta os dados das transações e, obedecendo as configurações vigentes, exigir ou não a entrada manual dessas informações por parte do usuário.

Por fim, sempre que uma entrega que está associada a um POS for finalizada, o sistema fechará o pedido referente a ela para que este pedido seja retirado do POS.

Existem duas formas de fechamento:

→ O pedido referente à entrega foi recebido (com ou sem divergências) no POS: neste caso, o sistema executa as ações de baixa, apenas ajustando a observação para "LANÇAMENTO BAIXADO ATRAVÉS DA FINALIZAÇÃO DA ENTREGA - [DATA/HORA] [USUÁRIO]".

→  O pedido referente à entrega não foi recebido no POS: neste caso, o sistema executa as ações de cancelamento, apenas ajustando a observação para "LANÇAMENTO CANCELADO ATRAVÉS DA FINALIZAÇÃO DA ENTREGA - [DATA/HORA] [USUÁRIO]".

Integração POS Connect no Linx Big Farma

O gerenciador POS Connect (Invoice Layer - Stone), foi criado para ser acessado em 2 lugares.

Tanto pelo retaguarda através do atalho Utilitários > Integrações > Gerenciador POS Connect (Invoice Layer - Stone), quanto pela Tela de vendas no controle de entregas através do atalho Gerenciador POS (Ctrl+M) (Figura 06 acima). 

Figura 12 - Gerenciador POS Connect

Na parte superior dessa tela existem três campos mostrando as informações de:

• Total a recebe: Exibe a totalização dos colunas de mesmo nome, de transações que estão sendo exibidas na grade;

• Total recebido: Exibe a totalização dos colunas de mesmo nome, de transações que estão sendo exibidas na grade, e

• Marcado (Registros selecionados): Exibe a marcação dos registros em grade.

Opções de Pesquisa

Por padrão pode ser pesquisado o registro da transação pelo numero da nota.

Ao lado da barra de pesquisa também existe o botão que vai permitir fazer a pesquisa por Situação, Terminal POS vinculado, Data de Envio, Cliente e Filial.

O botão é para configurar o período de análise, e virá como padrão configurado para 7 dias, e tem como funcionalidade minimizar o numero de registros em tela.

Legendas

Nesse informativo de legendas aparecem as interações para fazer marcações na grade, que são:

• (F5) Marcar,

• (F6) Marcar todos,

• (F7) Desmarcar todos,

Também é exibida a legenda com os ícones da situação, sendo as situações de:

• - Pendente,
• - Recebido,
• - Cancelado,
• - Recebido com Divergência,
• - Baixado e
• - Entrega Vinculada.

Grades de Visualização

Transação

O gerenciador POS conta com duas grades, a primeira grade com o nome de Transação, vai ser criada com 14 colunas, que são elas:

• Situação: Será exibida a situação de acordo com a transação, os registros podem ser: pendente, recebido, baixado, cancelado e recebido com divergência;

• Terminal POS: Exibe a descrição do terminal POS que está vinculado à transação, essa descrição será a mesma existente no cadastro de POS;

• Entrega Vinculada: Se o registro estiver vinculado a uma entrega vai aparecer o S, se não vai aparecer o N;

• Data Envio: Exibe a data que foi efetuada a entrega e consequentemente obteve o retorno da integração;

• Cliente: Exibe as informações de código do cliente junto ao nome do cliente em seu cadastro;

• Nº Nota: Exibe o numero da nota (cupom fiscal) que foi gerado para a transação;

• Num. Lanc: Exibe o numero de lançamento presente para controle interno de transações do Big;

• Data Emissão: Data de emissão do cupom fiscal;

• Total: Exibe o valor total da transação;

• Total Receber: Exibide o valor total a receber referente a transação;

• Total Recebido: Exibe o valor total recebido da transação, se a transação estiver com a situação pendente exibirá a coluna sem nenhum valor;

• ID: Exibe o ID (código interno) retornado pela integração, se a transação estiver com a situação pendente exibirá a coluna sem nenhum valor;

• Observação: Exibe a observação, caso houver alguma observação em relação a transação efetuada, essa observação também se faz presente na tela do controle de entregas;

• Data/Hora Ultima Atualização: Data e hora da última atualização/alteração que o registro presente na tela gerenciador de POS sofreu, as atualizações/alterações são relacionadas à interação do usuário com os botões na parte inferior da tela;

• Usuário Ultima Atualização: Código e nome do usuário que efetuou a última atualizações/alteração no registro selecionado, as atualizações/alterações são relacionadas à interação do usuário com os botões na parte inferior da tela;

• Filial: Exibe a filial ID juntamente com o nome da filial.   

Detalhes

A segunda grade chamada de detalhes é uma grade reativa à informação selecionada na grade de transações, isso é, ao selecionar um registro de transação na primeira grade, a segunda grade exibe os detalhes envolvendo essa transação, tal grade possui 6 colunas que são elas:

• Tipo de Pagamento: Exibe o tipo de pagamento utilizado na transação, crédito, debito ou pix;

• Data/Hora Recebimento: Data de hora que foi feito o recebimento dessa transação, caso o registro estiver com a situação pendente, não exibirá nenhuma informação nessa coluna;

• Valor: Exibe o valor da parcela dessa transação;

• Bandeira: Exibe a bandeira utilizada para essa transação;

• NSU: Exibe o número da NSU da transação;

• Nº Parcela: Exibe o número total de parcelas que foi utilizada para essa transação.

Abaixo da grade de detalhes, existem os botões:

• : O botão só tem funcionalidade quando o registro estiver com a situação pendente. Ao selecionar esse botão será feito a validação das transações que não foram atualizadas automaticamente na execução do webhook;

• : O botão tem funcionalidade para transações que estão com a situação pendentes, recebidos e recebido com divergência;

• : O botão tem a funcionalidade de vincular um lançamento registrado no Gerenciador POS Connect para uma transação de entrega existente na tela do controle de entregas; 

• : O botão tem a funcionalidade de desvincular um lançamento registrado no Gerenciador POS Connect de uma transação de entregas existentes na tela do controle de entregas;

• : O botão tem a funcionalidade de fazer a troca do Terminal POS, que está sendo exibido no registro de transação na nova tela do gerenciador POS.

As informações exibidas nessa tela não são necessariamente uma entrega e sim são registros de transações que vem através da API Pagar.me, isto é, vão aparecer registros de transações que passaram pelo POS, quando esse registro estiver atrelado a uma entrega essa questão ficará visivel para o usuário.

Porém pode acontecer de serem realizadas transações avulsas, isso é, quando aparece um registro na tela de gerenciador que não está atrelado a nenhuma entrega.

Por Exemplo

Entregador está em rota e surge um recebimento para que ele faça no meio do seu percurso, porém esse recebimento não está relacionado a nenhuma das entregas que ele está transportando, ao fazer esse recebimento, essa transação gerada no POS Connect é tratada como uma transação avulsa e ela vai aparecer na tela do gerenciador sem uma entrega associada.

Quando o registro não tem uma entrega associada ele tem particularidades em sua exibição na tela do gerenciador, isso é, algumas colunas vão ficar sem nenhuma informação, sendo exibidas em branco, as colunas são, data envio, cliente, nº nota, num. lanc e data emissão. 

Integração POS Connect no Linx Big Farma

Para realizar a baixa dessa entrega foi incluída a opção Baixar / Cancelar ao Gerenciador POS Connect.

Quando acionada, o sistema verifica:

1. Se há registros marcados, e
   
   
2. Se entre os marcados, há registros com Situação POS igual a Pendente, ou igual a Recebido e que não estejam vinculadas a Entregas.
   1. Se não houver registros marcados, o Linx Big deverá notificar o usuário com a mensagem a seguir e então abortar a operação.

Marque os registros das transações cujo POS deseja baixar e/ou cancelar e na sequência, o Linx Big verifica se entre os registros marcados há transações cuja Situação POS esteja definida como Pendente, ou igual a Recebido e que não estejam vinculadas a Entregas.

O botão realiza os 2 procedimentos, porém com suas particularidades, como segue:

• O Cancelamento de transações se aplica à registros com Situação POS igual a Pendente e a transação será desvinculada da entrega.

Os dados referentes à desvinculação serão gravados e estarão disponíveis para visualização através do Gerenciador POS.

→ A  Situação POS deve ser alterada para Cancelado e a Observação atualizada para LANÇAMENTO CANCELADO ATRAVÉS DO GERENCIADOR POS CONNECT - [DATA/HORA] [USUÁRIO].

• A baixa de transações se aplica a registros com Situação POS igual a Recebido e que não estão vinculados a uma Entrega.

Os dados referentes à baixa serão gravados e estarão disponíveis para visualização através do Gerenciador POS.

→ A  Situação POS deve ser alterada para Baixado e a Observação atualizada para LANÇAMENTO BAIXADO ATRAVÉS GERENCIADOR POS CONNECT - [DATA/HORA] [USUÁRIO].

Integração POS Connect no Linx Big Farma

Alguns dados de configuração fornecidos pela Stone podem ser encontrados no Dash da Pagar.me em: Desenvolvimento > Chaves.

Figura 13 - Pagar.Me - Chaves

Fluxo: Listagem de Pedidos (Controle de Entregas)

• Quando uma entrega é enviada a um terminal POS, é possível visualizar um pedido criado como Pendente no Dash da Pagar.me em: Pagamentos > Pedidos.

• O pedido apenas é atualizado para Pago quando a entrega for baixada no Linx Big Farma, pois é nesse momento que é retirado da lista no POS. Caso a entrega seja cancelada, voltada para pendente ou realizada a troca de motoqueiro, esse pedido é ajustado para Cancelado.

Fluxo: Pagamento Direto (PDV)

Quando os dados para pagamento são enviados ao POS na tela de vendas, é criado um pedido como Pendente no Dash da Pagar.me em: Pagamentos > Pedidos.

• Caso seja "Cancelado o Pagamento" na tela de vendas, esse pedido é atualizado para Cancelado.

• Caso seja realizado o recebimento no POS e a tela de vendas recebe essas informações o pedido é atualizado para Pago.

Figura 14 - Pagar.Me - Pedidos

Quando um pagamento é realizado no POS é registrado uma Cobrança no Dash da Pagar.me como Pago em: Pagamentos > Cobranças.

Caso o pagamento seja estornado, será apresentado como Cancelado.

Figura 15 - Pagar.Me - Cobranças

Para o funcionamento correto do recebimento automático das informações dos Terminais POS no Linx Big Farma, é necessário que haja a configuração do Webhook no Dash da Pagar.me em: Configurações > Webhooks.

A URL do Proxy para uso no Linx Big Farma deve ser https://dev-proxypagarme.azurewebsites.net/hook 

Figura 16 - Pagar.Me - Webhooks

Integração POS Connect no Linx Big Farma