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 =stone v2, 11, 0, 0
716-000 = STONE 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 diferenciada
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:
Valor da transação
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”:
| Código | Descrição |
|---|---|
| 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 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
| Código | Descrição |
|---|---|
| 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 |
|---|---|---|---|---|---|---|---|---|
| 0003-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 solicitação (Resp\intpos.001)
| Código | Valor total | CRT | ADM | CNC | CNQ |
|---|---|---|---|---|---|
| 003-000 | Valor total | M | O | M | M |
| 004-000 | Moeda | M | O | M | M |
| 707-000 | Valor orginal | 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 |
Considerações finais
- Caso o arquivo de resposta contenha campos desconhecidos pela Automação Comercial, esta deve ignorá-los sem acusar erro. Isto permite que informações adicionais sejam futuramente retornadas pelo aplicativo de TEF, mantendo compatibilidade com versões de Automação Comercial anteriores à nova especificação.
Exemplo de arquivo de retorno:
000-000 = CRT
001-000 = 618538554
002-000 = 223546
003-000 = 10800
004-000 = 0
009-000 = 0
010-000 = NOVAREDE
011-000 = 20
012-000 = 12282005821
013-000 = 005045
015-000 = 0906122820
016-000 = 0906122820
022-000 = 09062012
023-000 = 122820
027-000 = 12060912282012282005821
028-000 = 19
029-001 = " *** DEMONSTRACAO PAY&GO ***"
029-002 = " COMPROVANTE DE TEF"
029-003 = " "
029-004 = " ESTABELECIMENTO DE TESTE"
029-005 = " 823982346832235/03876463"
029-006 = " "
029-007 = " 09/06/2012 12:28:20"
029-008 = " REF.FISCAL:618538554"
029-009 = " DOC:020778 AUTORIZ:005045"
029-010 = " REF.HOST:12282005821"
029-011 = " "
029-012 = " DEMOCARD ************1111"
029-013 = " VENDA DEBITO A VISTA"
029-014 = " VALOR FINAL: R$ 108,00"
029-015 = " VALOR ORIGINAL: R$ 120,00"
029-016 = " DESCONTO: R$ 12,00"
029-017 = " "
029-018 = " TRANSACAO AUTORIZADA MEDIANTE"
029-019 = " USO DA SENHA PESSOAL."
030-000 = AUTORIZADA 005045
040-000 = DEMOCARD
707-000 = 12000
709-000 = 1200
710-000 = 5
711-001 = "DEMOCARD ************1111"
711-002 = "POS:03876463 DOC:020778 AUTORIZ:005045"
711-003 = "VENDA DEBITO A VISTA"
711-004 = "VALOR FINAL: R$ 108,00"
711-005 = "DESCONTO: R$ 12,00"
712-000 = 17
713-001 = " *** DEMONSTRACAO PAY&GO ***"
713-002 = " COMPROVANTE DE TEF"
713-003 = " VIA: CLIENTE"
713-004 = " "
713-005 = " ESTABELECIMENTO DE TESTE"
713-006 = " 823982346832235/03876463"
713-007 = " "
713-008 = " 09/06/2012 12:28:20"
713-009 = " REF.FISCAL:618538554"
713-010 = " DOC:020778 AUTORIZ:005045"
713-011 = " REF.HOST:12282005821"
713-012 = " "
713-013 = " DEMOCARD ************1111"
713-014 = " VENDA DEBITO A VISTA"
713-015 = " VALOR FINAL: R$ 108,00"
713-016 = " VALOR ORIGINAL: R$ 120,00"
713-017 = " DESCONTO: R$ 12,00"
714-000 = 20
715-001 = " *** DEMONSTRACAO PAY&GO ***"
715-002 = " COMPROVANTE DE TEF"
715-003 = " VIA: ESTABELECIMENTO"
715-004 = " "
715-005 = " ESTABELECIMENTO DE TESTE"
715-006 = " 823982346832235/03876463"
715-007 = " "
715-008 = " 09/06/2012 12:28:20"
715-009 = " REF.FISCAL:618538554"
715-010 = " DOC:020778 AUTORIZ:005045"
715-011 = " REF.HOST:12282005821"
715-012 = " "
715-013 = " DEMOCARD ************1111"
715-014 = " VENDA DEBITO A VISTA"
715-015 = " VALOR FINAL: R$ 108,00"
715-016 = " VALOR ORIGINAL: R$ 120,00"
715-017 = " DESCONTO: R$ 12,00"
715-018 = " "
715-019 = " TRANSACAO AUTORIZADA MEDIANTE"
715-020 = " USO DA SENHA PESSOAL."
718-000 = DEMO
719-000 = ESTAB 42
999-999 = 0