¶ Configurações TEF
Caso seja sua primeira instalação de TEF seja cabeado, mobile ou wifi você pode se deparar com a seguinte mensagem de erro ao finalizar uma venda
Não foi possível recuperar a forma de Recebimento para: Rede TEF código [xxxxx] não foi encontrado Rede TEF cadastrada. Bandeira TEF código [xxxxxx] não foi encontrado Bandeira TEF cadastrada. Tipo de Transação TEF código [xxxxxx] não foi encontrado para o tipo de transação TEF cadastrada. Deseja tentar novamente?.
A mensagem de erro descrita acima é um retorno direto do Petros informando que o retorno que o SITEF está nos passando não está devidamente cadastrado em sistema.
Logo é necessário a correção para que o sistema capture as vendas em cartão normalmente e sem apresentar erros.
Esteja ciente que o retorno do SITEF é diferente de qualquer outra adquirente transacionada via API, como por exemplo, clientes que usam o TEF Mobile da Cielo, Getnet ou Rede e, neste manual, não iremos informar todos os códigos de retorno, porém será passada a forma que eles devem ser configurados.
Em casos que o cliente seja usuario SDK (API) e no sistema não retorne o código da rede, bandeira e/ou tipo de transação cadastre o padrão do SITEF.
¶ Tipos de Concentrador TEF
Nesta etapa do manual você aprenderá como identificar o tipo de TEF do seu cliente. Isso é essencial para que saiba o que configurar e como configurar.
Geralmente o SItef é o mais utilizado. Necessita de contrato ativo com alguma empresa integradora de TEF, a mesma por padrão transaciona pela SITEF (Software Express) como por exemplo o TEF da SvBr.
Geralmente o SDK +é utilizado por clientes do PDV Mobile, principalmente CIELO e GETNET. A comunicação é feita via API e não depende do SITEF para transacionar com sua adquirente.
Atualmente o Scope é bem pouco utilizado e possui uma finalidade similar ao Sitef, porém suas configurações são diferentes.
Geralmente a Interface Padrão é utilizada por clientes agregados a TEF de terceiros como por exemplo PayGo, Auttar entre outros. É considerada uma interface padrão quando o sistema necessita “chamar” uma interface de fora para concluir a transação.
¶
Estando ciente do tipo de TEF do seu cliente você deve iniciar a parametrização de acordo com o erro retornado pelo sistema, neste caso pegaremos como exemplo a imagem abaixo para parametrizar.
| Tópico | Passo a passo |
|---|---|
 |
Acesse Automação ➔ Cadastros ➔ Rede TEF |
 |
Ao abrir a janela será exibida uma lista com uma variedade de redes TEF cadastradas por padrão em sistema |
 |
Localize a rede da adquirente do seu cliente (cielo, rede, getnet, safra, stone, etc), dê um duplo clique sobre a mesma e será exibida a seguinte tela:  |
 |
Em alguns casos no sistema o retorno de alguns TEFs podem já estar peenchidos, sendo assim não é necessário alterar |
Caso seu cliente seja usuário SDK é necessário clicar no sinal de
na lista exibida selecione SDK-TEF e preencha o código retornado na mensagem como por exemplo na imagem anterior do erro o código é 00005, uma vez preenchido salve a edição e essa parte está pronta, as demais abas são de interesse de preenchimento para conciliação e isso não será abordado neste manual.
| Tópico | Passo a passo |
|---|---|
|
Acesse Automação ➔ Cadastros ➔ Bandeira TEF |
|
Ao abrir a tela será exibida uma lista com uma variedade de bandeiras cadastradas por padrão em sistema |
|
Caso não encontre a bandeira do seu cliente, pode cadastrar uma nova clicando no  |
|
Uma vez que tenha aberto ou cadastrado a bandeira do seu cliente será exibida a seguinte tela:  |
 |
Como a Rede TEF em alguns casos as bandeiras podem ter os códigos preenchidos desta forma não é necessário a alteração a não ser que esteja errado ou não esteja cadastrado o código para seu tipo de TEF |
Caso seu cliente seja usuário SDK é necessário clicar no sinal de
| Tópico | Passo a passo |
|---|---|
|
Acesse Automação ➔ Cadastros ➔ Tipo de Transação TEF |
|
Ao abrir essa tela será exibida uma lista com uma variedade de transações pré cadastradas |
|
Nesta tela dificilmente você vai precisar adicionar algum registro tendo em vista que os principais usados (crédito a vista, crédito parcelado, débito a vista, etc) já estão cadastrados por padrão e na maioria das vezes o código de retorno e padrão porém caso mesmo assim apresente o erro, localize o tipo de transação que o cartão está executando e abra a opção, será exibida a seguinte tela:  |
Como nas demais telas selecione o tipo de TEF do seu cliente usando o botão de
¶ Configurando a Forma de Recebimento
Por fim, é necessário parametrizar a forma de recebimento de forma correta para que tudo rode 100%, para isso:
| Tópico | Passo a passo |
|---|---|
|
Acesse Automação ➔ Cadastros ➔ Forma de Recebimento |
|
provavelmente você já deve ter algumas formas de recebimento cadastradas caso não possua pode seguir o manual de cadastro de Forma_de_Recebimento |
|
Nesta tela dificilmente você vai precisar adicionar algum registro tendo em vista que os principais usados (crédito a vista, crédito parcelado, débito a vista, etc) já estão cadastrados por padrão e na maioria das vezes o código de retorno e padrão porém caso mesmo assim apresente o erro, localize o tipo de transação que o cartão está executando e abra a opção, será exibida a seguinte tela: |
Caso seu cliente utilize SITEF no TEF Cabeado + SDK nos terminais mobile aconselho fortemente ter 2 formas de recebimento diferentes para cada um de seus recebimentos, conforme citado anteriormente o código de retorno do SITEF é diferente do SDK e isso pode causar algum problema.
Ao acessar o cadastro da forma de recebimento será exibida a seguinte tela:
Conforme dito acima vmaos tratar apenas a questão da configuração do TEF na forma de recebimento, caso tenha dúvidas de preenchimento dos demais campos, acesse o manual de cadastro de Forma_de_Recebimento.
- 1 - Na parte TEF você deve selecionar a Rede TEF,Bandeira TEF, Tipo Transação TEF e Tipo de Captura
- 2 - A Rede TEF é a adquirente que seu cliente transaciona (cielo, rede, stone, getnet, safra, etc), a Bandeira TEF é a bandeira especifica do cartão que está sendo usado (visa, mastercard, elo, etc), o Tipo de Transação é defina pelo tipo de cartão (crédito a vista, débito a vista, crédito parcelado, etc) e por fim o tipo de captura (TEF, manual ou ambos)
Tipos de Captura:
TEF:Formas de recebimento definidas nessa forma somente passarão no sistema. Se for pelo TEF, não permite selecionr no PDV.
Manual:Formas de recebimento definidas nessa forma somente passarão no sistema. Se for por um POS manualmente, não permite selecionar um tipo de TEF para pagamento.
Ambos:Formas de recebimento definidas nessa forma aceitam passar no sistema de forma manual como também de forma TEF.
¶ Tabela de Códigos de Retorno
Esteja ciente que os retornos podem variar entre SITEF, SDK, como entre as adquirentes, logo não e possível prever todos os retornos, os do SITEF podem ser vistos baixando o arquivo aqui.
¶ Adquirentes
TIPO DE CONCENTRADOR TEF CÓD. REDE TEF ADQUIRENTE SITEF 00005 Redecard SCOPE 103 Redecard Interface Padrão REDECARD Redecard SDK 00005 Redecard SITEF 00125 Cielo SCOPE 102 Cielo Interface Padrão CIELO Cielo SDK 00005 Cielo SITEF 00181 Getnet SCOPE 73 Getnet Interface Padrão GETNET Getnet SDK 00082 Getnet SDK 00038 Safrapay
¶ Cartões
O SDK em alguns casos não diferenciam os cartões de crédito de débito, ou seja um VISA CRÉDITO e um VISA ELECTRON possuem o mesmo retorno VISA, porém no caso da REDECARD SDK esse retorno é diferente após a tabela existe um bloco informativo descrevendo melhor essa situação.
Em alguns casos a bandeira pode variar.
Exemplo:
Mastercard pode ser no SDK MASTERCARD CREDITO, já o Maestro pode ser MASTERCARD DÉBITO
Visa pode ser no SDK VISA CREDITO, já o Visa Electron pode ser VISA DEBITO
Isso pode ocorrer para alguns SDKS não todos.
Tipo de TEF Cód.Bandeira TEF Bandeira SITEF 00001 VISA SCOPE 001 VISA SDK-TEF VISA VISA SITEF 20002 VISA ELECTRON SCOPE 021 VISA ELECTRON SDK-TEF VISA VISA ELECTRON SITEF 00002 MASTERCARD SCOPE 002 MASTERCARD SDK-TEF MASTERCARD MASTERCARD SITEF 20001 MAESTRO SCOPE 008 MAESTRO SDK-TEF MASTERCARD MAESTRO SITEF 00031 ELO SCOPE 195 ELO SDK-TEF ELO ELO SITEF 20032 ELO DÉBITO SCOPE 194 ELO DÉBITO SDK-TEF ELO ELO DÉBITO SITEF 0004 AMEX SCOPE 003 AMEX SDK-TEF AMEX AMEX SITEF 00030 CABAL CRÉDITO SCOPE 059 CABAL CRÉDITO SDK-TEF CABAL CABAL CREDITO SITEF 20003 CABAL DÉBITO SCOPE 128 CABAL DÉBITO SDK-TEF CABAL CABAL DÉBITO
Esses são apenas alguns cartões que possuímos os códigos de retorno, obviamente não possuimos todos tendo em vista que são diversos cartões aceitos nos TEF’s e seus retornos podem variar, isso é apenas uma ideia para que seja possível parametrizar o básico do sistema
Um exemplo dessa variação seria o SDK - Rede onde geralmente os cartões possuem retornos diferentes do padrão Visa Débito no caso entraria como VISA ELECTRON, AMEX entraria como AMERICAN EXPRESS, Mastercard Débito entraria como MASTERCARD MAESTRO
O processo do Tipo Transação TEF parte do mesmo principio, caso pegue algum retorno diferente realize o cadastro e ajuste sua forma de recebimento para que opere corretamente.
Fazendo isso você não terá problemas com o mesmo cartão futuramente mas tenha ciência que sempre que aparecer um cartão novo não cadastrado em sistema será necessário realizar as configurações manualmente pela primeira vez.
Qualquer dúvida contate nosso suporte.