Pré-condiçoes de Atualização

Data da Versão

 

Responsável

Gerência de Configuração

Pacote da Versão

LINX-WEBSERVICES-3.8.1.zip

Versão Java

01.08

Caminho de Liberação

ftp://10.4.229.5/Produtos/LINXWEBSERVICES/LINX-WEBSERVICES-3.8.1

Caso não possua esta versão, entre em contato com o suporte da Linx para fazer a atualização não se esquecendo de executar todas as informações adicionais da nota de liberação da versão mínima requerida

Os xmls de configuração encontram-se disponíveis dentro do pacote da versão.

Passos para atualizar novos parâmetros:

  1. Deve-se primeiramente carregar o xml de configuração desta versão no servidor de configuração já instalado.
  2. Em seguida, deve-se ajustar os novos parâmetros (alguns dados são sensíveis, deverão ser informados pelo cliente):
  3. Após a configuração, deve recarregar as configurações do LWS.



Índice

Versões de Compatibilidade



Cliente

Produto

Versão


Servidor de Pedidos

4.51.0


Servidor de Configuração 

4.1.0


Banco de Dados

BD-Standard 7.18.0

BD-Versao14 5.14.0

BD-2961. 5.9.0

BD-STOREX. 5.17.0

BD-CSTM-STUDIOZ-1.38.0


Banco de dados do MID-E-CLIENT

MID-E-CLIENT-7.5.1


Storex-Integration

Storex-Integration-1.23.0

2961Storex

STOREX-RENNER-14.09.01

5000Storex

STOREX-TIM-16.00.00

5005 StorexSTOREX-15.07.90
2961StorexRENNER15.03.00





Instruções Adicionais da Versão


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.



Atenção

para esta funcionalidade operar corretamente com o Caixa rápido, não se esqueça de realizar as configurações informadas no release notes do CXR!


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:

ParâmetroDomínioDescriçãoValor padrão
Habilitar o agente de métricastrue/false'true' habilita o envio, 'false' desabilita.false
Intervalo de envio das métricas (em segundos)(segundos)Intervalo de consulta das métricas a serem enviadas. Mínimo: 30. 60
 Serviço de métricas AzureApplicationInsights/LinxMetricsService AzureApplicationInsights ->Envia para o Azure Application Insights diretamente.
LinxMetricsService -> Envia para o serviço de métricas Linx (que hoje repassa, como um proxy, pro Azure Application Insights)

Chave do serviço de métricas
Chave do provider. No caso do Azure Application Insights, é o Instrumentation Key. 
URL base do serviço de métricas Linx
URL base do serviço de métricas da Linx
Timeout do serviço de métricas Linx (em segundos) (segundos) Timeout do serviço de métricas Linx (em segundos) 60

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)

Habilitar Desoneração base de PIS e COFINS

Configurar o parâmetro:

Habilita calculo desonerado= true


A correção necessita da versão 4.9.0 do Servidor de Pedidos: BIGRETAIL-35739


 BIGRETAIL-41115 [LWS] Login por "Chave de Autenticação"

  • Endpoint da funcionalidade: /v2/signin/authentication_key
  • Foi criada a configuração "Chaves de autenticação".
    Configuração deve estar no formato "KEY:PASSWORD:SECRET". Utilizar ";" como separador em casos de múltiplas chaves.
  • KEY: Equivalente ao campo "identification" no corpo da requisição.
    PASSWORD: Equivalente ao campo "password" no corpo da requisição.
    SECRET: Deve ser utilizado por aplicações clientes para gerar a Hash, HMAC_SHA512, do campo "password".


BIGRETAIL-39845 Emissão RPS NFSe Para ativar o serviço é necessário configurar os parâmetros:

  • URL base do serviço de NFSe
  • URL base do serviço de token NFSe
  • Client ID do serviço de token NFSe
  • Client secret do serviço de token NFSe
  • Escopo do serviço de token NFSe
  • Timeout do serviço de NFSe (milissegundos)
  • Ambiente do serviço de NFSe [HOMOLOGACAO OU PRODUCAO]



  • BIGRETAIL-42274 Cartão sendo solicitado duas vezes no pagamento em TEF de pedido contendo frete
  • Foi criado o parâmetro para o LWS corporativo chamado: Tipos de itens não fiscais totalizados em cálculos
  • Usado para definir os tipos de itens não fiscais, separados por ponto e virgula, que devem ser incluídos no calculo do total da venda. Por exemplo se desejado frete e taxa de conveniência, basta preencher FREIGHT;CONVENIENCE_FEE

HOTFIX_v2.38.1

Esta hotfix contém a implementação da NT 2020.06 que foi liberada na versão 2.46.0 do LWS. Em caso de atualização do LWS desta HFIX, se atentar em atualizar para uma versão igual ou superior à 2.46.0!


Para utilizar a api de Marketing Cloud para envio de SMS faz-se necessário configurar os seguintes parâmetros:

  • URL Base da API de Mensagens Salesforce Marketing Cloud
  • ID do Cliente da SalesForce Marketing Cloud
  • Chave Secreta do Cliente da SalesForce Marketing Cloud
  • Identificador da conta do Cliente da SalesForce Marketing Cloud
  • Identificador das definições do template de mensagem da SalesForce Marketing Cloud


BIGRETAIL-44751 Ajustes no envio de SKUCupons para SEFAZ


  • Novo parâmetro chamado: Quantidade de digitos do número do produto, definie o número de dígtos para o numero do produto enviado na autorização da nota. O numero é completado com zeros a esquerda para contemplar o tamanho definido.

Exemplo: numero do produto: 56867 (parametro com valor 10)

É enviado: 0000056867


BIGRETAIL-47317 - Criado parâmetro para sobrescrever o nome exibido da forma de pagamento no Cupom fiscal.

  • Nome do parâmetro:  Sobrescrita dos nomes de exibição de formas de pagamento

Formato: ID_FORM_PAG=TEXTO_EXIBICAO;ID_FORM_PAG_2=TEXT_EXIBICAO_2
Exemplo de utilização: QR_LINX=QR PIX CART DIGITAL;CREDIT=CARTAO DE CREDITO


BIGRETAIL-47364 - Erro ao estornar pagamento por link de pagamento

Atualizar Client do Storex Cloud para a versão 1.34.0 ou superior e ajustar o tipo da propridade "amount"


BIGRETAIL-49062 Enviar automaticamente cupom de Vale troca para o cliente

No fluxo de venda, existe a possibilidade de enviar os cupons automaticamente para o cliente. Ativando o parâmetro de LWS: Envio de email automático ao integrar venda


Corrigido problema de serialização de classe, nas requisições de integração de venda. Para o correto funcionamento é necessário garantir que nenhuma mensagem esteja "presa" na fila antes de atualizar para essa versão. Validar se existem mensagens na seguinte pasta:

linx-wildfly\standalone\data\linx-webservices\plugins\lws_pool\sale-async

BIGRETAIL-51355 Habilitar Consulta do LinxGetCEP

  • URL base para consulta de endereço da Linx = linx-get-cep.url
  • Nome para autenticação na API para consulta de endereço da Linx = Storex Cloud
  • Nome de usuário para autenticação na API para consulta de endereço da Linx = storex-cloud
  • Email para autenticação na API para consulta de endereço da Linx = [email protected]
  • Senha para autenticação na API para consulta de endereço da Linx = 2yGbR8*1@38p

obs: Necessário configurar "Nome do provedor para consulta de endereço = LINX_GET_CEP" do Storex Mobile

BIGRETAIL-52994-BR.069263.2021.022- Alteração mensagem Link de Pagamento

Para possibilitar a alteração na mensagem do Link de Pagamento, foi criado algumas propriedades dinâmicas. Internamente a aplicação faz um bind e realiza a troca das informações contidas nas propriedades mapeadas. Abaixo segue a lista de propriedades:

${LINK} -> Contém a informação do Link de Pagamento
${CUSTOMER_NAME} -> Contém a informação do nome do cliente que está realizando a compra
${CUSTOMER_ID} -> Contém a informação do identificador do cliente, se houver (O Storex não armazena esta informação, ela só existirá se a consulta for realizada externamente)
${PRODUCTS} -> Contém a lista de produtos da transação
${STORE_NUMBER} -> Contém o número da Loja em que a transação ocorreu
${STORE_NAME} -> Contém o nome da loja em que a transação ocorreu
${TOTAL_VALUE} -> Contém o valor total da transação
${ORDER_DATE} -> Contém da data da transação

Parâmetro da mensagem: Template padrão para envio de Link de Pagamento existente nos parâmetros do Storex Cloud da versão 2.74.0 ou superior.

Exemplo de uso

  • Frase customizada:
    •  Olá, ${CUSTOMER_NAME}! Este é o link de pagamento referente à compra (${PRODUCTS}), na Loja (${STORE_NAME}), no valor de R$${TOTAL_VALUE} em (${ORDER_DATE}):\nLink: ${LINK}
  • Resultado:


  1. BIGRETAIL-54458 [STOREX-CLOUD] Customização de parâmetro da API de Mensagens
    1. O parâmetro Remetente padrão de mensagens foi atualizado para permitir mútiplos canais, sendo possível configurar o mesmo das seguintes formas:
      1. Forma inicial: palavra-chave (Zenvia)
      2. Forma nova: CANAL=palavra-chave;
        1. Ex: SMS=alder-danthus;WHATSAPP=pattern-claus;
  2. BIGRETAIL-54545
    Funcionalidade para integração do Storex Custom com o Azure telemetria através do LWS. Como esta integração já está disponível via EP, o meio de acesso ao serviço foi parametrizado.
  3. BIGRETAIL-54426
    Insere novo endpoint para consultar saldo de voucher
  4. BIGRETAIL-52014
    Necessário atualizar o Storex os SP's / ProcTrans dos clientes que necessitem dessa mudança.

Configuração "Chave secreta para autenticação com a API Mundipagg" agora suporta múltiplas lojas, basta seguir o formato "STORE_NUMBER=API_KEY;STORE_NUMBER2=API_KEY2". Apenas é recomendado este formato para clientes que utilizam Storex Cloud Corporativo.



  1. BIGRETAIL-59063
    Novos parâmetros:
    1. Versão do provider de link de pagamento Pagar.me. Domínio: V1,V2. V1 = pooling, V2 = webhook
    2. URL base do serviço de webhook do link de pagamento Pagar.me.
    3. Usuário do serviço de webhook do link de pagamento Pagar.me
    4. Senha do serviço de webhook do link de pagamento Pagar.m
    5. Timeout do serviço de webhook do link de pagamento Pagar.me (em segundos)


  1. BIGRETAIL-59044
    Criado a configuração "Processos Referenciados utilizados na emissão da DANFE".


Deve ser configurado no seguinte formato:
nProc=indProc,tpAto;nProc2=indProc2,tpAto2


Valores para nProc:
Deve ter no mínimo 1 caractere e no máximo 60 caracteres


Valores para indProc:
0, // SEFAZ
1, // Justiça Federal
2, // Justiça Estadual
3, // Secex/RFB
9 // Outros


Valores para tpAto: (Apenas deve ser configurado quando indProc = 0)
8, // Termo de Acordo
10, // Regime Especial
12 // Autorização Específica


  1. BIGRETAIL-58706
    Necessário Servidor de Pedidos 4.16.0


  1. BIGRETAIL-58575
    Insere novo parâmetro na transação e retorna numero da loja do pedido


> BIGRETAIL-61869


Equalização do retorno dos serviços de assinatura, consulta de produtos, campanhas e planos e eventos para os ambientes loja e corporativo.


> BIGRETAIL-59762

Foi adicionado um novo parâmetro para habilitar o tratamento de eventos de operações com giftcards. Para ocorrer o tratamento, o mesmo deverá setado como true. Seu valor default foi definido como false.

giftcard-service.enable-ctrl-events
Habilitar eventos para controle de cartão presente

o mesmo consta no xml de configuração do lws,
 presente a partir da versão 2.83


-> BIGRETAIL-62884

"Template padrão para envio de Link de Pagamento": Agora pode ser configurado para múltiplos modelos de template, para isto basta informar o tipo do template, exemplo TEXT=Template em formato de Texto;EXTERNAL_TEMPLATE=ID_DO_TEMPLATE_NO_PROVEDOR
"Mapa de Protocolos do template padrão para envio de Link de Pagamento": Configurar no formato PROTOCOLO_1=MODELO_TEMPLATE;PROTOCOLO_2=MODELO_TEMPLATE_2, exemplo "SMS=TEXT;WHATSAPP=EXTERNAL_TEMPLATE

"Template para notificação de Link de Pagamento pago": Mensagem que será enviada para o cliente quando o Link é pago. Exemplo TEXT=Template em formato de Texto;EXTERNAL_TEMPLATE=ID_DO_TEMPLATE_NO_PROVEDOR
"Mapa de Protocolos do Template para notificação de Link de Pagamento pago": Configurar no formato PROTOCOLO_1=MODELO_TEMPLATE;PROTOCOLO_2=MODELO_TEMPLATE_2, exemplo SMS=TEXT;WHATSAPP=EXTERNAL_TEMPLATE

"Template para notificação de Link de Pagamento rejeitado": Quando por algum motivo o link for cancelado por rejeição esta será a mensagem enviada ao cliente. Exemplo TEXT=Template em formato de Texto;EXTERNAL_TEMPLATE=ID_DO_TEMPLATE_NO_PROVEDOR
"Mapa de Protocolos do Template para notificação de Link de Pagamento rejeitado": Configurar no formato PROTOCOLO_1=MODELO_TEMPLATE;PROTOCOLO_2=MODELO_TEMPLATE_2, exemplo SMS=TEXT;WHATSAPP=EXTERNAL_TEMPLATE

-> BIGRETAIL-62208

Equalização do retorno dos serviços de assinatura, consulta de produtos, campanhas e planos e eventos para os ambientes loja e corporativo.

Implementação do RFID, onde será necessário que a base esteja compatível com as versões:
BD-VERSAO14-3.4.0
BD-STOREX-3.13.0


BIGRETAIL-69605 Parametrizar impressão da via do estabelecimento do TEF

    • Para habilitar a reimpressão da via do estabelecimento, faz-se necessário ajustar o novo parâmetro para true
      • Parâmetro: Imprimir via do estabelecimento do TEF


BIGRETAIL-69148 [CLOUD] Desativação de recálculo de itens em resgate de pedidos

    • Para desabilitar o cálculo de totalização de itens no resgate de pedidos, faz-se necessário desabilitar o novo parâmetro inputando o valor para false.
      • Parâmetro: Desabilita cálculos de totalizações em resgate de pedidos


BIGRETAIL-81747 Implementação de Rate Limiter no LWS

Parameters:
Habilitar Rate Limiter - Boolean
Quantidade máxima de tokens no bucket - Long
Rapidez com que os tokens podem ser recarregados em um período de tempo - Long
Tempo até o bucket ser reabastecido por completo (seg) - IntegerTipo de chave usada para bloquear requisições - Domain(JWT_TOKEN,STORE_TERMINAL,IP)

Para que a funcionalidade do Rate Limiter funcione, a aplicação deve ser inicializada com o parâmetro "Habilitar Rate Limiter" como true. Já que a classe responsável pela funcionalidade carrega de forma dinâmica em tempo de inicialização baseada no valor deste parâmetro. Para evitar carregamento desnecessário para clientes que não utilizam a funcionalidade.


BIGRETAIL-91475 [CLOUD] Contingência PROMO

    1. Novo parâmetro criado: URL do Servidor de Contingência PROMO
    2. Valor: Utilizar o endereço do PROMO Offline


BIGRETAIL-97455 [MultiTenant] Evolução arquitetural Storex Cloud

  • É necessário subir o XML da versão antes de atualizar o Storex Cloud para versão 3.0.0 (ou posterior). Caso contrário, o acesso aos serviços não será possível no Storex Cloud de Loja. Se o XML de uma versão posterior já estiver sido atualizado, este passo torna-se desnecessário. 
  • Caso a empresa utilize o serviço de "consulta de clientes", será necessário acrescentar no parâmetro "Providers default por tipo de serviço" o provedor utilizado. Sem isso, os Storex Mobile's de versões anteriores à 3.1.0 não consultarão clientes.
    • O  conteúdo do parâmetro pode ser obtido no parâmetro do Storex Mobile (não é do Storex Cloud!), chamado "Provedor para consulta de Clientes". Assim, é só adicionar o texto CUSTOMER=NOME_DO_PROVEDOR ao final da lista, com o ponto-e-vírgula usado como separador e, portanto, de prefixo.
    • Se o provedor de consulta for VTEX, deve-se adicionar "CUSTOMER=VTEX" à lista.
       
      De:
       "DEVICE=STOREX;AUTHENTICATION=STOREX;IMAGE=FILESYSTEM;PRODUCT=STOREX;PAYMENT_PLAN=STOREX;
      PAYMENT=STOREX;SALES_INTEGRATION=STOREX;STORE=STOREX;MIDECLIENT=STOREX"   Para: "DEVICE=STOREX;AUTHENTICATION=STOREX;IMAGE=FILESYSTEM;PRODUCT=STOREX;PAYMENT_PLAN=STOREX;
      PAYMENT=STOREX;SALES_INTEGRATION=STOREX;STORE=STOREX;MIDECLIENT=STOREX;CUSTOMER=VTEX"

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.

Atenção

para esta funcionalidade operar corretamente com o Caixa rápido, não se esqueça de realizar as configurações informadas no release notes do CXR!


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.

Atenção

para esta funcionalidade operar corretamente com o Caixa rápido, não se esqueça de realizar as configurações informadas no release notes do CXR!

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.

 
[BR.002961.2020.047] LWS - Desconto de colaborador pelo CPF
Para habilitar, configurar o parâmetro "URL para descontos pelo cadastro do cliente"


[BR.002961.2020.042] Permitir o pagamento de carnês, faturas e acordos no VM (BIGRETAIL-24321)

Um datasource deve ser mapeado no Wildfly para o JNDI: "java:jboss/datasources/DeferredProcessDS"
Parâmetros da funcionalidade:
 - URL para consulta de cobranças
 - URL para confirmação de pagamento de cobranças


Um novo parâmetro para definição de timeout no serviço de consulta de transações Web LOGIC foi adicionado à versão:

Nome: Tempo de expiração da requisição (Timeout) LOGIC em segundos.
fqdn: transaction-search.logic.timeout
Valor padrão: 25
Observações: O valor do tempo deve ser informado em segundos.


Integração Linx-commerce - consulta imagem de produto:

Preencher os seguintes parâmetros:

  • URL base de consulta de produtos via Linx-Commerce
  • Chave de autorização da consulta de produtos via Linx-Commerce
  • clientId da consulta de produtos via Linx-Commerce
  • channelid da consulta de produtos via Linx-Commerce

Integração Linx-Promo - atualização de senha de cartões usando API REST (Catálogos):

Preencher os seguintes parâmetros:


  1. BIGRETAIL-44506 [CXR - LWS] - Melhoria na gravação das informações de pagamentos TEF no Datahub
    • Para informar o valor que será preenchido no campo Código Autorizador, utilizar o parâmetro abaixo:
      • Origem do campo Código Autorizador =Domínio: REDE ou BANDEIRA
  2. BIGRETAIL-44178 [LWS] Troca Web OMS - Status para troca
    • Para adicionar novos status para troca, utilizar o parâmetro abaixo:
      • Lista de status de atendimento da Chaordic OMS (fulfillment) disponíveis para troca (Separado por ponto-vírgula)
        Exemplo: DELIVERED;PAID;FINISHED;
  1. BIGRETAIL-43864 [LWS] Criar parâmetro para tempo de limpeza de transações do processador de eventos
    1. Para informar o tempo da limpeza dos eventos, utilizar o parâmetro abaixo:
      • Limite em dias dos eventos do LWS, após isso eles serão apagados
        Exemplo: 30

Nova configuração "Timeout em milissegundos para consulta de Planos de Pagamento na Realize"


BIGRETAIL-57622:
Para utilizar controle das autorizações de Vouchers é necessário habilitar a nova configuração "Habilita Eventos de Controle para Autorização de Voucher".
Para utilizar eventos de controle do Estoque é necessário habilitar a nova configuração "Habilita Eventos de Controle para Estoque de Produtos".
BIGRETAIL-56602:
Necessário Proctrans na versão 16.03.00


BIGRETAIL-63829

  • customer-rest-api.enabled
  • customer-rest-api.client-id
  • customer-rest-api.client-secret
  • customer-rest-api.grant-type
  • customer-rest-api.username
  • customer-rest-api.password
  • customer-rest-api.timeout


  • BIGRETAIL-64440
    • Foi necessário modificar os arquivos de configuração para remover o parâmetro “Chave da API do loyalty” e adicionar o parâmetro “Credenciais do cliente do serviço do loyalty”. Com isso, após atualizar o LWS, será necessário preencher este novo parâmetro com o consumer key e consumer secret, conforme era feito anteriormente (https://share.linx.com.br/pages/viewpage.action?pageId=266437128). Para a URL de homologação da Renner (https://apihmla1.lojasrenner.com.br:443), pode-se preencher o valor “HUFlZrQRMV_aScRXqRqUEMgCsNMa:1wTh3rQtoBC2P4BfpUhVaS1TaW8a” no novo parâmetro.
  • BIGRETAIL-63353
  • BIGRETAIL-65148 e-Sitef hoje só permite channelName com valor N/I
    • Channels mapeados no LWS:
      CAIXA_RAPIDO_APP_NAME = "Caixa-Rapido";
      SELF_CHECKOUT_APP_NAME = "Self-Checkout";
      AV_APP_NAME = "AV";
      PDV_APP_NAME = "PDV";
      PORTAL_BIG_RETAIL_APP_NAME = "Portal-Big-Retail";
      STOREX_HOME = "Storex-Home";
      OMS_ORDER_PLUGIN = "Oms-Order-Plugin";
    • Qualquer comportamento diferente será necessário configurar de acordo com o devido sistema de origem.


  • BIGRETAIL-65101 Adicionar tratamento para descontos por item no pedido
    • Tratamento adicionado para o tipo de desconto EXTERNAL_TOTAL_VALUE. Nesse caso, pedidos com desconto no total do item (independentemente da quantidade) devem ter o desconto total do item lançado no campo value e o tipo EXTERNAL_TOTAL_VALUE no campo source, como no exemplo abaixo:
"discounts":[
      {
         "value":25.7,
         "source":"EXTERNAL_TOTAL_VALUE"
      }
   ]

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.


Não Impressão de Cupom de Doação (STOREX MOBILE)
Preencher o seguinte parâmetro:

  • Habilita impressão de cupom doação

Novas configurações:
"Quantidade de retentativas de requisição do QR Linx" - apenas ocorrerá em casos que a requisição não for enviada para PayHub, exceto se a configuração
"Força retentativas de requisição do QR Linx" for TRUE.
"Força retentativas de requisição do QR Linx" - inclusive em casos que a requisição foi enviada para PayHub
"Intervalo em MS para validação de conexões do QR Linx"


 Necessário as seguintes versões:
Servidor de Pedidos: 4.14.0, 3.23.7
Storex Mobile: 1.92.0, 1.91.3


POSSUI DEPENDÊNCIA COM O STOREX-TIM-16.27.02



BIGRETAIL-68997 Não está sendo aparecendo o IMEI no cupom (TIM)

    • Para imprimir o código universão dos produtos no cumpom fiscal, faz-se necessário habilitar o novo parâmetro com o valor true.
      • Parâmetro: Habilita a impressão dos códigos IMEI|ICCID no rodapé do cupom

Obrigatório as seguintes versões de BD para CORP:
BD-STANDARD-6.3.0
BD-2961-3.21.0
BD-STOREX-4.3.0
BD-VERSAO14-4.3.0

https://jira.linx.com.br/browse/BIGRETAIL-75528

CLIENTE TIM DEVE HABILITAR:
Habilitar Eventos para controle de Devoluções
Habilitar Eventos de Controle de Serviços
Habilita Eventos de Controle para Autorização de Voucher
Habilita eventos de controle de doação

https://jira.linx.com.br/browse/BIGRETAIL-74828


BIGRETAIL-77759 [LWS] Acesso Caixa Rápido na versão atualizada

Foram retirados os seguintes parâmetros:

  • <fqdn>version-control.minimal-mobile-version</fqdn>
  • <fqdn>version-control.action-when-update-available</fqdn>
  • <fqdn>version-control.update-notification-message</fqdn>

Foi criado no lugar um único parâmetro que atende mais de uma aplicação:

  • <fqdn>version-control.applications-configuration</fqdn>
  • Descrição: Configuração das Aplicações
  • Descrição completa: 
    Dados devem estar no formato "NOME_APLICACAO=VERSAO_MINIMA#ACAO#MSG_NOTIFICACAO", utilizar ";" como separador em casos de multiplas chaves. Ex: LINX-CAIXA-RAPIDO=1.118.3#NOTIFY_ONLY#Por favor, atualize o Storex Mobile;

Deve possuir a seguinte formatação:

  • "NOME_APLICACAO=VERSAO_MINIMA#ACAO#MSG_NOTIFICACAO"
    • Possíveis valores:
      • NOME_APLICACAO:
        • Ex: LINX-CAIXA-RAPIDO 
      • VERSÃO: Deve seguir o formato: ##.###.###
        • Ex: 1.118.3
      • ACAO:
        • IGNORE
        • NOTIFY_ONLY
        • NOTIFY_AND_PREVENT_LOGIN
      • MSG_NOTIFICACAO: (OPCIONAL)
        • Uma string contendo a mensagem a ser mostrada.
          • DEFAULT: "Existe uma nova versão disponível. Favor atualizar."

Exemplo:

  • LINX-CAIXA-RAPIDO=1.118.3#NOTIFY_ONLY#Por favor, atualize o Storex Mobile;

Caso haja mais de uma aplicação elas devem ser separadas por ";".


BIGRETAIL-98366 Informação do COD_FORMA Tabela CAMPO_GENERICO não está sendo alimentado [MERGE]

  • Existe uma instrução para o cliente TIM no release notes "CLIENTE TIM DEVE HABILITAR", favor acrescentar este parâmetro:
    Habilitar Calcula Desconto Non Price



BIGRETAIL-60801- Crediário

  • Configurar os parâmetros:
    URL Base para consulta de cliente Lebes
    Timeout em segundos para consulta de cliente Lebes
    URL para consulta de crediario Lebes
    Timeout em segundos para consulta de crediario Lebes
    URL para consulta de seguros Lebes
    Timeout em segundos para consulta de seguros Lebes

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)

Habilitação da funcionalidade: Inclusão de campos de marketing

Necessário Storex-EP atualizado com a versão STOREX 15.07.68 e CAIXA-RAPIDO-1.22.6.

Configurações para utilizar Termo de Consentimento

"URL base de consulta de termo de consentimento" - url do serviço responsável pela consulta se o usuário possui termo de consentimento para aprovar
"PIN para rejeição de termo de consentimento" - Numero usado para rejeitar o termo
"PIN de não recebimento de termo de consentimento" - Numero usado para pular a validação do termo. Será questionado na proxima vez.
"Mensagem de envio dos termos de consentimento" - Mensagem que será enviada no SMS. Usar na mensagem a tag <VALOR_PIN> onde deseja que o pin seja exibido.

Configurações para envio do SMS do Termo de Consentimento

"URL Base da API de Mensagens Salesforce Marketing Cloud" - url da api de envio de sms SalesForce Ex: https://mc06qt7nm8p9g453pyb9g8wz2pvy.rest.marketingcloudapis.com
"ID do Cliente da SalesForce Marketing Cloud" - ID do cliente, disponível na conta de configuração do SalesForce Ex: nqd8j33ry5lhz03jsfbtd2kq
"Chave Secreta do Cliente da SalesForce Marketing Cloud" - chave secreta da api, disponível na conta de configuração do SalesForce Ex: E1Im4YwqDXB6Gvu4ifUQqi98
"Identificador da conta do Cliente da SalesForce Marketing Cloud" - Identificador da conta, disponível na conta de configuração do SalesForce Ex: 520001508
"Identificador das definições do template de mensagem da SalesForce Marketing Cloud" - Template, disponível na conta de configuração do SalesForce Ex: SMS_API-v1


BIGRETAIL-73632 - Ajustes no Estoque para transmissão do Bloco X - Para utilização do PAF ECF, é necessário realizar as configurações abaixo:

  • Realizar o preenchimento do parâmetro abaixo do LWS Corporativo, no Servidor de Configuração (GRP-LWS-CORP):


ParâmetrosCategoriaRegra de AtivaçãoValor
Lista de números de credenciamentos estaduaisPAFDisponívelSC=NUMERO_CREDENCIAMENTO_PAF_ECF
Chaves de autenticaçãoSIGNINDisponívellinx_storex:linx_storex_pass:EL%4$g=y$yHHUxF+;linx_plugin:linx_plugin_pass:8'-j.Ke`ZbCK#eZU  

Obs: NUMERO_CREDENCIAMENTO_PAF_ECF deve ser substituído pelo número de credenciamento do PAF ECF cadastrado na Sefaz SC.


  1. BIGRETAIL-75788
    1. Para utilização do Storex Cloud em âmbito de loja, faz-se, necessário a atualização do Storex para a versão da Centauro 15.25.00.
    2. Para utilização do Storex Cloud em âmbito corporativo, não já necessidade de atualização do Storex.

BIGRETAIL-66815 [LWS] Resgate de Pedidos Magento

  • POSSUI DEPENDÊNCIA COM OS SEGUINTES ITENS:
    • STOREX HC 16.14.11
    • SERVIDOR DE PEDIDOS 04.25.00

BIGRETAIL-69803 Criar parâmetro para imprimir número do pedido externo ou interno no comprovante não fiscal 

  • Criado novo parâmetro tipo boolean no Storex Cloud:
    • FQDN: coupon-builder.print-external-order-number
    • Descrição: Imprimir número do pedido externo ao invés do interno no cupom não fiscal

#BIGRETAIL-40033 - Criado configurações "ID de usuário para consulta de cliente no Linx Commerce", "Senha para consulta de cliente no Linx Commerce", "Senha para consulta de cliente no Linx Commerce". Obrigatoriamente devem ser configuradas para que o serviço de consulta de clientes no Linx Commerce funcione.

"Número de dígitos que identificam o código pai do produto". Esse parâmetro envia no item do Promo um atributo codeSmall, efetuando um substring até o valor informado. Valores negativos serão considerados 0."

BIGRETAIL-57398:
Criação de novo parâmetro.
Parâmetro: Código do produto usado na emissão do DANFE
Domínio: INTERNAL/EXTERNAL [código interno / código externo]
Valor padrão: INTERNAL


BIGRETAIL-70778 
Implementação das novas funcionalidades do PAF-NFC-e.

  • BIGRETAIL-61653 [VM] Biometria - API VALIDAÇÃO - ajuste LWS

BIGRETAIL-68348: Validação Usuario X Loja - Storex Cloud

  • Criado item de configuração (signin-settings.enable-store-validation) para controlar ou não o acesso do usuário por loja.


  1. BIGRETAIL-76482 Novos parâmetros para restricao de acesso
    1. URL base servico valida status funcionario Fujioka (String)
    2. Token para autenticacao em api de validacao de funcionario Fujioka (String)
    3. Username para a conseguir o token da API de status de funcionario Fujioka (String)
    4. Password para a conseguir o token da API de status de funcionario Fujioka (String)
    5. Habilita validação status funcionario (Boolean)
    6. Timeout em milissegundos para API valida status funcionario Fujioka (Integer)


Lista de Issue's Liberadas nesta Versão


IssueResumoNúmero do caso
BIGRETAIL-111341Corrigido falha onde impossibilitava resgatar pedidos com reservas de estoque, adicionado suporte a multiplas reservas de estoque

02552490 

BIGRETAIL-111268Ajustado falha durante a consulta da campanha quando a forma de pagamento não está mapeada no Storex Cloud

lista completa de issues

  • Sem rótulos