Histórico da Página

CONTEÚDO

1. Visão Geral
2. Configurações
3. Retorno da integração
4. Exemplo de XML de retorno da Fenyx

01. VISÃO GERAL

     Essa documentação tem como objetivo explicar quais são os parâmetros necessários e qual o funcionamento da utilização da integração do PDV com a Fenyx, para consulta de cheque.

02. CONFIGURAÇÕES

     Para ativar a rotina é necessário ativar a consulta pela Fenyx:

Imagem 1 - Configurações da consulta de crédito pela Fenyx

     Também é necessário configurar as mensagens abaixo:

Imagem 2 - Configurações das mensagens de retorno

• Mensagem crédito bloqueado: mensagem a ser exibida quando o cheque for considerado bloqueado no retorno da Fenyx;
• Mensagem crédito não checado sem conexão com servidor: mensagem a ser exibida quando ocorrer falha de comunicação com o servidor.

     Configurar também os dados para comunicação com a Fenyx:

Imagem 3 - Configurações dos dados de comunicação com a Fenyx

• CNPJ de consulta: CNPJ de consulta Fenyx;
• Código do usuário: Usuário de consulta Fenyx;
• Senha: Senha de consulta Fenyx;
• URL base: URL de comunicação Fenyx.

03. RETORNO DA INTEGRAÇÃO

No momento do pagamento com cheque, se a integração estiver ativa, será enviada uma consulta para a Fenyx realizar a validação.

O cheque é considerado como bloqueado apenas quando o campo "SEQ_14" (campo "Existe restrição CCF") do retorno da Fenyx for igual a "S" ("Sim").

O retorno é tratado das seguintes formas (no tópico 04 é possível verificar um exemplo de XML de retorno da Fenyx):

• Cheque Liberado: uma mensagem com a chave da consulta retornada pela Fenyx é exibida e o pagamento é aprovado;

Imagem 4 - Retorno Fenyx cheque aprovado

• Cheque Bloqueado: quando o cheque é considerado bloqueado pela Fenyx, uma mensagem com a chave da consulta retornada pela Fenyx é exibida com a mensagem parametrizada no campo "Mensagem crédito bloqueado" e é solicitada a liberação pelo supervisor.

Imagem 5 - Retorno Fenyx cheque bloqueado

• Sem Conexão: quando ocorre falha de comunicação com o servidor, é exibida a mensagem parametrizada no campo "Mensagem crédito não checado sem conexão com servidor" e solicitada a liberação pelo supervisor.

03. EXEMPLO DE XML DE RETORNO DA FENYX

<?xml version="1.0" encoding="utf-8"?>
<CHEQUEEXPERTPDV>
    <HEADER_OUTPUT>
        <SEQ_01>FRXSC03</SEQ_01>
        <SEQ_02>VS0160</SEQ_02>
        <SEQ_03>001</SEQ_03>
        <SEQ_04>000301</SEQ_04>
        <SEQ_05>PDV</SEQ_05>
        <SEQ_06> </SEQ_06>
        <SEQ_07>J</SEQ_07>
        <SEQ_08>016116116116188</SEQ_08>
        <SEQ_09> </SEQ_09>
        <SEQ_10>BW1416DS23560626</SEQ_10>
        <SEQ_11>14062023</SEQ_11>
        <SEQ_12>155626</SEQ_12>
        <SEQ_13> </SEQ_13>
        <SEQ_14>N</SEQ_14>
        <SEQ_15>N</SEQ_15>
        <SEQ_16>N</SEQ_16>
        <SEQ_17>I</SEQ_17>
        <SEQ_18>N</SEQ_18>
        <SEQ_19/>
        <SEQ_20>N</SEQ_20>
        <SEQ_21>N</SEQ_21>
        <SEQ_22>I</SEQ_22>
        <SEQ_23>I</SEQ_23>
        <SEQ_24/>
        <SEQ_25>X</SEQ_25>
    </HEADER_OUTPUT>
    <REGISTRO_03>
        <SEQ_01/>
        <SEQ_02/>
        <SEQ_03/>
        <SEQ_04/>
        <SEQ_05/>
        <SEQ_06/>
        <SEQ_07/>
        <SEQ_08/>
        <SEQ_09/>
        <SEQ_10/>
        <SEQ_11/>
        <SEQ_12/>
        <SEQ_13/>
        <SEQ_14/>
        <SEQ_15/>
        <SEQ_16/>
        <SEQ_17/>
        <SEQ_18/>
        <SEQ_19/>
        <SEQ_20/>
    </REGISTRO_03>
    <REG_90>
        <SEQ_01/>
        <SEQ_02/>
        <SEQ_03>CONSULTA CONCLUIDA COM SUCESSO</SEQ_03>
    </REG_90>
    <REG_99>
        <SEQ_01>F99</SEQ_01>
        <SEQ_02>FIM</SEQ_02>
    </REG_99>
</CHEQUEEXPERTPDV>