Início da transação de Pagamento ou Gerencial

As rotinas a seguir são as recomendadas para iniciar uma transação na CliSiTef.

O que diferencia a transação a ser executada é o código de Função passado por parâmetro. (Vide Tabela 5.2.2)

As diversas transações iniciadas pela automação comercial ficam agrupadas pelos dados fiscais, que é o par (CupomFiscal, DataFiscal) e com esses dados são realizados os controles de transações pendentes de confirmações da CliSiTef.

A HoraFiscal é importante para validações de segurança de alguns fabricantes de pinpad (com o objetivo de evitar ataques e fraudes).

int IniciaFuncaoSiTefInterativo (Funcao, Valor, CupomFiscal, DataFiscal, HoraFiscal, Operador, ParamAdic)

** Interface ASCII **

IniciaFuncaoSiTefInterativoA (Resultado, Funcao, Valor, CupomFiscal, DataFiscal, HoraFiscal, Operador, ParamAdic)

As funções abaixo eram utilizadas para terminais de Auto-Atendimento, e são consideradas obsoletas.

int IniciaFuncaoAASiTefInterativo (Funcao, Valor, CupomFiscal, DataFiscal, HoraFiscal, Operador, ParamAdic, Produtos)

** Interface ASCII **

IniciaFuncaoAASiTefInterativoA (Resultado, Funcao, Valor, CupomFiscal, DataFiscal, HoraDiscal, Operador, ParamAdic, Produtos)

Parâmetro	Tipo	Interface padrão	Interface ASCII	Descrição

 Resultado   | Saída,     por valor | Não usado  | Fixo 6   | Contém o resultado de resposta à chamada da rotina.
 Funcao      | Entrada,   por valor | int        | Fixo 6   | Seleciona a forma de pagamento, conforme a tabela “Códigos de Funções” a seguir.
 Valor       | Entrada,   por valor | char \*    | Variável | Contém o valor a   ser pago contendo o separador decimal (“,”). Deve sempre ser passado com duas   casas decimais após a vírgula (“,”). Caso a operação não tenha um valor   definido a priori (p/ex. recarga de pré-pago), esse campo deve vir vazio.
 CupomFiscal | Entrada,   por valor | char \*    | Máx. 20  | Número do Cupom Fiscal   correspondente à venda                É importante que o número do cupom fiscal seja sempre crescente   (incrementado a cada transação), pois todo processo de controle de transações   pendentes e confirmações da CliSiTef se baseiam no conjunto CupomFiscal + DataFiscal.
 DataFiscal  | Entrada,   por valor | char \*    | Fixo 8   | Data Fiscal no   formato AAAAMMDD
 HoraFiscal  | Entrada,   por valor | char \*    | Fixo 6   | Horário Fiscal   no formato HHMMSS
 Operador    | Entrada,   por valor | char \*    | Máx. 20  | Identificação do   operador de caixa
 ParamAdic   | Entrada,   por valor | char \*    | Variável | Parâmetros   adicionais. Permite que o aplicativo limite o tipo de meio de pagamento. Ele   é opcional e pode ser passado vazio. Quando esse campo for utilizado a   CliSiTef irá limitar os menus de navegação apenas aos códigos não presentes   na lista. Vide item 5 para a descrição do formato interno deste campo
 Produtos    | Entrada,   por valor | char \*    | Variável | Contém a lista de produtos que o   cliente está adquirindo no terminal de Auto-Atendimento. É obrigatório pois   tais produtos farão parte integrante do comprovante da operação de Tef a ser   impresso.     O formato básico deste campo é:   \[&lt;Descrição1&gt;;&lt;Código1&gt;;&lt;Quantidade1&gt;;&lt;ValorTotal1&gt;\];   \[&lt;Descrição2&gt;;&lt;Código2&gt;;&lt;Quantidade2&gt;;&lt;ValorTotal2&gt;\];...    Ele deve ser repetido tantas vezes   quanto o número de produtos distintos adquirido pelo cliente.|

IMPORTANTE: Essa rotina apenas inicia o processo de pagamento. Se o retorno for 10000 o processo de pagamento deve ser continuado através da rotina ContinuaFuncaoSiTefInterativo ou ContinuaFuncaoSiTefInterativoA até que esta última devolva um resultado final (vide item que descreve esta função).

IMPORTANTE: até a versão 6.1.114.39 (inclusive) da clisitef, sempre que for iniciado um pagamento em um novo documento fiscal (um par <CupomFiscal, DataFiscal> diferente do anterior), os dados da transação anterior serão substituídos pelos da recém-iniciada, impossibilitando que alguns tratamentos, como os de pendências, sejam feitos com sucesso.

Portanto, devem ser resolvidos todos os tratamentos necessários antes de iniciar-se uma nova transação.

A partir da versão 6.1.114.40 (inclusive), a CliSiTef permite iniciar um novo pagamento, sem apagar eventuais pendências do documento fiscal anterior.