HOMOLOGAÇÃO M-SiTef

Homologação: Fiserv
Data:

Dados do Cliente:

Razão Social:

Nome Fantasia: CNPJ:

Endereço: Cidade:

Telefone:

Estado: CEP:

Responsável pela empresa:

E-mail: Telefone:

Dados da Aplicação

Nome do Aplicativo: Versão do Aplicativo

Linguagem Desenvolvimento Sistema Operacional:

Responsável pela aplicação: E-mail:

Telefone: Tipo Aplicação: PDV outros:

Segmento para o qual se destina a aplicação (Varejo, Restaurante etc.):

Interface homologada e versão CliSiTef: Versão do SiTef:

Modelo Terminal: Impressora:

Dados do Documento
Software Express Informática Ltda.

Nome do documento: Roteiro de Pré Homologação M-SITEF

Versão do documento: 1.5

Data do documento: 22/05/2024

Suporte Técnico: (11) 3170-5300 / (11) 4766-8000 / certificacao@fiserv.com/ Portal do Cliente ou Chat

Roteiro de Pré-Homologação – M-SiTef

 https://dev.softwareexpress.com.br/docs/m-sitef/m-SiTef
https://dev.softwareexpress.com.br/en/docs/clisitef/clisitef_documento_principal/

1. Etapas do processo de homologação

Pré-homologação: Realizada pelo desenvolvedor com uso do simulador do SiTef e Especificação Técnica fornecida pela Software Express.
Deverão ser enviados para o Time de Certificação através do seguinte e-mail: certificacao@fiserv.com para validação: o documento Roteiro
de Pré-Homologação M-SITEF.doc devidamente preenchido, e os arquivos \SiTef\audit\ e \SiTef\LOG e arquivos trace do terminal
(CliSiTef.dmp) do dia dos testes, os cupons TEF impressos (caso haja impressão ou digitalizados).

Agendamento: Após aprovação no processo de pré homologação, o setor de certificação entrará em contato para agendar a homologação,
mediante disponibilidade de agenda.

Homologação Remota: São duas as opções, sendo:

O processo será realizado por videoconferência através do Teams.

Você deverá ter algum dispositivo de câmera no seu computador para que possamos ver sua automação funcionando, ou poderá também
compartilhar a tela da sua automação.

O SitDemo devera rodar em seu ambiente para conectar o seu terminal, compartilhando a tela do computador onde o SitDemo estará em
execução para que possamos validar os retornos e relatório de transações.

Caso não seja possível compartilhar a tela do computador que executa o SitDemo, poderão acessar este computador remotamente
através de outro computador e compartilhar a tela deste para podermos validar os retornos e relatório de transações.
2. Envio de CNPJ - ITEM OBRIGATORIO

Com o objetivo de reduzir erros operacionais, foi desenvolvida uma validação do CNPJ da loja que é informado pela automação durante o
fluxo de abertura, garantindo que esta informação presente no terminal está consistente.

A configuração ParmsClient permite que a automação comercial possa incluir informações específicas nas transações trocadas com o
servidor SiTef. Essa configuração deve ser passada através do parâmetro Vide documento -> https://dev.softwareexpress.com.br/docs/m-
sitef/m-SiTef

i.putExtra("CNPJ_CPF", "12345678912345");

i.putExtra("cnpj_automacao", "12345678912345");

Onde:
- 1 (CNPJ do Estabelecimento) com o valor 31406434895111.

- 2 (CNPJ da empresa de automação comercial) com o valor 12523654185985.

* Atenção NÃO utilizar esse número de CNPJ quando estiver executando os testes de pré-homologação. Esses números são apenas exemplos.
 3. Envio de Trace - ITEM OBRIGATORIO

Premissas para o envio do Trace:

 Configure o Nservices conforme documentação enviada pelo time de Certificação.

 A função de enviar trace pode ser acionada de duas formas, primeira através do menu gerencial (modalidade 110) e de forma direta
através da função 121).

Informações importantes.

 Parametro comExterna é obrigatório o envio porque será usado em produção. No ambiente de homologação esse parâmetro precisa ser
enviado da seguinte forma. i.putExtra("comExterna", "0");
https://dev.softwareexpress.com.br/docs/m-sitef/m-SiTef/#tls-software-express

 Orientamos que o valor do campo CupomFiscal seja alterado a cada nova transação. Uma dica é utilizar data e hora em que é
chamado a transação. Exemplo AAAAMMDDHHMMSS ou DDMMAAAAHHMMSS.

• O arquivo de configuração da CliSiTef é “CliSiTef.ini”, mas para as plataformas mobile, utilizaremos a denominação ‘CLSIT’ (sem extensão
e em caixa alta).

• Por padrão a gravação de informações de trace é desabilitada, para habilitar a gravação do mesmo, devem-se adicionar as configurações
no arquivo CLSIT (Este procedimento é válido apenas para facilitar o diagnóstico de problemas pela equipe da Software Express, ou
 quando houver alguma dúvida específica por parte do cliente ou algum comportamento inesperado na aplicação que só através da análise
do mesmo poderá ser esclarecida).

• Até o momento não temos disponível uma biblioteca genérica que atenda todos os dispositivos M-SITEF (Carbon, A8, GPOS700...), sendo
assim a integração deve ser realizada com a biblioteca correspondente ao equipamento utilizado, verificar a informação com nossa equipe
de suporte através de e-mail, chat ou telefone.

4. Critérios de Homologação

• A homologação é realizada no conjunto, Software e Hardware, obrigatório o uso do equipamento para realizar a certificação.

• Para efetuar as vendas devemos utilizar produtos validos na retaguarda da aplicação.

• Para homologação deverão ser realizados os testes que estão marcados como obrigatórios e os demais será necessário realizar
de acordo com o que for utilizar em produção.

• M-SITEF NÃO CONTEMPLA A FUNCIONALIDADE PARA ATENDER TRANSAÇÕES COM MÚTIPLOS PAGAMENTOS.

• Os dados do portador do cartão não podem ser armazenados pelo sistema. Qualquer exceção deve ser previamente negociada com as
Administradoras de Cartão e a autorização devidamente documentada.

• O usuário do cartão deve ser informado através de display do andamento da transação financeira. (Ex. “Digite a senha”, “aguarde em
processamento” e etc.)
 • A automação comercial não deve utilizar a identificação de terminal na faixa entre SE000900 a SE000999 que é reservada para uso pelo
SiTef:

https://dev.softwareexpress.com.br/en/docs/clisitef/clisitef_documento_principal/#configura%C3%A7%C3%A3o-da-biblioteca
• Durante o fluxo transacional, a aplicação deve possibilitar ao operador o abandono da transação e o retorno para opção anterior. Vide
função “Continua”.

• O campo de senha do supervisor, no fluxo transacional, Tipo Campo 500 deve ser mascarado e validado na aplicação. Quem
gerencia/altera/controla o código do supervisor é a própria aplicação.

5. Informações de conexão
Nos casos de utilização da comunicação segura via TLS (Software Express) o cliente deverá seguir o seguinte procedimento:

TLS Software Express , utilizar o parâmetro i.putExtra("comExterna", "1"); nas chamadas de intent ao m-sitef.
O parâmetro acima deve ser utilizado somente em produção. Ao usar sitdemo deve ser passado o valor 0.

ATENÇÃO – DESENVOLVEDORES

As imagens dos cupons relativos aos testes abaixo devem ser nomeadas de acordo com a ordem dos mesmos e só serão avaliados mediante a esta numeração,
facilitando assim o manejo por parte do técnico, tal procedimento se faz necessário para uma avaliação mais rápida e eficiente do processo como um todo, não precisa anexar a
imagem do comprovante no documento de roteiro, caso achar melhor, pode criar um documento de resposta e preencher todas informações, Prints, anexo de comprovante desde
que obedeça a sequência.
* Desenvolvimento da lib de impressão da bin é obrigatório para o processo de homologação. Caso não seja desenvolvido ou seja usado a lib de impressão do fabricante vai gerar
um grande impacto no processo de homologação do app na loja First Apps.

Validação da Lib Impressão da Bin.

Sequência Preparação Print.

- Anexar print da pasta onde está lib e o

Seq. 1 código de chamada da lib de impressão.

Obs: Teste Obrigatório

 Teste de Comunicação (Timeout)
Falha de Configuração

Resultado obtido / Data e

Sequência Preparação Execução Resultado Esperado
Hora da transação.
Seq. 2 - Opcional caso a aplicação execute as - Realizar uma venda - Verificar se todas as transações previstas são Print 1(função 0):
modalidades com as funções direta. de um item qualquer. exibidas.
- Caso haja restrições a aplicação deverá - Verificar o menu de Exemplo: Cheque, Cartão Crédito, Cartão Débito Print 2(funções do menu
desabilitá-las para a certificação e chamar transações retornado. etc. gerencial):
as transações TEF de venda passando o - Printar a tela com o
valor 0 na função. menu para enviar como
i.putExtra("modalidade", "0"); evidência da Pré-
homologação.
- Função 0 - Pagamento genérico. A - Em seguida cancelar
CliSiTef permite que o operador escolha o cupom e printar a tela com
a forma de pagamento através de menus. o menu de transações
gerenciais.
- Não deverá ter restrições no menu de
transações gerenciais, função 110.
i.putExtra("modalidade", "110");
 Seq. 3 - fechar sitdemo - Realizar uma transação com qualquer Resultado:
cartão. - Exibir mensagens retornada para o operador. Data e hora da transação:
- Não há visualização de cupom TEF.
- Após o teste iniciar o SiTef - Aplicação cairá por timeout.

Obs: Teste Obrigatório

Seq. 4 - Com a aplicação fora do ar, - Tentar realizar uma transação - Resultado:
configurar o seguinte código no com qualquer cartão.
parâmetro da Empresa (Loja) do - Exibir mensagens retornada para o operador - Data e hora da transação:
SiTef: de:00000000 para: - Precisa apresentar na tela o
1111AAAA retorno da CliSiTef que será Nao - A transação não será autorizada
Existe Conf
- Iniciar a aplicação, esta transação - Não há impressão de cupom TEF.
poderá ser de qualquer valor.

-Obs: Teste Obrigatório

 Venda Cartão/chip. (Crédito e Débito).

Resultado obtido / Data

Sequência Preparação Execução Resultado Esperado e hora da transação /
NSU Host.
Seq. 5 - O valor desta transação deve ser - Realizar a transação com cartão de - Verificar comandos de mensagem retornados. - Resultado:
maior ou igual a R$ 10,00. Débito. - Exibir mensagens retornada para o operador.
- Pagamento dessa transação deve ser - A transação será autorizada. - Data e hora da
feita por chip. Há visualização de cupom. transação:
Obs: Teste Obrigatório
- NSU Host:
Seq. 6 - O valor desta transação deve ser - Realizar a transação com cartão de - Verificar comandos de mensagem retornados. - Resultado:
maior ou igual a R$ 15,00. Débito. - Exibir mensagens retornada para o operador.
- A transação será autorizada. - Data e hora da
transação:
- Pagamento dessa transação deve ser - Há visualização de cupom.
Obs: Teste Obrigatório feita por chip.
- NSU Host:

- Selecionar a opção à vista.

Seq. 7 - O valor desta transação deve ser - Realizar a transação com cartão de - Verificar comandos de mensagem retornados. - Resultado:
maior ou igual a R$ 25,00. Crédito. - Exibir mensagens retornada para o operador.
- Pagamento dessa transação deve ser - A transação será autorizada. - Data e hora da
feita por chip. - Há visualização de cupom. transação:
Obs: Teste Obrigatório - Selecionar a opção à vista.
- NSU Host:
Seq. 8 - O valor desta transação deve ser - Realizar a transação com cartão de - Verificar comandos de mensagem retornados. - Resultado:
maior ou igual a R$ 30,00. Crédito. - Exibir mensagens retornada para o operador.
- A transação será autorizada. - Data e hora da
- Pagamento dessa transação deve ser Há visualização de cupom. transação:
Obs: Teste Obrigatório feita por chip.
- NSU Host:

Selecionar a opção à vista.

 Seq. 9 - O valor desta transação deve ser R$ - Realizar uma transação com cartão - Verificar comandos de mensagem retornados. - Resultado:
20,00 ou mais. de Crédito magnético. - Exibir mensagens retornada para o operador.
- Pagamento dessa transação deve ser - A transação será autorizada. - Data e hora da
feita por chip. - Há visualização de cupom. transação:
- Selecionar a opção: Financ. Adm.
(parcelado). - NSU Host:

Obs: Teste Obrigatório - Dividir em 2 ou mais parcelas

Transações de Reimpressão
.

Resultado obtido / Data

Sequência Preparação Execução Resultado Esperado e hora da transação /
NSU Host.
- Acessar o menu de reimpressão através - Realizar uma transação de - Verificar comandos de mensagem retornados. Resultado:
Seq. 10 das transações gerenciais Função 110 Reimpressão - Exibir mensagens retornada para o operador.
ou a 112 ou de forma direta via Função - A transação será autorizada. Data e hora
114. - Selecionar a opção: Último - Há visualização de cupom. da transação:
comprovante
NSU Host:

Obs: Teste Obrigatório

Seq. 11 - Utilizar comprovante da - Realizar uma transação de - Verificar comandos de mensagem retornados. Resultado:
transação da Seq. 5 para reimpressão. Reimpressão - Exibir mensagens retornada para o operador.
- A transação será autorizada. Data e hora
Acessar o menu de reimpressão através Selecionar a opção: Específica(o) - Há visualização de cupom. da transação:
das transações gerenciais Função 110
ou a 112 ou de forma direta via Função NSU Host:
113.

Obs: Teste Obrigatório

 Cancelamento de Crédito/Débito
Observação: Na solicitação da Senha do Supervisor a aplicação deverá efetuar a validação do
TipoCampo 500 com a senha mascarada.
Resultado obtido / Data e
Sequência Preparação Execução Resultado Esperado hora da transação / NSU
Host.
Seq. 12 - Utilizar comprovante da transação da - Realizar o cancelamento da transação - Verificar comandos de mensagem retornados. - Resultado:
Seq. 5 para o cancelamento. de Débito. - Exibir mensagens retornada para o operador.
- A transação será autorizada. - Data e hora da transação:
Obs: Teste Obrigatório - Há visualização de cupom.
- NSU Host:

Seq. 13 - Utilizar comprovante da transação da - Realizar o cancelamento da transação - Verificar comandos de mensagem retornados. - Resultado:
Seq. 7 para o cancelamento. de Crédito. - Exibir mensagens retornada para o operador.
- A transação será autorizada. - Data e hora da transação:
- Há visualização de cupom.
- NSU Host:
Obs: Teste Obrigatório
 Topologia das principais Carteiras Digitais.

 Habilitando transações de Venda e Cancelamento de Carteira Digital

i.putExtra("transacoesHabilitadas", "7;8;3919");

Segue abaixo um Exemplo:

Intent i = new Intent("br.com.softwareexpress.sitef.msitef.ACTIVITY_CLISITEF");

i.putExtra("empresaSitef", "00000000");

i.putExtra("enderecoSitef", "127.0.0.1");

i.putExtra("modalidade", "’122");

i.putExtra("CNPJ_CPF", "12345678912345");

i.putExtra("cnpj_automacao", "12345678912345");

i.putExtra("transacoesHabilitadas", "7;8;3919");

startActivityForResult(i,1234);
 Transações com Carteiras Digitais

Resultado obtido / Data

Sequência Preparação Execução Resultado Esperado e hora da transação /
NSU Host.
Seq. 14 - Esta transação poderá ser de qualquer -Realizar uma transação de Carteira - Verificar comandos de mensagem retornados. Resultado:
valor. Digital - Exibir mensagens retornada para o operador.
- A transação será autorizada. Data e hora
-A transação de Carteira Digital é - Há visualização de cupom. da transação:
acessada pelo menu genérico de
transações (modalidade 0) ou através da NSU Host:
chamada direta da modalidade 122.

Obs: Teste Obrigatório

Seq. 15 -Realizar uma transação de - Verificar comandos de mensagem retornados. Resultado:

-A transação de cancelamento de Cancelamento de Carteira Digital - Exibir mensagens retornada para o operador.
Carteira Digital é acessada pelo menu - A transação será autorizada. Data e hora
genérico de transações (modalidade 0) - Há visualização de cupom. da transação:
ou através da chamada direta da -
modalidade 123. NSU Host:

Obs: Teste Obrigatório

 Teste de Envio de Trace

Resultado obtido / Data

Sequência Preparação Execução Resultado Esperado e hora da transação /
NSU Host.
Seq. 16 -Para este teste o NServices deve estar - Resultado:
previamente habilitado e configurado. - Após realizar uma transação, acessar Validar na pasta SiTef se foram gerados os
o menu de transações gerenciais logs. - Data e hora da
- O envio de trace é realizado através do (Função 110) ou de forma direta transação:
menu de transações gerenciais 110 ou através da função 121 para envio dos \SiTef\AUDIT\TraceClient\<empresa>\<terminal>
de forma direta pela função 121. traces para o servidor SiTef. - NSU Host:

Obs: Teste Obrigatório