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.
Funcionalidade | Descrição |
---|---|
CodigoCliente=xxxxxx | Código de cliente de uma determinada loja, limitado a 36 caracteres, a ser vinculado nos relatórios do SiTef Web. |
ExecutaAteLeituraCartao=0 | Se 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=1 | Este 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=1 | O 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=nnnn | Esta 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=1 | Inicialmente 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=1 | Esta 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=1 | Este 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=x | Indica 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=XXXXXXXXXXX | A 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;}; |