manual de interligação via api rest ou arquivo txt

71
Manual de Interligação via API REST ou Arquivo TXT

Upload: others

Post on 29-Jul-2022

30 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Manual de Interligação via API REST ou Arquivo TXT

Manual de Interligação via API REST ou Arquivo TXT

Page 2: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 1 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Sumário Atualizações .............................................................................................................................................................................................. 3

Histórico de alterações.................................................................................................................................................................... 3

CAPÍTULO 1 .................................................................................................................................................................................................. 5

API REST ......................................................................................................................................................................................................... 5

1.1. Objetivos............................................................................................................................................................................................................. 5

1.2. Requisitos .......................................................................................................................................................................................................... 5

1.3. Cadastro de Token via GZ Serviços....................................................................................................................................................... 6

CAPÍTULO 2 .................................................................................................................................................................................................. 9

Integração via Arquivo TXT .................................................................................................................................................................. 9

2.1. Objetivos............................................................................................................................................................................................................. 9

2.2. Observações...................................................................................................................................................................................................... 9

2.3. Estrutura dos arquivos ............................................................................................................................................................................ 10

2.3.1. VENDEDOR.TXT (Cadastro de Vendedor) ................................................................................................................................ 10

2.3.2. LISTANEG.TXT (Cadastro de Lista Negra) ............................................................................................................................... 10

2.3.3. LIMITPRE.TXT (Saldo em Aberto de Cheques por CGC/CPF) ........................................................................................ 11

2.3.4. EMPRESA.TXT ( Cadastro de Empresa Conveniada ) .......................................................................................................... 11

2.3.5. CLIENTEC.TXT (Cadastro de Cliente Conveniado)............................................................................................................... 14

2.3.6. CLIENTES.TXT (Cadastro de Clientes) ....................................................................................................................................... 16

2.3.7. CLIENTES.TXT (Cadastro de Clientes - Continuação) ......................................................................................................... 18

2.3.8. BARRAREL.TXT (Código de Barras Relacionadas - Produtos com vários códigos de barras) ........................... 20

2.3.9. FORMULA.TXT (Fórmula – Produto composto de diversos itens. Exemplo: Cesta Básica) ................................ 20

2.3.10. VASILHAME.TXT (Vasilhame – Controle de Vasilhame por Produto) ........................................................................ 21

2.3.11. ARMACAO.TXT (Cadastro de Armação de Produto)............................................................................................................ 21

2.3.12. GRUPO.TXT (Cadastro de Grupo de Produto) .......................................................................................................................... 21

2.3.13. DEPTO.TXT (Cadastro de Departamento de Produto) ........................................................................................................... 21

2.3.14. MARCA.TXT (Cadastro de Marca de Produto)......................................................................................................................... 21

2.3.15. LISTAPRE.TXT (Lista de Preços) .................................................................................................................................................. 21

2.3.16. SIMILAR.TXT (Produtos Similares) .............................................................................................................................................. 23

2.3.17. ALTPRECO.TXT (Alteração de Preço) ........................................................................................................................................ 23

2.3.18. TABPVDQT.TXT (Parâmetro de Produto/Preço/Múltiplos) ............................................................................................... 23

2.3.19. TABPRECO.TXT (Tabela de Preços) ............................................................................................................................................ 24

2.3.20. TABFPAG.TXT (Parâmetro de Cliente/Tabela/Finalizadores) ........................................................................................... 24

Page 3: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 2 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.21. PROMCAM.TXT (Promoção Campanha) ................................................................................................................................... 25

2.3.22. ESTOQUE.TXT e ESTOQUEMIX.TXT (Cadastro de Produtos Monoloja e Multiloja) ........................................ 26

2.3.23. ESTOQUE.TXT (Cadastro de Produtos - Continuação) ........................................................................................................ 29

2.3.24 BALCAO.TXT (Pedido de Balcão)................................................................................................................................................. 34

2.3.25 TITULOS.TXT (Títulos / Parcelas / Contas a Receber) ......................................................................................................... 37

2.3.26 LISTACAS.TXT (Lista de Casamento) ......................................................................................................................................... 37

2.3.27 MOVIMENTO ANALITICO GERADO PELO FRENTE DE LOJA / CONCENTRADOR PARA A

RETAGUARDA (MOVOUTRA.TXT) ............................................................................................................................................................. 38

2.3.28 LOG DE MOVIMENTO AUTOMÁTICO GERADO PELO FRENTE DE LOJA PARA A RETAGUARDA

(lvxxxxxx.ccc) ............................................................................................................................................................................................................... 49

2.3.29 MOVIMENTO SINTÉTICO GERADO PELO CONCENTRADOR PARA A RETAGUARDA

(MOVSINT.TXT)........................................................................................................................................................................................................ 50

2.3.30 INVENTARIO GERADO PELO FRENTE DE LOJA / CONCENTRADOR (CONTAGEM.TXT) ................ 50

2.3.31 CHECAGEM DE PREÇOS GERADO PELO FRENTE DE LOJA / CONCENTRADOR

(MATABURO.TXT) .................................................................................................................................................................................................. 51

2.3.32 MAPA RESUMO ECF GERADO PELO FRENTE DE LOJA OU PELO CONCENTRADOR PARA A

RETAGUARDA (MAPAECF.TXT) .................................................................................................................................................................. 52

2.3.33 TABELA 1 - REDE DESTINO DA TRANSAÇÃO (TEF) .................................................................................................. 53

2.3.34 TABELA 2 - CÓDIGOS DE SITUAÇÃO TRIBUTÁRIA ................................................................................................... 55

2.3.35 TABELA 3 – TIPO DA TRANSAÇÃO TEF ............................................................................................................................. 56

2.3.36 TABELA 4 – TIPO DO PARCELAMENTO TEF ................................................................................................................... 57

2.3.37 TABELA 5 – BANDEIRAS DE CARTÃO DE CRÉDITO/DÉBITO ............................................................................. 57

2.3.38 EFETUANDO IMPORTAÇÃO E CARGA AUTOMÁTICA PELA PRÓPRIA RETAGUARDA ................... 58

2.3.39 INTERLIGAÇÃO GZ POSTO (LMC.TXT) ............................................................................................................................... 60

2.3.40 MOVIMENTO ANALÍTICO FISCAL GERADO PELO FRENTE DE LOJA/CONCENTRADOR PARA A

RETAGUARDA (MOVOUTRA_FISCAL.TXT) ......................................................................................................................................... 65

2.3.41 NFC-E INUTILIZADA (NFCEINUT.TXT) ............................................................................................................................... 67

2.3.42 CUPOM PROMOCIONAL (CUPPROM.TXT) ........................................................................................................................ 67

2.3.43 CUPOM PROMOCIONAL TEXTO (CUPPROMTEXTO.TXT) ..................................................................................... 68

2.3.44 INFORMAÇÃO NUTRICIONAL (INFONUTRI.TXT) ....................................................................................................... 68

Page 4: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 3 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Atualizações

Versões atualizadas deste manual sempre estarão disponíveis no Painel GZ Sistemas em Arquivos >

Documentos > Manuais de Sistema > TI e Infra > Documentação – Interligação GZ.

Caso você não possua acesso ao Painel, solicite o documento a um de nossos analistas através do telefone (11)

3308-8199.

Histórico de alterações

Versão Pacote Flex

Versão GZ Serviços

Data Descrição

12.05 02/12/2009 Criação do campo acréscimo do item na tabela MOVOUTRA.TXT

Alteração do campo Número do Pedido para Número da PV / Comanda na tabela BALCAO

Criação do campo Número Seqüencial do DAV / Pedido na tabela BALCAO

10/12/2009 Criação do campo Número do DAV / Pedido na tabela MOVOUTRA.TXT

Alteração do campo Número do Pedido para Número da PV / Comanda na tabela MOVOUTRA.TXT

Criação do campo Título do DAV / Pedido na tabela MOVOUTRA.TXT

Criação do campo Título do DAV / Pedido na tabela BALCAO

12.06 17/01/2010 Criação do campo Observação para cupom fiscal na tabela BALCAO

18/01/2010 Criação do registro tipo 17 ( Dados para geração de registro R06 – Ato Cotepe 06/08 ) na tabela MOVOUTRA.TXT

Tabelas TABPRECO.TXT (Tabela de Preços) e TABFPAG.TXT (Parâmetro de Cliente/Tabela/Finalizadores) foram descontinuadas na versão Flex.

Criado nova tabela ALTPRECO.TXT (Alteração de Preço). Somente para FlexPDV.

12.07 09/02/2010 Alteração do campo Número da PV / Comanda para Comanda na tabela BALCAO.

Criação do campo Número Seqüencial da PV / Comanda na tabela BALCAO.

12.08 30/03/2010 Criação do registro tipo 15 ( Cartão Fidelidade ) na tabela MOVOUTRA.TXT

12.09 29/06/2010 Criação do campo Preço Máximo de Venda ao Consumidor na tabela ESTOQUE.TXT

12.10 22/10/2010 Criação do registro tipo 82 ( Correspondente Bancário – Banco Completo ) na tabela

MOVOUTRA.TXT

12.11 10/05/2011 Criação do campo Desconto Total do Item na tabela BALCAO.

Criação do campo Acréscimo Total do Item na tabela BALCAO.

12.12 10/05/2011 Alteração do número de casas decimais nos campos Desconto Total do Item e

Acréscimo Total do Item na tabela BALCAO.

13.00 29/11/2011 Implementado gravação do código de autorização para as transações de crédito no

campo Número do Cartão (Crédito Rotativo) conforme observação 46.

Alteração do descritivo do registro tipo 40 de Cancelamento Compra Cartão RC para Cancelamento Compra Cartão Próprio / Autorizadores.

Criado gatilho para solicitar ao FlexConcent / FlexBridge, a execução da rotina de importação de carga geral e/ou parcial e posterior carga de tabelas no FlexPDV

conforme explicativo em EFETUANDO IMPORTAÇÃO E CARGA AUTOMÁTICA PELA PRÓPRIA RETAGUARDA.

Criação do registro tipo 18 ( Identificação do Cliente - Lei Anti-Álcool ) na tabela MOVOUTRA.TXT

13.01 30/05/2012 Alteração no descritivo dos campos e nas observações da tabela TITULOS.TXT

13.02 27/09/2012 Tabelas TABPRECO.TXT (Tabela de Preços) e TABFPAG.TXT (Parâmetro de

Cliente/Tabela/Finalizadores) foram implementados na versão Flex.

28/09/2012 Criação do campo Regra para Utilização na tabela TABFPAG.

08/05/2013

Criação do Campo CARGATRIB

Esta informação atende a Lei nº 12.741, de 8 de dezembro de 2012, popularmente conhecida como Lei “De Olho no

Imposto”.

Page 5: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 4 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

13.03 27/03/2014 Inclusão dos campos Bandeira e Instituição no final do layout do arquivo

MOVOUTRA.TXT

13.04 04/08/2014 Alteração na Tabela 5 (Bandeiras de cartão de crédito/débito). Adição dos códigos

para cartões de débito.

20/08/2014 Inclusão do campo Entregável no cadastro de produtos.

04/11/2014

Inclusão de informações sobre o pagamento de conta TecTotal na Observação 19

do arquivo MOVOUTRA.TXT Inclusão de informações sobre o pagamento de conta B2C na Observação 19 do

arquivo MOVOUTRA.TXT

13.05 04/02/2015 Inclusão da carga tributária estadual (Lei de Olho no Imposto)

13.06 21/08/2015 Inclusão dos campos referentes a NFC-e e CF-e (SAT) e novas observações.

03/09/2015 Complemento dos campos a serem usados na NFC-e e SAT no Arquivo

MOVOUTRA.TXT. Verificar campos marcados com * ou **.

13.07 18/11/2015 Adição dos campos de PIS e COFINS no arquivo ESTOQUE.TXT (73 a 76)

13.08 23/11/2015 Adição dos campos de PIS e COFINS no arquivo MOVOUTRA.TXT (106 a 109)

22/03/2016 Criado campo CEST no cadastro de Produtos. Disponível a partir da versão de 28/03/2016.

13.09 05/07/2016 Gravação das informações do CPF de clientes participantes do programa SOU+

16.601.01 28/07/16 Inserido campo loja no arquivo Barrarel.txt

16.601.01 27/09/16 Inserido Campos Valor Unitário de PIS e COFINS (saída)

16.601.01 08/11/16 Inclusão do campo Preço de Custo nas tabelas: MOVOUTRA,ESTOQUE

16.601.01 08/11/16 Inclusão do campo Cartão no Cadastro de Vendedor (identified)

16.601.01 09/12/16 Atualização das informações referentes a integração com posto combustível

16.601.02 06/01/2017 Criação de arquivo de retorno de pagamento de venda balcão (pedido ou comanda)

17.602.01 22/01/2017 Cadastro de Clientes, inclusão do campo ACRESPRAZO

17.602.03 10/03/2017 Inclusão dos campos Preço de Custo

17.602.03 10/03/2017 Criação do Status 36 (abastecimentos) no arquivo MOVOUTRA.TXT

17.602.03 23/03/2017 Exclusão dos campos 08 e 09 do registro L1 do arquivo LMC.TXT

17.602.03 23/03/2017 Inclusão dos campos 07 e 08 no registro L2 do arquivo LMC.TXT

17.602.04 21/08/2017 Inclusão do campo percentual de comissão – ESTOQUE.TXT

17.602.04 21/08/2017 Inclusão do campo valor calculado da comissão – MOVOUTRA.TXT

17.602.04 21/08/2017 Inclusão das informações de SuperTroco

17.800.01 Inclusão do campo Mensagem complementar no cadastro de produtos.

17.800.01 09/10/2017 Inclusão de Integração MultLoja (GESTOR)

17.800.01 03/11/2017 Inclusão de Registro de E-mail Marketing em arquivo MOVOUTRA

12/01/2018 Inclusão do Campo Preço Alterado no Cadastro de Fórmula

13/09/2018 Inclusão do Campo Código de Produto ANP

18/09/2018 Inclusão dos Campos de FCP (Fundo Combate a Pobreza)

19.800.07 19/11/2018 Inclusão Registros: CPF Zoombox / Bonuz Minutrade

19.800.09 12/07/2019 Inclusão do campo Data de alteração – ESTOQUE.TXT

12/07/2019 Criação do status 32 (Taxa de serviço) – MOVOUTRA.TXT

19.800.09 19.03.00 30/08/2019

20.800.12 20.05.40 06/08/2020 Criação dos status 31 (ZoomBox) e 35 (Taxa de entrega) – MOVOUTRA.TXT

20.800.12 20.05.40 06/08/2020 Criação dos campos 113 ao 121 do arquivo MOVOUTRA.TXT

20.800.12 20.05.40 06/08/2020 Criação do arquivo MOVOUTRA_FISCAL.TXT

20.800.12 20.05.40 10/08/2020

Criação dos status 19 (Itens de venda cancelada (PAF)), 33 (Complemento de

produto), 34 (IPTU garantido), 37 (Vias de cupom SuperTroco), 83 (Bônus de cliente) e 99 (Nota A/A1 referenciada no cupom (PAR ER 02.02)).

20.800.12 20.05.40 10/08/2020 Inclusão do campo Código do Vendedor (5 dígitos) e Observação 9 – BALCAO.TXT.

20.800.12 20.06.00 18/08/2020 Criação dos status 39 (Campanha de troco), 49 (Fechamento Scanntech) e 51 (Identificação cliente GIVEX).

20.800.12 20.06.00 01/10/2020 Criação dos itens 31, 32 e 33 no arquivo movoutra_fiscal. Atualização dos itens 23, 24 e 34 do arquivo movoutra. Criação da estrutura NFCEINUT.TXT.

20.800.12 20.06.00 05/11/2020 Adição do Tipo Transação TEF QRCode (Q), criado em versão anterior, na Tabela 3.

20.800.12 20.07.R1 25/11/2020 Criação dos arquivos CUPPROM.TXT e CUPPROMTEXTO.TXT

20.800.13 20.07.R1 20/01/2021 Criação do arquivo INFONUTRI.TXT e adição dos campos 92 e 93 no arquivo

ESTOQUE.TXT.

21.800.14 20.08.R1 30/04/2021 Criação do status 98 (Itens de CF-e Complementar)

21.800.14 21.08.R4 22/07/2021 Criação dos status 46 (Cupom desconto) e 97 (Cupom de uso/consumo)

21.800.14 21.08.R4 29/07/2021 Criação do status 47 (Detalhes de item de pedido integração)

22.800.16 21.10.R1 18/03/2022 Criação do status 53 (Dados do intermediador)

22.800.16 22.10.R2 19/05/2022 Criação do item 18 (Tipo de pedido) no arquivo BALCAO.TXT

Page 6: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 5 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

CAPÍTULO 1

API REST

1.1. Objetivos

• Este capítulo demonstrará configuração das integrações GZ Serviços via API REST.

1.2. Requisitos

• O ambiente cliente deverá estar operando com um dos sistemas Flex da GZ (MercoFlex, MercattoFlex, FlexConcent ou Gestor).

• A API GZ Sistemas é disponibilizada na instalação do GZ Serviços, portanto, o ambiente cliente deve ter o GZ Serviços rodando em sua última versão.

• Ambiente para testes disponível em demo.gzcloud.com.br. Solicite acesso via e-mail para [email protected]

• Para utilização das funções, será necessário cadastrar um token, que será solicitado na integração. Passo a passo do cadastro de token no próximo item.

• Todas as funções desenvolvidas para integração e exemplos estão disponíveis em api.gzcloud.com.br

• A cada nova função desenvolvida, disponibilizaremos no endereço acima a documentação e

exemplos.

Page 7: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 6 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

1.3. Cadastro de Token via GZ Serviços

• Em um navegador, acesse o endereço do seu GZ Serviços. (Instalação e outras configurações do GZ Serviços estão disponíveis no Manual do GZ Serviços no Painel GZ Sistemas.)

• Após logar com usuário e senha, acesse a opção Serviços > Token.

• Clique no botão Novo para cadastrar um token.

Page 8: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 7 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

• Informe a validade (campo não obrigatório), se este token está ativo e quais funções serão utilizadas através dele.

• Em seguida, clique no botão Salvar.

Page 9: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 8 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

• Os tokens cadastrados ficarão disponíveis na tela. Para editar ou excluir um dos tokens, passe o mouse sobre a última coluna e clique na opção Ações e, em seguida, em Editar ou Remover.

Page 10: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 9 www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

CAPÍTULO 2

Integração via Arquivo TXT

2.1. Objetivos

• Este capítulo demonstrará o passo a passo para configuração dos arquivos TXT de integração com

o Flex.

2.2. Observações

• Os registros deverão ser terminados com EOL ( ASC 13 e 10 ).

• Não é obrigatório a terminação do arquivo com EOF ( ASC 26 ).

• Gerar o arquivo com extensão .TXT quando for CARGA GERAL.

• Gerar o arquivo com extensão .ITE quando for CARGA PARCIAL.

• Os campos do tipo Caracter (C) deverão estar alinhados a esquerda com espaços a direita.

• Os campos do tipo Data (D) deverão estar no formato: AAAAMMDD.

• Os campos do tipo Lógico (L) deverão conter T para Verdadeiro e F para Falso.

• Os campos do tipo Numérico sem decimal (N) deverão estar alinhados a direita preenchida com

zeros à esquerda.

• Os campos do tipo Numérico com decimal ( N ) deverão estar alinhados a direita preenchido com

zeros a esquerda e sem o ponto decimal.

• Os campos de Código do Produto (PLU) apesar de serem do tipo Numérico sem decimal (N),

para compatibilidade com versões anteriores, viram alinhados a direita preenchidos com espaços em branco a

esquerda.

• Para geração do arquivo ESTOQUEMIX.TXT seguir a mesma regra de

geração do arquivo ESTOQUE.TXT, informando a loja ao qual o produto pertence.

• Na importação do arquivo ESTOQUEMIX.TXT as informações serão sempre

atualizadas, ou seja, nunca serão apagadas das tabelas de integração.

• DICA: Quando for efetuar a leitura de qualquer arquivo gerado pelo concentrador / frente de

loja, faça a leitura linha por linha (line sequencial) e processe o conteúdo do registro até a posição que a versão

Page 11: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 10

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

da sua retaguarda está preparada, pois o sistema sofre constantes atualizações e os novos recursos são

acrescentados sempre ao final de cada registro.

2.3. Estrutura dos arquivos

2.3.1. VENDEDOR.TXT (Cadastro de Vendedor)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 4 0 1 4

02 Nome Fantasia/Apelido C 15 5 19

03 Nome Completo C 50 20 69

04 Percentual Comissão Sobre a Venda N 5 2 70 74 Percentual Padrão

05 1º Percentual Comissão Sobre a Venda N 5 2 75 79 Finalizador Venda

06 2º Percentual Comissão Sobre a Venda N 5 2 80 84 Finalizador Venda

07 3º Percentual Comissão Sobre a Venda N 5 2 85 89 Finalizador Venda

08 4º Percentual Comissão Sobre a Venda N 5 2 90 94 Finalizador Venda

09 Percentual Desconto Máximo Produto N 5 2 95 99 Vendas Balcão

10 Cartão C 16 0 100 115 Cartão de Identificação

do vendedor

2.3.2. LISTANEG.TXT (Cadastro de Lista Negra)

Campo Tipo Tam Dec Inicio Fim Observação

01 CGC / CPF a ser Bloqueado C 19 1 19 Observação 1

02 Inscrição Estadual / RG C 25 20 44

03 Nome do Titular C 50 45 94

04 Telefone C 25 95 119

05 Observação C 70 120 189

06 Código do Histórico N 1 0 190 190 Observação 2

07 Mensagem na Tela do PDV C 5 191 195

Observação 1: O campo CGC/CPF deverá estar com a máscara. Exemplo:

CPF: 12345678910 123.456.789-10

CPF: 1234567891 012.345.678-91

CGC: 12345678000123 012.345.678/0001-23

CGC: 123456789000123 123.456.789/0001-23

Observação 2: 1. Cheque Sem Fundo

2. Cheque Sustado

3. Cheque Roubado

4. Cheque Furtado

0. Outros

Page 12: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 11

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.3. LIMITPRE.TXT (Saldo em Aberto de Cheques por CGC/CPF)

Campo Tipo Tam Dec Inicio Fim Observação

01 CGC/CPF C 19 1 19 Observação 1

02 Valor Total de Cheques em Aberto N 12 2 20 31

03 Quantidade de Cheques em Aberto N 4 0 32 35

Observação 1: O campo CGC/CPF deverá estar com a máscara. Exemplo:

CPF: 12345678910 123.456.789-10

CPF: 1234567891 012.345.678-91

CGC: 12345678000123 012.345.678/0001-23

CGC: 123456789000123 123.456.789/0001-23

2.3.4. EMPRESA.TXT ( Cadastro de Empresa Conveniada )

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 3 0 1 3

02 Nome Completo C 50 4 53

03 Nome Fantasia / Apelido C 15 54 68

04 Endereço C 60 69 128

05 Bairro C 30 129 158

06 Cidade C 30 159 188

07 Estado (UF) C 2 189 190

08 CEP C 8 191 198

09 Situação C 1 199 199 Observação 1

10 Percentual de Desconto Sobre o Cupom N 4 2 200 203

11 Desconto Sobre Produto em Promoção C 1 204 204 S - Sim / N - Não

12 CGC / CPF C 19 205 223 Observação 2

13 Inscrição Estadual / RG C 25 224 248

14 Reservado - Espaço em Branco C 2 249 250

15 Telefone C 15 251 265

16 Tabela de Preço a Utilizar C 1 266 266 A - Atacado

E - Especial

P - Padrão

17 Nível de Bloqueio N 2 0 267 268 Observação 3

18 Tipo de Bloqueio de Produto C 1 269 269 Observação 4

19 Dados do Bloqueio C 240 270 509 Observação 5

20 Produto Alternativo (PLU) N 20 0 510 529 Observação 6

21 Plano de Pagamento C 30 0 530 559 Observação 7

22 Tipo de Desconto de Produto C 1 560 560 Observação 8

23 Dados do Desconto C 240 561 800 Observação 5

24 Tipo do Endereço C 15 801 815

Rua, Avenida,Travessa, ...

25 Numero do Endereço N 6 0 816 821

26 Complemento C 20 822 841 Casa, Apto, Bloco, ...

Observação 1: L – Liberado

Page 13: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 12

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

B – Bloqueado

N – Negativo

Observação 2: O campo CGC/CPF deverá estar com a máscara. Exemplo:

CPF: 12345678910 123.456.789-10

CPF: 1234567891 012.345.678-91

CGC: 12345678000123 012.345.678/0001-23

CGC: 123456789000123 123.456.789/0001-23

Observação 3: Campo com valor numérico de “00” a “99” com o nível do bloqueio. Este nível será

exibido e poderá ser utilizado com outras opções, onde será definido a necessidade de uma

autorização ou liberação automática.

Observação 4: Este campo é usado para efetuar o bloqueio de determinado (G)rupo,

(D)epartamento ou (M)arca de produto. Deixar em branco caso não haja bloqueio.

Observação 5: O campo deverá conter os códigos do grupo, departamento ou marca de produto alinhado

em 6 dígitos completados com zeros a esquerda caso necessário. Deixar em branco caso

não haja bloqueio: Exemplo:

Bloquear os códigos: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 000001000002000010000015000110000200

Observação 6: Caso o bloqueio esteja ativo, este campo poderá ser usado para definir uma faixa de código

de produto com uma descrição alternativa para o produto, que será utilizada no cupom

fiscal. Deixar em branco caso não haja bloqueio ou caso haja bloqueio e não deva

realmente deixar efetuar a compra do produto.

Exemplo:

a) Criar códigos (PLU) de 90001 a 90090 com descrições de produtos, e no campo

Produto Alternativo (PLU) coloca-se o código 90001, não criar o código

90091 pois assim o sistema saberá que aqui termina a faixa de códigos e automaticamente

voltará ao código inicial ( 90001 ).

b) Quando o sistema processar o produto 555666 com descrição x, cujo produto está

bloqueado para compra, o sistema irá imprimir o produto 555666 com a descrição y (

90001 ), e na próxima ocorrência 90002, 9003, até 90090 e retornar ao 90001.

Para todos os efeitos de relatórios, controles, estatísticos, etc... vale o código original e a

descrição original, a descrição alternativa apenas é utilizada na impressão do cupom fiscal

e não será armazenada para futura necessidade.

Observação 7: O conteúdo deste campo será impresso no comprovante.

Observação 8: Este campo é usado para definir qual(is) (G)rupo,D)epartamento ou (M)arca de produto

podem receber o desconto sobre cupom . Deixar em branco caso não haja regra.

Page 14: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 13

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Page 15: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 14

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.5. CLIENTEC.TXT (Cadastro de Cliente Conveniado)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código da Empresa Conveniada N 3 0 1 3

02 Código do Cliente N 6 0 4 9

03 Matrícula / Registro C 15 10 24

04 Nome Completo C 50 25 74

05 1ª Pessoa Autorizada a Comprar C 50 75 124

06 2ª Pessoa Autorizada a Comprar C 50 125 174

07 3ª Pessoa Autorizada a Comprar C 50 175 224

08 Endereço C 60 225 284

09 Bairro C 30 285 314

10 Cidade C 30 315 344

11 Estado (UF) C 2 345 346

12 CEP C 8 347 354

13 Data de Nascimento D 8 355 362

14 Situação C 1 363 363 Observação 1

15 Limite Total de Crédito para Compra N 12 2 364 375

16 Valor Total das Compras em Aberto N 12 2 376 387

17 Percentual de Desconto Sobre o Cupom N 4 2 388 391 Observação 2

18 Desconto Sobre Produto em Promoção C 1 392 392 S - Sim / N - Não

19 Desconto Geral C 1 393 393 Observação 3

20 Cartão / Código de Barras C 80 394 473

21 Reservado - Espaço em Branco C 40 474 513

22 Pontuação Acumulada (Fidelidade) N 9 0 514 522

23 Reservado - Espaço em Branco C 10 523 532

24 CGC / CPF C 19 533 551 Observação 5

25 Inscrição Estadual / RG C 25 552 576

26 Telefone C 15 577 591

27 Reservado - Espaço em Branco C 2 592 593

28 Data da Ultima Compra D 8 594 601

29 Valor da Ultima Compra N 12 2 602 613

30 Finalizadores de Venda Bloqueados C 90 614 703 Observação 6

31 Mensagem C 80 704 783 Observação 7

32 Tabela de Preço a Utilizar C 1 784 784 Observação 2

33 Nível de Bloqueio N 2 0 785 786 Observação 8

34 Chapa C 15 787 801

35 Senha do Cliente C 20 802 821 Observação 4

Observação 1: L – Liberado

B – Bloqueado

N – Negativo

Observação 2: Esse campo tem a mesma finalidade do campo que está no cadastro de empresa

conveniada. No caso desse campo estar em branco vale o da empresa.

Observação 3: Este campo informa se o cliente tem desconto geral sobre todos os produtos independente

da condição cadastrada no campo Desconto Padrão no arquivo

ESTOQUE.TXT.

Page 16: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 15

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 4: Caso o recurso esteja ativo na configuração do concentrador, será solicitado ao cliente uma

senha através do pinpad do caixa. Caso este campo esteja em branco será solicitado ao

cliente a gravação da senha e será gerado um movimento no arquivo de movimento para

retaguarda (MOVOUTRA – STATUS: 50).

Observação 5: O campo CGC/CPF deverá estar com a máscara. Exemplo:

CPF: 12345678910 123.456.789-10

CPF: 1234567891 012.345.678-91

CGC: 12345678000123 012.345.678/0001-23

CGC: 123456789000123 123.456.789/0001-23

Observação 6: O campo deverá conter os finalizadores de venda que o cliente não está autorizado a

comprar alinhado em 3 dígitos completados com zeros a esquerda caso necessário:

Exemplo:

Bloquear os finalizadores: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 001002010015110200

Observação 7: O conteúdo deste campo será enviado para a tela do PDV quando for informado este

cliente. Tome cuidado com a mensagem!

Observação 8: Campo com valor numérico de “00” a “99” com o nível do bloqueio. Este nível será

exibido e poderá ser utilizado com outras opções, onde será definido a necessidade de uma

autorização ou liberação automática.

Page 17: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 16

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.6. CLIENTES.TXT (Cadastro de Clientes)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 16 0 1 16

02 Nome Completo C 50 17 66

03 Endereço C 60 67 126

04 Bairro C 30 127 156

05 Cidade C 30 157 186

06 Estado (UF) C 2 187 188

07 CEP C 8 189 196

08 Telefone C 15 197 211

09 CGC / CPF C 19 212 230 Observação 1

10 Data de Nascimento D 8 231 238

11 Data da Ultima Compra D 8 239 246

12 Situação C 1 247 247 Observação 2

13 Limite Total de Crédito para Compra Convênio (Fiado)

N 12 2 248 259

14 Valor Total das Compras em Aberto no Convênio (Fiado)

N 12 2 260 271

15 Percentual de Desconto Sobre o Cupom N 4 2 272 275

16 Desconto Sobre Produto em Promoção C 1 276 276 S - Sim / N - Não

17 Desconto Geral C 1 277 277 Observação 3

18 Permite Compra no Convênio (Fiado) C 1 278 278 S - Sim / N - Não

19 Mensagem C 80 279 358 Observação 4

20 Limite Total de Crédito para Compra com Cheque (Valor)

N 12 2 359 370

21 Limite Total de Crédito para Compra com Cheque (Quantidade)

N 6 0 371 376

22 Valor Total das Compras em Aberto com Cheque (Valor)

N 12 2 377 388

23 Valor Total das Compras em Aberto com Cheque (Quantidade)

N 6 0 389 394

24 Cartão / Código de Barras C 80 395 474

25 Reservado - Espaço em Branco C 40 475 514

26 Inscrição Estadual / RG C 25 515 539

27 Pontuação Acumulada (Fidelidade) N 9 0 540 548

28 Reservado - Espaço em Branco C 2 549 550

29 Reservado - Espaço em Branco C 10 551 560

30 Valor da Ultima Compra N 12 2 561 572

31 Saldo para Recebimento de Conta N 12 2 573 584

32 Quantidade de Documentos em Aberto N 6 0 585 590

33 Finalizadores de Venda Bloqueados C 90 591 680 Observação 5

34 Tabela de Preço a Utilizar C 1 681 681 A – Atacado E – Especial P - Padrão

35 Nível de Bloqueio N 2 0 682 683 Observação 6

36 Nome Fantasia C 15 684 698

37 Senha do Cliente C 20 699 718 Observação 7

38 Dia para Vencimento do Convênio N 2 0 719 720 Observação 8

39 Dias para Cálculo do Vencimento do Convênio

N 3 0 721 723 Observação 9

Page 18: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 17

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Page 19: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 18

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.7. CLIENTES.TXT (Cadastro de Clientes - Continuação)

40 Condição para Cálculo do Vencimento C 2 724 725 Observação 10

41 Melhor Dia para Compra N 2 0 726 727 Observação 11

42 Contato / 2ª Pessoa Autorizada C 40 728 767

43 Tipo do Endereço C 15 768 782 Rua, Avenida,Trav.,

44 Numero do Endereço N 6 0 783 788

45 Complemento C 20 789 808 Casa, Apto, Bloco, ...

46 País C 20 809 828 Nome do país

47 Código do país N 4 0 829 832 Código do país

48 Código do município (IBGE) N 7 0 833 839

49 E-mail C 100 840 939

50 Inclusão de Percentual de Acréscimo em vendas a PRAZO

C 1 0 940 940 S/N - Observação 12

Observação 1: O campo CGC/CPF deverá estar com a máscara. Exemplo:

CPF: 12345678910 123.456.789-10

CPF: 1234567891 012.345.678-91

CGC: 12345678000123 012.345.678/0001-23

CGC: 123456789000123 123.456.789/0001-23

Observação 2: L – Liberado

B – Bloqueado

N – Negativo

Observação 3: Informa se o desconto também deverá ser aplicado aos itens que estiverem em

promoção ( S ou N )

Observação 4: O conteúdo deste campo será enviado para a tela do PDV quando for informado este

cliente. Tome cuidado com a mensagem!

Observação 5: O campo deverá conter os finalizadores de venda que o cliente não está autorizado a

comprar alinhado em 3 dígitos completados com zeros a esquerda caso necessário:

Exemplo:

Bloquear os finalizadores: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 001002010015110200

Observação 6: Campo com valor numérico de “00” a “99” com o nível do bloqueio. Este nível será

exibido e poderá ser utilizado com outras opções, onde será definido a necessidade de uma

autorização ou liberação automática.

Observação 7: Caso o recurso esteja ativo na configuração do concentrador, será solicitado ao cliente uma

senha através do pinpad do caixa. Caso este campo esteja em branco será solicitado ao

cliente a gravação da senha e será gerado um movimento no arquivo de movimento para

retaguarda.

(MOVOUTRA – STATUS: 50).

Page 20: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 19

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 8: Informa ao PDV que todos os convênios deste cliente vencem sempre neste dia,

independente da quantidade de dias para vencimento e da condição. Lembrando que essa

condição somente é utilizada nos finalizadores que utilizam vencimento rotativo.

Observação 9: Utilizado em conjunto com o campo Condição para Cálculo de Vencimento, informa a

quantidade padrão de dias para cálculo de vencimento dos títulos deste cliente. Lembrando

que essa condição somente é utilizada nos finalizadores que utilizam vencimento rotativo.

Observação 10: Utilizado em conjunto com o campo Dias para Cálculo de Vencimento, este campo pode

conter:

DD - Dias Direto da Data

DS - Dias Fora a Semana

DQ - Dias Fora a Quinzena

DM - Dias Fora o Mês

Caso o campo esteja em branco, será utilizado 'DD' como padrão. Lembrando que essa

condição somente é utilizada nos finalizadores que utilizam vencimento rotativo.

Observação 11: Utilizado em conjunto com o campo Dia para Vencimento do Convênio, informa o

melhor dia para compra do cliente. Exemplo:

Vencimento do Cliente: Todo dia 10

Melhor Dia para Compra: Todo dia 5

Data da Compra Data do Vencimento

01/01/2007 10/01/2007

05/01/2007 10/02/2007

07/01/2007 10/02/2007

Observação 12: Defini se será cobrado do cliente percentual de acréscimo, quando a venda for identificada

como A PRAZO. Este parâmetro funciona em conjunto com as seguintes configurações

no PDV e MERCOFLEX/FLEXCONCENT (TODAS EM CONJUNTO).

1 – FLEXPDV – Solicitar cliente no início da venda.

2 – MERCOFLEX/FLEXCONCENT - Parâmetros do Sistema, parametrizado com

Pergunta Venda a PRAZO.

3 – MERCOFLEX/FLEXCONCENT - Parâmetros do Sistema, percentual de venda a

PRAZO.

Page 21: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 20

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.8. BARRAREL.TXT (Código de Barras Relacionadas - Produtos com vários

códigos de barras)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto Principal (PLU) N 20 0 1 20

02 Código de Barras do Produto N 20 0 21 40

03 Observação C 40 41 80

04 Múltiplos N 9 3 81 89 Observação 1

05 Preço de Venda N 9 3 90 98 Observação 2

06 Loja N 3 0 99 101

Observação 1: Campo usado para informar ao PDV que deve ser utilizado:

(Múltiplos x Quantidade do PDV) x Preço de Venda

Observação 2: Se este campo estiver sem valor, o PDV utilizará o preço do produto principal

2.3.9. FORMULA.TXT (Fórmula – Produto composto de diversos itens.

Exemplo: Cesta Básica)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto Principal (PLU) N 20 0 1 20

02 Código do Produto Item (PLU) N 20 0 21 40

03 Quantidade N 7 3 41 47 Observação 1

04 Preço de Venda N 9 3 48 56 Observação 2

05 Descrição Resumida para o PDV C 24 57 80 Observação 3

06 Preço de Venda Promocional N 9 3 81 89 Observação 2

07 Preço de Venda Atacado N 9 3 90 98 Observação 2

08 Preço de Venda Especial N 9 3 99 107 Observação 2

09 Loja N 3 0 108 110

10 Preço Alterado S ou N ? C 1 0 111 111 Observação 4

Observação 1: Campo usado para informar ao PDV que deve ser utilizado:

(Quantidade da Fórmula x Quantidade do PDV) x Preço de Venda

Observação 2: Teoricamente deveria ser utilizado o preço de venda em ESTOQUE.TXT mas existem

casos onde numa determinada fórmula o item em referência tem um preço diferenciado.

(Cesta Básica, Kits, etc...). Caso não haja diferença preencher esse campo com o mesmo

valor do item em ESTOQUE.TXT

Observação 3: Se este campo estiver em branco, o PDV utilizará a descrição existente em

ESTOQUE.TXT

Observação 4: Caso este campo venha marcado como S (Sim), o sistema irá utilizar o preço informado

nos campos da tabela FORMULA e não os preços da tabela ESTOQUE

Page 22: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 21

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.10. VASILHAME.TXT (Vasilhame – Controle de Vasilhame por Produto)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 4 0 1 4

02 Descrição C 20 5 24

03 Preço Unitário N 8 2 25 32

04 Código no Cadastro de Produtos N 20 0 33 52

2.3.11. ARMACAO.TXT (Cadastro de Armação de Produto)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 4 0 1 4

02 Descrição C 20 5 24

2.3.12. GRUPO.TXT (Cadastro de Grupo de Produto)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 6 0 1 6

02 Descrição C 20 7 26

2.3.13. DEPTO.TXT (Cadastro de Departamento de Produto)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 6 0 1 6

02 Descrição C 20 7 26

2.3.14. MARCA.TXT (Cadastro de Marca de Produto)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 6 0 1 6

02 Descrição C 20 7 26

2.3.15. LISTAPRE.TXT (Lista de Preços)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código da Lista N 3 0 1 3

02 Código do Produto (PLU) C 20 4 23

03 Sequência (Ordem de Classificação) N 3 0 24 26

Page 23: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 22

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Page 24: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 23

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.16. SIMILAR.TXT (Produtos Similares)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Grupo de Similares N 6 0 1 6

02 Código do Produto (PLU) C 20 7 26

2.3.17. ALTPRECO.TXT (Alteração de Preço)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto (PLU) C 20 1 20

02 Tabela de Preço C 1 21 21 A - Atacado

E - Especial

P - Padrão

R - Promoção

03 Preço de Venda

N

9

3

22

30

Observação 1

(Disponível somente para FlexConcent / FlexPdv)

Observação 1: Caso queira zerar um preço (por exemplo Promoção) enviar o campo com valor zero.

2.3.18. TABPVDQT.TXT (Parâmetro de Produto/Preço/Múltiplos)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto Principal (PLU) N 20 0 1 20

02 Quantidade N 7 3 21 27

03 Tipo da Quantidade C 1 28 28 Observação 1

04 Código do Produto Associado (PLU) N 20 0 29 48

05 Preço de Venda N 9 3 49 57

06 Fator N 3 0 58 60 Observação 2

07 Quantidade Máxima N 5 0 61 65

08 Quantidade Vendida N 5 0 66 70

09 Terminar Promoção C 1 71 71 Observação 4

10 Data de Inicio da Promoção D 8 72 79

11 Data de Término da Promoção D 8 80 87

12 Data da Ultima Venda Efetuada D 8 88 95 Deixar em Branco

Observação 1: M - Múltiplos

A - Acima de

L - Leve X Pague Y

Observação 2: Informa a quantidade de produtos associados beneficiados pela parametrização.

Caso o campo Tipo da Quantidade for “A” o campo Fator será considerado como geral.

Page 25: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 24

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 3: Caso o campo Tipo da Quantidade for “L” o campo Código do Produto Associado

(PLU) será o mesmo do Código do Produto Principal (PLU) e o campo Fator deverá

conter o valor para Y.

Observação 4: D - No próximo dia após atingir a quantidade máxima

M - Ao atingir a quantidade máxima

S - Sem data definida para término

T - Na data definida como término da promoção

Exemplo 1: 1 lata de sardinha custa R$ 1,00, acima de 2 latas a mesma sai por R$ 0,90

Código do Produto Principal - Lata de Sardinha

Quantidade - 2

Tipo da Quantidade - A

Código do Produto Associado - Lata de Sardinha

Preço de Venda - 0,90

Fator - Geral – Todas custaram R$ 0,90

Exemplo 2: A cada compra de 2 vidros de azeitona o café do chico sai por R$ 1,00

Código do Produto Principal - Vidro de Azeitona

Quantidade - 2

Tipo da Quantidade - M

Código do Produto Associado - Café do chico

Preço de Venda - 1,00

Fator – 1

Exemplo 3: A cada compra de 2 peças de carne, 6 latas de cerveja saem por R$ 0,99 cada

Código do Produto Principal - Peça de Carne

Quantidade - 2

Tipo da Quantidade - M

Código do Produto Associado - Cerveja

Preço de Venda - 0,99

Fator – 6

2.3.19. TABPRECO.TXT (Tabela de Preços)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto (PLU) C 20 1 20

02 Código da Tabela N 6 0 21 26 Observação 1

03 Preço de Venda N 9 3 27 35

Observação 1: O campo deverá conter o código da tabela cadastrado no arquivo TABFPAG.TXT

(Parâmetro de Cliente/Tabela/Finalizadores).

2.3.20. TABFPAG.TXT (Parâmetro de Cliente/Tabela/Finalizadores)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código da Tabela N 6 0 1 6

Page 26: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 25

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

02 Código do Cliente N 16 0 7 22 Observação 1

03 Finalizadores Permitidos C 180 23 202 Observação 2

04 Regra para Utilização N 1 0 203 203 Observação 3

(Disponível somente para FlexConcent / FlexPdv)

Observação 1: O cliente deverá ser identificado no cupom de venda no PDV. O preço de venda do produto

deverá estar cadastrado no arquivo TABPRECO.TXT (Tabela de Preços).

Observação 2: O campo deverá conter os finalizadores de venda que o cliente poderá utilizar para

pagamento do total dos produtos pertencentes a tabela. Caso o cliente possa pagar em

qualquer finalizador, deixar em branco.

Alinhar de 3 em 3 dígitos completados com zeros a esquerda caso necessário:

Exemplo: Finalizadores: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 001002010015110200

Observação 3: 0 - Não há regra

1 - Receber apenas nos finalizadores autorizados

2 - Permitir recebimento parcial em qualquer outro finalizador

3 - Permitir recebimento parcial em DINHEIRO

2.3.21. PROMCAM.TXT (Promoção Campanha)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código da Campanha N 6 0 1 6

02 Seqüencial do Registro N 6 0 7 12 Observação 1

03 Descrição C 30 13 42

04 Inicio da Campanha D 8 43 50

05 Término da Campanha D 8 51 58

06 Inclui itens em promoção ? C 1 59 59 S - Sim / N - Não

07 Filtro C 1 60 60 Observação 2

08 Código do Item do Filtro C 20 61 80 Observação 3

09 Tipo do Desconto N 1 0 81 81 Observação 4

10 Desconto para Cliente Com Cartão N 9 2 82 90

11 Desconto para Cliente Sem Cartão N 9 2 91 99

12 Tipo de Valor Mínimo C 1 100 100 Observação 5

13 Valor Mínimo N 12 3 101 112

14 Tabela de Preço C 1 113 113 Observação 6

15 Fator C 1 114 114 Observação 7

16 Finalizadores Permitidos C 90 115 204 Observação 8

Observação 1: Para cada registro relativo a um código de item do filtro, deve ser gerado uma seqüência

de registro, começando em 1 até a quantidade de registros.

Observação 2: A - Armação

G - Grupo

D - Departamento

M - Marca

P - Produto

T – Todos

Page 27: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 26

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 3: Preencher com o código do item informado no campo FILTRO.

O alinhamento deste campo não será criticado na importação.

Deve ser gerado um registro para cada filtro. Exemplo: caso seja escolhido

FILTRO: PRODUTO, e seja referente a 3 itens, deverá ser gerado 3 registros, com todos

os campos da tabela idênticos apenas alterando o SEQUENCIAL DO

REGISTRO para cada registro (1,2 e 3 ) e o CÓDIGO DO ITEM DO FILTRO.

Observação 4: 1 - Percentual

2 - Valor

3 - Bônus

4 - Prazo

Observação 5: Q - Quantidade

V – Valor

Observação 6: P - Padrão

A - Atacado

E - Especial

T - Todos

Observação 7: M - Múltiplos

A - Acima de

Observação 8: O campo deverá conter os finalizadores de venda que a campanha está condicionada,

alinhado em 3 dígitos completados com zeros a esquerda caso necessário: Exemplo:

Finalizadores: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 001002010015110200

2.3.22. ESTOQUE.TXT e ESTOQUEMIX.TXT (Cadastro de Produtos Monoloja

e Multiloja)

• Este capítulo demonstrará o passo a passo para configuração dos arquivos TXT de integração com

o Flex.

• A partir da versão 17.800.01-R1 o GZServiços passa a ter o recurso de importação de carga de

produto Multiloja (GESTOR). Esse recurso é indicado para os clientes que utilizam o recurso de carga

centralizada.

• Dessa forma, a importação dos produtos é feita para o banco de dados do Gestor e depois enviada

ao FlexConcent.

• Regra para geração do arquivo ESTOQUEMIX.TXT: o arquivo ESTOQUEMIX.TXT, seguirá

a mesma estrutura do arquivo ESTOQUE.TXT, mais deverá ter todos os produtos juntamente com a informação

da loja (campo 85 do manual e observação 33) ao qual o mesmo faz parte. Sendo assim, caso um produto exista

por exemplo nas lojas 1,2 e 3, as informações deverão estar nas 3 linhas do arquivo juntamente com sua devida

loja.

• Exemplo:

0000000000000060262000000000095188790348SUCO TAMPICO FRUTAS CITRICAS GF 1 LT SUCO TAMPICO FRUTAS CI NUN000000

Page 28: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 27

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

0000000000000060262000000000095188790348SUCO TAMPICO FRUTAS CITRICAS GF 1 LT SUCO TAMPICO FRUTAS CI NUN000000

0000000000000060262000000000095188790348SUCO TAMPICO FRUTAS CITRICAS GF 1 LT SUCO TAMPICO FRUTAS CI NUN000000

Page 29: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 28

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Campo Tipo Tam Dec Inicio Fim Observação

01 Código Interno do Produto (PLU) N 20 0 1 20

02 Código de Barras N 20 0 21 40 Observação 1

03 Descrição Completa C 40 41 80

04 Descrição Resumida para o PDV C 24 81 104

05 Fórmula C 1 105 105 Observação 2

06 Unidade de Referência C 2 106 107 Observação 3

07 Armação / Localização N 4 0 108 111

08 Setor ( Balança ) N 2 0 112 113 Produto Pesado

09 Preço de Venda Padrão N 9 3 114 122

10 Preço de Venda Promocional N 9 3 123 131 Observação 4

11 Saldo em Estoque (Quantidade) N 12 3 132 143

12 Desconto Padrão C 1 144 144 Observação 5

13 Quantidade Variável / Produto Pesado ? C 1 145 145 S,N,E Observação 27

14 Altera Preço de Venda no PDV ? C 1 146 146 S,N,T Observação 6

15 Bloqueia Multiplicador ? C 1 147 147 Observação 7

16 Promoção: Leve X Pague Y C 6 148 153 Observação 8

17 Código da Tributação N 2 0 154 155 Observação 9

18 Reservado - Espaço em Branco C 1 156 156

19 Quantidade por Embalagem N 7 3 157 163 Observação 10

20 Vende Somente Embalagem Fechada ? C 1 164 164 Observação 11

21 Desconto por Embalagem Fechada N 4 2 165 168 Observação 12

22 Pede Descrição Complementar ? C 1 169 169 S,N,P,T Obs. 13

23 Reservado - Espaço em Branco C 80 170 249

24 Preço de Venda Atacado N 9 3 250 258

25 Bloqueia Venda Fracionada ? C 1 259 259 Observação 14

26 Referencia C 40 260 299

27 Situação Tributária C 3 300 302 Tabela 2

28 Estado do Produto C 1 303 303 A - Ativo / I - Inativo

29 Código do Vasilhame N 4 0 304 307 Observação 15

30 Reservado - Espaço em Branco C 81 308 388

31 Percentual Desconto Máximo Permitido N 4 2 389 392 Observação 16

32 Quantidade por Embalagem (Atacado) N 7 3 393 399 Observação 10

33 Vende Só Embal. Fechada ? (Atacado) C 1 400 400 Observação 11

34 Desconto por Embal. Fechada(Atacado) N 4 2 401 404 Observação 12

35 Classificação Fiscal C 10 405 414

36 Quantidade Pendente N 12 3 415 426 Venda Balcão

37 Validade da Quantidade Pendente C 4 427 430 Venda Balcão

38 Preço de Venda Especial N 9 3 431 439

39 Quantidade por Embalagem (Especial) N 7 3 440 446 Observação 10

40 Vende Só Embal. Fechada ? (Especial) C 1 447 447 Observação 11

41 Desconto por Embalagem Fechada (Especial) N 4 2 448 451 Observação 12

42 Quantidade Mínima para Preço Atacado N 12 3 452 463 Observação 17

43 Quantidade Mínima para Preço Especial N 12 3 464 475 Observação 17

Page 30: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 29

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.23. ESTOQUE.TXT (Cadastro de Produtos - Continuação)

Campo Tipo Tam Dec Inicio Fim Observação

44 Grupo N 6 0 476 481

45 Departamento N 6 0 482 487

46 Marca N 6 0 488 493

47 Pontos Clube Fidelidade N 8 4 494 501 Observação 18

48 Base de Cálculo Clube Fidelidade C 1 502 502 Observação 19

49 Código Interno do Produto Associado N 20 0 503 522 Observação 20

50 Grupo de Finalizadores N 3 0 523 525 Observação 21

51 Desconto Finalizadores Específicos N 9 2 526 534 Observação 22

52 Finalizadores para Desconto C 90 535 624 Observação 23

53 1º Micro-Terminal de Impressão N 2 0 625 626 Observação 24

54 Quantidade Máxima de Item por Compra N 6 0 627 632

55 Cupom Vinculado C 1 633 633 Observação 25

56 Bloqueador de Venda C 1 634 634 Observação 26

57 Tipo do Produto N 1 0 635 635 0 - Produto / 1 Serviço

58 2º Micro-Terminal de Impressão N 2 0 636 637 Observação 24

59 3º Micro-Terminal de Impressão N 2 0 638 639 Observação 24

60 4º Micro-Terminal de Impressão N 2 0 640 641 Observação 24

61 5º Micro-Terminal de Impressão N 2 0 642 643 Observação 24

62 Solicita Senha para Liberação de Venda C 1 644 644 S - Sim / N - Não

63 Grupo de Balcão N 3 0 645 647 Observação 28

64 Indicador de Produção Própria ou de Terceiro

C 1 648 648 P – Própria T – Terceiro

65 Indicador de Arredondamento ou Truncamento

C 1 649 649 A – Arredondamento T – Truncamento

66 Preço Máximo de Venda ao Consumidor N 9 3 650 658

67 Tipo do Produto N 3 0 659 661 Observação 29

68 Carga Tributária Federal N 4 2 662 665 Observação 30

69 CSOSN C 4 666 669

70 Entregável C 1 670 670 S – Sim / N – Não Observação 31

71 Carga Tributária Estadual N 4 2 671 674 Observação 30

72 Chave Tabela IBPT C 10 675 684

73 CST do PIS C 2 685 686

74 Alíquota do PIS N 9 2 687 695

75 CST do COFINS C 2 696 697

76 Alíquota do COFINS N 9 2 698 706

77 CEST – Código Especificador da Situação Tributária

C 7 0 707 713 Observação 32

78 Valor Unitário PIS - SAIDA N 9 4 714 722

79 Valor Unitário COFINS - SAIDA N 9 4 723 731

80 Preço de Custo N 9 3 732 740

81 Data de Início de Promoção D 8 0 741 748

82 Data de Fim da Promoção D 8 0 749 756

83 Percentual de comissão N 5 2 757 761

84 Mensagem complementar do Produto C 128 0 762 889

85 Loja N 3 0 890 892 Observação 33

86 Código de Produto ANP N 9 0 893 901

87 Alíquota de FCP N 9 4 902 910

Page 31: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 30

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

88 Alíquota de FCP ST N 9 4 911 919

Campo Tipo Tam Dec Inicio Fim Observação

89 Alíquota de FCP Retido N 9 4 920 928

90 Código GTIN N 20 0 929 948 Observação 34

91 Data de alteração D 8 0 949 956

92 Dias de validade N 3 0 957 959

93 Código da informação nutricional N 6 0 960 965

Observação 1: Para produto pesado devera conter o código resumido na etiqueta

Exemplo: (Etiqueta padrão valor convencional com código de 4 dígitos)

Etiqueta: 2001234012501 Cadastro: 1234

Etiqueta: 2105678012501 Cadastro: 5678

Etiqueta: 2609012012501 Cadastro: 9012

Observação 2: Este campo deverá ser preenchido com a letra “S” quando o mesmo se tratar de um

produto composto por diversos itens, como por exemplo, CESTA BÁSICA.

Para isso os itens desta fórmula deveram estar cadastrados no cadastro de fórmula

(FORMULA.TXT ).

No ato da venda no PDV serão impressos apenas os itens desta fórmula

(Quantidade da Fórmula x Quantidade do PDV) x Preço de Venda

Observação 3: Para etiquetas de unidade, utilizar UN ou PC, as demais unidades serão consideradas como

produto pesado.

Observação 4: Quando o produto estiver em promoção pode ser informado diretamente no campo Preço

de Venda, não utilizando esse. Lembrando que caso isso seja feito o sistema não terá como

saber se o produto está ou não em promoção, não efetuando assim comparações a nível de

desconto de cliente conveniado

(Vide observações no EMPRESA.TXT, CLIENTEC.TXT e CLIENTES.TXT).

Observação 5: Informa ao PDV em que situação esse produto pode receber desconto.

( EMPRESA.TXT, CLIENTEC.TXT e CLIENTES.TXT )

C Clientes Convênio

L Clientes Loja

A Ambos

N Nenhum

Observação 6: Informa ao PDV que este produto tem preço variável

S Será solicitado ao operador o preço unitário do produto

N Não será solicitado o preço (utiliza do cadastro)

T Será solicitado ao operador o valor total do produto

Observação 7: Informa ao PDV que este produto não aceita a tecla “X”, ou seja, caso no ato

da venda exista mais que 1(uma) unidade do produto, o operador deverá digitar

ou passar pelo leitor “X” vezes o código do produto.

Page 32: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 31

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 8: Informa ao PDV que toda venda em múltiplos de “X” (Quantidade) terá “X-Y”

(Quantidade) de desconto. Deixar em branco caso não utilizado

Exemplo:

Leve 3 Pague 2 - X=3 - Y=2 - Preencher: 003002

Leve 5 Pague 3 - X=5 - Y=3 - Preencher: 005003

Observação 9: Este campo deverá ser preenchido com o código da tributação fiscal que por sua vez deverá

estar no CADASTRO DE TRIBUTAÇÃO no MÓDULO

CONCENTRADOR.

Observação 10: Este campo é usado apenas pelo MÓDULO DE VENDAS BALCÃO Informa ao

Balcão a quantidade por embalagem.

Observação 11: Este campo é usado apenas pelo MÓDULO DE VENDAS BALCÃO.

Este campo deverá ser preenchido com a letra “S” quando o produto só puder ser vendido

em embalagem fechada, ou seja, se no campo Quantidade por Embalagem estiver

preenchido com a quantidade 2,50 esse item só poderá ser vendido em múltiplos desse

valor.

Observação 12: Este campo é usado apenas pelo MÓDULO DE VENDAS BALCÃO.

Este campo deverá ser preenchido com um percentual de desconto por embalagem fechada.

Exemplo:

Se um determinado produto com embalagem de 2,50, configurado para venda não somente

em embalagem fechada e com desconto de 10%.

Quantidade: 4 Preço Unitário: R$ 5,00.

( ( 2,5 x 5,00 ) – 10% ) + ( 1,5 x 5,00 ) = 18,75

Observação 13: Solicitar descrição complementar:

N - Não Solicitar

S - Solicitar apenas no MÓDULO DE VENDAS BALCÃO

P - Solicitar apenas no FRENTE DE LOJA

T - Solicitar em ambos

Observação 14: Informa ao PDV que esse produto só pode ser vendido em quantidades Inteiras.

Ou seja, 1 ou 10 nunca 1,25 ou 10,251.

Observação 15: Se o controle de vasilhame estiver ativo na configuração do concentrador, será solicitado

ao operador o número do cupom de vasilhame.

Observação 16: Este campo é usado apenas pelo MÓDULO DE VENDAS BALCÃO.

Informa ao Balcão o desconto máximo permitido na venda do produto.

Observação 17: Informa ao MÓDULO DE VENDAS BALCÃO e ao PDV que esse produto deverá

utilizar este preço caso a quantidade comprada seja maior ou igual a essa quantidade

mínima.

Page 33: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 32

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 18: Quando o recurso do CLUBE FIDELIDADE estiver ativo na configuração do

concentrador, existe uma pontuação e uma base de cálculo padrão que deverá ser

configurada. Independente desta configuração padrão, existe a possibilidade de se ter

pontuações diferenciadas por produto.

-999.9999 - PRODUTO SEM PONTUAÇÃO

EM BRANCO - UTILIZAR PONTUAÇÃO PADRÃO

VALOR > 0 - UTILIZAR PONTUAÇÃO DO PRODUTO

Observação 19: Base de cálculo da pontuação do clube fidelidade

EM BRANCO - UTILIZAR BASE DE CÁLCULO PADRÃO

V - (Pontos do Produto x Valor Total Líquido Item)

Q - (Pontos do Produto x Quantidade de Itens)

Observação 20: Informa ao PDV que esse produto deverá ser processado (vendido) junto com este item.

Observação 21: Informa ao PDV que esse produto pode ser recebido pela Modalidade de Pagamento

(Finalizador) que faz parte desse grupo. Para que esse recurso funcione corretamente é

necessário o grupo estar definido no Cadastro de Modalidade de Pagamento

(Finalizador) e estar configurado no finalizador que o mesmo só poderá ser usado para

produtos que fazem parte do grupo.

Observação 22: Este campo deverá ser preenchido com o valor de desconto sobre o preço de venda, caso

o produto seja recebido pela Modalidade de Pagamento (Finalizador) definida no campo

Finalizadores para Desconto.

Caso esse recurso não seja utilizado deixar este campo em branco. (Valor Zero).

Observação 23: O campo deverá conter os finalizadores de venda que o cliente deverá utilizar, para ter

direito ao desconto, alinhado em 3 dígitos completados com zeros a esquerda caso

necessário: Exemplo:

Bloquear os finalizadores: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 001002010015110200

Caso esse recurso não seja utilizado deixar este campo em branco.

Observação 24: Este campo é usado pelo MÓDULO DE VENDAS BALCÃO e MÓDULO SERVIDOR

DE MICROTERMINAIS.

Este campo deverá ser preenchido com o número do micro-terminal de impressão quando

houver a necessidade da emissão de um pedido/comanda para o produto.

Exemplo: num restaurante ao digitar um produto da cozinha, emitir um pedido/comanda

no micro-terminal na cozinha.

Observação 25: Informa ao PDV para emitir um cupom vinculado associado a este item.

EM BRANCO - Não emitir

1 - Cupom para Retirada

2 - Cupom de Entrega

Observação 26: Instrução para bloqueio da venda do produto caso não haja saldo disponível.

N - Não Bloquear

S - Bloquear apenas no MÓDULO DE VENDAS BALCÃO

Page 34: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 33

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 27: Informa ao PDV que este produto é pesável ou tem quantidade variável.

S - Será solicitado ao operador a quantidade ou peso

N - Não será solicitado a quantidade ou peso

E - Bloqueia a digitação da quantidade ou peso

Observação 28: Este campo é usado apenas pelo MÓDULO DE VENDAS BALCÃO. Informa ao Balcão

para não aceitar produtos de grupos diferentes no mesmo pedido/comanda.

Observação 29: Este campo é usado apenas para definir o tipo do produto baseado nas informações:

000 - Mercadoria Para Revenda

001 - Matéria-Prima

002 - Embalagem

003 - Produto em Processo

004 - Produto Acabado

005 - Subproduto

006 - Produto Intermedi rio

007 - Material de Uso e Consumo

008 - Ativo Imobilizado

009 - Serviços

010 - Outros Insumos

099 - Outras

Observação 30: Informar a Carga Tributária Estadual e Federal do produto para que o PDV possa calcular

e destacar a informação na mensagem cortesia.

Exemplo 1 – Carga Tributária de 7,35% - Preencher: 0735

Exemplo 2 – Carga Tributária de 21,72% - Preencher: 2172

Observação 31: Informar a neste campo se o produto será ou não impresso no Cupom de Entrega quando

este estiver configurado no PDV. Como padrão só não irá imprimir o item caso o valor

seja = N

Observação 32: Deverá ser salvo sem máscara.

Observação 33: Enviar a informação da loja ao qual o produto faz parte. No arquivo ESTOQUE.TXT essa

informação também precisa ser gerada para manter a compatibilidade do arquivo, mais

essa informação nesse caso será desconsiderada na gravação.

Observação 34: Este campo será utilizado para preenchimento das tags cEAN e cEANTrib nos XMLs. Se

este campo não estiver preenchido ou não for válido, as tags terão o conteúdo "SEM GTIN"

Page 35: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 34

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.24 BALCAO.TXT (Pedido de Balcão)

Campo Tipo Tam Dec Inicio Fim Observação

01 Comanda/Pedido C 8 1 8

02 Número Seqüencial do Item N 3 0 9 11

03 Código do Produto (PLU) N 20 0 12 31

04 Quantidade N 8 3 32 39

05 Preço Unitário do Item N 9 3 40 48

06 Código do Vendedor (4 dígitos) N 4 0 49 52 Observação 9

07 Código da Empresa N 3 0 53 55 Quando Cliente Convênio

08 Código do Cliente N 16 0 56 71

09 Código da Modalidade de Pagamento N 3 0 72 74 Finalizador

10

Número Seqüencial do DAV / Pedido N 10 0 75 84

Somente para FlexPdv com FlexBalcao

11 Item Cancelado C 1 85 85 Somente para FlexPdv com FlexBalcao S – Sim N – Não

12 Título do DAV / Pedido C 1 86 86 Somente para FlexPdv com FlexBalcao O – Orçamento P – Pedido

13 Observação para cupom fiscal C 240 87 326 Somente para FlexPdv com FlexBalcao

14 Número Seqüencial da PV / Comanda N 10 0 327 336 Somente para FlexPdv com FlexBalcao

15 Desconto Total do Item N 9 2 337 345

16 Acréscimo Total do Item N 9 2 346 354 Somente FlexPDV

17 Código do Vendedor (5 dígitos) N 5 0 355 359 Observação 9

18 Tipo de Pedido N 1 0 360 361 Observação 10

Observação 1: Após a solicitação do pedido pela frente de loja, será feito uma checagem no mesmo. Caso

haja algum problema com algum dos itens, o pedido não será processado pela frente de

loja.

Observação 2: Para conceder abatimento/desconto no total do pedido, coloque no campo Código do

Produto (PLU) a mensagem ABATIMENTO com espaços a direita até o tamanho de

20 caracteres e no campo Preço Unitário do Item o VALOR DO ABATIMENTO, o

restante dos campos preencher normalmente.

Observação 3: Para conceder acréscimo no total do pedido, coloque no campo Código do Produto (PLU)

a mensagem ACRESCIMO com espaços a direita até o tamanho de 20 caracteres e no

campo Preço Unitário do Item o VALOR DO ACRESCIMO, o restante dos campos

preencher normalmente.

Page 36: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 35

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 4: Para gerar o arquivo usar o seguinte padrão para nome do arquivo:

pppppppp.txt (Onde pppppppp é o número do pedido).

Exemplos: 1.txt, 25.txt, 125.txt, etc. Lembrando que o arquivo será apagado após o

processamento dos itens do pedido.

Observação 5: O Código da Modalidade de Pagamento (Finalizador) é opcional. Caso seja informado,

o frente de loja somente aceitará esse finalizador no encerramento do cupom.

Observação 6: A Observação para cupom fiscal deverá ser preenchida no formato 5 linhas por 48

caracteres totalizando os 240 dígitos disponíveis. Lembrando que para as impressoras

fiscais que possuem espaçamento inferior ou superior a 48 caracteres, a observação será

truncada ou preenchida ao tamanho máximo permitido pela impressora.

Observação 7: Os campos Desconto Total do Item e Acréscimo Total do Item deveram ser utilizados

para conceder desconto ou acréscimo no item. Esse valor deve ser menor que o valor total

do item, caso o contrário o mesmo será ignorado pelo frente de loja.

Observação 8: Após o processamento da venda, será gerado um arquivo de retorno com as informações

do cupom, conforme layout abaixo. O arquivo de retorno terá o mesmo nome e extensão

do arquivo gerado. O arquivo será composto por uma linha.

Observação 9: Caso o código do vendedor possua quatro dígitos, preencher o campo 6 e manter o campo

17 em branco. Caso o código do vendedor possuir cinco dígitos, preencher o campo 17. Se

o campo 17 estiver preenchido, o campo 6 será ignorado na importação.

Observação 10: Tipos de Pedido possíveis: 0 – FlexPDV solicitará seleção de tipo de pedido em tela 1 – Comanda/PV 2 – Pedido/DAV 3 – Pedido Integrado

4 – Pedido de Pagamento de Conta

Arquivo retorno – confirmação de pagamento do pedido gerado.

Campo Tipo Tam Dec Inicio Fim Observação

01 Ano C 4 1 4

02 Mês C 2 0 5 6

03 Dia C 2 0 7 8

04 Hora C 2 0 9 10

05 Minuto C 2 3 11 12

06 Segundo C 2 0 13 14

07 Loja C 3 0 15 17

08 Caixa C 3 0 18 20

09 Numero de Cupom C 6 0 21 26

Exemplo:

yyyyMMddHHmmSSLLLcccPPPPPP.TXT

Page 37: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 36

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Page 38: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 37

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.25 TITULOS.TXT (Títulos / Parcelas / Contas a Receber)

Campo Tipo Tam Dec Inicio Fim Observação

01 Número do Documento C 20 1 20

02 Emissão do Documento D 8 21 28

03 Vencimento do Documento D 8 29 36

04 Valor N 12 2 37 48 Valor em aberto

05 Juros N 12 2 49 60 Valor da mora/multa

06 Código do Cliente N 16 0 61 76

07 Estado do Título C 1 77 77 A – Aberto P – Recebido Parcial R – Recebido Total

08 Permite Recebimento Parcial C 1 78 78 S – Sim / N – Não

09 Valor Recebido N 12 2 79 90 Valor já Recebido

Observação 1: O número do documento pode conter números, letras e alguns caracteres especiais como

hífen, virgula e ponto.

Observação 2: Nenhuma consistência será feita nos campos de data de emissão, data de vencimento,

valor, juros e valor recebido.

Observação 3: O valor a ser recebido será a soma dos campos valor e juros, subtraindo o valor recebido.

(valor a receber = (valor+juros)-valor recebido)

Observação 4: O cliente deverá estar cadastrado no arquivo de clientes.

2.3.26 LISTACAS.TXT (Lista de Casamento)

Campo Tipo Tam Dec Inicio Fim Observação

01 Código N 10 0 1 10

02 Nome da Noiva C 50 11 60

03 Nome do Noivo C 50 61 110

04 Data do Casamento D 8 111 118

05 Observação C 200 119 318

Page 39: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 38

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.27 MOVIMENTO ANALITICO GERADO PELO FRENTE DE LOJA /

CONCENTRADOR PARA A RETAGUARDA (MOVOUTRA.TXT)

Campo Tipo Tam Dec Inicio Fim Observação

01 Número do Documento N 6 0 1 6

02 Número da PV / Comanda C 8 7 14

03 Tipo do Documento L 1 15 15 T – Cupom Fiscal F –Pedido

04 Tipo do Registro C 2 16 17 Observação 1

05 Código do Produto (PLU) N 20 0 18 37

06 Tipo do Produto C 1 38 38 Observação 2

07 Quantidade N 8 3 39 46

08 Valor Unitário N 12 3 47 58

09 Valor Total N 12 2 59 70

10 Código do Vendedor N 4 0 71 74

11 Código da Empresa N 3 0 75 77 Cliente Convênio

12 Código do Cliente N 16 0 78 93

13 Tipo do Cliente C 1 94 94 L – Loja C - Convênio

14 Loja N 3 0 95 97

15 Caixa N 3 0 98 100

16 Operador N 4 0 101 104

17 Data D 8 105 112

18 Hora C 5 113 117 HH:MM

19 Código do Finalizador de Venda C 3 118 120 Observação 3

20 CGC / CPF (Cheque) C 19 121 139 Observação 4

21 Banco (Cheque) C 3 140 142 Observação 48

22 Agência (Cheque) C 7 143 149 Observação 49

23 Antigo Conta Corrente (Cheque) C 9 150 158 Observação 5 / Observação 61

24 Número do Cheque (Cheque) C 6 159 164 Observação 60

25 Data de Vencimento (Cheque) D 8 165 172

26 Reservado - Espaço em Branco C 2 173 174

27 Código do Titular (Cartão RC) N 8 0 175 182

28 Sequência (Cartão RC) N 1 0 183 183

29 Via (Cartão RC) N 1 0 184 184 Observação 50

30 Número da Boleta (Cartão RC) N 8 0 185 192

31 Código da Condição Pagto (Cartão RC) N 4 0 193 196

32 Condição de Pagamento C 10 197 206 Nº Parcelas TEF/ Senha /Cond.Pagto/ TicketVasilhame / Ticket Troca

33 Telefone (Cheque) C 10 207 216

34 Atual Conta Corrente (Cheque) C 10 217 226 Observação 5 / Observação 62

35 CMC-7 / Número do Documento C 70 227 296

36 Rede Destino da Transação (TEF) N 4 0 297 300 Tabela 1

Page 40: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 39

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

(MOVOUTRA.TXT - CONTINUAÇÃO)

Campo Tipo Tam Dec Inicio Fim Observação

37 Tipo da Transação (TEF) C 1 301 301 Tabela 3

38 Número do Cartão (Crédito Rotativo) C 40 302 341 Interno

39 Tipo do Documento Pagamento Conta N 3 0 342 344 Observação 16

40 Status da Transação (TEF) C 1 345 345 N - Não Efetivada

41 Valor do Troco N 12 2 346 357 Observação 17

42 Tabela de Preço Utilizada C 1 358 358 A – Atacado E – Especial P – Padrão R – Promoção

43 Pontos Concedidos neste item N 8 4 359 366 Clube Fidelidade

44 Tributação C 6 367 372 Observação 18

45 1º Documento Digitado C 20 373 392 Observação 19

46 Contador de Ordem de Operação (COO) N 6 0 393 398

47 Número de Ordem do Item no Cupom N 6 0 399 404

48 2º Documento Digitado C 20 405 424 Observação 19

49 3º Documento Digitado C 20 425 444 Observação 19

50 4º Documento Digitado C 20 445 464 Observação 19

51 Número da ECF N 3 0 465 467

52 Supervisor N 4 0 468 471 Observação 22

53 Data do Movimento D 8 472 479 Observação 23

54 Código de Barras Digitado / Lido C 20 480 499 Observação 52

55 Desconto do Item N 12 3 500 511 Observação 24

56 Abatimento ( Cupom ) N 12 3 512 523 Observação 25

57 Acréscimo ( Cupom ) N 12 3 524 535 Observação 26

58 Tipo do Parcelamento (TEF) C 2 536 537 Tabela 4

59 Código da Tabela de Preço Utilizada N 6 0 538 543

60 Bin do Cartão de Débito/Crédito (TEF) C 6 544 549

61 Número de Parcelas ( Crédito Rotativo ) N 2 0 550 551

62 Indicação de Registro Cancelado L 1 552 552 Observação 29

63 Código do Finalizador de Venda Anterior C 3 553 555 Observação 30

64 Tipo do Registro Referente ao Finalizador C 2 556 557 Observação 32

65 Número do Ticket de Troca N 6 0 558 563 Observação 33

66 Tanque C 2 564 565 Observação 34

67 Bico C 2 566 567 Observação 34

68 Número do Abastecimento N 6 0 568 573 Observação 34

69 Numero Seqüencial do Abastecimento N 6 0 574 579 Observação 34

70 Local do Cancelamento do Registro N 1 0 580 580 0 – PDV 1 – Retaguarda

71 Código da Lista de Casamento N 10 0 581 590

72 C1 ( Cheque ) N 1 0 591 591

Page 41: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 40

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

(MOVOUTRA.TXT - CONTINUAÇÃO)

Campo Tipo Tam Dec Inicio Fim Observação

73 C2 ( Cheque ) N 1 0 592 592

74 C3 ( Cheque ) N 1 0 593 593

75 Contador de Cupom Fiscal (CCF) N 6 0 594 599

76 Camara de Compensação N 3 0 600 602

77 Desconto Produto/Preço/Múltiplos N 12 3 603 614 Observação 37

78 Desconto Promoção Campanha N 12 3 615 626 Observação 38

79 Contador de Redução Z (CRZ) N 6 0 627 632

80 NSU Autorizador TEF C 15 633 647

81 Código do Cartão do Cliente N 3 0 648 650 Somente Versão Flex

82 Quantidade Referente a Produto/Preço/Múltiplos

N 5 0 651 655

83 Quantidade Máxima Referente a Produto/Preço/Múltiplos

N 5 0 656 660

84 Contador de Seqüência Fiscal (SEQCF) N 6 0 661 666 Somente Versão Flex

85 Contador de Seqüência Não-Fiscal (SEQCNF)

N 6 0 667 672 Somente Versão Flex

86 Acréscimo do Item N 12 3 673 684 Somente Versão Flex Observação 43

87 Número do DAV / Pedido N 10 0 685 694 Somente Versão Flex Observação 44

88 Título do DAV / Pedido C 1 695 695 Somente Versão Flex O – Orçamento P – Pedido

89 NFC-e Enviada * C 1 696 696 ‘S’ ou ‘N’

90 NFC-e Emitida em Contingência * C 1 697 697 ‘S’ ou ‘N’

91 NFC-e Modelo ** C 2 698 699 65 NFC-e – 59 CF-e

92 NFC-e Série * N 3 0 700 702 Número do caixa

93 NFC-e Chave ** C 44 703 746

94 NFC-e Protocolo de autorização ** C 15 747 761 Observação 51

95 NFC-e Data/Hora de autorização ** C 30 762 791

96 NFC-e Protocolo de cancelamento ** C 15 792 806 Observação 51

97 NFC-e Data/Hora de cancelamento ** C 30 807 836

98 NFC-e Data/Hora de entrada em contingência *

C 30 837 866

99 NFC-e Justificativa de contingência * C 100 867 966

100 NFC-e Tipo de impressão * N 1 0 967 967

101 NFC-e Forma de emissão * N 1 0 968 968

102 NFC-e Tipo de ambiente * N 1 0 969 969

103 NFC-e Digest Value * C 100 970 1069

104 Código da Bandeira de Cartão de Crédito (SiTef)

N 5 0 1070 1074 Tabela 5

105 Nome da Instituição (SiTef) C 50 1075 1124 Exemplo: “VISA CREDITO”, “VISA ELECTRON”, “PLANVALE”

106 CST do PIS ** C 2 1125 1126

107 Alíquota do PIS ** N 9 2 1127 1135

108 CST do COFINS ** C 2 1136 1137

109 Alíquota do COFINS ** N 9 2 1138 1146

110 Preço de Custo N 9 3 1147 1155

Page 42: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 41

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

111 Preço Máximo ao Consumidor (PMC) N 9 3 1156 1164

112 Valor Comissão N 13 3 1165 1177

113 CST IPI C 2 1178 1179 Observação 59

114 Alíquota IPI N 8 4 1180 1187 Observação 59

115 Natureza da receita PIS e COFINS N 3 1188 1190 Observação 59

116 Enquadramento IPI N 3 1191 1193 Observação 59

117 Alíquota PIS Quantidade N 9 4 1194 1202 Observação 59

118 Alíquota COFINS Quantidade N 9 4 1203 1211 Observação 59

119 Base de cálculo de ICMS N 12 2 1212 1223 Observação 59

120 Base de cálculo de PIS N 12 2 1224 1235 Observação 59

121 Base de cálculo de COFINS N 12 2 1236 1247 Observação 59

* NFC-e

** (NFC-e e CF-e SAT)

OBSERVAÇÃO 1 : TIPO DO REGISTRO

• 01 - Venda de Item

• 02 - Abatimento (Desconto) sobre total do Cupom

• 03 - Finalizador de Venda

• 04 - Cancelamento de Cupom

• 05 - Acréscimo sobre Total do Cupom

• 06 - Contra-Vale emitido

• 07 - Cupom Vasilhame

• 08 - Ticket de Troca Emitido

• 09 - Correção de Finalizador

• 10 - Cancelamento de Item

• 11 - Cancelamento de Venda

• 12 - Troco de Finalizador

• 13 - Identificação do Cliente (CAT)

• 14 - Promoção Campanha

• 15 - Cartão Fidelidade

• 16 - Sangria

• 17 - Dados para geração de registro R06 - Ato Cotepe 06/08

• 18 - Identificação do Cliente (Lei Anti-Álcool)

• 19 - Itens de venda Cancelada (PAF)

• 20 - SuperTroco (Observação 54)

• 21 - Entrada em Caixa (Reforço)

• 22 - Saída no Caixa

• 23 - Abertura de Caixa

• 24 - Fechamento de Caixa

• 25 - Encerramento de Dia ( Redução Z )

• 26 - Redução Gerencial Z

• 27 - Email marketing (Observação 55)

• 28 - Cliente (Observação 56)

• 29 - Operador (Observação 56)

• 30 - Emissão Cupom sobre Pedido (No Campo Código do Cliente será gravado o número do

Pedido de origem)

• 31 - CPF/CGC utilizando na integração com ZoomBox (Observação 57) • 32 - Taxa de serviço utilizada no pagamento da compra

Page 43: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 42

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

• 33 - Complemento de produto

• 34 - IPTU Garantido

• 35 - Aferição (Tanque/Bico )

• 36 - Abastecimento (Observação 53)

• 37 - Vias de cupom Supertroco

• 38 - Taxa de entrega (Observação 58)

• 39 - Campanha de Troco

• 40 - Cancelamento Compra Cartão Próprio / Autorizadores

• 41 - Cancelamento Compra Cartão Crédito Rotativo

• 42 - Cancelamento Transação TEF DISCADO

• 43 - Cancelamento Transação TEF

• 44 - Cancelamento de Pagamento de Conta

• 45 - Cancelamento de Recebimento de Conta de Cliente Loja

• 46 - Cupom desconto

• 47 - Detalhes de item de pedido integração

• 49 - Fechamento Scanntech

• 50 - Cadastro de Senha de Cliente

• 51 - Identificação cliente GIVEX

• 53 - Dados do Intermediador (Observação 63)

• 60 - Pagamento de Conta

• 70 - Recebimento de Conta de Cliente Loja

• 80 - Correspondente Bancário

• 81 - Saque Cartão ( Compra&Saque e Troco-Fácil )

• 82 - Correspondente Bancário ( Banco Completo )

• 83 - Bônus de cliente

• 90 - Recarga de Celular

• 97 - Cupom de uso/consumo

• 98 - Itens de CF-e Complementar

• 99 - Nota A/A1 referenciada no cupom (PAF ER 02.02)

Observação 2: O campo Tipo do Produto será preenchido com a letra F quando se tratar de uma

fórmula assim como os itens desta fórmula viram em seguida preenchidos com a letra C.

Em todos os outros casos ele estará em branco.

Observação 3: O campo Código do Finalizador de Venda virá sempre preenchido com 3 dígitos.

Exemplo: 001, 010, 150, etc...

Observação 4: O campo CGC/CPF irá conter a máscara. Exemplo:

CPF: 12345678910 123.456.789-10

CPF: 1234567891 012.345.678-91

CGC: 12345678000123 012.345.678/0001-23

CGC: 123456789000123 123.456.789/0001-23

Observação 5: Quando Status 03 com pagamento em finalizador CHEQUE: Para manter a

compatibilidade com versões anteriores, sempre que o NÚMERO DA CONTA

CORRENTE (CHEQUE), for menor que 10 dígitos, serão atualizados os campos Antigo

e Atual Número da Conta. As retaguardas que estiverem utilizando o manual para

Page 44: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 43

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

interligação versão 5.00 ou superior deverão utilizar apenas o campo Atual Número da

Conta.

Observação 6: O campo CMC7 será atualizado quando o Tipo do Registro for 03 (Finalizador de

Venda), o Código do Finalizador de Venda for igual a Cheque ou Cheque- Pré e o

PDV possuir leitor de CMC-7 instalado.

Observação 7: O campo CMC7 será preenchido com o NÚMERO DO DOCUMENTO quando o

Tipo do Registro for 60 (Pagamento de Conta) e com a OBSERVAÇÃO DIGITADA

PELO OPERADOR DE CAIXA quando o Tipo do Registro for 21 ou 22 (Entrada em

Caixa / Saída no Caixa).

Observação 8: Os campos referentes ao cheque, serão atualizados quando o Tipo do Registro for 03

(Finalizador de Venda) e o Código do Finalizador de Venda for igual a Cheque ou

Cheque-Pré.

Observação 9: Os campos Código da Empresa, Código do Cliente e Tipo do Cliente serão atualizados

sempre que o cliente, seja convênio ou loja, for informado.

Observação 10: Somente será uma venda convênio ou fiado quando os campos Código da Empresa,

Código do Cliente e Tipo do Cliente estiverem preenchidos, o Tipo do Registro for igual

a 03 (Finalizador de Venda) e o Código do Finalizador de Venda for igual a Convênio.

De outra forma será apenas um registro da compra do cliente informado.

Observação 11: Quando o Tipo do Registro for igual a 07 (Cupom Vasilhame) o número do cupom

vasilhame virá no campo Condição de Pagamento.

Observação 12: Quando o Tipo do Registro for igual a 50 (Cadastro de Senha de Cliente) a senha

digitada pelo cliente virá no campo 1º Documento Digitado.

Observação 13: Quando o Tipo do Registro for igual a 25 (Encerramento de Dia - Redução Z) o

Número do Documento virá com o número do ultimo cupom impresso, o Contador de

Ordem de Operação (COO) virá com o número do ultimo COO, o Número de Ordem

do Item no Cupom virá com o número do contador de redução (CRZ), o 1º Documento

Digitado virá com o valor do GT inicial, o 2º Documento Digitado virá com o valor do

GT final, o 3º Documento Digitado virá com o valor da venda bruta e o 4º Documento

Digitado virá com o valor da venda líquida.

Observação 14: Quando o Tipo do Registro for igual a 60 (Pagamento de Conta) o Valor Total virá com

o valor pago pelo cliente no pdv.

Observação 15: Quando o Tipo do Registro for igual a 70 (Recebimento de Conta de Cliente Loja) o

Valor Total virá com o valor pago pelo cliente no pdv.

Observação 16: O campo Tipo do Documento Pagamento de Conta será preenchido com o Código do

Tipo de Documento ( cadastrado no módulo concentrador ) quando o Tipo do Registro

for 60 (Pagamento de Conta).

Page 45: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 44

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 17: O campo Valor do Troco será preenchido quando o Tipo do Registro for igual a 03 (

Finalizador de Venda ). Esse valor deverá ser utilizado quando houver a necessidade de

se obter o valor líquido do finalizador. Exemplo: Para uma compra com valor total R$

90,00 que foi recebida com finalizador de venda 003 no valor de R$ 100,00, os campos

virão preenchidos da seguinte forma.

Código do Finalizador de Venda: 003

Valor Total: R$ 100,00

Valor do Troco: R$ 10,00

Observação 18: O campo Tributação será preenchido quando o Tipo do Registro for igual a 01 ( Venda

de Item ). Este campo é composto pela legenda da tributação e do valor da alíquota

utilizada. Exemplo:

F00.00 Substituição Tributária

I00.00 Isento

T18.00 Tributado - ICMS 18%

S04.00 Tributado - Serviço 4%

Observação 19: Quando o Tipo do Registro for igual a 03 (Finalizador de Venda) o campo Documento

Digitado será preenchido quando no cadastro de Modalidade de Pagamento (Finalizador)

estiver configurado para que o PDV solicite o documento.

CAMPO45 – Primeiro Documento Digitado

Tipo do Registro for igual a 01, este campo terá o Código de Barras do Produto.

CAMPO49 – Terceiro Documento Digitado

Tipo do Registro for igual a 01, este campo terá o da Fórmula, quando este produto for

um componente.

CAMPO50 – Quarto Documento Digitado.

Quando o Tipo do cupom for NFC-e e o Tipo do Registro for igual a 01, este campo

terá a CSOSN do produto.

Quando o Tipo do Registro for igual a 60 (Pagamento de Conta) e o Tipo de Conta

for TecTotal o campo 1º Documento Digitado conterá o número do certificado e o campo

3º Documento Digitado conterá o código do FTP no formato TEC:<código com 4

dígitos>.

Quando o Tipo do Registro for igual a 60 (Pagamento de Conta) e o Tipo de Conta

for B2C o campo 3º Documento Digitado conterá a flag B2C para indicar o tipo de conta.

Observação 20: O campo Condição de Pagamento será preenchido com o Número do Ticket de Troca

quando o Tipo do Registro for 03 (Finalizador de Venda) e no cadastro de Modalidade

de Pagamento (Finalizador) estiver configurado para que o PDV solicite o documento.

Observação 21: Quando o Tipo do Registro for igual a 09 (Correção de Finalizador) o 1º Documento

Digitado virá com o número do cupom fiscal de origem, o Valor Total virá com o valor

da correção, o 2º Documento Digitado virá com o finalizador de origem e o 3º Documento

Digitado virá com o finalizador de destino. Os outros campos seram preenchidos de acordo

com o finalizador de destino, seguindo o mesmo padrão do Tipo de Registro 03 (

Finalizador de Venda ). O Registro 03 ( Finalizador de Venda ) do cupom fiscal de

origem será atualizado com os novos dados do finalizador.

Page 46: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 45

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 22: O campo Supervisor será preenchido com o código do supervisor que autorizou a

transação quando a mesma foi negada por algum motivo.

Observação 23: Quando o Frente de Loja estiver configurado e trabalhando no modo 24 horas, este

campo virá com a data referente ao movimento, quando não estiver configurado terá o

mesmo valor do campo data.

Observação 24: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor do

desconto concedido no item. Lembrando que esse valor é apenas informativo, o campo

Valor Total contém o valor líquido do item, ou seja, já abatido esse valor. O sistema

deverá estar parametrizado para imprimir preço promoção direto como N, caso contrário

esse campo será gravado com 0,00

Observação 25: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor do

abatimento concedido no cupom ( rateado pelo valor total do item ). Esse campo é útil

quando a retaguarda não efetua o rateio automático.

Observação 26: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor do

acréscimo concedido no cupom ( rateado pelo valor total do item ). Esse campo é útil

quando a retaguarda não efetua o rateio automático.

Observação 27: Quando o Tipo do Registro for igual a 11 (Cancelamento de Venda) indica que o cupom

foi cancelado ainda aberto, diferente do Tipo do Registro 04 (Cancelamento de Cupom)

que é referente a um cupom que foi finalizado e posteriormente cancelado. Para efeito de

venda, este registro (11 – Cancelamento de Venda) não deve ser abatido, pois não existirá

o registro do cupom como venda.

Observação 28: Quando o Tipo do Registro for igual a 12 (Troco de Finalizador), o campo Código do

Finalizador de Venda virá com o finalizador ao qual o troco se refere. Esse tipo de registro

foi criado para uso em consultas e relatórios específicos, todo o tratamento necessário ao

cupom deve ser feito no Tipo de

Registro 03 (Finalizador de Venda).

Observação 29: Quando houver cancelamento de um cupom (Tipo do Registro 04 - Cancelamento de

Cupom), o campo Indicação de Registro Cancelado será atualizado com verdadeiro em

todos os tipos de registros referente ao cupom cancelado.

Observação 30: Quando houver correção de finalizador no cupom (Tipo do Registro 09), o campo Código

do Finalizador de Venda Anterior será preenchido com o código anterior a correção.

Lembrando que em caso de correção de finalizador, os dados do Tipo do Registro 03

(Finalizador de Venda) serão os dados após a correção e não os dados originais.

Observação 31: Quando o Tipo do Registro for igual a 10 (Cancelamento de Item), não haverá

necessidade de se efetuar um abatimento ou cancelamento referente ao mesmo, pois não

irá existir um registro de venda (Tipo do Registro 01) em contrapartida ao registro. Esse

tipo de registro foi criado para uso em consultas e relatórios específicos, devendo o mesmo

ser ignorado para efeito de venda.

Page 47: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 46

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 32: Quando o Tipo do Registro for igual a 03 (Finalizador de Venda), o campo Código do

Registro Referente ao Finalizador virá preenchido com o tipo do registro referente ao

mesmo. Exemplo:

Finalizador Referente a um Cupom: 01 – Venda de Item

Finalizador de um Pagamento de Conta: 60 – Pagamento de Conta

Finalizador de um Correspondente Bancário: 80 – Correspondente Bancário

Observação 33: Quando o Tipo do Registro for igual a 03 (Finalizador de Venda) e o finalizador for do

tipo Troca, o campo Número do Ticket de Troca virá preenchido com o ticket de troca

utilizado.

Observação 34: Registro utilizado para o controle de bombas de combustível.

Observação 35: O campo DESCITEM será preenchido com a quantidade quando o Tipo do Registro for

igual a 35 (Iniciante Tanque/Bico) ou 37 (Encerrante Tanque/Bico).

Observação 36: Quando o Tipo do Registro for igual a 24 (Fechamento de Caixa) o Valor Unitário virá

com o valor total da venda do operador e o Valor Total virá com o troco final.

Observação 37: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor do

abatimento concedido no cupom relativo a produto/preço/múltiplos (rateado pelo valor

total do item).

Observação 38: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor do

abatimento concedido no cupom relativo a promoção campanha

(rateado pelo valor total do item).

Observação 39: Quando o Tipo do Registro for igual a 01 (Venda de Item) e o produto estiver

configurado para solicitar descrição complementar, o campo Número do Cartão (Crédito

Rotativo Interno) será preenchido com a descrição complementar.

Observação 40: Quando o Tipo do Registro for igual a 13 (Identificação do Cliente - CAT) o campo

CGC/CPF (Cheque) será preenchido com o CPF/CNPJ, o campo 1º Documento

Digitado será preenchido com o nome do cliente e o campo CMC7 será preenchido com

o endereço do cliente.

Observação 41: Quando o Tipo do Registro for igual a 14 (Promoção Campanha) o campo Código do

Finalizador de Venda será preenchido com o finalizador relativo ao desconto, o campo

1º Documento Digitado será preenchido com o tipo do desconto e o campo 2º Documento

Digitado será preenchido com o código da promoção campanha.

Observação 42: Quando o Tipo do Registro for igual a 81 (Saque Cartão) o campo Valor Total será

preenchido com o troco devolvido ao cliente na transação de cartão (TEF).

Observação 43: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor do

acréscimo concedido no item. Lembrando que esse valor é apenas informativo, o campo

Valor Total contém o valor líquido do item, ou seja, já acrescido esse valor. O sistema

Page 48: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 47

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

deverá estar parametrizado para imprimir preço promoção direto como N, caso contrário

esse campo será gravado com 0,00

Observação 44: Pela regra definida no ato cotepe 06/08 (PAF-ECF) o contador para DAV ou Pedido passa

a ter 10 dígitos obrigatoriamente. Quando o frente de loja estiver utilizando o regime do

PAF-ECF, os campos Número da PV/Comanda e o Número do DAV / Pedido serão

atualizados conforme o tipo do documento processado pelo frente de loja. Para efeito de

compatibilidade com versões anteriores, quando o frente de loja não estiver utilizando o

regime do PAF-ECF, o campo Número do DAV / Pedido será atualizado com o mesmo

conteúdo do campo Número da PV / Comanda.

Observação 45: Quando o Tipo do Registro for igual a 15 (Cartão Fidelidade) o campo 1º Documento

Digitado será preenchido com o número do cartão fidelidade.

Observação 46: Quando o Tipo do Registro for igual a 03 (Finalizador de Venda) e o finalizador for do

tipo TEF, o campo Número do Cartão (Crédito Rotativo) virá preenchido com o código

de autorização para as transações de crédito (15 posições no máximo). (Somente para Versão

Flex)

Observação 47: Quando o Tipo do Registro for igual a 18 (Identificação do Cliente – Lei AntiÁlcool) o

campo 1º Documento Digitado será preenchido com o número do documento de

identidade (RG) do cliente e o 2º Documento Digitado será preenchido com o nome. (Somente para Versão Flex)

Observação 48: Será gravado a ST que estiver cadastrada na tributação do produto (tabela tributa), quando

status do registro for 01

Observação 49: Será gravado a CFOP de venda (NFC-e e CF-e - SAT), quando status do registro for 01

Observação 50: Será gravado o valor fixo 9 para identificar um cliente DMCard (SOU+), quando status do

registro for 03

Observação 51: Quando NFC-e (Modelo 65) – Será gravado o protocolo de autorização fornecido pela

SEFAZ no momento da venda, em todos os registros do cupom.

Quando CF-e (Modelo 59) – Será gravado o número de série do SAT que efetuou a venda

e o número do extrato fornecido pelo SAT no formato abaixo:

SSSSSSSSSXXXXXX, onde S será o número de série do SAT e o X, será o número do

extrato.

Observação 52: No registro de Finalizador de Venda (STATUS 03), quando o cliente for participante

do programa SOU+, será gravado nesse campo o CPF informado no programa, em

qualquer forma de pagamento adotada pelo mesmo.

Exemplo:

a. CPF do Cliente SOU+: 111.111.111-11

b. CPF do Cliente da Loja: 222.222.222.-22

Na geração do registro de STATUS 03:

Campo 20(CGC) será gravado a informação b (222.222.222.-22)

Campo 54(COD.BARRAS) será gravado a informação a (111.111.111-11)

Page 49: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 48

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Observação 53: Quando o Tipo do Registro for igual a 36, será gerado um registro para cada combustível

coletado. Os campos específicos serão gravados da seguinte forma:

Tabela Abastecimentos (origem) Campo na MOVOUTRA

Encerrante Inicial Campo 45

Encerrante Final Campo 48

Observação 54: Quando houver SuperTroco, o status 12 permanece da mesma forma, ou seja, irá ter o valor

do troco devolvido ao cliente, o status 20 terá no campo VALORTOT o valor do

SuperTroco que o cliente aceitou pagar para participar.

Observação 55: Quando houver utilização de PDV Mobile, as informações de e-mail marketing serão

gravadas como abaixo:

Campo CGC – Será gravado o CPF/CNPJ informado.

Campo CMC7 – Será gravado o e-mail informado.

Observação 56: Será gravado as informações da bonificação Minutrade:

Campo VALORTOT – Será gravado o valor total do bônus entregue ao cliente/operador.

Campo CMC7 – Será gravado o telefone do cliente/operador.

Observação 57: Será gravado as informações do CPF/CGC utilizado na interação com CRM ZoomBox

Campo CGC – Valor informado PinPad/Tela.

Observação 58: Outros dados da taxa de entrega na linha do status 38:

valortot: valor da taxa de entrega docto: XXX=S ou XXX=N, onde XXX é o código do finalizador com a taxa de entrega, e S/N(Sim/Não) indicam se a taxa foi incluída na base do ICMS ou não.

Observação 59: Esse campo só será gerado na exportação do arquivo movoutra.txt. Para arquivo gerado por terceiro e que será importado no Flex, este campo não deverá ser preenchido.

Observação 60: O campo Alíquota do ICMS original do produto será preenchido quando o Tipo do

Registro for igual a 01 (Venda de Item). Este campo é composto pela legenda da tributação e do valor da alíquota cadastradas no produto. Exemplo: T17.00

Observação 61: Será gravado a redução do ICMS cadastrada na tributação do produto (tabela tributa), quando status do registro for 01.

Observação 62: Será gravado a ST que estiver cadastrada na tributação do produto (tabela tributa),

quando status do registro for 01. Observação 63: Colunas gravados na linha de status 53:

Page 50: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 49

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

cgc = CNPJ do intermediador tabela = código do intermediador cmc7 = razão social do intermediador docto, docto2 e docto3 = identificação no intermediador Além dos campos chave (loja/caixa/cupom/data/datamovto), titularrc e campos de NFC-e

2.3.28 LOG DE MOVIMENTO AUTOMÁTICO GERADO PELO FRENTE DE LOJA

PARA A RETAGUARDA (lvxxxxxx.ccc)

• Através desse recurso, a retaguarda poderá obter de forma online as operações de venda do frente

de loja (venda e cancelamento) ou todas as operações (abertura, sangria, venda, cancelamento, fechamento, etc).

• O arquivo será gerado após a confirmação da operação, em local parametrizado no módulo

concentrador.

• O layout do arquivo segue o mesmo padrão do arquivo de movimento analítico (MOVOUTRA).

• OBSERVAÇÕES

o O arquivo deverá ser apagado pela retaguarda após a sua leitura.

o O CCC do nome do arquivo é o número do caixa.

o Se o parâmetro Gerar movoutra_fiscal.txt estiver selecionado em FlexBridge > Parâmetros sistema > aba Parâmetros, ao gerar o LV, também será gerado o LV_FISCALxxxxxx.ccc correspondente, com as informações fiscais das vendas. Este arquivo seguirá o layout do arquivo MOVOUTRA_FISCAL.TXT descrito na página 57.

• DICAS PARA A LEITURA DO LOG

o Não utilize o nome do arquivo de log para controle. Utilize o número do documento e do caixa

que estão dentro do arquivo.

o No programa de leitura do log, deixar um tempo (sleep) entre as pesquisas. Isto evita erros de

leitura e gravação, além de evitar tráfego excessivo no servidor.

o Pesquisar no diretório parametrizado, arquivos com o escopo lv*.* ou lv??????.???. Despreze

qualquer outro escopo, pois o frente de loja utiliza arquivos temporários nesta pasta para a

geração do log.

o Quando for efetuar a leitura do log, tente abrir o arquivo em modo exclusivo para garantir que

o frente de loja ainda não esta em processo de gravação do mesmo. Caso não consiga abrir em

modo exclusivo, aguarde um tempo (sleep) e tente novamente. Após um número de tentativas

sem sucesso, termine o processo e solicite uma verificação no servidor para ver se o arquivo

não está travado.

o Após a leitura e processamento do arquivo, apague o mesmo. Após apagar, verifique se o

mesmo ainda não se encontra no diretório. Caso não consiga apagar o arquivo, termine o

processo e solicite uma verificação no servidor para ver se o arquivo não está travado.

Page 51: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 50

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.29 MOVIMENTO SINTÉTICO GERADO PELO CONCENTRADOR PARA A

RETAGUARDA (MOVSINT.TXT)

Campo Tipo Tam Dec Inicio Fim Observação

01 Data D 8 1 8

02 Loja N 3 0 9 11

03 Tipo do Registro C 2 12 13 Observação 1

04 Código do Produto (PLU) ou Finalizador N 20 0 14 33

05 Quantidade N 15 3 34 48

06 Valor Total N 15 2 49 63

07 Valor Total dos Abatimentos N 15 2 64 78 Observação 2

08 Valor Total dos Acréscimos N 15 2 79 93 Observação 3

Observação 1: Utilizar o mesmo TIPO DO REGISTRO do arquivo MOVOUTRA.TXT

Observação 2: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor total

dos abatimentos concedidos ao produto.

Quando o Tipo do Registro for igual a 03 (Finalizador de Venda) esse campo terá o

valor total dos trocos concedidos do finalizador, com exceção do finalizador DINHEIRO

(código padrão 001). Lembrando que esse valor é apenas informativo, pois o campo de

valor total contém o valor líquido, ou seja, já abatido esse valor.

Observação 3: Quando o Tipo do Registro for igual a 01 (Venda de Item) esse campo terá o valor total

dos acréscimos concedidos ao produto.

EXEMPLO DE REGISTROS:

AAAAMMDDLLL01xxxxxxx7891234567890000000000100000000000000150000000000000001500000000000001200

AAAAMMDDLLL01xxxxxxxxxxxxxxxx1001000000000100000000000000150000000000000000000000000000000000

AAAAMMDDLLL02xxxxxxxxxxxxxxxxxxxx000000000002000000000000020000000000000000000000000000000000

AAAAMMDDLLL03001xxxxxxxxxxxxxxxxx000000000020000000000000200000000000000000000000000000000000

AAAAMMDDLLL03002xxxxxxxxxxxxxxxxx000000000020000000000000200000000000000015000000000000000000

AAAAMMDDLLL11xxxxxxxxxxxxxxxxxxxx000000000000000000000000050000000000000000000000000000000000

AAAAMMDDLLL12xxxxxxxxxxxxxxxxxxxx000000000020000000000000100000000000000000000000000000000000

Obs: O caracter “x” representa 1 (um) espaço em branco

2.3.30 INVENTARIO GERADO PELO FRENTE DE LOJA / CONCENTRADOR

(CONTAGEM.TXT)

• Existe um recurso disponível no Frente de Loja (a partir da versão 8.16), onde há possibilidade da

utilização do caixa para a contagem de estoque (inventário).

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto (PLU) N 20 0 1 20

02 Quantidade N 7 3 21 27

03 Operador N 4 0 28 31

Page 52: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 51

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

04 Data D 8 32 39

05 Hora C 5 40 44 HH:MM

06 Caixa N 3 0 45 47

07 Loja N 3 0 48 50

2.3.31 CHECAGEM DE PREÇOS GERADO PELO FRENTE DE LOJA /

CONCENTRADOR (MATABURO.TXT)

• Existe um recurso disponível no Frente de Loja (a partir da versão 10.27), onde há possibilidade

da utilização do caixa para a checagem de preços.

Campo Tipo Tam Dec Inicio Fim Observação

01 Código do Produto (PLU) N 20 0 1 20

02 Preço de Venda N 9 3 21 29

03 Situação C 1 30 30 A – Alterado C – Confirmado

04 Operador N 4 0 31 34

05 Data D 8 35 42

06 Hora C 5 43 47 HH:MM

07 Caixa N 3 0 48 50

08 Loja N 3 0 51 53

Page 53: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 52

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.32 MAPA RESUMO ECF GERADO PELO FRENTE DE LOJA OU PELO

CONCENTRADOR PARA A RETAGUARDA (MAPAECF.TXT)

Campo Tipo Tam Dec Inicio Fim Observação

01 Data D 8 1 8

02 Loja N 3 0 9 11

03 Número da ECF N 3 0 12 14

04 Número de Reduções Efetuadas N 6 0 15 20 CRZ

05 Operação Inicial N 6 0 21 26 COO

06 Operação Final N 6 0 27 32

07 Operação Não Fiscal Inicial N 6 0 33 38 GNF

08 Operação Não Fiscal Final N 6 0 39 44

09 Reinicio Inicial N 6 0 45 50 CRO – Observação 2

10 Reinicio Final N 6 0 51 56 CRO – Observação 2

11 Cupons Não Fiscais Emitidos N 6 0 57 62 CDC

12 Cupons Fiscais Emitidos N 6 0 63 68 CCF

13 Itens Cancelados N 6 0 69 74

14 Cupons Cancelados N 6 0 75 80

15 Cupons Não Fiscais Cancelados N 6 0 81 86 NFC

16 Contador de Descontos N 6 0 87 92

17 Contador de Acréscimos N 6 0 93 98

18 GT Inicial N 18 2 99 116

19 GT Final N 18 2 117 134

20 Venda Bruta N 18 2 135 152

21 Valor Cupons Cancelados N 18 2 153 170

22 Valor Itens Cancelados N 18 2 171 188

23 Valor Desconto em Itens N 18 2 189 206

24 Valor Desconto N 18 2 207 224

25 Valor Acréscimo N 18 2 225 242

26 Venda Líquida N 18 2 243 260

Campo Tipo Tam Dec Inicio Fim Observação

01 Legenda da Tributação ( 1 a 20 ) C 10 261 270 Obs1

02 Alíquota ( 1 a 20 ) N 4 2 271 274

03 Valor de Venda da Tributação ( 1 a 20 ) N 18 2 275 292

04 Valor do Imposto Calculado ( 1 a 20 ) N 18 2 293 310

20 BLOCOS

Campo Tipo Tam Dec Inicio Fim Observação

01 Número do Caixa N 3 0 1261 1263

02 Número de Série de Fabricação do ECF C 20 1264 1283

03 Número do Mapa N 6 0 1284 1289 Quando gerado pelo

Concentrador ou FlexConcent 04 Hora da Geração do Mapa C 8 1290 1297 05 Geral de Relatório Gerencial N 6 0 1298 1303 GRG

06 Contador Fita Detalhe N 6 0 1304 1309 CFD

07 Codificação da Criptografia do GT C 10 1310 1319

Page 54: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 53

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

• OBSERVAÇÕES GERAIS:

o (Alguns campos poderão estar vazios devido ao fato da ECF não disponibilizar a informação.)

Observação 1: Determinados modelos de ECF podem não informar este campo quando não houver venda

em determinada alíquota. Alguns modelos de ECF podem gerar as informações de

alíquotas da seguinte forma:

Substituição Tributária = F00.00 ou F0000 ou F00.01 ou F0001, etc

Isento = I00.00 ou I0000 ou I00.01 ou I0001, etc

Não Tributado = N00.00 ou N0000 ou N00.01 ou N0001, etc

Tributado a 7% = T07.00 ou T0700, etc

Tributado a 12% = T12.00 ou T1200, etc

Tributado a 18% = T18.00 ou T1800, etc

Tributado a 17% = T17.00 ou T1700, etc

Tributado a 19% = T19.00 ou T1900, etc

Tributado a 25% = T25.00 ou T2500, etc

Tributado a 29% = T29.00 ou T2900, etc

Observação 2: Determinados modelos de ECF podem não informar este campo ou enviar em campos

diferentes.

2.3.33 TABELA 1 - REDE DESTINO DA TRANSAÇÃO (TEF)

Codigo Rede Codigo Rede

1 Tecban 119 Protege

4 Visanet (em desuso) 121 HotCard

5 Redecard 122 Banco Panamericano

6 | 194 Amex 124 SigaCred

18 Standby 125 Cielo

19 Edmcard 127 Cartao Presente Marisa

20 Credicesta 128 Cooplife

21 Banrisul 130 GCard

22 Redebase 131 TCredit

23 CSU 132 Siscred

25 Vidalink 133 Foxwin Card

27 Ediguay 134 Convcard

29 Conductor 135 SAV

30 Muticheque 136 Expand Cards

31 Autorizador Bonus 138 Qualicard

32 Yamada 140 Waapa

33 Citibank 141 SQCF

Page 55: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 54

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

34 Infocard 142 Intelisys

35 BESC 144 Accredito

36 CCS 145 Comprocard

37 Cheque Cash 146 Orgcard

38 Central Card 147 Minascred

39 PBMR 148 Farmacia Popular

40 OUTRO_SERVIÇO 149 Fidelidade Mais

41 Ticket Accor 152 Fortcard

42 Epay 153 Paggo

43 Senff 154 Smartnet

44 Tokoro 155 Interfarmacia

45 Coopercred 156 Valecon

46 Servcel 157 Cartão Evangélico

47 Sorocred 158 Vegas Card

49 SAX Financeira Marisa 159 SSCard

50 Formosa 160 Orbitall

51 Hipercard 161 Icards

52 Tricard 162 Facil Card

53 Check OK 163 Fidelize

54 Policard 164 Finamax

56 | 91 Leader 165 Banco GE

58 Gazincred 166 Unik

59 Telenet 167 TIVIT

61 Brasil Card 168 Validata

62 E – Pharma 169 Banescard

63 Rede Total 171 Valeshop

65 GAX 172 Somar Card

66 Peralta 173 Omnion

68 Banese 174 Condor

69 Resomaq 175 StandByDup

70 Sysdata 177 Marisa Sax Sysin

72 Big Card 178 StarFiche

73 Data Tranfer 179 Ace Seguros

75 | 107 Check Express 180 Top Card

76 Givex 182 Up Sight

77 Vale Card 183 MAR

78 Portal Card 184 Funcional BPM

79 Banpara 185 Pharma System

80 Softnex 186 Neus

81 Supercard 187 Sicredi

Page 56: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 55

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

82 | 181 Getnet 189 NServices

83 Prevsaude 190 CSF

84 Banco Pottencial 192 Avista

85 Sophus 193 Algorix

86 Marisa 195 Compremax

87 MaxiCred 196 Libercard

88 Black Hawk 197 Seicon

89 Expansiva 199 SmartN

90 Sas/NT 201 SmartNet

91 Leader 203 Peela

92 Somar 204 Nutrik

93 Aura – Cetelem 205 GoldenFarma BPM

94 Cabal 206 Global Payments

95 Credsystem 207 Elavon

97 Cartesys 208 CTF

98 Cisa 209 Banestik

99 TrnCentre 214 Eletrozema

101 Cardco 215 Barigui

102 CheckCheck - -

103 DaCasa 801 CB Banco do Brasil

104 Private Bradesco 802 CB Interchange

105 Platinum 803 CB Bank Boston

106 GwCel 804 CB Cef

109 Usecred 805 CB Bradesco

110 Serv_Voucher 806 CB Safra

111 Tradenexx 807 CB Santander

112 Cartão Presente 808 CB_Hsbc

113 Crediship 809 CB Bancoob

114 Porto Seguro 810 CB CorbanSe

115 IBI 811 CB GXS

116 WorkerCard 812 CB Itau

118 Oboe

2.3.34 TABELA 2 - CÓDIGOS DE SITUAÇÃO TRIBUTÁRIA

• OBSERVAÇÃO

o O campo é composto por duas tabelas (A e B) totalizando 3 caracteres.

Page 57: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 56

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

• TABELA A - ORIGEM DA MERCADORIA

0 - Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8; 1 - Estrangeira - Importação direta, exceto a indicada no código 6 2 - Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7 3 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% (quarenta por cento) 4 - Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei nº 288/67, e as Leis nºs 8.248/91, 8.387/91, 10.176/01 e 11 . 4 8 4 / 0 7 5 - Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40% (quarenta por cento) 6 - Estrangeira - Importação direta, sem similar nacional, constante em lista de Resolução CAMEX 7 - Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista de Resolução CAMEX” 8 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70% (setenta por cento)

• TABELA B - TRIBUTAÇÃO PELO ICMS

00 - TRIBUTADA INTEGRALMENTE

10 - TRIBUTADA E COM COBRANÇA DO ICMS POR SUBSTITUIÇÃO TRIBUTÁRIA

20 - COM REDUÇÃO DE BASE DE CÁLCULO

30 - ISENTA OU NÃO TRIBUTADA E COM COBR. ICMS POR SUBSTITUIÇÃO

TRIBUTÁRIA

40 - ISENTA

41 - NÃO TRIBUTADA

50 - SUSPENSÃO

51 - DIFERIMENTO

60 - ICMS COBRADO ANTERIORMENTE POR SUBSTITUIÇÃO TRIBUTÁRIA

70 - COM REDUÇÃO DE BASE DE CÁLCULO COBR. ICMS POR SUBST. TRIBUTÁRIA

90 - OUTROS

2.3.35 TABELA 3 – TIPO DA TRANSAÇÃO TEF

• OBSERVAÇÃO

o Na versão anterior ao TEF DEDICADO 4.1 somente retornara 'D' ou 'C'

D Cartão de Débito

C Cartão de Crédito

E Cheque

V Cartão Tipo Voucher

I Dinheiro

Q QRCode de Carteira Digital (Cadastro de caixa – GZ Serviços)

O Outros

Page 58: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 57

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.36 TABELA 4 – TIPO DO PARCELAMENTO TEF

• OBSERVAÇÃO

o Tabela válida somente para o TEF DEDICADO 4.1

00 À Vista

01 Pré-datado

02 Parcelado com financiamento pelo estabelecimento

03 Parcelado com financiamento pela administradora

2.3.37 TABELA 5 – BANDEIRAS DE CARTÃO DE CRÉDITO/DÉBITO

• OBSERVAÇÃO

o Dados extraídos da documentação da CliSiTef

00000 CréditoOutro, não definido

00001 CréditoVisa

00002 CréditoMastercard

00003 CréditoDiners

00004 CréditoAmerican Express

00005 CréditoSollo

00006 CréditoSirecard (Redecard)

00007 CréditoPrivate Label (Redecard)

00008 CréditoRedeshop

00009 CréditoPão de Açúcar

00010 CréditoFininvest (Visanet)

00011 CréditoJCB

00012 CréditoHipercard

00013 CréditoAura

00014 CréditoLosango

00015 CréditoSorocred

00000 Débito Débito Genérico

00001 Débito Voucher

20001 Débito Maestro

20002 Débito Electron

20003 Débito CabalDebit

10001 Débito Ticket

10002 Débito Visavale

10003 Débito Sodexho

10004 Débito Nitricash

10005 Débito Greencard

10006 Débito Planvale

10007 Débito Banquet

Page 59: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 58

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

10008 Débito Verocheque

10009 Débito Sapore

10010 Débito Bnbclube

10011 Débito Valecard

10012 Débito Cabal

2.3.38 EFETUANDO IMPORTAÇÃO E CARGA AUTOMÁTICA PELA PRÓPRIA

RETAGUARDA

• Através desse recurso, a retaguarda poderá solicitar ao FlexConcent / FlexBridge que execute a

importação da carga geral (arquivos com a extensão .TXT) e/ou carga parcial (arquivos com a extensão .ITE) e

ao final do processo enviar a carga das tabelas alteradas para o FlexPDV.

• VANTAGENS

o Automatizar os processos de Importação de Arquivos e Solicitação de Carga, existentes no

FlexConcent.

o Efetuar uma alteração parcial e/ou geral a qualquer momento, em qualquer uma das tabelas

disponíveis neste manual, na base do FlexConcent assim como em todos os FlexPDV do

estabelecimento.

• COMO FUNCIONA

o Carga Geral – Após a geração dos arquivos com a extensão .TXT no caminho especificado no

FlexBridge, criar um arquivo no mesmo caminho chamado carga.geral

o Carga Parcial – Após a geração dos arquivos com a extensão .ITE no caminho especificado

no FlexBridge, criar um arquivo no mesmo caminho chamado carga.parcial

• OBSERVAÇÕES

o Diferente do processo manual (FlexConcent) e do agendado (FlexBridge), após a execução do

processo, os arquivos envolvidos no processo, serão eliminados evitando assim uma carga

incorreta. No processo manual e no agendado os arquivos não são eliminados.

o Após o término da importação dos arquivos (extensão .TXT e/ou .ITE) o FlexBridge

automaticamente irá solicitar a carga das tabelas alteradas em todos os FlexPDV.

o Caso a retaguarda implemente a carga geral e/ou a parcial de forma automática, e queira saber

se o FlexBridge já processou a carga anterior, basta verificar se o arquivo carga.geral e/ou

carga.parcial ainda existe, se existir, o FlexBridge ainda não processou a carga anterior. Caso

não exista, aguarde até o arquivo extensão .TXT e/ou .ITE ser apagado e crie a nova carga.

o Disponível a partir da versão Flex 02.09.B2 2011.11.29.01

Page 60: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 59

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Page 61: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 60

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.39 INTERLIGAÇÃO GZ POSTO (LMC.TXT)

CABEÇALHO – OCORRÊNCIAS: 0-1

Campo Tipo Tam Dec Início Fim Observação

01 Identificador T 2 1 2 Fixo “L1”

02 Código da loja N 3 0 3 5

03 Número da folha N 9 0 6 14

04 Descrição do produto T 40 15 54 Observação 1

05 Data D 8 55 62 Observação 2

06 Valor total vendido (R$) N 13 2 63 75 Observação 3

07 Valor total acumulado no mês N 13 2 76 88 Observação 4

08 Observações T 256 89 345

Observação 1: Descrição utilizada no cadastro de produtos

Observação 2: Data de emissão do LMC Observação 3: Valor líquido de venda do produto na data de emissão Observação 4: Valor líquido de venda do produto a partir do 1o dia do mês

VOLUME DE ABERTURA E FECHAMENTO DOS TANQUES

OCORRÊNCIAS: 0-N (1 PARA CADA TANQUE)

Campo Tipo Tam Dec Início Fim Observações

01 Identificador T 2 1 2 Fixo “L2”

02 Código da loja N 3 0 3 5

03 Número da folha N 9 0 6 14

04 Código do tanque N 3 0 15 17

05 Volume de abertura em litros N 13 3 18 30

06 Volume de fechamento em litros N 13 3 31 43

07 Volume de perdas em litros N 13 3 44 56

08 Volume de ganhos em litros N 13 3 57 69

Page 62: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 61

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

VOLUME RECEBIDO (NOTAS DE ENTRADA)

OCORRÊNCIAS: 0-N (1 PARA CADA NOTA/TANQUE)

Campo Tipo Tam Dec Início Fim Observações

01 Identificador T 2 1 2 Fixo “L3”

02 Código da loja N 3 0 3 5

03 Número da folha N 9 0 6 14

04 Número da nota fiscal N 9 0 15 23

05 Série da nota fiscal T 5 24 28

06 Data da nota fiscal D 8 29 36

07 Código do tanque de descarga N 3 0 37 39

08 Volume recebido em litros no tanque de descarga N 13 3 40 52

VOLUME VENDIDO

OCORRÊNCIAS: 0-N (1 PARA CADA BICO)

Campo Tipo Tam Dec Início Fim Observações

01 Identificador T 2 1 2 Fixo “L4”

02 Código da loja N 3 0 3 5

03 Número da folha N 9 0 6 14

04 Código do tanque N 3 0 15 17

05 Código do bico T 2 18 19 Observação 1

06 Volume de abertura em litros N 13 3 20 32

07 Volume de fechamento em litros N 13 3 33 45

08 Volume de aferição em litros N 13 3 46 58

Observação 1: Código do bico configurado na bomba

TIPOS DE DADOS

TIPO DESCRIÇÃO Texto Alinhado à esquerda com espaços a direita Número Alinhado à direita com zeros a esquerda sem separadores.

Ex.:R$ 123,45 → 00012345 A quantidade de casas decimais está incluída no tamanho

Data Formato: DDMMAAAA onde D=DIA, M=MÊS E A=ANO, cada um com zeros a

esquerda. Ex.: 01102016

Page 63: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 62

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

EXEMPLO

L1001000000001GASOLINA A COMUM 051020160000000150099000002049547700000000002000000000000220OBSERVACAO DO LMC L200100000000100100000030000000000002500000 L200100000000100200000043000000000002350000 L30010000000010000157761 051020160010000003000000 L30010000000010000157771 051020160020000003000000 L40010000000010010C000000300000000000025000000000000020000 L40010000000010014A000000300000000000025000000000000020000

ABASTECIMENTO

(ABASTECIMENTO.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código do bico C 2 04 05

03 Valor total pagar N 10 2 06 15

04 Valor total volume N 10 3 16 25

05 Valor preço unitário N 10 3 26 35

06 Tempo de duração em segundos do abastecimento N 6 0 36 41

07 Data do abastecimento D 8 42 49

08 Hora do abastecimento C 5 50 54 hh:mm

09 Código número do abastecimento N 9 0 55 63

10 Valor em Reais do Encerrante Inicial N 10 2 64 73

11 Valor em Reais do Encerrante Final N 10 2 74 83

12 Código identificador do frentista C 16 84 99

13 Código identificador do cliente C 16 100 115

14 Status do bico C 1 D 116 116

15 Código (número) do caixa N 3 0 117 119

AFERIÇÃO (AFERICAO.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código do caixa N 3 0 04 06

03 Código do bico interno N 3 0 07 09

04 Data D 8 10 17

05 Valor volume aferido N 13 3 18 30

Page 64: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 63

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

BICO (BICO.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código do bico interno N 3 0 04 06

03 Código do tanque N 3 0 07 09

04 Código da bomba N 3 0 10 12

05 Código do bico C 2 13 14

BOMBA (BOMBA.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código da bomba N 3 0 04 06

03 Número de Série C 45 07 51

04 Nome do Fabricante C 45 52 96

05 Modelo C 45 97 141

06 Código do tipo de medição N 3 0 142 144

LACRE DA BOMBA (LACRE.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código da bomba N 3 0 04 06

03 Número do lacre C 20 07 26

04 Data da aplicação do lacre D 8 27 34

COMBUSTÍVEL (COMBUSTIVEL.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 04

02 Código do Combustível N 3 0 04 06

03 Tipo de combustível C 45 07 51

04 Código do produto associado C 20 52 71

05 Código do produto na ANP N 9 0 72 80

06 Código do produto na SEFAZ N 4 0 81 84

Page 65: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 64

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

INTERVENÇÃO (INTERVENCAO.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código da bomba N 3 0 04 06

03 Código da intervenção N 6 0 07 12

04 Data D 8 13 20

05 Descrição do motivo da intervenção C 100 21 120

06 Nome interventor C 100 121 220

07 CNPJ da empresa responsável pela intervenção C 14 221 234

08 CPF do técnico responsável pela intervenção C 11 235 245

09 Valor do volume abertura N 13 3 246 258

10 Valor do volume fechamento N 13 3 259 271

11 Valor do volume aferição N 13 3 272 284

NOTA ENTRADA (NFENTRADA.TXT)

PRODUTO ANP(PRODUTO_ANP.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código do produto N 9 0 01 09

02 Família C 120 10 129

03 Grupo C 120 130 249

04 Subgrupo C 120 250 369

05 Subsubgrupo C 120 370 489

06 Produto C 120 490 609

07 Grandeza C 120 610 729

08 Unidade simples C 2 730 731

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Data da emissão da nota D 8 04 11

03 Código (número) da nota N 9 0 12 20

04 Código (número) da série da nota C 5 0 21 25

05 Código do tanque N 3 0 26 28

06 Volume recebido N 13 3 29 41

07 CNPJ Fornecedor C 14 0 42 55

Page 66: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 65

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

PRODUTO SEFAZ(PRODUTO_SEFAZ.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código do produto N 4 0 01 04

02 Descrição do produto C 120 05 124

CADASTRO DO TANQUE (TANQUE.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código do tanque N 3 0 04 06

03 Código do combustível N 3 0 07 09

04 Valor da capacidade do tanque N 13 3 10 22

TANQUE ESTOQUE (TANQUE_ESTOQUE.TXT)

Campo Tipo Tam Dec Início Fim Observação

01 Código da loja N 3 0 01 03

02 Código do tanque N 3 0 04 06

03 Data D 8 07 14

04 Valor do volume abertura N 13 3 15 27

05 Valor do volume fechamento N 13 3 28 40

2.3.40 MOVIMENTO ANALÍTICO FISCAL GERADO PELO FRENTE DE

LOJA/CONCENTRADOR PARA A RETAGUARDA

(MOVOUTRA_FISCAL.TXT)

O arquivo movoutra_fiscal.txt só será gerado se o parâmetro Gerar movoutra_fiscal.txt estiver selecionado em FlexBridge > Parâmetros sistema > aba Parâmetros.

Campo Tipo Tam Dec Inicio Fim Observação

01 Loja N 3 0 1 3

02 Caixa N 3 0 4 6

03 Cupom N 6 0 7 12

04 Data D 8 0 13 20 AAAAMMDD Observação 1

05 Número de Ordem do Item no Cupom N 6 0 21 26

06 Código do Produto C 20 0 27 46

07 CFOP C 4 0 47 50

08 CST do ICMS C 3 0 51 53 Observação 2

09 Valor Base de Cálculo do ICMS N 12 2 54 65

Page 67: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 66

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

10 Alíquota do ICMS C 9 2 66 74 Observação 3

11 Valor do ICMS N 12 2 75 86

12 Valor Base de Cálculo do ICMS ST N 12 2 87 98

13 Valor do ICMS ST N 12 2 99 110

14 CST do IPI C 2 0 111 112

15 Código de Enquadramento IPI C 3 0 113 115

16 Valor Base de Cálculo do IPI N 12 2 116 127

17 Alíquota do IPI N 9 2 128 136

18 Valor do IPI N 12 2 137 148

19 CST do PIS C 2 0 149 150

20 Valor Base de Cálculo do PIS N 12 2 151 162

21 Alíquota do PIS N 9 2 163 171

22 Quantidade Base de Cálculo do PIS N 12 3 172 183

23 Alíquota PIS Quantidade N 9 4 184 192

24 Valor do PIS N 12 2 193 204

25 CST do COFINS C 2 0 205 206

26 Valor Base de Cálculo do COFINS N 12 2 207 218

27 Alíquota do COFINS N 9 2 219 227

28 Quantidade Base de Cálculo do COFINS N 12 3 228 239

29 Alíquota COFINS Quantidade N 9 4 240 248

30 Valor do COFINS N 12 2 249 260

31 Alíquota do ICMS original do produto C 6 261 266 Observação 4

32 Redução do ICMS original do produto N 9 2 267 275 Observação 5

33 CST do ICMS original do produto C 3 276 278 Observação 6

Observação 1: Quando o Frente de Loja estiver configurado e trabalhando no modo 24 horas, este campo

virá com a data referente ao movimento, quando não estiver configurado terá o mesmo valor do campo data.

Observação 2: Será gravado a ST do produto após cálculo de redução (se houver), quando status do registro

for 01. Observação 3: O campo Alíquota do ICMS será preenchido quando o Tipo do Registro for igual a 01

(Venda de Item). Este campo é composto pela legenda da tributação e do valor da alíquota utilizada após cálculos de redução (se houver). Exemplo: T07.00

Observação 4: O campo Alíquota do ICMS original do produto será preenchido quando o Tipo do

Registro for igual a 01 (Venda de Item). Este campo é composto pela legenda da tributação e do valor da alíquota cadastradas no produto. Exemplo: T17.00

Observação 5: Será gravado a redução do ICMS cadastrada na tributação do produto (tabela tributa), quando status do registro for 01.

Observação 6: Será gravado a ST que estiver cadastrada na tributação do produto (tabela tributa), quando

status do registro for 01.

Page 68: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 67

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

2.3.41 NFC-E INUTILIZADA (NFCEINUT.TXT)

O arquivo nfceinut.txt só será gerado se o parâmetro Gerar nfceinut.txt estiver selecionado em FlexBridge > Parâmetros sistema > aba Parâmetros.

Campo Tipo Tam Dec Inicio Fim Observação

01 Loja N 3 0 1 3

02 Caixa N 3 0 4 6

03 Número do documento N 6 0 7 12

04 Data D 8 0 13 20 Formato: AAAAMMDD

05 Protocolo C 50 0 21 70

06 Data de recebimento C 50 0 71 120 Formato: AAAA-MM-DDTHH:MM:SSUTC Exemplo: 2020-09-17T17:52:31-03:00

2.3.42 CUPOM PROMOCIONAL (CUPPROM.TXT)

Campo Tipo Tam Dec Inicio Fim Observação 01 Código do cupom N 6 0 1 6

02 Sequencial do registro N 6 0 7 12 Observação 1

03 Descrição C 30 0 13 42

04 Tipo promoção N 2 0 43 44 1 - Múltiplos de 2 - Acima de

05 Data de início da promoção D 8 0 45 52 Padrão AAAAMMDD

06 Data de fim da promoção D 8 0 53 60 Padrão AAAAMMDD

07 Mínimo / Fator C 1 0 61 61 Q - Quantidade V - Valor

08 Valor do Mínimo / Fator D 13 2 62 74

09 Tipo do comprovante N 1 0 75 75 1 - Emitir via única 2 - Emitir uma via para cada cupom 3 - Códigos promocionais

10 Cupom promocional principal

N 6 0 76 81

11 Imprimir mensagem automática?

C 1 0 82 82 S - Sim N - Não

12 Filtro C 1 0 83 83 A - Armação G - Grupo D - Departamento M - Marca P - Produto

Page 69: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 68

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

T - Todos

13 Código do item do filtro N 20 0 84 103 Observação 2

14 Comparar valor mínimo com

C 1 0 104 104 C - Cupom F - Filtro

15 Integra Super Troco? C 1 0 105 105 S - Sim N - Não

16 Quantidade de vias adicionais Super Troco

N 2 0 106 107 Se “Integra Supertroco” for “Sim”

17 Finalizadores permitidos C 90 0 108 197 Observação 3

Observação 1: Para cada registro referente a um código de item do filtro, deve ser gerada uma sequência

de registro, começando em 1 até a quantidade de itens do filtro.

Observação 2: Preencher com o código do item informado no campo 12 - FILTRO.

O alinhamento deste campo não será criticado na importação.

Deve ser gerado um registro para cada item do filtro. Exemplo: caso seja escolhido o filtro

PRODUTO, e a promoção abranja três itens com códigos de produto diferentes, deverá ser

gerado 3 linhas de registro para o mesmo cupom promocional, com todos os campos da

tabela idênticos, exceto os campos 02 - SEQUENCIAL DO REGISTRO, que deverá

seguir a ordem dos itens (1,2 e 3) e o 13 - CÓDIGO DO ITEM DO FILTRO, que deverá

ter, em cada uma das três linhas, o código interno de um dos três produtos.

Observação 3: O campo deverá conter os finalizadores de venda aos quais a promoção está condicionada,

alinhados de 3 em 3 dígitos completados com zeros à esquerda, caso necessário. Exemplo:

Finalizadores: 1, 2, 10, 15, 110, 200

Conteúdo do campo: 001002010015110200

2.3.43 CUPOM PROMOCIONAL TEXTO (CUPPROMTEXTO.TXT)

Campo Tipo Tam Dec Inicio Fim Observação 01 Código do cupom N 6 0 1 6

02 Sequencial do registro N 6 0 7 12 Observação 1

03 Texto adicional C 40 0 13 52 Observação 2

Observação 1: Para cada registro referente a um código de item do filtro, deve ser gerada uma sequência

de registro, começando em 1 até a quantidade de itens do filtro.

Observação 2: É possível imprimir 40 caracteres (contando espaços) em cada linha de texto no cupom,

portanto, caso o texto a ser impresso possua mais de 40 caracteres, deve ser gerada uma

sequência de registro para cada linha.

2.3.44 INFORMAÇÃO NUTRICIONAL (INFONUTRI.TXT)

Page 70: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 69

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

Campo Tipo Tam Dec Início Fim Observações

01 Código N 6

1 6 02 Descrição C 40

7 46

03 Porção N 3

47 49 04 Unidade da porção N 2

50 51 Observação 1

05 Medida caseira N 8 2 52 59 06 Unidade de medida caseira N 2

60 61 Observação 2

07 Valor calórico - quantidade por porção N 8 2 62 69 08 Valor calórico - percentual do valor diário N 6 2 70 75 09 Valor calórico - v. diário N 2

76 77

10 Valor energético - quantidade por porção N 8 2 78 85 11 Valor energético - percentual do valor diário N 6 2 86 91 12 Valor energético - v. diário N 2

92 93

13 Carboidratos - quantidade por porção N 8 2 94 101 14 Carboidratos - percentual do valor diário N 6 2 102 107 15 Carboidratos - v. diário N 2

108 109

16 Proteína - quantidade por porção N 8 2 110 117 17 Proteína - percentual do valor diário N 6 2 118 123 18 Proteína - v. diário N 2

124 125

19 Gorduras totais - quantidade por porção N 8 2 126 133 20 Gorduras totais - percentual do valor diário N 6 2 134 139 21 Gorduras totais - v. diário N 2

140 141

22 Gorduras saturadas - quantidade por porção N 8 2 142 149 23 Gorduras saturadas - percentual do valor diário N 6 2 150 155 24 Gorduras saturadas - v. diário N 2

156 157

25 Colesterol - quantidade por porção N 8 2 158 165 26 Colesterol - percentual do valor diário N 6 2 166 171 27 Colesterol - v. diário N 2

172 173

28 Fibra - quantidade por porção N 8 2 174 181 29 Fibra - percentual do valor diário N 6 2 182 187 30 Fibra - v. diário N 2

188 189

31 Cálcio - quantidade por porção N 8 2 190 197 32 Cálcio - percentual do valor diário N 6 2 198 203 33 Cálcio - v. diário N 2 204 205

34 Ferro - quantidade por porção N 8 2 206 213

35 Ferro - percentual do valor diário N 6 2 214 219

36 Ferro - v. diário N 2 220 221

37 Sódio - quantidade por porção N 8 2 222 229

38 Sódio - percentual do valor diário N 6 2 230 235

39 Sódio - v. diário N 2 236 237

40 Gordura trans - quantidade por porção N 8 2 238 245

41 Gordura trans - percentual do valor diário N 6 2 246 251

Page 71: Manual de Interligação via API REST ou Arquivo TXT

Interligação via API REST e arquivo TXT – página 70

www.gzsistemas.com.br email: [email protected]

GZ Sistemas | www.gzsistemas.com.br Última Atualização 19/05/2022

42 Gordura trans - v. diário N 2 252 253

43 Ácido fólico - quantidade por porção N 8 2 254 261

44 Ácido fólico - percentual do valor diário N 6 2 262 267

45 Ácido fólico - v. diário N 2 268 269

Observação 1: Códigos das unidades de medida

1- Gramas 2- Mililitros 3- Unidades

Observação 2: Códigos das unidades de medida caseiras

1- Colher(es) de sopa

2- Colher(es) de café 3- Colher(es) de chá

4- Xícara(s) 5- De xícara(s)

6- Unidade(s) 7- Pacote(s)

8- Fatia(s) 9- Fatia(s) fina(s)

10- Pedaço(s) 11- Folha(s)

12- Pão(ões) 13- Biscoito(s)

14- Bisnaguinha(s) 15- Disco(s)

16- Copo(s) 17- Porção(ões)

18- Tablete(s) 19- Sachê(s)

20- Almôndega(s) 21- Bife(s)

22- Filé(s) 23- Concha(s)

24- Bala(s) 25- Prato(s) fundo(s)

26- Pitada(s) 27- Lata(s)