Habilitação de configurações especiais por transação

Em determinadas transações, é possível incluir novas funcionalidades e características ao fluxo transacional, permitindo maior flexibilidade de operação sem que estas funcionalidades não estejam vinculadas a um meio de pagamento específico.

Para tanto, basta acrescentar um novo campo ao parâmetro "ParamAdic", presente nas funções que iniciam o processo de pagamento ou Correspondente Bancário (IniciaFuncaoSiTefInterativo e CorrespondenteBancarioSiTefInterativo). O formato deste campo é o seguinte:

{<Funcionalidade1>;<Funcionalidade2>;...;<Funcionalidaden>;};

Note que neste formato as funcionalidades estão entre chaves ('{' e '}'), ao passo que as restrições estão entre colchetes ('[' e ']').

Exemplo: no processo de venda exemplificado no item 5.1, suponha que o valor da venda possa ser alterado durante o fluxo, e que o aplicativo da automação deseje fazer seu tratamento, então o valor do parâmetro "ParamAdic" deve ser:

[10;17;18;19;27;28;34;35;];{TrataPagamentoExtendido=1;}

A seguir, descrevemos as funcionalidades previstas neste campo.

FuncionalidadeDescrição
CodigoCliente=xxxxxxCódigo de cliente de uma determinada loja, limitado a 36 caracteres, a ser vinculado nos relatórios do SiTef Web.
ExecutaAteLeituraCartao=0Se um arquivo de chaves .CHA estiver presente no servidor Sitef, então, a CliSiTef se comporta da seguinte maneira: Se a CliSiTef estiver sem comunicação com o Sitef, ao invés de retornar um erro de comunicação, a CliSiTef continua o fluxo da transação até a leitura do cartão. Para inibir este comportamento, utilizar a funcionalidade ao lado.
HabilitaVendaViaCodigoBarras=1Este parâmetro informa a CliSiTef que a opção de venda crédito através de cartões gravados em código em barras deve ser habilitada na transação corrente. Lembrando que além dessa configuração a opção de menu (3025) também deve estar habilitada.
ItemMenuIdentificado=1O aplicativo de automação informa a CliSiTef que ele está preparado para tratar o comando de menu com itens identificados (comando 42).
Quando esse parâmetro está habilitado a CliSiTef substitui a utilização do comando 21 pelo comando 42, na maior parte dos menus utilizados na navegação.
{MKRede=A,B,C,D}Configuração válida somente para CliSiTef Reduzida Redecard.
OBS: Esta configuração deve ser passada entre chaves ({}) separadamente, ou seja, não deve ser concatenada com nenhuma outra configuração separada por ponto-e-vírgula (;)Os parâmetros A,B,C,D são índices das chaves de criptografia Redecard nos POS’s. Esses parâmetros irão sobrepor os índices das chaves recebidos no serviço 3. Os parâmetros C e D serão implementados somente a partir da versão (4.0.104.1, a confirmar). Se alguma chave não for configurada é preciso passar o parâmetro com valor -1. Exemplo: {MKRede=-1,-1,-1,2} vai configurar somente a chave relativa à criptografia DUKPT 3DES.
A = Índice da master key DES
B = Índice da master key 3DES
C = Índice do registro de tratamento DUKPT DES
D = Índice do registro de tratamento DUKPT 3DES
{MKRedeDados=A,B,C,D}Igual a MKRede (Ver descrição acima),
OBS: Esta configuração deve ser passada entre chaves ({}) separadamente, ou seja, não deve ser concatenada com nenhuma outra configuração separada por ponto-e-vírgula (;)exceto que as chaves de criptografia serão usadas para criptografar trilhas.
NumCartaoCripto=<Cartão criptografado>O fornecimento do campo adicional “NumCartaoCripto”, com o cartão criptografado, desabilita a captura do número do cartão digitado. Este parâmetro depende da correta configuração do arquivo de chaves .cha no servidor SiTef, isto é, com as chaves de criptografia correspondentes.
RedeDestino=nnnnEsta configuração permite forçar que a transação seja realizada por uma rede específica (nnnn = 4 dígitos numéricos). Consulte o item 0 - Transações crédito/débito com cartão sem BIN.
TrataConsultaSaqueComSaque=1Inicialmente projetada para transações do Banco Ibi, este parâmetro permite vincular, em uma única transação, a “Consulta a Saque” e “Saque”.
Caso seja passado este parâmetro, o menu administrativo oferecerá somente a opção “Consulta Saque com Saque”.
TrataPagamentoExtendido=1Esta função informa que o aplicativo da automação está preparado para tratar informações de recebimento a menor (falta saldo a ser recebido com outra forma de pagamento) ou a maior (deve ser devolvido um troco para o cliente).
Esta função também habilita o recebimento dos campos 137 (Saldo a ser pago) e 138 (Valor efetivamente recebido).
ValidadeCartao=<AAMM ou MMAA>A entrega do campo adicional “ValidadeCartao”, com a data de validade do cartão, desabilita a sua captura, porém a utilização do valor passado através do parâmetro adicional é condicionada à passagem bem sucedida do campo “NumCartaoCripto”.
ValorIncluiTaxa=1Este parâmetro informa que o aplicativo da automação incluiu no valor compra o valor da taxa de embarque ou serviço.
Se durante o fluxo de captura for solicitada a taxa, o valor que foi acrescentado à venda deve ser repassado pela automação.
TipoDocFiscal=xIndica o tipo de Documento Fiscal emitido pela “Automação Comercial”.
Onde x:
0 - Cupom Fiscal (Cupom Fiscal - Legado)
1 - NFC-e (Nota Fiscal Consumidor - Eletrônica)
2 – SAT-CF-e (Cupom Fiscal - Eletrônico)
OBS: . Na ausência desta “funcionalidade”, a CliSiTef assume que o “Documento Fiscal” emitido é do tipo ‘0’ (Cupom Fiscal - Legado).
. Qualquer valor de ‘x’ diferente dos definidos, a transação será abortada pela CliSiTef indicando parâmetros inválido.
ChaveAcessoDocFiscal=<Dados da chave>Chave de acesso do Documento Fiscal Eletrônico (tamanho 44 digitos). Necessário informar quando “TipoDocFiscal” for igual a ‘1’ ou ‘2’.
OBS: . Na ausência desta “funcionalidade” para “TipoDocFiscal” igual a ‘1’ ou ‘2’, ou na presença da ”funcionalidade” para “TipoDocFiscal” igual a ‘0’, a transação será abortada pela CliSiTef indicando parâmetros inválidos.
Exemplos:
{TipoDocFiscal=0}
{TipoDocFiscal=1;ChaveAcessoDocFiscal=1111111111222222222233333333334444}
{TipoDocFiscal=2;ChaveAcessoDocFiscal=5555555555666666666677777777778888}
CPFColetado=XXXXXXXXXXXA coleta default do CPF é realizada pelo PinPad, quando solicitado na transação. Caso a automação comercial já o tenha capturado anteriormente, ou já o possua por algum motivo, e não quer que o usuário tenha que digitar novamente o dado no pinpad, deve-se passá-lo via parâmetros adicionais.
Inicialmente previsto para utilização com Carteiras Digitais, surgiu a necessidade de utilização com outros produtos.
Exemplo:
{CPFColetado=99966633300;}
SPLITPAY:Estab1=Valor1
IMPORTANTE: O código de estabelecimento do vendedor principal não deve fazer parte dos estabelecimentos do Split, que deve conter apenas dados dos vendedores secundários.
O código do estabelecimento deve ser um CNPJ válido de no máximo 15 dígitos, e o valor, 12 dígitos, considerando os 2 últimos dígitos como casas decimais. Campos menores serão completados com zeros a esquerda. Campos formatados serão considerados apenas os dígitos. O valor associado é opcional.
O caracter ‘|’ serve de separador quando houver vários conjuntos de dados.
Exemplos:
{SPLITPAY:1222555000101=500|111222111000101=000000001000|111.222.333/0001-01=15,00|111.222.444/0001-01;};