Especificação Troca de Arquivos

Identificação da Automação Comercial

A Automação Comercial deve obrigatoriamente preencher em todos os arquivos de solicitação os campos 716000 e 701-000, informando respectivamente a razão social da empresa responsável pelo desenvolvimento da Automação Comercial e o nome e a versão da aplicação de Automação Comercial.

Exemplo

    701-000 = Linx v2, 11, 0, 0 
    716-000 = LINX AUTOMACAO

Importante: não há uma nomenclatura específica exigida para o campo 701-000, porém:

⦁ Deve incluir o nome completo da aplicação de Automação Comercial; ⦁ Deve incluir a informação de versão completa da Automação Comercial; ⦁ A informação de versão deve identificar sem ambiguidade o executável/binário (ou conjunto de executáveis/binários) que compõe(m) a Automação Comercial.

Impressão de vias diferenciadas

O TEF passa a poder gerar 4 vias do comprovante, abaixo descritas.

⦁ Via completa (campos 028-000 e 029-xxx)

Esta via contém todas as informações para ambos o Cliente e o Estabelecimento. É tipicamente usado em impressoras com folha dupla, ou quando a rede adquirente não suporta os demais tipos de comprovante. Este é o único comprovante que é obrigatoriamente gerado pelo TEF.

⦁ Via diferenciada para o Estabelecimento (campos 714-000 e 715-xxx)

Esta via somente contém as informações relevantes para o Estabelecimento. Este comprovante é opcional, podendo ou não ser gerado pelo TEF. A Automação Comercial deve preferencialmente emitir esta via do comprovante para o Estabelecimento, para não divulgar informações somente relevantes para o Cliente (saldo do cartão, informações de pontuação/premiação, etc.).

⦁ Via diferenciada para o Cliente (campos 712-000 e 713-xxx)

Esta via somente contém as informações relevantes para o Cliente. Este comprovante é opcional, podendo ou não ser emitido pelo TEF. A Automação Comercial deve preferencialmente emitir esta via do comprovante para o Cliente, para reduzir o consumo de papel.

⦁ Cupom reduzido (campos 710-000 e 711-xxx)

Esta via somente contém as informações relevantes para o Cliente, excluindo informações que já estejam presentes no cupom fiscal (nome, endereço e CNPJ do Estabelecimento, data da transação, etc.). Se possível, este comprovante de até 5 linhas deve ser impresso pela Automação Comercial dentro do cupom fiscal, não num cupom fiscal vinculado. Este comprovante é opcional, podendo ou não ser emitido pelo TEF, e restrito a transações de Venda. A Automação Comercial deve preferencialmente emitir esta via do comprovante para o Cliente, para reduzir o consumo de papel.

A Automação Comercial deve utilizar o fluxo abaixo para determinar quais vias do comprovante serão impressas:

Fluxo de impressão de comprovante

Valor da transação, Saque e Desconto

Uma funcionalidade importante da plataforma Premia é a possibilidade de ser concedido ao Cliente um prêmio monetário instantâneo no momento da transação. Este prêmio se traduz por um desconto no valor da transação, que deve ser registrado na Impressora Fiscal pela Automação Comercial.

Com isto, fazem-se necessários os seguintes controles adicionais:

⦁ A Automação Comercial deve indicar em todos os arquivos de solicitação através do campo 706-000se suporta a funcionalidade de saque (valor 1), a funcionalidade de desconto (valor 2), ambas (valor 3) ou nenhuma (valor 0). Caso este campo não seja informado (versões anteriores da Automação Comercial), o TEF assume o valor 0 (nenhuma das funcionalidades é suportada).

⦁ O campo 004-000 (moeda) é obrigatório em todos os arquivos que possuam o campo 003000 (valor da transação).

⦁ O campo 707-000 indica o valor original da transação (o valor do campo 003-000 informado pela Automação Comercial no arquivo de solicitação). Caso ausente, significa que o valor da transação não foi alterado.

⦁ O campo 708-000 indica o valor do saque/troco. Caso ausente, significa que não houve saque na transação.

⦁ O campo 709-000 indica o valor do desconto. Caso ausente, significa que não houve desconto na transação.

⦁ O campo 003-000 indica o valor final da transação, incluindo saque e desconto. Assim:

Valor total (003-000) = Valor original (707-000) + Valor do saque (708000) – Valor do desconto (709-000)

Detalhamento dos campos

Esta seção lista apenas os campos mencionados neste documento. Demais campos pré-existentes permanecem inalterados.

Legenda para a coluna “Formato”:

⦁ ‘n’ indica um campo contendo exclusivamente caracteres numéricos;

⦁ ‘a’ indica um campo podendo conter qualquer caractere permitido, de acordo com “6.1.  Formato genérico”;

⦁ ‘a7’ indica um campo de exatamente 7 caracteres;

⦁ ‘a..5’ indica um campo de 1 a 5 caracteres.

Código	Nome	Formato	Descrição
003-000	Valor total	n..12	Valor total da operação, em centavos da moeda informada no campo 004-000. No arquivo de resposta para transações de venda, este campo indica o valor efetivamente debitado do Cliente e creditado para o Estabelecimento (desconsiderando taxas referentes ao uso da solução, descontadas pela rede adquirente).
004-000	Moeda	n1	0: Real 1: Dólar americano
028-000	Tamanho via única	n..3	Quantidade de linhas da via única do comprovante.
029-xxx	Via única do comprovante	a..40	Linha da via única do comprovante, entre aspas duplas. xxx indica o número da linha, de 001 até a quantidade total de linhas indicada pelo campo 028-000.
701-000	Versão da automação	a..40	Nome e versão da Automação Comercial. Exemplo: SUPERVENDAS v1.01
706-000	Capacidades da automação	n1	Soma dos seguintes valores, identificando as funcionalidades suportadas pela Automação Comercial: 1: funcionalidade de saque (ver campo 708-000) 2: funcionalidade de desconto (ver campo 709-000) Caso este campo não seja informado pela Automação Comercial, considera-se que nenhuma das funcionalidades é suportada.
707-000	Valor original	n12	Valor original da transação informado pela Automação Comercial no campo 003000 do arquivo de solicitação, em centavos da moeda identificada no campo 004-000. Este campo é informado pelo TEF caso seja diferente do valor final da transação informado no campo 003-000 do arquivo de resposta, sempre respeitando a regra abaixo: Valor total (003-000) = Valor original (707-000) + Valor do saque (708000) – Valor do desconto (709-000)
708-000	Valor do saque	n12	Valor de retirada em dinheiro (saque no cartão) realizada em conjunto com a transação de venda. Este valor é acrescido ao valor original da transação, e deve ser registrado na Impressora Fiscal como “troco”.
709-000	Valor do desconto	n12	Valor do desconto concedido ao Cliente pela rede adquirente ou pelo Emissor para uma transação de venda. Este valor é retirado do valor original da transação, e deve ser registrado na Impressora Fiscal como “desconto”.
710-000	Tamanho cupom reduzido	n..3	Quantidade de linhas do cupom reduzido.
711-xxx	Cupom reduzido	a..40	Linha do cupom reduzido, entre aspas duplas. xxx indica o número da linha, de 001 até a quantidade total de linhas indicada pelo campo 710-000.
712-000	Tamanho via Cliente	n..3	Quantidade de linhas da via diferenciada do comprovante destinada ao Cliente.
713-xxx	Via Cliente do comprovante	a..40	Linha da via do Cliente, entre aspas duplas. xxx indica o número da linha, de 001 até a quantidade total de linhas indicada pelo campo 712-000.
714-000	Tamanho via Estabelecimento	n..3	Quantidade de linhas da via diferenciada do comprovante destinada ao Estabelecimento.
715-xxx	Via Estabelecimento do comprovante	a..40	Linha da via do Estabelecimento, entre aspas duplas. xxx indica o número da linha, de 001 até a quantidade total de linhas indicada pelo campo 714-000.
716-000	Empresa da Automação	a..40	Razão social da empresa responsável pelo desenvolvimento da aplicação de Automação Comercial. Exemplo: KND SISTEMAS LTDA.

Presença dos Campos

⦁ ‘M’ indica que a presença do campo é obrigatória;

⦁ ‘O’ indica que a presença do campo é opcional;

⦁ ‘E’ indica que o campo é ecoado (idêntico ao arquivo de solicitação);

⦁ ‘C1’ indica que o campo está presente caso o campo anterior seja diferente de zero (tamanho do comprovante);

A ausência de caractere em uma coluna indica que o campo não é esperado.

Arquivo de solicitação (Req\intpos.001)

Código	Nome	ATV	CRT	ADM	CNC	CHQ	CNF	NCN
003-000	Valor total		M		M	M
004-000	Moeda		M		M	M
701-000	Versão da Automação		M	M	M	M
706-000	Capacidades da Automação		M	M	M	M
716-000	Empresa da Automação		M	M	M	M

Arquivo de resposta (Resp\intpos.001)

Código	Nome	CRT	ADM	CNC	CHQ
003-000	Valor Total	M	O	M	M
004-000	Moeda	M	O	M	M
707-000	Valor Original	O	O	O
708-000	Valor do Saque	O	O	O
709-000	Valor do Desconto	O	O	O
710-000	Tamanho cupom reduzido	O	O	O	O
711-xxx	Cupom reduzido	C1	C1	C1	C1
712-000	Tamanho via Cliente	O	O	O	O
713-xxx	Via Cliente do comprovante	C1	C1	C1	C1
714-000	Tamanho via Estabelecimento	O	O	O	O
715-xxx	Via Estabelecimento do comprovante	C1	C1	C1	C1