Linx Webservices Release Notes - 2.32.0

Habilitação do LWS para trabalhar com MFE + Mid-e client Agent

Para habilitar a operação do lws e do cxr com o MFE através do agent, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado. Em seguida, instale o agent, para que seja possível configurar o ip e a porta do mesmo no servidor de configuração.

 Em seguida, você deve fazer as seguintes configurações:

• Para o grupo do LWS:
• tipo autorizador: selecionar opção "sat_integradorfiscal".
• uso do mid-e client agent: true
• tipo do mid-e client agent: mfe
• endereco ip do mid-e client agent: <ip onde o agent foi instalado>
• porta do mid-e client agent: <porta onde o agent foi instalado>

• fabricante do aparelho sat: <fabricante desejado>

• código de ativação do fabricante sat: <código de ativação do fabricante desejado>

• Intervalo leitura output Integrador Fiscal: 10000 (milissegundos)
  

• Diretório output MFE: <diretório onde o Integrador Fiscal gravará os retornos dos arquivos de solicitação fiscal>
  

• Diretório input MFE: <diretório de onde o Integrador Fiscal fará a leitura dos arquivos de solicitação fiscal>
  

• para o Caixa Rápido:
  • tipo autorizador: selecionar a opção "integrador fiscal".

Após a configuração, você deve enviar a mesma para o linx webservice correspondente. Em seguida, deve reiniciar o Mid-e client agent para que ele receba as configurações carregadas pelo LWS. Sem isso, ele não vai funcionar.

Atenção: Quando usar um MFE Elgin, deve ser colocado no bin do wildfly o arquivo mide-client-mfe-elgin-homologacao.properties para o ambiente de homologação.

Alteração Legal (RJ): Inclusão do PROCON e CODECON no Documento Fiscal

Esta versão contempla uma alteração legal para o Rio de Janeiro, que é a exibição dos endereços do PROCON e CODECON nos documentos fiscais.

Para habilitar esta alteração legal, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

Foram criados 2 parâmetros, que indicam a lista dos endereços destes departamentos no formato <UF>=<Endereço>, separadas por ;. Desta forma, quando for necessário incluir um endereço de PROCON ou CODECON para uma nova UF, basta alterar os parâmetros, acrescentando um novo elemento <UF>=<Endereço>

Sendo assim, você deve fazer as seguintes configurações para o grupo do LWS:

• Lista de endereços dos Procons estaduais: UF=Endereço ; UF=Endereço
• Lista de endereços dos Codecons estaduais: UF=Endereço ; UF=Endereço

Para a UF do RJ, seguem os endereços que devem ser informados:

PROCON: tel. 151, end. Av. Rio Branco, 25 - 5o andar, Centro/RJ.
CODECON: tel. 0800 282 7060, end. R. da Alfandega, 8 – Centro/RJ.

Exemplo do preenchimento para o RJ:

• Lista de endereços dos Procons estaduais: RJ=tel. 151, end. Av. Rio Branco, 25 - 5o andar, Centro/RJ
• Lista de endereços dos Codecons estaduais: RJ=tel. 0800 282 7060, end. R. da Alfandega, 8 – Centro/RJ

Após a configuração, você deve enviar a mesma para todos os LWS, visto que os novos parâmetros são globais.

Habilitar da funcionalidade: Múltiplos Agent's com MFE

Para habilitar a funcionalidade, deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente):

• Endereço IP e Porta do MID-e Client Agent: informar os IPs e Portas dos Agentes no seguinte formato: IP:PORTA;IP:PORTA;

Após a configuração, deve recarregar as configurações do LWS.

Habilitar QR Linx

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

Os valores dos parâmetros abaixo são específicos por cliente.

Target da API do QR Linx
Canal do cliente da API do QR Linx
Chave de assinatura da API do QR Linx
Após a configuração, você deve recarregar as configurações pro LWS.

Alterar o Tempo de armazenamento da MFD

 Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente):

• Tempo de armazenamento da MFD (em dias): 60

Após a configuração, você deve recarregar as configurações do Caixa Rápido.

Envio de e-mail automático ao integrar venda

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
Em seguida, deve-se fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente):

• Envio de email automático ao integrar venda: true

Após a configuração, você deve recarregar as configurações do Caixa Rápido.

Parametrizar novos adquirente de aprovação do pagamento do cartão

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

• Mapeamento das autorizadoras do CTF= authorizerCode=description#brandType#cnpj ; authorizerCode=description#brandType#cnpj;

ex: NL=CLESSELODEBITO#99#01027058000191 ; BL=CLESSELODEBITO#99#01027058000191

Após a configuração, você deve recarregar as configurações pro LWS.

BIGRETAIL-15453 [LWS] Criar integração do LWS com o Link de Pagamento

Para utilizar o link de pagamento da Linx Pay Hub, deve-se seguir os passos seguintes:
1 - Carregar o XML de configuração desta versão no servidor de configuração.
2 - Após a importação, seguir para a tela de configurações dos parâmetros.
3 - Informar os parâmetros do link de pagamento, são eles:

• API Key do Link de pagamento.
• URL da API de Link de pagamento.
• Timeout de requisições à API de Link de pagamento.
• Usuário da API de Link de pagamento.
• Senha da API de Link de pagamento.

Após a configuração, deve-se carregar as configurações no LWS.

Recarregar Configurações Automaticamente no Caixa Rápido

Parâmetro:

• TTL de cache dos parâmetros de configuração: <valor>
  Onde: O LWS só retornará dados quando o valor for maior ou igual a ZERO. Com zero indicando que uma consulta sempre será feita ao Serv. de Config. e com valores maiores que uma consulta só será feita após o valor em minutos definido no parâmetro.

Liberar o arquivo em anexo (serv-config-webservice.xml) no FTP junto com as versões.

• Clientes: TODOS
• Projeto: Parametrização chave de criptografia no LWS
• Chave Crypto-Triple (chave-crypto-triple-des)

[LWS] Integração Zenvia API 2.0

**Para habilitar a funcionalidade de envio de SMS e Whatsapp da Zenvia 2.0, informe o parâmetro abaixo:
 - Token da API de mensagens da Zenvia
OBS: O Token é fornecido pela Zenvia.

Parametrização do Agente de Métricas:

Habilitação Geração de Vale Troca - Nota Fiscal Web

Fazer as seguintes configurações no servidor de configuração para o LWS:

• URL para consulta de transações LOGIC= <URL>

Habilitar Voucher de Vale Troca do Promo:
Identificador único do tipo de Voucher -> É o código do tipo do voucher criado no Promo
Número prefixo de Voucher -> Se houver um prefixo, deve-se informar aqui
Url do PROMO -> URL base do PROMO para as requisições
CompanyId do PROMO -> É o identificador da empresa no PROMO

Habilitar Regras de desconto do Promo:

Tipo do Motor de Promoções = PROMO
Parâmetro que guarda a url do servidor do PROMO = (Url do PROMO)
Identificador da empresa no serviço do Promo = ( ID cadastrado no Promo)

Habilitar consulta de Pedidos no OMS para anulação/devolução/troca:

URL base do serviço Chaordic OMS =
ID do cliente do Chaordic OMS =
Usuário do serviço do Chaordic OMS =
Senha do serviço do Chaordic OMS =
Timeout padrão dos serviços da Chaordic OMS (milissegundos) =

Habilitar consultas de Pedidos WEB no OMS
URL base do serviço Chaordic OMS =
ID do cliente do Chaordic OMS =
Usuário do serviço do Chaordic OMS =
Senha do serviço do Chaordic OMS =
Timeout padrão dos serviços da Chaordic OMS (milissegundos) =
 
 
Habilitar geração de Vale Troca no Promo
 Identificador único do tipo de Voucher -> É o código do tipo do voucher criado no Promo
Número prefixo de Voucher -> Se houver um prefixo, deve-se informar aqui
Url do PROMO -> URL base do PROMO para as requisições
CompanyId do PROMO -> É o identificador da empresa no PROMO

• A funcionalidade "Forma de recebimento Link Pgto SE via CXR" necessita:
• SELINK-CALLBACK-SERVICE-1.0.0 esteja configurado e pronto (BIGRETAIL-24608)
• SERVIDOR_PEDIDOS-4.4.0 esteja configrado e pront (BIGRETAIL-24091)
• Parâmetros dessa funcionalidade:
• Período de verificação de pagamento para Pedidos: Tempo em Segundos
• Tipos de verificação de pagamento para Pedidos: Para Renner informar "SE" (Sem aspas)
• URL da API de Link de pagamento - SiTef: Informar O Host do SELink Callback Service
• Timeout de requisições à API de Link de pagamento - SiTef: Padrão se não informado é 15000 (15s)

Habilitação da funcionalidade de Geração de vale-troca

Para habilitar a funcionalidade de Geração de vale-troca, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

 Em seguida, você deve fazer as seguintes configurações para o grupo do LWS:

• Tipo da operaçao de retorno de itens: TIPO_2

Após a configuração, você deve enviar a mesma para o linx webservices correspondente.

Habilitação da funcionalidade de Atualização dos dados do cliente

Para habilitar a funcionalidade de Atualização dos dados do cliente, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

 Em seguida, você deve fazer as seguintes configurações para o grupo do LWS (alguns dados são sensíveis, deverão ser informados pelo cliente):

• Habilita o uso de API externa de clientes: true
• URL base da API externa de Clientes
• Id do cliente consumidor da API (client_id)
• Chave do cliente consumidor da API (client_secret)
• Tipo de concessão da autenticação (grant_type oAuth): client_credentials
• Nome de usuário da API externa (username)
• Senha do usuário da API externa (password)
• Tempo (segundos) limite de espera por requisição à API: 15

Após a configuração, você deve enviar a mesma para o linx webservices correspondente.

Habilitação da funcionalidade de Impressão de Cupom de Troca Genérico

Para habilitar a funcionalidade de Impressão de Cupom de Troca, você deve primeiramente carregar os xmls de configuração desta versão no servidor de configuração já instalado.

 Em seguida, você deve fazer as seguintes configurações para o grupo do LWS (alguns dados são sensíveis, deverão ser informados pelo cliente):

• Imprimir Cupom de Troca: true

Após a configuração, você deve enviar a mesma para o linx webservices correspondente.

Para integrar o LWS com a API de Cashback da Realize, faz-se necessário seguir os seguintes passos:

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

• Parâmetro: URL base da API externa de cashback
  -ex: https://api
• Parâmetro: Nome de usuário da API externa (username)
  -ex: usuario
• Parâmetro: Senha do usuário da API externa (password)
  -ex: senha
• Parâmetro: Tempo (segundos) limite de espera por requisição à API
  -ex: 15

Após a configuração, você deve recarregar as configurações pro LWS.

BIGRETAIL-13527 LWS - Super Gêmeos

Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.

Em seguida, você deve fazer as seguintes configurações (alguns dados são sensíveis, deverão ser informados pelo cliente): 

• Mercadológicos sem valor fiscal em BUNDLE=ZV.A12020001,ZV.A12020002 ( No P2K, esse é o valor do parâmetro "PRODUTO_KIT_MERCADOLOGICO")
• Filtro de Consulta de Produtos=BUNLDE_NO_ORPHANS

Após a configuração, você deve recarregar as configurações pro LWS.

CR 126681: [LINX MESSAGES] Adicionar tratamento de cliente estrangeiro

Adicionar o caminho abaixo como uma linha no arquivo host do windows:

10.56.96.116 hospoq00ler.lmbr.int.adeo.com

<system-properties>

    <property name="javax.net.ssl.trustStore" value="D:/Packages/wildfly-10.1.0.Final/standalone/configuration/clientkeystore.jks"/>

</system-properties>

Adicionar isso no standalone.xml do wildfly

Arquivo: clientkeystore.jks

jogar essa chave na pasta standalone\configuration do wildfly (Ou jogar em qualquer lugar e editar o path ali em cima no system-properties)