CliSiTef – Especificação
Técnica - Carrefour
Software Express Informática Ltda
- O usuário deste documento é o responsável por garantir que está de posse de sua versão mais
atualizada.
- Qualquer usuário pode utilizar essa cópia para sugerir alterações ao documento.
- Todos os pedidos de alteração devem ser direcionados ao responsável pelo documento (ver
coluna “Autor” do item “Histórico das Atualizações e Controle de Versão” neste documento).
- Somente o responsável consolida os pedidos de alteração.
1 Introdução ............................................................................................................................. 5
2 Transações disponíveis .......................................................................................................... 6
3 Captura de Dados pela Automação para Redes Proprietárias .............................................. 7
3.1 Habilitação ............................................................................................................................... 7
3.2 Funcionamento ....................................................................................................................... 7
3.3 Dados de entrada das transações de Venda ........................................................................... 8
3.3.1 Venda T-Sys ..................................................................................................................... 8
3.3.2 Venda Cetelem/CSU ........................................................................................................ 9
4 Fluxo de coleta .................................................................................................................... 10
4.1 Venda / Cancelamento / Consulta de Saldo .......................................................................... 10
4.2 Recebimento Carrefour ou Pagamento de Conta ................................................................. 11
4.2.1 Consulta Pagamento Genérico / Consulta Recebimento Carrefour ............................. 11
4.2.2 Pagamento de Conta Genérico / Recebimento Carrefour ............................................ 13
4.3 Consulta Promoções Flexíveis ............................................................................................... 15
4.4 Recarga de Celular ................................................................................................................. 16
5 Rede Autorizadora para Transações sem Cartão ................................................................ 17
6 Comando de Coleta de Campo Sem Intervenção do Operador .......................................... 17
Através do parâmetro “Funcao” das rotinas acima é escolhida qual das transações será
executada. Os demais parâmetros estão especificados no documento principal da CliSiTef.
Abaixo estão os valores possíveis do parâmetro para as transações com cartão Carrefour.
Valor Transação
0 A CliSiTef permite que o operador escolha a forma de pagamento através de
menus
3 Venda Crédito
50 Venda Boleto Carrefour
51 Venda com Autorização Carrefour
52 Recebimento Carrefour
53 Inclusão de Boleto (Balcão de Atendimento “TU”)
54 Inclusão de Venda (Balcão de Atendimento “TU”)
55 Consulta Recebimento Carrefour
56 Consulta Limite Mínimo de Promoções Flexíveis
57 Cancelamento Recebimento Carrefour
200 A CliSiTef permite que o operador escolha o cancelamento desejado através de
menus
602 Consulta Saldo Crédito
Para as transações de PDV a automação pode optar por deixar todo o fluxo de coleta de
dados sob responsabilidade da CliSiTef ou apenas a coleta de dados relativos a cartão e os
demais dados sob sua responsabilidade, sendo que a segunda opção é permitida apenas
para redes proprietárias como: Cetelem (55), CSU (170) e T-Sys (190).
3.1 Habilitação
Para habilitar a captura de dados pela automação, o PDV deve informar a CliSiTef quais
redes o PDV ficará responsável pelo fluxo de coleta de dados, através do parâmetro
“ParamAdic” das rotinas descritas no item Transações Disponíveis deste documento. Abaixo
está descrito o formato deste parâmetro:
Sem Restrições:
{FluxoAutomacao=55,170,190}
Com Restrições:
[29];{FluxoAutomacao=55,170,190}
Em que “55,170,190” são os códigos das redes que o PDV ficará encarregada do fluxo de
dados. E “[29]” é um exemplo de envio de restrições, restringindo o crédito digitado.
3.2 Funcionamento
Depois de realizada a consulta de bins com o SiTef, a CliSiTef verifica se a rede retornada é
uma das redes passadas no parâmetro adicional (“FluxoAutomacao”); Caso não seja, a
biblioteca irá seguir no seu fluxo normal; caso contrário enviará o comando 24 (Coleta de
Dados Pela Automação) na função:
TipoCampo=Valor_Coletado
Ex: 519=12345
Para indicar que não existem mais dados o PDV deve passar uma string vazia (“”) em Buffer e
a CliSiTef retornará ao seu fluxo de coleta. Enquanto não for passada a string vazia a CliSiTef
ficará enviando o comando 24, aguardando por mais campos coletados pelo PDV.
Baseado na transação selecionada e no código de rede (Campo 131) retornado pela CliSiTef
o PDV o deve definir quais campos deverão ser coletados e enviados para a CliSiTef.
TipoCampo Descrição
131 Contém um índice que indica qual a instituição que irá processar a transação
segundo a tabela presente no final do documento (5 posições)
170 Venda Crédito Parcelada Estabelecimento Habilitada
171 Número Mínimo de Parcelas – Parcelada Estabelecimento
172 Número Máximo de Parcelas – Parcelada Estabelecimento
173 Valor Mínimo Por Parcela – Parcelada Estabelecimento
174 Venda Crédito Parcelada Administradora Habilitada
175 Número Mínimo de Parcelas – Parcelada Administradora
176 Número Mínimo de Parcelas – Parcelada Administradora
724 Venda Crédito Parcelada com Plano Habilitada
725 Venda Crédito com Autorização a Vista Habilitada
726 Venda Crédito com Autorização Parcela com Plano Habilitada
727 Venda Boleto Habilitada
TipoCampo Descrição
1 Dados de Confirmação
100 Contém a modalidade de pagamento no formato xxnn; xx corresponde ao
grupo da modalidade e nn ao sub-grupo. Vide tabela no final deste documento
descrevendo os possíveis valores de xx e nn.
101 Contém o texto real da modalidade de pagamento que pode ser memorizado
pela aplicação caso exista essa necessidade. Descreve por extenso o par xxnn
fornecido em 100
102 Contém o texto descritivo da modalidade de pagamento que deve ser impresso
no cupon fiscal (p/ex: T.E.F., Cheque, etc...)
105 Contém a data e hora da transação no formato AAAAMMDDHHMMSS
121 Buffer contém a primeira via do comprovante de pagamento (via do cliente) a
ser impressa na impressora fiscal. Essa via, quando possível, é reduzida de
No processo de execução dessa transação, podem ser retornados para o PDV os seguintes campos:
00 Dinheiro
01 Cheque
02 TEF Débito
03 TEF Crédito
04 Cartão Presente (Pré-Pago) Carrefour
05 Cartão Bônus Carrefour
06 Cartão Carrefour
07 Saque para pagamento
08 Saque
09 DCC Carrefour
50 TEF Cartão
77 Campo Reservado
99 Outras Formas
732 Dados a serem enviados para o Tipo de Pagamento (Campo 730) retornado
anteriormente, repete “n” vezes, onde “n” é o número de dados a serem enviados
para o respectivo Tipo de Pagamento:
00 Campo Reservado
01 Tipo de Entrada do Cheque
02 Dados do Cheque
03 Rede Destino
04 NSU do SiTef da transação de TEF
05 Data do SiTef da transação de TEF (não utilizado, uso futuro)
06 Código da Empresa (Loja) da transação de TEF
07 NSU do Host da transação de TEF
08 Data do Host da transação de TEF (Campo 105 CliSiTef)
09 Código de Origem (Estabelecimento) da transação de TEF
10 Serviço Z da transação de TEF
11 Código de Autorização da transação de TEF
12 Valor do Cheque
736 Saldo devedor atual, apenas para recebimento Carrefour
{NFPAG=<Formas de Pagamento>}
No caso de Recebimento Carrefour também deve ser enviado o código de barras recebido na
consulta ou o código de barras coletado para fazer a consulta, acrescentado ao campo
parâmetro adicional:
Campo Formato
X:CB Onde X indica o tipo de coleta, de acordo com a tabela abaixo; e CB é o
código de barras.
{NFPAG= FPAG1;FPAG2;...;FPAGn}
TipoN:ValorN:IDColetaN1:DadoColetaN1-IDColetaN2:DadoColetaN2-...-
IDColetaNn:DadoColetaNn
Caso nenhum campo deva ser enviado, FPAGn deve apresentar apenas:
TipoN:ValorN
ValorN: indica o valor utilizado com esta forma de pagamento, com duas casas
decimais, sem a vírgula
IDColetaNn: indica o ID do campo que foi coletado pelo PDV (conforme tabela já
apresentada acima)
Obs.: A consistência dos valores (soma das várias formas de pagamento utilizadas,
totalizando o valor da transação realizada) deve ser feita pelo PDV.
Ao final de uma transação no valor de R$ 50,00, retornando os campos 730 e 731 indicando
que aceita as seguintes formas de pagamento:
O PDV, por sua vez, na confirmação da transação, enviará as formas de pagamento que
foram efetivamente utilizadas:
00:3000;02:2000:03:5-07:123456789-08:15122016-09:000000000000001
TipoCampo Descrição
734 Limite mínimo de venda para promoções flexíveis, com 12 dígitos sendo os 2
últimos dígitos referentes as casas decimais
Lembrando que em todos os casos o cupom fiscal e a data fiscal não podem ser alterados.
Nas transações que utilizam códigos de barras, como não é efetuada a consulta de bins, a
CliSiTef não consegue definir para qual rede autorizadora enviará a transação, logo a
automação ficará responsável de informar para CliSiTef essa rede. Para isso existem duas
formas:
Nas duas transações acima, a automação sabe para qual rede enviará a transação antes
mesmo de chamar a rotina IniciaFuncaoSiTefInterativo, logo ela passará para CliSiTef o
código dessa rede através do parâmetro ParamAdic dessa rotina, no seguinte formato:
{RedeDestino=nnnn}
Nas demais transações a automação só saberá para qual rede enviar a transação depois de
coletado o código de barras, campo 624. Nesse caso, logo após a coleta do campo 624, a
CliSiTef solicitará a coleta do campo rede destino (campo 131). Essa coleta é realizada
através de um comando especial, o comando 29, que indica que a automação deve passar
algum valor previamente definido (através de alguma lógica interna da automação), sem que
exista a intervenção do operador (digitação dos dados).
Como já descrito no parágrafo acima, para coleta do código da rede autorizadora de uma
transação sem cartão. Ele também é utilizado na coleta do código do plano de crediário.
O código desse comando é 29 e indica que o valor a ser coletado deve ser definido
internamente pela automação, sem a necessidade de digitação por parte do operador, fora
isso esse comando é idêntico ao comando 30 (ObtemCampo).