1 - PGCliWin - Interface Com A Automação Comercial - v2.11 PDF

Pay&Go Cliente Windows
Especificao Tcnica da interface com

a Automao Comercial
Verso 2.11 (13 jun 2014)
Copyright 2006-2014 SETIS Automao e Sistemas Ltda.

Este documento possui informaes de propriedade intelectual exclusiva da SETIS Automao e
Sistemas Ltda., no podendo ser reproduzido, utilizado ou divulgado por qualquer modo ou
meio, total ou parcialmente, para qualquer fim, sem a devida autorizao prvia.
HISTRICO
Verso
Data
Responsvel
Descrio da alterao
1.00
08 fev 2006
Vincent Bouchy
Primeira verso.
1.01
17 abr 2006
Vincent Bouchy
- Novo campo: identificao da aplicao de Automao Comercial.

- Novo campo: ndice do Estabelecimento.
1.10
11 abr 2008
Vincent Bouchy
- Alterao no tamanho dos campos 012 e 027

- Correo no formato dos campos 710, 712 e 714
1.11
06 abr 2009
Vincent Bouchy
- Incluso dos campos 704 e 705 (assinatura da Automao)
1.12
30 jun 2010
Vincent Bouchy
- Incluso da soluo Plug&Pay

- Incluso dos campos 706 a 709 (tratamento das funcionalidades de
desconto e troco)
2.00
01 abr 2011
Vincent Bouchy
- Incorporadas as definies do documento original Guia Tcnico da

Soluo TEF Discado Interface e Ambiente Verso 2.3 07/2003
American Express / Redecard / Visanet, deixando de referenciar este
documento.
- Reviso completa
- Possibilidade de desconto e troco simultneos
- Incluso dos campos 716 a 725
- Excluso dos campos 704 e 705
2.01
02 abr 2012
Vincent Bouchy
- Acrescentado comando de Consulta de cheque

- So obrigatrios os campos 022 e 023 no comando CNC
- Compatibilizao com o processo de certificao existente
Alexandre Nishiyama - Incluso dos campos 718 e 719

2.02
08 jun 2012
Vincent Bouchy
- Correo do registro finalizador 999-999

- O campo 706-000 passa a ser obrigatrio
2.03
08 fev 2013
Vincent Bouchy
- A funcionalidade de desconto exigida na certificao CIELO
2.10
06 mai 2013
Vincent Bouchy
- Incluso do comando CDP (captura de dado pessoal no PIN-pad)

- Incluso dos campos 726-000 a 737-000
- Novos valores para o campo 706-000 (capacidades da Automao)
- Campo 701-000 substitudo por 735-000 e 736-000
- Ajustes pontuais que no afetam as funcionalidades existentes
2.11
13 jun 2014
Vincent Bouchy
- Incluso do campo 738-000

- Uso do campo Dado adicional #1 no extrato eletrnico, se
suportado pela rede adquirente
- Remoo da opo credirio do campo 731-000
- Remoo do comando CHQ e campos no usados
- Incluso da seo Tratamento de troco e desconto
- Incluso da seo Emisso de documento fiscal eletrnico
NDICE
1. Sobre este documento .................................................................................................................................. 5
1.1. Escopo .................................................................................................................................................... 5
1.2. Pblico ................................................................................................................................................... 5
1.3. Contatos................................................................................................................................................. 5
1.4. Compatibilidade..................................................................................................................................... 5
1.5. Avisos ..................................................................................................................................................... 5
2. Glossrio ........................................................................................................................................................ 6
3. Arquitetura .................................................................................................................................................... 8
4. Princpios bsicos .......................................................................................................................................... 9
4.1. Dinmica de operao ........................................................................................................................... 9
4.2. Fluxo de uma transao ......................................................................................................................... 9
4.3. Tipos de transao ...............................................................................................................................10
4.4. Comprovantes .....................................................................................................................................10
4.5. Diretrios para troca de arquivos ........................................................................................................11
4.5.1. Exemplo ..........................................................................................................................................11
4.5.2. Regras de uso .................................................................................................................................12
5. Fluxos da Automao Comercial .................................................................................................................13
5.1. Transao de Venda simples ...............................................................................................................13
5.2. Interrupo da transao ....................................................................................................................14
5.3. Impresso ............................................................................................................................................14
5.3.1. Definio das vias a serem impressas ............................................................................................15
5.4. Queda de energia ................................................................................................................................16
5.5. Mensagens de erro ..............................................................................................................................16
5.6. Transao Administrativa ....................................................................................................................17
5.7. Transao de Cancelamento ...............................................................................................................17
5.8. Transao de Venda com outras formas de pagamento .....................................................................18
5.9. Transao de Venda com mltiplos cartes ........................................................................................18
5.10. Verificao da atividade do Pay&Go ...................................................................................................20
5.11. Outras consideraes referentes troca de arquivos.........................................................................20
5.11.1. Gravao de arquivo.......................................................................................................................20
5.11.2. Acesso a arquivos existentes ..........................................................................................................20
5.11.3. Liberao do processador ..............................................................................................................20
5.12. Tratamento de troco e desconto .........................................................................................................21
5.13. Emisso de documento fiscal eletrnico .............................................................................................21
5.14. Impressora no fiscal ...........................................................................................................................23
5.15. Captura de dado pessoal no PIN-pad ..................................................................................................23
6. Formato dos arquivos trocados...................................................................................................................25
6.1. Formato genrico ................................................................................................................................25
6.2. Comandos existentes...........................................................................................................................25
6.3. Campos previstos para cada comando ................................................................................................26
6.3.1. Arquivo de solicitao (Req\intpos.001) ..................................................................................26

6.3.2. Arquivo de status (Resp\intpos.sts) .......................................................................................28
6.3.3. Arquivo de resposta (Resp\intpos.001) ...................................................................................28
6.4. Detalhamento dos campos ..................................................................................................................29
6.5. Exemplos de arquivos ..........................................................................................................................36
6.5.1. Solicitao de venda (Req\intpos.001) .....................................................................................36
6.5.2. Status de venda (Resp\intpos.sts) ..........................................................................................36
6.5.3. Resposta de venda (Resp\intpos.001) .....................................................................................36
6.5.4. Confirmao de venda (Req\intpos.001)..................................................................................38
6.5.5. Status de confirmao (Resp\intpos.sts) ................................................................................38
Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial
1.
Verso 2.11 (13 jun 2014)
Sobre este documento
1.1. Escopo
Este documento constitui a especificao tcnica para integrao de uma aplicao de Automao
Comercial com a soluo Pay&Go na plataforma Microsoft Windows. Tambm se aplica a produtos
derivados do Pay&Go, como o TEF IP One.
1.2. Pblico
Este documento essencialmente destinado a desenvolvedores de sistemas de Automao
Comercial que desejem integrar seu sistema com o Pay&Go para a realizao de transaes
eletrnicas (TEF).
1.3. Contatos
O suporte ao desenvolvedor de sistema de Automao Comercial prestado atravs do e-mail
suporte.desenv@ntk.com.br, que poder fornecer informaes referentes ao processo de
certificao.
1.4. Compatibilidade
Esta especificao derivada do documento Guia Tcnico da Soluo TEF Discado, e mantm plena
compatibilidade com este, porm somente considera os tratamentos necessrios para integrao
com o Pay&Go, alm de incluir novas funcionalidades.
A verso 2.10 deste documento inclui vrios campos adicionais que podem, dependendo da verso
do Pay&Go instalada no estabelecimento, no estar disponveis para algumas Redes Adquirentes. No
entanto, o funcionamento correto da soluo garantido, desde que os tratamentos especificados
neste documento sejam respeitados.
1.5. Avisos
As informaes contidas neste documento esto sujeitas a alterao sem prvio aviso.
Pay&Go uma marca registrada da SETIS Automao e Sistemas Ltda.
Microsoft e Windows so marcas registradas da Microsoft Corporation.
Copyright 2006-2014 SETIS Automao e Sistemas Ltda. Todos os direitos reservados.
SETIS Automao e Sistemas / NTK Solutions
5 / 34
2.
Verso 2.11 (13 jun 2014)
Glossrio
Rede Adquirente Empresa responsvel por prover o servio de captura de transaes eletrnicas
(seja de carto de crdito/dbito ou outro meio de pagamento). CIELO,
REDECARD e BANRISUL so exemplos de Redes adquirentes brasileiras.
Estabelecimento Refere-se neste documento aos estabelecimentos comerciais afiliados a uma ou
mais Redes adquirentes para aceitao de um meio de pagamento eletrnico das
mercadorias ou servios que eles provem.
Cliente
Pessoa fsica ou jurdica adquirindo mercadorias ou servios do Estabelecimento,
responsvel pelo pagamento destas e portador de um carto ou outro meio de
pagamento. A nica exceo a esta definio o uso do nome Cliente Pay&Go,
que designa o mdulo aplicativo do Pay&Go instalado no Checkout.
Emissor
Empresa responsvel pela emisso do carto utilizado pelo Cliente para a
realizao de transaes eletrnicas no Estabelecimento. Administradoras
associadas a bancos so os principais emissores de cartes, assim como
administradoras de cartes de benefcio (refeio, alimentao, combustvel,
premiao, etc.).
Bandeira
Empresa definindo um padro e provendo servios de intercmbio e troca de
informaes entre a Rede Adquirente e o Emissor. VISA, MASTERCARD e
AMERICAN EXPRESS so exemplos tpicos de Bandeiras.
TEF
(Transferncia Eletrnica de Fundos) Este termo designa os sistemas e processos
envolvidos numa transao eletrnica entre o Cliente e o Estabelecimento,
envolvendo Rede Adquirente, Emissor e, dependendo do carto utilizado,
Bandeira.
Checkout ou PDV Terminal de caixa utilizado para pagamento das mercadorias e servios ofertados
pelo Estabelecimento. O Checkout usualmente possui uma aplicao de
Automao Comercial, responsvel pela captura das informaes dos produtos
sendo adquiridos, registro fiscal da venda (atravs de uma Impressora Fiscal ou
outro dispositivo/mecanismo homologado pela Secretaria da Fazenda), registro
do meio de pagamento utilizado e acionamento do sistema de TEF.
PIN-pad
Equipamento certificado pelas Redes Adquirentes e destinado leitura de carto
com tarja magntica, captura da senha do Cliente (PIN = Personal Identification
Number) e processamento de cartes com chip.
TCP/IP
TCP/IP designa um conjunto de protocolos de comunicao entre computadores
em rede. As duas camadas TCP (Transmission Control Protocol) e IP (Internet
Protocol) so utilizadas por camadas de mais alto nvel, que dependem da
aplicao, e por outro lado se utilizam de camadas de mais baixo nvel, que
dependem do meio fsico utilizado (seja Ethernet, GPRS, ADSL, linha discada ou
outro) para a comunicao.
VPN
Virtual Private Network ou Rede Particular Virtual uma rede privada segura
construda sobre a infra-estrutura de uma rede pblica, normalmente a Internet.
Ou seja, ao invs de se utilizar links dedicados ou redes de pacotes (como Frame
Relay e X.25) para conectar redes remotas, utiliza-se a infra-estrutura da Internet.
Modem
Equipamento para comunicao com sistemas remotos atravs de discagem pela
rede de telefonia comutada pblica. O equipamento considerado neste
documento especfico, por ser capaz de estabelecer conexes sncronas (de alto
desempenho) com as Redes adquirentes.
6 / 34
Pay&Go
Verso 2.11 (13 jun 2014)
O Pay&Go um sistema certificado pelas principais Redes adquirentes brasileiras

para realizao de transaes eletrnicas (TEF) atravs da Internet, com uso de
VPN e de protocolo TCP/IP. destinado a Estabelecimentos com um ou mais
Checkouts, e deve ser integrado com um aplicativo de Automao Comercial
certificado.
7 / 34
3.
Verso 2.11 (13 jun 2014)
Arquitetura
A figura a seguir ilustra a arquitetura da soluo Pay&Go com Checkout na plataforma Windows:
Checkout (Windows)
Pay&Go Cliente
Automao comercial
Pay&Go
Servidor
socket TCP/IP
Sistema operacional (Windows)

Porta serial
Legenda:
Aplicao de Automao comercial
Componentes do Pay&Go
Componentes de sistema
Chamadas via funo
PIN-pad
Interface objeto desta especificao
Um executvel independente (Pay&Go Cliente) roda no Checkout e responsvel por toda a

comunicao com o Pay&Go Servidor e com o PIN-pad. Atravs da interface detalhada nas sees a
seguir, o Pay&Go Cliente permite que a Automao Comercial acesse todas as funes de TEF
disponibilizadas pela soluo Pay&Go.
8 / 34
4.
Verso 2.11 (13 jun 2014)
Princpios bsicos
4.1. Dinmica de operao

Os componentes do TEF (Pay&Go Servidor e Pay&Go Cliente) so executados automaticamente ao
Windows ser iniciado, porm permanecem em segundo plano, no requerendo nenhuma ao do
usurio. Embora o Pay&Go Servidor possa iniciar automaticamente processos agendados pelas redes
adquirentes ou pelo Estabelecimento, o Pay&Go Cliente, por sua vez, permanece no aguardo de um
comando oriundo da Automao Comercial.
O acionamento do TEF pela Automao Comercial realizado atravs da gravao de um arquivo de
comando especfico em determinado diretrio. A gravao deste arquivo aciona imediatamente o
TEF, que assume a interface com o usurio, ficando a partir deste momento a Automao Comercial
em segundo plano. No final da operao de TEF, um arquivo de resposta gravado em determinado
diretrio monitorado pela Automao Comercial, fazendo com que esta assuma novamente o
controle, retornando o TEF ao estado de aguardo.
Embora ambos os aplicativos Automao Comercial e TEF estejam sempre ativos (sendo executados)
simultaneamente, em cada momento somente um deles est interagindo com o usurio,
permanecendo o outro em segundo plano. O sincronismo entre as aplicaes realizado atravs da
gravao sucessiva de arquivos.
4.2. Fluxo de uma transao

A figura abaixo ilustra a seqncia de arquivos trocados durante uma transao de venda bem
sucedida (aprovada pela Rede Adquirente).
Automao comercial
Arquivos trocados
Registra os dados da venda

Usurio seleciona pagamento com TEF
Limpa o diretrio de retornos
Comando (intpos.001)
Monitora o diretrio de comandos

Status (intpos.sts)
Monitora o diretrio de retornos

Resposta (intpos.001)
Imprime o comprovante
Apaga o arquivo de Status
Apaga o arquivo de Resposta
Monitora o diretrio de retornos
Apaga o arquivo de Status
Pronta para realizar novas operaes
TEF
Apaga o arquivo de Comando

Assume o primeiro plano
L o carto e solicita os dados ao
usurio
Comunica-se com a rede adquirente
Volta para o segundo plano
Confirmao (intpos.001)
Status (intpos.sts)
Apaga o arquivo de Confirmao

9 / 34
Verso 2.11 (13 jun 2014)
4.3. Tipos de transao

A Automao pode acionar o TEF para efetuar vrios tipos de transao, no entanto destacam-se
dois principais tipos:
Pagamento de mercadorias e/ou servios adquiridos no Estabelecimento, associado a um cupom
fiscal nos Estabelecimentos onde a legislao se aplicar, por exemplo:
Venda com carto de crdito/dbito/etc.;
Confirmao de pr-autorizao;
Venda com CPF (primeira compra);
Financiamento.
Outras transaes e funes que no se encaixam no primeiro grupo, por exemplo:
Pr-autorizao;
Consulta de saldo ou de financiamento;
Pagamento de boleto/fatura;
Recarga de celular pr-pago;
Saque;
Cancelamento de qualquer transao;
Antecipao de vendas;
Relatrios;
Fechamento;
Outras funes administrativas.
Os tipos de transao disponveis variam muito dependendo da Rede Adquirente utilizada.
Para simplificar o entendimento, chamaremos a partir de agora estes 2 tipos de transao de Venda
e Administrativa.
4.4. Comprovantes
O Pay&Go pode gerar vrios tipos de comprovantes, dependendo do tipo de transao efetuada e da
Rede Adquirente utilizada:
Comprovante completo: Contm todas as informaes para ambos o Cliente e o Estabelecimento.
tipicamente usado em impressoras com folha dupla, ou quando a Rede Adquirente no suporta
os demais tipos de comprovante. Este o nico comprovante que sempre gerado pelo Pay&Go.
Comprovante diferenciado para o Estabelecimento: Somente contm as informaes relevantes
para o Estabelecimento. Este comprovante opcional, podendo ou no ser gerado pelo Pay&Go.
A Automao Comercial deve preferencialmente emitir esta via do comprovante para o
Estabelecimento, para no divulgar informaes somente relevantes para o Cliente (por exemplo,
o saldo do carto).
Comprovante diferenciado para o Cliente: Somente contm as informaes relevantes para o
Cliente. Este comprovante opcional, podendo ou no ser emitido pelo Pay&Go. A Automao
Comercial deve preferencialmente emitir esta via do comprovante para o Cliente, para reduzir o
consumo de papel.
10 / 34
Verso 2.11 (13 jun 2014)
Comprovante reduzido: Somente contm as informaes relevantes para o Cliente, excluindo

informaes que j estejam presentes no cupom fiscal (nome, endereo e CNPJ do
Estabelecimento, data da transao, etc.). Se possvel, este comprovante de at 5 linhas deve ser
impresso pela Automao Comercial dentro do cupom fiscal, no num cupom fiscal vinculado.
Este comprovante opcional, podendo ou no ser emitido pelo Pay&Go, e restrito a transaes
de Venda. A Automao Comercial deve preferencialmente emitir esta via do comprovante para o
Cliente, para reduzir o consumo de papel.
O Pay&Go gera comprovantes:
Para transaes de Venda aprovadas: sempre;
Para transaes Administrativas aprovadas: opcional;
Para transaes (de Venda ou Administrativas) negadas: nunca.
Para transaes de Venda, a Automao Comercial deve sempre imprimir 2 vias, a primeira para o
Cliente, a segunda para o Estabelecimento. Estes comprovantes sempre devem ser vinculados ao
documento fiscal correspondente.
Para transaes Administrativas, a Automao Comercial deve imprimir uma primeira via (do
Cliente), e perguntar para o operador se deseja imprimir a segunda via. Caso confirme a impresso
da segunda via, imprimir a do Estabelecimento.
No caso da impresso de duas vias na mesma folha, a Automao Comercial dever prever um
mecanismo para separao das vias, seja de maneira automtica (guilhotina) ou manual (pausa na
impresso, prever um espaamento de 5 linhas entre as vias).
Para que o Pay&Go possa formatar adequadamente os comprovantes para a Automao Comercial,
esta deve informar no campo 706-000:
Se apta a imprimir as vias diferenciadas (ao invs de duplicar a via nica);
Se apta a imprimir o cupom reduzido.
4.5. Diretrios para troca de arquivos

Para manter a compatibilidade com sistemas de TEF que substitui ou com os quais coexiste, o
Pay&Go monitora e opera em diversos diretrios, dependendo das redes adquirentes habilitadas na
soluo.
Pelo mesmo motivo, importante que o(s) diretrio(s) de troca de arquivos utilizado(s) pela
Automao Comercial seja(m) configurvel(is), de acordo com as solues de TEF contratadas pelo
Estabelecimento.
Para integrao com Pay&Go, recomenda-se o uso da pasta C:\PAYGO, pelos seguintes motivos:
suportada em todas as instalaes de ambos os produtos Pay&Go;
Atende todas as redes adquirentes habilitadas na soluo;
No depende de sistema intermedirio para operar (mdulo legado Gerenciador Padro).
4.5.1. Exemplo
A Automao pode utilizar as seguintes pastas:
C:\PAYGO para acionar qualquer rede habilitada no Pay&Go;
C:\TEF_Dial para acionar:
Qualquer rede habilitada no Pay&Go (se no estiver usando o mdulo Gerenciador Padro);
As redes CIELO e REDECARD (se estiver usando o mdulo Gerenciador Padro);
11 / 34
Verso 2.11 (13 jun 2014)
C:\TEF_Disc para acionar as redes BANRISUL, TRICARD, POLICARD e VALECARD (e outras

suportadas por solues de TEF especficas), com uso do mdulo Gerenciador Padro secundrio;
C:\TEF_CSHP para acionar a rede CREDI-SHOP.
4.5.2. Regras de uso

Independentemente do diretrio utilizado, este contm duas pastas:
Req (por exemplo, C:\PAYGO\Req):
Todos os arquivos gerados pela Automao Comercial para o Pay&Go so gravados nesta
pasta.
de responsabilidade do Pay&Go excluir os arquivos gravados nesta pasta aps l-los.
Resp (por exemplo, C:\PAYGO\Resp):
Todos os arquivos gerados pelo Pay&Go para a Automao Comercial so gravados nesta
pasta.
de responsabilidade da Automao Comercial excluir os arquivos gravados nesta pasta aps
l-los.
Observao: ao ser instalado, o Pay&Go automaticamente concede os direitos de leitura e gravao
nas pastas acima para todos os usurios autenticados no computador.
12 / 34
5.
Verso 2.11 (13 jun 2014)
Fluxos da Automao Comercial

Esta seo detalha os fluxos de processamento que deve ser seguidos pela Automao Comercial
(AC) para realizar operaes de TEF.
5.1. Transao de Venda simples

Uma transao de Venda simples (com uma nica forma de pagamento) segue o fluxo abaixo, para
uma soluo integrada com Impressora Fiscal:
AC totaliza cupom fiscal
AC solicita forma
de pagamento
AC processa forma de pagamento
outra forma de pagamento
TEF
tempo esgotado
(7 segundos)
AC apaga contedo da pasta Resp
AC apresenta contedo do campo

030-000 (sem pausa)
AC gera arquivo Req\intpos.001

(campo 000-000 = CRT)
AC finaliza o cupom fiscal e

imprime o comprovante
AC tenta novamente imprimir o

comprovante
AC aguarda
arquivo
Resp\intpos.sts
arquivo
encontrado
AC confere
arquivo
Resp\intpos.sts
inconsistncia
AC acusa erro
falha
sucesso
ok
AC informa o usurio e pergunta se

deseja tentar novamente
AC aguarda arquivo Resp\intpos.001

(sem tempo limite)
inconsistncia
AC confere
arquivo
Resp\intpos.001
Resultado da
impresso?
sim
sim
Tenta
novamente?
no
Campo 729-000
presente e igual
a1
no
ok
sim
diferente de zero
AC verifica
campo 009-000
zero
Campo 729-000
presente e igual
a1

(campo 000-000 = CNF)
no
AC aguarda arquivo Resp\intpos.sts

(campo 000-000 = NCN)
AC pronta para iniciar nova operao
As prximas sees contm informaes importantes relacionadas a etapas especficas do fluxo

acima.
13 / 34
Verso 2.11 (13 jun 2014)
5.2. Interrupo da transao

No existe tempo mximo para a Automao Comercial aguardar o arquivo Resp\intpos.001
gerado pelo TEF, pelos motivos seguintes:
Devido a mecanismos de tolerncia a falha configurados dinamicamente pela Rede Adquirente
(quantidade de tentativas e tempo mximo de espera), o processo de conexo Rede Adquirente
para autorizao da transao no tem tempo mximo definido.
Devido interao com o usurio, o fluxo de telas para captura das informaes da transao
tambm no tem tempo mximo definido. (Existe um tempo mximo de ociosidade, porm
reiniciado a cada ao do usurio.)
Por esses motivos, a Automao Comercial no deve permitir que uma operao de TEF seja
interrompida aps o recebimento do arquivo Resp\intpos.sts. Alm disso, tal possibilidade
poderia quebrar o sincronismo entre as aplicaes e por consequncia a integridade da transao.
No entanto, em caso de situao inesperada na qual o TEF deixaria de responder solicitao da
Automao Comercial, aceita-se que a Automao Comercial fornea um mecanismo para abortar a
operao de TEF, desde que o acesso a este recurso seja protegido por uma senha de divulgao
restrita.
5.3. Impresso
O processo de impresso dos comprovantes crtico, pois dele depende o status final da transao,
se esta ser confirmada ou cancelada. Um tratamento incorreto pode resultar em quebra da
integridade da transao, ficando indevidamente efetivada ou cancelada, sem o conhecimento do
operador e do Cliente.
Em caso de falha no processo de impresso, a Automao Comercial deve avisar o usurio e
perguntar se deseja realizar uma nova tentativa de impresso (dando a oportunidade de verificar o
estado e as conexes da impressora), repetidamente a cada tentativa. O resultado da impresso
somente deve ser considerado falho (para gerao do arquivo de resposta ao Pay&Go) aps o
operador confirmar a desistncia.
O sucesso da impresso deve ser determinado pela Automao Comercial, atravs de comunicao
direta com a Impressora Fiscal, nunca deve ser determinado pelo operador.
Caso seja determinada falha na impresso e o operador desiste de novas tentativas, a Automao
Comercial deve avisar claramente o usurio que a transao de TEF foi cancelada, apresentando a
mensagem de erro abaixo definida para esta situao.
Importante:
Algumas transaes, mesmo bem sucedidas e gerando comprovantes, podem no requerer
confirmao. Esta situao identificada pela Automao Comercial atravs do campo 729-000.
H duas causas possveis para esta situao:
A transao no tem impacto para o estabelecimento ou para o Cliente (por exemplo, consulta
de saldo); ou
Mesmo tendo impacto, a transao j est confirmada, e a Rede Adquirente no permite
desfaz-la.
As definies aqui realizadas no substituem e no invalidam nenhum ponto da lei fiscal vigente,
com a qual a Automao Comercial deve estar em pleno acordo.
14 / 34
Verso 2.11 (13 jun 2014)
5.3.1. Definio das vias a serem impressas

O fluxo abaixo deve ser utilizado para determinar quais vias do comprovante devem ser impressas:
Impressora de
folha dupla?
sim
no
Imprime a via nica uma nica vez
(campos 029-xxx)
outros valores
Campo 737-000?
1, 3 ou ausente
ADM
ou CNC
Tipo de
transao?
CRT
Campo 710-000?
presente e
diferente de zero
ausente ou
igual a zero
presente e
diferente de zero
Campo 712-000?
ausente ou
igual a zero
Imprime via do Cliente (1 via)
(campos 713-xxx)
Imprime via nica (1 via)

(campos 029-xxx)
Campo 737-000?
Imprime cupom reduzido (1 via)

(campos 711-xxx)
outros valores
2, 3 ou ausente
Campo 714-000?
presente e
diferente de zero
ausente ou
igual a zero
Imprime via nica (2 via)
(campos 029-xxx)
Imprime via do estabelecimento

(2 via) (campos 715-xxx)
Impresso concluda
15 / 34
Verso 2.11 (13 jun 2014)
5.4. Queda de energia

Em caso de queda de energia durante uma operao de TEF, ao ser reiniciada, a Automao
Comercial deve verificar a presena do Resp\intpos.001. Caso presente, indica que a operao de
TEF foi efetuada, porm a impresso no foi finalizada. Nesta situao, deve ser adotado o mesmo
procedimento acima descrito para uma falha na impresso:
Avisar o usurio do ocorrido;
Perguntar para o usurio se deseja efetuar uma nova tentativa de impresso ou se deseja
cancelar a operao de TEF;
Nunca deixar o operador determinar o status final da operao.
5.5. Mensagens de erro

Em caso de erro na operao de TEF, a mensagem apresentada para o usurio deve ser condizente
com a situao ocorrida. O fluxo em 5.1.Transao de Venda simples destaca as seguintes
situaes:
Situao
Mensagem de erro
O arquivo Resp\intpos.sts no gerado

pelo TEF
TEF no responde
Inconsistncia no arquivo
Resp\intpos.001
Inconsistncia no campo <nmero do campo> do

arquivo <nome do arquivo> gerado pelo TEF
Campo 009-000 diferente de zero
<campo 030-000>
Falha na impresso
Transao TEF cancelada:

Rede: <campo 010-000>
NSU: <campo 012-000>
Valor: <campo 003-000>
Observao: aps apresentao da mensagem, a Automao Comercial deve aguardar uma

confirmao de leitura do usurio (boto OK, por exemplo).
16 / 34
Verso 2.11 (13 jun 2014)
5.6. Transao Administrativa

O fluxo de uma transao Administrativa muito similar ao da Venda simples:
Usurio acionada operao
Administrativa de TEF

diferente
de zero
tempo
esgotado
(7 segundos)
ausente
AC aguarda
arquivo
Resp\intpos.sts
AC confere
arquivo
Resp\intpos.sts
zero
AC verifica
campo 028-000
inconsistncia
arquivo
encontrado
zero
AC verifica
campo 737-000

(campo 000-000 = ADM)
diferente
de zero
AC imprime o comprovante
ok
AC tenta novamente imprimir o
comprovante
AC aguarda arquivo Resp\intpos.001

(sem tempo limite)
inconsistncia
AC confere
arquivo
Resp\intpos.001
falha
Resultado da
impresso?
ok
diferente
de zero
sucesso

AC verifica
campo 009-000
sim
zero
sim
Tenta
novamente?
Campo 729-000
presente e igual
a1
no

030-000 (sem pausa)
no
sim
Campo 729-000
presente e igual
a1
no

(campo 000-000 = NCN)

(campo 000-000 = CNF)
AC acusa erro
5.7. Transao de Cancelamento

O cancelamento de uma venda pode ser realizado atravs de uma transao Administrativa, com
digitao das informaes da venda no fluxo da operao. A transao de Cancelamento (comando
CNC) permite um acesso direto a esta mesma operao, referenciando uma transao de Venda
realizada anteriormente.
17 / 34
Verso 2.11 (13 jun 2014)
O fluxo da operao segue exatamente o mesmo de uma transao Administrativa, como acima
detalhado. Somente deve se lembrar, caso necessrio, de tambm cancelar o cupom fiscal
correspondente.
A implementao da transao de Cancelamento pela Automao Comercial opcional.
5.8. Transao de Venda com outras formas de pagamento

Caso seja utilizada uma ou mais formas de pagamento alm do pagamento via TEF (cheque, dinheiro,
etc.), estas formas de pagamento devem ser registradas antes de acionar o TEF. O valor da transao
de Venda informado pela Automao Comercial ao TEF deve sempre ser o valor total ainda no pago,
finalizando desta forma a venda aps aprovao da transao pelo TEF, e confirmao pela
Automao Comercial.
5.9. Transao de Venda com mltiplos cartes

Devido necessidade de confirmar cada transao antes de iniciar a prxima, o pagamento de uma
mesma Venda atravs de mais de uma operao de TEF no suportado de maneira direta. A
funcionalidade pode ser implementada, opcionalmente, pela Automao Comercial, porm requer
tratamentos adicionais, abaixo descritos.
As regras so as seguintes:
Cada operao de TEF que no seja a ltima deve ser confirmada imediatamente para o Pay&Go
(comando CNF), e os comprovantes devem ser armazenados em memria no voltil para
futura impresso.
Aps aprovao da ltima operao de TEF, o cupom fiscal deve ser fechado e todos os
comprovantes impressos, respeitando a ordem na qual foram realizadas as transaes. Aps
impresso com sucesso dos comprovantes da ltima operao de TEF, deve ento ser confirmada
a ltima transao (comando CNF).
Caso, por qualquer motivo, o pagamento no possa ser completado via TEF, todas as operaes
de TEF realizadas devem ser canceladas:
A ltima operao ainda no confirmada cancelada simplesmente atravs do comando
NCN.
As demais operaes de TEF j confirmadas devem ser canceladas atravs de uma transao
de Cancelamento (comando CNC).
A transao de cancelamento no imediata e requer diversas aes do usurio (leitura do
carto, digitao de informaes da operao de TEF original, etc.), que dependem da Rede
Adquirente utilizada. Alm disso, pode no ser bem sucedida, devido a erros na digitao, falhas
de comunicao, etc. A transao de cancelamento somente deve ser considerada como efetuada
pela Automao Comercial aps aprovao pelo Pay&Go, impresso dos comprovantes com
sucesso e envio da confirmao (comando CNF) ao Pay&Go.
Uma vez iniciado o fluxo de pagamento com mltiplos cartes, este no pode ser interrompido
at ser finalizado com sucesso (todas as transaes confirmadas) ou falha (todas as transaes
canceladas com sucesso).
Quedas de energia durante o fluxo de pagamento devem ser tratadas da mesma forma de uma
transao simples, ainda recuperando o estado das transaes j realizadas e pendentes de
impresso, podendo o usurio optar por prosseguir com o fluxo, ou iniciar a sequncia de
cancelamentos.
18 / 34
Verso 2.11 (13 jun 2014)
Em caso de queda de energia durante o fluxo de cancelamento, ao ser reiniciada, a Automao

Comercial deve automaticamente prosseguir com este, sem fornecer opo para o usurio
interromper este.
O diagrama abaixo ilustra o fluxo seguido pela Automao Comercial:
Define o valor do pagamento TEF
AC aciona TEF
(comando CRT)
AC acusa erro
falha
AC confirma a transao
(comando CNF)
Resultado
(campo 009-000)
ok

030-000 (sem pausa)
Valor total pago?
AC imprime os comprovantes ainda

no impressos
AC armazena dados de retorno da

transao e comprovantes
no
sim
AC finaliza o cupom fiscal e

imprime todos os comprovantes

falha
sim
Tenta
novamente?
Resultado da
impresso?
no
AC cancela ltima transao

(comando NCN), exceto se campo
729-000 presente e igual a 1
Ainda h
transao no
cancelada?
sucesso
AC confirma ltima transao

(comando CNF), exceto se campo
729-000 presente e igual a 1
no
sim
AC cancela a transao
(comando CNC)
Resultado do
cancelamento +
impresso
falha
sucesso
Observaes:
No fluxo acima, para maior clareza, os controles efetuados nos arquivos trocados com o Pay&Go
foram omitidos, porm permanecem idnticos ao fluxo de venda simples.
A transao de cancelamento (comando CNC) deve ser confirmada aps a impresso dos
comprovantes, como qualquer transao administrativa.
19 / 34
Verso 2.11 (13 jun 2014)
5.10.Verificao da atividade do Pay&Go

Para verificar se o Pay&Go est ativo, a Automao Comercial deve:
Apagar o contedo da pasta Resp;
Gerar um arquivo Req\intpos.001, com campo 000-000 = ATV;
Aguardar at 7 segundos pela gerao do arquivo Resp\intpos.sts;
Considerar que o Pay&Go est ativo se o arquivo for gerado.
Seguem observaes importantes para compatibilidade com futuras verses dos produtos:
A Automao Comercial somente deve utilizar este mecanismo, nunca deve verificar a presena
de determinado arquivo em disco ou janela/processo em memria para este fim.
Caso o Pay&Go esteja inativo, por qualquer motivo que seja, o usurio dever acion-lo
manualmente. A Automao Comercial deve avisar o usurio, porm no deve tentar acionar
automaticamente o Pay&Go. No entanto, como exceo, caso a Automao utilize o diretrio
C:\TEF_Dial ou C:\TEF_Disc para troca de arquivos, esta poder executar o arquivo
correspondente ao mdulo Gerenciador Padro (C:\TEF_Dial\tef_dial.exe ou
C:\TEF_Disc\tef_disc.exe).
O Pay&Go ativado automaticamente pelo Windows, para qualquer usurio da mquina. Caso a
ativao automtica deixe de funcionar em determinado Estabelecimento, dever ser acionado o
suporte ao produto para verificar a instalao e corrigir o problema.
5.11.Outras consideraes referentes troca de arquivos

5.11.1.Gravao de arquivo
Para evitar conflitos de acesso a arquivos, a Automao Comercial sempre deve:
Gravar arquivos na pasta Req com um nome temporrio (por exemplo, intpos.tmp);
Esvaziar o cache (flush) imediatamente antes de fechar o arquivo;
Por ltimo, renomear o arquivo para o nome especificado (intpos.001).
5.11.2.Acesso a arquivos existentes

Aplicativos legtimos residentes no equipamento, que monitorem acesso a arquivos (principalmente
antivrus), podem causar falha de acesso quando a Automao Comercial tentar abrir um arquivo
existente (intpos.001 ou intpos.sts). Por isso, importante que a Automao Comercial
identifique e trate esta situao especfica, tentando novamente vrias vezes o acesso ao arquivo,
com intervalos de frao de segundos, antes de reportar o erro para o usurio.
Para mais informaes: http://support.microsoft.com/kb/316609/pt-br.
5.11.3.Liberao do processador
Enquanto aguarda um arquivo de resposta do TEF, importante que a Automao Comercial faa um
uso mnimo do processador, para no prejudicar o funcionamento do computador e do aplicativo de
TEF.
Recomenda-se que a presena do arquivo seja verificada no mximo 4 vezes por segundo, por
exemplo efetuando uma pausa de 250 ms aps cada verificao.
20 / 34
Verso 2.11 (13 jun 2014)
5.12.Tratamento de troco e desconto

Esta especificao prev que, em uma transao de Venda, o valor da transao inicialmente
informado pela Automao Comercial possa ser alterado durante a operao de TEF, devido a:
Uma retirada em dinheiro (saque) em conjunto com a Venda, por opo do cliente; e/ou
Um desconto concedido pela Rede Adquirente.
A Automao Comercial deve atentar-se a atualizar corretamente seus registros internos da
transao com estas informaes, assim como os registros fiscais correspondentes.
No caso do uso de uma Impressora Fiscal, recomenda-se registrar as formas de pagamento e
eventuais descontos concedidos pelo estabelecimento somente aps a realizao da operao de
TEF, convivendo assim com as restries de determinados modelos de equipamentos que no
permitem:
Registrar um desconto aps ter registrado uma forma de pagamento (tipicamente, dinheiro);
Registrar mais de um desconto.
5.13.Emisso de documento fiscal eletrnico

Para Estabelecimentos que emitam um documento fiscal eletrnico (NF-e, NFC-e, SAT, etc.) ao invs
de um Cupom Fiscal atravs de uma Impressora Fiscal:
Para garantir a integridade da transao, os passos referentes impresso do comprovante no
fluxo da transao detalhado anteriormente devem ser substitudos pelo registro fiscal eletrnico.
Ou seja, caso a comunicao com o dispositivo ou servio fiscal falhe e no possa ser recuperado,
a operao de TEF deve ser desfeita.
Dependendo do modo de operao do Estabelecimento, os comprovantes de TEF podem ser
emitidos:
Em uma impressora no fiscal (neste caso, uma falha na impresso no desfaz a operao de
TEF, conforme 5.14. Impressora no fiscal);
Dentro do DANFE, em campo adequado para este uso, de acordo com a legislao vigente.
21 / 34
Verso 2.11 (13 jun 2014)
A figura abaixo ilustra o final do fluxo de uma Transao de Venda:

030-000 (sem pausa)
AC realiza o registro
eletrnico da venda
AC tenta novamente realizar o

registro eletrnico da venda
falha
Resultado do
registro?
sucesso
sim
Campo 729-000
presente e igual
a1
Tenta
novamente?
sim
no
no
sim
Campo 729-000
presente e igual
a1

(campo 000-000 = CNF)
no

(campo 000-000 = NCN)
22 / 34
Verso 2.11 (13 jun 2014)
5.14.Impressora no fiscal
Para Estabelecimentos que no tenham a obrigao de utilizar uma Impressora Fiscal, solues de
Automao Comercial podem realizar a impresso dos comprovantes em impressoras no fiscais.
Nesta situao exclusivamente, no existe a necessidade de a Automao Comercial verificar o status
da impresso dos comprovantes para confirmar a transao ao Pay&Go.
A figura abaixo ilustra o final do fluxo de uma Transao de Venda:

030-000 (sem pausa)
sim
Campo 729-000
presente e igual
a1
no

(campo 000-000 = CNF)
Observaes:
Caso a impresso tenha falhado, a soluo Pay&Go permite a reimpresso do comprovante
atravs de uma Transao Administrativa.
Caso a Automao Comercial esteja integrada com um equipamento para o qual a integridade da
transao precise ser mantida (por exemplo, liberao automtica de uma mercadoria aps o
pagamento), o mesmo tratamento realizado para a impresso numa Impressora Fiscal poder ser
adotado: a Automao Comercial dever confirmar ou cancelar a transao de acordo com o
sucesso ou a falha da operao no equipamento acoplado.
5.15.Captura de dado pessoal no PIN-pad

O Pay&Go disponibiliza um comando especfico (CDP) para captura de um dado pessoal do Cliente no
PIN-pad utilizado pela soluo, favorecendo a operao (evitando erros de digitao) e preservando
a confidencialidade da informao.
Este dado pode ser:
O cdigo CPF do Cliente; ou
Um identificador numrico qualquer, de 4 a 12 dgitos.
Ao receber este comando, o Pay&Go solicita imediatamente a captura do dado no PIN-pad. Por uma
caracterstica do equipamento PIN-pad, o dado mascarado durante sua digitao e, para evitar
erros de digitao, o Pay&Go apresenta no PIN-pad a informao em claro para ser confirmada pelo
Cliente, antes de retorn-la para a Automao Comercial e finalizar o comando.
23 / 34
Verso 2.11 (13 jun 2014)
Observaes:
No caso de um CPF, o cdigo validado pelo Pay&Go antes de ser retornado para a Automao
Comercial.
Este comando no permite a digitao de um cdigo CNPJ, por o PIN-pad no permitir a captura
de um dado com mais de 12 dgitos.
Alguns equipamentos PIN-pads podem no suportar esta funcionalidade, em qual caso o Pay&Go
retornar erro. Por isso importante que, independentemente de ter implementado este
comando, a Automao comercial tambm permita a captura do dado atravs de sua prpria
interface com o usurio.
O comando CDP no gera comprovante e a Automao Comercial no deve gerar um arquivo de
confirmao.
Este comando est desvinculado de uma operao de TEF, e pode ser utilizado tambm para
vendas com forma de pagamento no tratada pelo Pay&Go (tipicamente, dinheiro).
Caso este comando seja seguido por uma operao de TEF, o Pay&Go no utilizar
automaticamente a informao capturada. Para que o CPF digitado seja utilizado pelo Pay&Go
(por exemplo, para pontuao de programa de fidelizao), este deve ser informado no arquivo
correspondente ao comando CRT ou ADM. Isso permite que sejam utilizados CPF distintos na
venda e na fidelizao.
24 / 34
6.
Verso 2.11 (13 jun 2014)
Formato dos arquivos trocados

Esta seo detalha o formato dos arquivos trocados entre a Automao Comercial e o Pay&Go.
6.1. Formato genrico

Todos os arquivos so de texto, compostos de vrias linhas.
Cada linha terminada pelos caracteres CR (carriage return, ASCII hexadecimal 0Dh, decimal 13) e LF
(line feed, ASCII 0Ah, decimal 10).
Exceto por estes dois caracteres de controle, os demais caracteres pertencem faixa de caracteres
ASCII de 20h (decimal 32) a 7Eh (decimal 126), no sendo permitidos caracteres acentuados.
Cada linha do arquivo dedicada a um campo especfico, e segue o formato:
AAA-BBB = CCCCC...CCCCC
... onde:
AAA identificador (nmero) do campo;
BBB o ndice de repetio do campo, para campos de mltiplos registros;
CCCCC...CCCCC o contedo do campo;
O smbolo = (igual) sempre precedido e seguido por um caractere espao (20h, decimal 32).
6.2. Comandos existentes

O primeiro campo 000-000 identifica o propsito do arquivo, ou seja, o comando executado (no caso
de uma resposta do Pay&Go) ou a ser executado (no caso de uma solicitao da Automao
Comercial).
Como visto no captulo anterior, existem 6 tipos de comando possveis, listados na tabela abaixo, que
ainda identifica se o comando gera um arquivo de status (Resp\intpos.sts) e um arquivo de
resposta (Resp\intpos.001):
Comando
Status
Resposta
ATV
CRT
Realiza uma transao de Venda
ADM
Realiza uma transao Administrativa
CNC
Realiza uma transao de Cancelamento
CNF
Confirma a ltima transao realizada
NCN
Desfaz a ltima transao realizada
CDP
Descrio
Verifica se o Pay&Go est ativo
Captura um dado pessoal no PIN-pad
25 / 34
Verso 2.11 (13 jun 2014)
Observao: os comandos CNF e NCN somente devem ser gerados pela Automao Comercial
quando a ltima transao CRT, ADM ou CNC foi realizada com sucesso (campo 009-000 igual a
zero) e:
O campo 729-000 est presente e indica a necessidade de confirmao; ou
O campo 729-000 est ausente e a transao gerou comprovantes (para compatibilidade com
verses anteriores de especificao).
6.3. Campos previstos para cada comando

As tabelas a seguir identificam os campos presentes para cada arquivo (solicitao, status ou
resposta) e comando.
Legenda:
M indica que a presena do campo obrigatria;
O indica que a presena do campo opcional;
E indica que o campo ecoado (idntico ao arquivo de solicitao);
C1 indica que o campo est presente caso a transao tenha sido bem sucedida
(campo 009-000 = 0);
C2 indica que o campo est presente caso a transao seja parcelada
(de acordo com o campo 732-000);
C3 indica que o campo est presente caso a transao seja pr-datada
(de acordo com o campo 732-000);
C4 indica que o campo est presente caso o campo anterior seja diferente de zero (tamanho do
comprovante);
C5 indica que a presena do campo obrigatria, mesmo que o valor seja nulo, no setor de
alimentao (bares, restaurantes e lanchonetes);
C6 indica que a presena do campo obrigatria para aquisio de passagens areas, martimas
e terrestres.
A ausncia de caractere em uma coluna indica que o campo no esperado.
Importante: Caso o arquivo de resposta contenha campos desconhecidos ou no esperados pela
Automao Comercial, esta deve ignor-los sem acusar erro. Isto permite que informaes adicionais
sejam futuramente retornadas pelo Pay&Go, mantendo compatibilidade com verses de Automao
Comercial anteriores nova especificao.
6.3.1. Arquivo de solicitao (Req\intpos.001)

Cdigo
Nome
ATV
CRT
ADM
CNC
CNF
NCN
CDP
000-000
Comando
001-000
Identificao
002-000
Documento fiscal
003-000
Valor total
004-000
Moeda
006-000
Entidade Cliente
26 / 34
Cdigo
Nome
007-000
CRT
ADM
CNC
Identificador Cliente
010-000
Rede Adquirente
012-000
NSU
013-000
Cdigo de autorizao
018-000
Qtde. parcelas
022-000
Data no comprovante
023-000
Hora no comprovante
024-000
Data pr-datado
027-000
Cdigo de controle
702-000
ndice do Estabelecimento
706-000
Capacidades da Automao
716-000
Empresa da Automao
717-000
Data/hora fiscal
722-000
Dados adicionais #1
723-000
Dados adicionais #2
724-000
Dados adicionais #3
725-000
Dados adicionais #4
726-000
Idioma do Cliente
727-000
Taxa de servio
C5
728-000
Taxa de embarque
C6
730-000
Operao
731-000
Tipo de carto
732-000
Tipo de financiamento
733-000
Verso da interface
735-000
Nome da Automao
736-000
Verso da Automao
738-000
Registro de Certificao
999-999
Registro finalizador
ATV
Verso 2.11 (13 jun 2014)
C2
C3
C2
C3
CNF
NCN
CDP
C2
C3
27 / 34
Verso 2.11 (13 jun 2014)
6.3.2. Arquivo de status (Resp\intpos.sts)

Cdigo
Nome
ATV
CRT
ADM
CNC
CNF
NCN
CDP
000-000
Comando
ME
ME
ME
ME
ME
ME
ME
001-000
Identificao
ME
ME
ME
ME
ME
ME
ME
999-999
Todos os campos do arquivo de status tm o mesmo valor do arquivo de solicitao.
6.3.3. Arquivo de resposta (Resp\intpos.001)

Cdigo
Nome
CRT
ADM
CNC
CDP
000-000
Comando
ME
ME
ME
ME
001-000
Identificao
ME
ME
ME
ME
002-000
Documento fiscal
OE
OE
OE
003-000
Valor total
004-000
Moeda
006-000
Entidade Cliente
ME
007-000
Identificador Cliente
C1
009-000
Status
010-000
Rede Adquirente
C1
C1
C1
011-000
Tipo de transao
C1
C1
C1
012-000
NSU
C1
C1
013-000
Cdigo de autorizao
017-000
Tipo de parcelamento
C2
C2
018-000
Qtde. parcelas
C2
C2
022-000
Data no comprovante
C1
C1
023-000
Hora no comprovante
C1
C1
024-000
Data pr-datado
C3
C3
025-000
NSU original
C1
026-000
Data/hora rede original
C1
027-000
Cdigo de controle
C1
C1
028-000
Tamanho via nica
029-xxx
Via nica do comprovante
C4
C4
C4
030-000
Mensagem operador
28 / 34
Verso 2.11 (13 jun 2014)
Cdigo
Nome
CRT
ADM
CNC
040-000
Nome do carto ou da administradora
707-000
Valor original
708-000
Valor do troco
709-000
Valor do desconto
710-000
Tamanho cupom reduzido
711-xxx
Cupom reduzido
C4
C4
C4
712-000
Tamanho via Cliente
713-xxx
Via Cliente do comprovante
C4
C4
C4
714-000
Tamanho via Estabelecimento
715-xxx
Via Estabelecimento do comprovante
C4
C4
C4
718-000
Nmero lgico do terminal
C1
C1
719-000
Cdigo do estabelecimento
C1
C1
729-000
Status da confirmao
C1
C1
C1
730-000
Operao
C1
C1
C1
731-000
Tipo de carto
C1
732-000
Tipo de financiamento
C1
737-000
Vias de comprovante
C1
C1
C1
999-999
CDP
6.4. Detalhamento dos campos

A tabela a seguir detalha o contedo de cada campo previsto por esta especificao.
Legenda para a coluna Formato:
n indica um campo contendo exclusivamente caracteres numricos;
a indica um campo podendo conter qualquer caractere permitido, de acordo com 6.1. Formato
genrico;
a7 indica um campo de exatamente 7 caracteres;
a..5 indica um campo de 1 a 5 caracteres.
Cdigo
000-000
001-000
Nome
Comando
Identificao
Formato
a3
n..10
Descrio
Identifica o propsito do arquivo, conforme 6.2. Comandos
existentes.
Nmero de controle gerado pela Automao Comercial, devendo
o valor ser diferente para cada nova operao de TEF. ecoado
pelo Pay&Go nos arquivos de status e de resposta, e deve ser
consistido pelo Automao Comercial.
29 / 34
Cdigo
002-000
Nome
Documento fiscal
Formato
n..12
Verso 2.11 (13 jun 2014)
Descrio
Nmero do documento fiscal ao qual a operao de TEF est
vinculada. Caso seja usada uma Impressora Fiscal, o
preenchimento deste campo obrigatrio para transaes de
venda.
Valor total da operao, em centavos da moeda informada no
campo 004-000, incluindo todas as taxas cobradas do Cliente
(servio, embarque, etc.).
003-000
Valor total
004-000
Moeda
006-000
Entidade Cliente
n..12
No arquivo de resposta para transaes de venda, este campo

indica o valor efetivamente debitado do Cliente e creditado para o
Estabelecimento (desconsiderando taxas referentes ao uso da
soluo, descontadas pela Rede Adquirente).
n1
0: Real
1: Dlar americano
a1
Forma de identificao do Cliente:

F: CPF
J: CNPJ
X: Outro identificador, gerenciado pelo estabelecimento.
Identificador do Cliente (somente nmeros, sem formatao), de
acordo com o campo 006-000, obrigatrio caso este campo esteja
presente.
007-000
Identificador
Cliente
n..16
009-000
Status
a..3
Indica o resultado final da operao de TEF:

0: operao bem sucedida, ou transao aprovada;
qualquer outro valor: erro na transao, ou transao negada.
a..8
Nome da Rede Adquirente que processou a transao, por

exemplo: VISANET (Cielo), REDECARD (Rede), BANRISUL, GETNET,
ELAVON, CSHOP (Credi-Shop), TRIBANCO (Tricard), POLICARD,
FANCARD, BCARD (BaneseCard), COOPERCR (CooperCred),
VLCARD (ValeCard), TKTCAR (Ticket Car).
Para compatibilidade com verses futuras do produto (por
exemplo, incluso de novas redes), a Automao Comercial no
deve consistir este campo, somente armazen-lo para consulta ou
agrupamento de transaes.
Pelo mesmo motivo, recomendado no preencher este campo
no arquivo de solicitao para os comandos CRT e ADM. Caso seja
preenchido, o Pay&Go processar a transao atravs da rede
informada, sem apresentar o menu de seleo da Rede
Adquirente.
010-000
Rede Adquirente
Caso informado pela Automao Comercial, este dado poder ser

utilizado pelo Pay&Go para transaes que requeiram esta
informao (por exemplo, fidelizao), evitando assim uma dupla
digitao na Automao Comercial e no Pay&Go.
30 / 34
Cdigo
Nome
Formato
n2
Verso 2.11 (13 jun 2014)
Descrio
Venda ou cancelamento (de acordo com o campo 000-000):
10: Carto de crdito vista
11: Carto de crdito parcelado pelo Estabelecimento
12: Carto de crdito parcelado pelo Emissor
20: Carto de dbito vista
22: Carto de dbito parcelado pelo Estabelecimento
21: Carto de dbito pr-datado
24: Carto de dbito pr-datado forada
40: CDC / dbito parcelado pelo Emissor
60: Voucher / PAT
30: Outro tipo de carto
99: No definido (a operao no foi concluda)
Operao administrativa:
13: Pr-autorizao com carto de crdito
41: Consulta CDC / dbito parcelado pelo Emissor
70: Consulta de cheque
71: Garantia de cheque
01: Fechamento / Finalizao
00: Outra operao administrativa
Este campo obsoleto, foi substitudo pelos campos 730-000,
731-000 e 732-000.
011-000
Tipo de transao
012-000
NSU
a..12
Identificador nico da transao, atribudo pela Rede Adquirente.
013-000
Cdigo de
autorizao
a..6
Cdigo de autorizao, atribudo pelo Emissor.
017-000
Tipo de
parcelamento
n1
0: parcelado pelo Estabelecimento;

1: parcelado pelo Emissor.
Este campo obsoleto, foi substitudo pelo campo 732-000.
018-000
Qtde. parcelas
n..2
Quantidade de parcelas, para transaes parceladas.
022-000
Data no
comprovante
n8
Formato DDMMAAAA.
023-000
Hora no
comprovante
n6
Formato hhmmss.
024-000
Data pr-datado
n8
Data de agendamento da transao. Formato DDMMAAAA.
025-000
NSU original
a..12
Campo 012-000 correspondente transao original, para

transao cancelada.
026-000
Data/hora rede
original
n10
Data/hora da transao original, para transao cancelada.

Formato DDMMhhmmss.
027-000
Cdigo de controle
a..30
Identificador nico da transao gerado pelo Pay&Go.
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 nmero da linha, de 001 at a quantidade total de
linhas indicada pelo campo 028-000.
030-000
Mensagem
operador
a..40
Mensagem de texto que deve ser apresentada ao operador do

sistema pela Automao Comercial.
31 / 34
Cdigo
040-000
702-000
Nome
Nome do carto ou
da administradora
ndice do
Estabelecimento
Verso 2.11 (13 jun 2014)
Formato
Descrio
a..12
Nome do carto ou do Emissor. O mesmo carto pode ter nomes

diferentes de acordo com a Rede Adquirente utilizada.
Por motivo de compatibilidade, a Automao Comercial no deve
consistir este campo, somente armazen-lo para consulta ou
agrupamento de transaes.
n..2
ndice do Estabelecimento, iniciado em 0.

Exclusivamente para o produto Pay&Go, em instalaes especficas
onde um mesmo Checkout pode realizar transaes para vrios
Estabelecimentos. Este nmero acrescentado porta TCP
configurada no Pay&Go Cliente, para conexo ao Pay&Go
Servidor.
Soma dos seguintes valores, identificando as funcionalidades
suportadas pela Automao Comercial:
706-000
Capacidades da
Automao
n..3
1: funcionalidade de troco (ver campo 708-000)

2: funcionalidade de desconto (ver campo 709-000)
4: valor fixo, sempre incluir
8: vias diferenciadas do comprovante para
Cliente/Estabelecimento (campos 712-000 a 715-000)
16: cupom reduzido (campos 710-000 e 711-000)
Caso este campo no seja informado pela Automao Comercial
(verses anteriores), considera-se que nenhuma das
funcionalidades suportada.
Importante: na certificao da CIELO, exigido que a Automao
Comercial implemente a funcionalidade de desconto.
Valor original da transao informado pela Automao Comercial
no campo 003-000 do arquivo de solicitao, em centavos da
moeda identificada no campo 004-000.
707-000
708-000
Valor original
Valor do troco
n12
Este campo informado pelo Pay&Go caso seja diferente do valor

final da transao informado no campo 003-000 do arquivo de
resposta, sempre respeitando a regra abaixo:
Valor total (003-000) = Valor original (707-000) +
Valor do troco (708-000) Valor do desconto (709-000)
n12
Valor de retirada em dinheiro (saque no carto) realizada em

conjunto com a transao de venda, em centavos da moeda
informada no campo 004-000.
Este valor acrescido ao valor original da transao, 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 transao de venda, em centavos da
moeda informada no campo 004-000.
Este valor retirado do valor original da transao, e deve ser
registrado na Impressora Fiscal como desconto.
710-000
Tamanho cupom
reduzido
n..3
Quantidade de linhas do cupom reduzido.
32 / 34
Cdigo
Nome
Formato
Verso 2.11 (13 jun 2014)
Descrio
711-xxx
Cupom reduzido
a..40
Linha do cupom reduzido, entre aspas duplas.

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.

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.

716-000
Empresa da
Automao
a..40
Razo social da empresa responsvel pelo desenvolvimento da

aplicao de Automao Comercial.
Exemplo: KND SISTEMAS LTDA.
Data/hora registrada no cupom fiscal, no formato
AAMMDDhhmmss
717-000
Data/hora fiscal
n12
718-000
Nmero lgico do
terminal
a..50
Identificao do terminal.
719-000
Cdigo do
estabelecimento
a..50
Identificao do estabelecimento.
Caso seja usada uma Impressora Fiscal, o preenchimento deste

campo obrigatrio para transaes de venda.
722-000
Dados adicionais #1
a..128
Informaes adicionais sob controle da Automao Comercial,

para registro no histrico de transaes do Pay&Go.
Caso a Rede Adquirente suporte esta funcionalidade, este dado
aparece como dado adicional do estabelecimento no extrato
eletrnico.
723-000
Dados adicionais #2
a..128

724-000
Dados adicionais #3
a..128

725-000
Dados adicionais #4
a..128

726-000
Idioma do Cliente
a2
Idioma a ser utilizado para a interface com o Cliente

(especialmente para autoatendimento):
pt: portugus (valor padro)
en: ingls
es: espanhol
33 / 34
Cdigo
727-000
728-000
Nome
Taxa de servio
Taxa de embarque
Formato
n..12
n..12
Verso 2.11 (13 jun 2014)
Descrio
Valor correspondente taxa de servio cobrada adicionalmente
aos produtos adquiridos, tipicamente no setor de alimentao
(gorjeta), em centavos da moeda informada no campo 004-000.
Este valor includo no valor total informado no campo 003-000.
Valor correspondente s taxas cobradas pelos aeroportos, portos,
rodovirias, etc. adicionalmente ao valor da passagem adquirida,
em centavos da moeda informada no campo 004-000.
Este valor includo no valor total informado no campo 003-000.
Indica o status da confirmao da transao, para transaes bem
sucedidas (campo 009-000 = 0):
729-000
730-000
Status da
confirmao
Operao
n1
n..2
1: transao no requer confirmao, ou j confirmada

2: transao requer confirmao
Para manter compatibilidade com verses de especificao
anteriores, caso este campo no esteja presente no arquivo de
resposta, assumir que a transao requer confirmao se houver
comprovantes a serem impressos.
1: venda (pagamento com carto)
51: cancelamento de venda / reembolso
2: pr-autorizao
52: cancelamento de pr-autorizao
3: consulta do carto (de saldo, financiamento, etc.)
4: consulta de cheque
5: garantia de cheque
6: saque
8: doao (em dinheiro)
9: doao (com carto)
10: pagamento de conta/boleto/fatura (em dinheiro)
60: cancelamento de pagamento de conta (dinheiro)
11: pagamento de conta/boleto/fatura (com carto)
61: cancelamento de pagamento de conta (carto)
12: compra de crditos / recarga de celular pr-pago (em dinheiro)
13: compra de crditos / recarga de celular pr-pago (com carto)
48: fechamento/finalizao
49: outra operao administrativa
resposta, verificar o campo 011-000.
34 / 34
Cdigo
Nome
Formato
Verso 2.11 (13 jun 2014)
Descrio
Modalidade da transao com carto:
0: qualquer / no definido (padro)
1: crdito
2: dbito
3: voucher
731-000
Tipo de carto
n..2
Importante: para compatibilidade com evolues futuras, caso a

Automao Comercial capture esta informao antes de acionar o
Pay&Go, sempre deve oferecer para o usurio uma opo outro
que alimente este campo com o valor 0.
resposta, verificar o campo 011-000.
732-000
Tipo de
financiamento
n..2
Modalidade de financiamento da transao:

0: qualquer / no definido (padro)
1: vista
2: parcelado pelo Emissor
3: parcelado pelo Estabelecimento
4: pr-datado
5: pr-datado forado
resposta, verificar os campos 011-000 e 017-000.
733-000
Verso da interface
n..3
Valor fixo, identificando a verso deste documento implementada

pela Automao Comercial (somente nmeros, por exemplo, 210
para v2.10).
734-000
Grupo de
transaes
n..10
(reservado para uso futuro)

Para pagamento com mltiplos cartes, este campo deve conter o
mesmo valor do campo 001-000 da primeira transao, e ser
repetido com este mesmo valor a cada nova transao enquanto
no for finalizado o pagamento em curso.
Para confirmar ou desfazer o grupo de transaes, um nico
comando CNF ou NCN gerado, incluindo nos campos 010-xxx e
027-xxx (e, eventualmente, 702-xxx) os valores correspondentes
s transaes sendo confirmadas/desfeitas, na ordem em que
foram realizadas.
735-000
Nome da
Automao
a..40
Nome da aplicao de Automao Comercial.
736-000
Verso da
Automao
a..20
Verso da aplicao de Automao Comercial, conforme

nomenclatura utilizada pelo desenvolvedor.
35 / 34
Cdigo
Nome
737-000
Vias de
comprovantes
738-000
Registro de
Certificao
999-999
Formato
n1
a..20
n1
Verso 2.11 (13 jun 2014)
Descrio
Indica quais vias devem ser impressas:
0: no h comprovante
1: imprimir somente a via do Cliente
2: imprimir somente a via do Estabelecimento
3: imprimir ambas as vias do Cliente e do Estabelecimento
resposta, assumir o valor:
0 se o campo 028-000 estiver igual a zero;
3 se o campo 028-000 estiver diferente de zero.
Cdigo obtido junto NTK Solutions no incio do processo de
certificao da Automao Comercial.
Contedo fixo: 0 (zero)
6.5. Exemplos de arquivos

6.5.1. Solicitao de venda (Req\intpos.001)
000-000
001-000
002-000
003-000
004-000
706-000
716-000
717-000
733-000
735-000
736-000
738-000
999-999
=
=
=
=
=
=
=
=
=
=
=
=
=
CRT
34430576
223546
10000
0
3
SETIS AUTOMACAO E SISTEMAS LTDA.
110117190534
210
KiWi
v1, 14, 0, 0
G45J35G3JH45B435
0
6.5.2. Status de venda (Resp\intpos.sts)

000-000 = CRT
001-000 = 34430576
999-999 = 0
6.5.3. Resposta de venda (Resp\intpos.001)

000-000
001-000
002-000
003-000
004-000
009-000
010-000
=
=
=
=
=
=
=
CRT
34430576
223546
12000
0
0
NOVAREDE
36 / 34
011-000
012-000
013-000
015-000
016-000
022-000
023-000
027-000
028-000
029-001
029-002
029-003
029-004
029-005
029-006
029-007
029-008
029-009
029-010
029-011
029-012
029-013
029-014
029-015
029-016
029-017
029-018
030-000
040-000
707-000
708-000
710-000
711-001
711-002
711-003
711-004
712-000
713-001
713-002
713-003
713-004
713-005
713-006
713-007
713-008
713-009
713-010
713-011
713-012
713-013
713-014
713-015
713-016
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
Verso 2.11 (13 jun 2014)
20
19100205783
022167
1701191002
1701191002
17012011
191002
11011719100219100205783
18
"
*** DEMONSTRACAO PAY&GO ***"
"
COMPROVANTE DE TEF"
"
"
"
ESTABELECIMENTO DE TESTE"
"
823982346832235/03876463"
"
"
"
17/01/2011
19:10:02"
"
REF.FISCAL:223546"
"
DOC:026982
AUTORIZ:022167"
"
REF.HOST:19100205783"
"
"
"
DEMOCARD
************1111"
"
VENDA DEBITO A VISTA"
"
VALOR FINAL: R$ 120,00"
"
SAQUE: R$ 20,00"
"
"
"
TRANSACAO AUTORIZADA MEDIANTE"
"
USO DA SENHA PESSOAL."
AUTORIZADA 022167
DEMOCARD
10000
2000
4
"DEMOCARD
************1111"
"POS:03876463 DOC:026982 AUTORIZ:022167"
"VENDA DEBITO A VISTA"
"VALOR FINAL: R$ 120,00"
16
"
"
COMPROVANTE DE TEF"
"
VIA: CLIENTE"
"
"
"
"
823982346832235/03876463"
"
"
"
17/01/2011
19:10:02"
"
REF.FISCAL:34430576"
"
DOC:026982
AUTORIZ:022167"
"
REF.HOST:19100205783"
"
"
"
DEMOCARD
************1111"
"
"
"
SAQUE: R$ 20,00"
37 / 34
714-000
715-001
715-002
715-003
715-004
715-005
715-006
715-007
715-008
715-009
715-010
715-011
715-012
715-013
715-014
715-015
715-016
715-017
715-018
715-019
718-000
719-000
729-000
730-000
731-000
732-000
737-000
999-999
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
Verso 2.11 (13 jun 2014)
19
"
"
COMPROVANTE DE TEF"
"
VIA: ESTABELECIMENTO"
"
"
"
"
823982346832235/03876463"
"
"
"
17/01/2011
19:10:02"
"
REF.FISCAL:34430576"
"
DOC:026982
AUTORIZ:022167"
"
REF.HOST:19100205783"
"
"
"
DEMOCARD
************1111"
"
"
"
SAQUE: R$ 20,00"
"
"
"
TRANSACAO AUTORIZADA MEDIANTE"
"
USO DA SENHA PESSOAL."
03876463
823982346832235
2
1
2
1
3
0
6.5.4. Confirmao de venda (Req\intpos.001)

000-000
001-000
002-000
010-000
027-000
733-000
735-000
736-000
738-000
999-999
=
=
=
=
=
=
=
=
=
=
CNF
34430576
223546
NOVAREDE
11011719100219100205783
210
KiWi
v1, 14, 0, 0
G45J35G3JH45B435
0
6.5.5. Status de confirmao (Resp\intpos.sts)

000-000 = CNF
001-000 = 34430576
999-999 = 0
38 / 34

1 - PGCliWin - Interface Com A Automação Comercial - v2.11 PDF

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

1 - PGCliWin - Interface Com A Automação Comercial - v2.11 PDF

Hochgeladen von

Copyright:

Verfügbare Formate

Pay&Go Cliente Windows

Especificao Tcnica da interface com

Copyright 2006-2014 SETIS Automao e Sistemas Ltda.

- Novo campo: identificao da aplicao de Automao Comercial.

- Alterao no tamanho dos campos 012 e 027

- Incluso dos campos 704 e 705 (assinatura da Automao)

- Incluso da soluo Plug&Pay

- Incorporadas as definies do documento original Guia Tcnico da

- Acrescentado comando de Consulta de cheque

Alexandre Nishiyama - Incluso dos campos 718 e 719

- Correo do registro finalizador 999-999

- A funcionalidade de desconto exigida na certificao CIELO

- Incluso do comando CDP (captura de dado pessoal no PIN-pad)

- Incluso do campo 738-000

6.3.1. Arquivo de solicitao (Req\intpos.001) ..................................................................................26

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

Sobre este documento

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

O Pay&Go um sistema certificado pelas principais Redes adquirentes brasileiras

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

Sistema operacional (Windows)

Interface objeto desta especificao

Um executvel independente (Pay&Go Cliente) roda no Checkout e responsvel por toda a

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

4.1. Dinmica de operao

4.2. Fluxo de uma transao

Registra os dados da venda

Monitora o diretrio de comandos

Monitora o diretrio de retornos

SETIS Automao e Sistemas / NTK Solutions

Apaga o arquivo de Comando

Apaga o arquivo de Confirmao

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

4.3. Tipos de transao

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

Comprovante reduzido: Somente contm as informaes relevantes para o Cliente, excluindo

4.5. Diretrios para troca de arquivos

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

C:\TEF_Disc para acionar as redes BANRISUL, TRICARD, POLICARD e VALECARD (e outras

4.5.2. Regras de uso

SETIS Automao e Sistemas / NTK Solutions

Pay&Go Cliente Windows - Especificao Tcnica da interface com a Automao Comercial

Verso 2.11 (13 jun 2014)

Fluxos da Automao Comercial

5.1. Transao de Venda simples

AC totaliza cupom fiscal

AC processa forma de pagamento

outra forma de pagamento