Categoria Moderniza Connection

porRenan Rodrigues

Controle de versões – Moderniza Connection

Versão: 4.19.1.x (Janeiro 2016) – Liberação em 05/02/19

Release: 0 (05/02/18)

  • Bloco B (Produto)
    • B010: Possibilidade de informar o ID do produto também para inclusão
    • B016: alteração da informação do ID da regra de tributação para o código da NOP de venda do produto (a qual uma regra de tributação estará vinculada)
  • Bloco D (Pré-venda)
    • D011: acrescentada coluna para o “valor unitário líquido” além do percentual de desconto (usar ou um ou outro)

 

 

Versão: 3.16.11.x (Novembro 2016) – Liberação em 08/11/16

Release: 0 (08/11/16)

  • Acrescentado o seguinte campo no C011: “chave_nfce” (campo 043).

Versão: 2.15.8.x (Agosto 2015) – Liberação em 12/08/15

Release: 0 (12/08/15)

  • Acrescentados os registros B020 (Cadastro de Tabelas de Variação) e B021 (Itens da Tabela de Variação)

 

 

Versão: 2.15.7.x (Julho 2015) – Liberação em 01/07/15

Release: 1 (09/07/15)

  • Acrescentado os seguintes campos no C011:
    • Id da pré-venda (campo 040)
    • Ssu da pré-venda (campo 041)
    • código localizador da pré-venda (campo 42)
  • Correção e acréscimo dos campos no C015:
    • Correção dos campos 012, 013 e 014 . Quando a operação não fosse por TEF ou por cartão de crédito ou débito, esses campos não eram retornados. Agora caso a operação não seja por TEF ou cartão de crédito ou débito, esses campos são retornados vazios.
    • Acrescentado os campos “conta” quando o finalizador for cheque (campo 018)
    • Acrescentado o campo agencia quando o finalizador for cheque (campo 019)
  • Acrescentado o seguinte campo no C016:
    • Valor do desconto no recebimento (campo 012)

porModerniza

Moderniza Connection – Anexos

Anexo 1: Tabelas referenciadas

Tabela 1.1: Tipo de item

Valor

Descrição

1

Mercadoria para revenda

2

Matéria-prima

3

Embalagem

4

Produto em processo

5

Produto acabado

6

Subproduto

7

Produto intermediário

8

Material de uso e consumo

9

Ativo imobilizado

10

Serviços

11

Outros insumos

12

Outras

Tabela 1.2: Unidades de medida primárias para produtos

Valor

Descrição

PC

Peça

KG

Quilograma

MT

Metro

CJ

Conjunto

Tabela 1.3: Tipos de operação do PDV

Valor

Descrição

0

Venda não concluída

1

Venda normal

2

Recebimento

3

Lançamento de pagamento

4

Lançamento de recebimento

5

Recebimento de suprimento

6

Pagamento de suprimento

7

Sangria

porModerniza

Moderniza Connection Bloco 9

Bloco 9: Encerramento

Registro 9999: Encerramento do arquivo

Este registro tem por objetivo identificar o encerramento do arquivo, este registro deverá ser informado apenas na última linha do arquivo.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

Texto fixo contendo “9999”

C

4

I-A-E

002

Seqüência do registro no arquivo

N

8

I-A-E

003

Quantidade de linhas

N

8

I-A-E

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Seqüência do registro no arquivo

N

8

I-A-E

003

Quantidade de linhas

T

14

I-A-E

porModerniza

Moderniza Connection Bloco D

Bloco D: Comercial

Registro D010: Cadastro de pré-venda

Este registro tem por objetivo possibilitar o cadastro ou alteração de uma pré-venda.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

RegistroTexto fixo contendo “D010”

C

4

*

002

Sequência do registro no arquivo

N

8

*

003

OperaçãoOnde:

1 – Inclusão

2 – Alteração

N

1

I-A

004

ID da pré-venda cadastrada na base de dados

N

8

A

005

Código localizador da pré-venda

C

20

I-A

006

CNPJ da filial do pré-venda

C

14

I-A

007

CPF ou CNPJ do cliente da pré-venda

C

0-11-14

*

008

ID da tabela de preço cadastrada na base de dados

N

4

*

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

*

002

Sequência do registro no arquivo de entrada

N

8

*

003

Operação

N

1

*

004

Indicador de sucesso da operação

B

1

*

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

ID da pré-venda cadastrada ou manipulada na operação

N

8

*

Registro D011: Item da pré-venda

Este registro tem por objetivo possibilitar o cadastro, alteração ou exclusão de itens de uma pré-venda.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

RegistroTexto fixo contendo “D011”

C

4

*

002

Sequência do registro no arquivo

N

8

*

003

OperaçãoOnde:

1 – Inclusão

2 – Alteração

N

1

I-A-E

004

ID da pré-venda cadastrada na base de dados

N

8

I-A-E

005

ID do item da pré-venda cadastrada na base de dados

N

8

A-E

006

Código identificador do produto (código de barras, EAN, número de série)

C

30

I

007

Quantidade

N

9

3

I-A

008

Valor unitário bruto

N

10

3

I-A

009

Percentual de desconto do item (se informar este, não informar o campo 011 – Valor unitário líquido)

N

10

2

I-A

010

Id do usuário vendedor

N

10

I-A

011

Valor unitário líquido (se informar este, não informar o campo 009 – Percentual de desconto do item)

N

10

I-A

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

*

002

Sequência do registro no arquivo de entrada

N

8

*

003

Operação

N

1

*

004

Indicador de sucesso da operação

B

1

*

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

ID do item da pré-venda cadastrado ou manipulada na operação

N

8

*

porModerniza

Moderniza Connetion Bloco C

Bloco C: PDV

Registro C010: Consultar operações do PDV

Este registro tem por objetivo gerar e retornar uma listagem com as operações efetuadas no PDV em determinado período.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

RegistroTexto fixo contendo “C010”

C

4

*

002

Sequência do registro no arquivo

N

8

*

003

Data inicial do período do movimento

D

8

*

004

Data final do período do movimento

D

8

*

005

CNPJ do estabelecimento que realizou o movimento

N

14

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

*

002

Sequência do registro no arquivo de entrada

N

8

*

003

Indicador de sucesso da operação

B

1

*

004

Texto descritivo da ocorrência de sucesso ou erro

C

512

005

Número de registros retornados na consulta

N

8

*

Registro C011: Operação do PDV

Este registro tem por objetivo retornar dados gerais de uma operação efetuada no PDV.

Layout para entrada de dados

Não se aplica

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “C011”

C

4

*

002

Sequência do registro no arquivo de retorno

N

8

*

003

ID da operação

N

8

*

004

Login do operador de caixa

C

10

*

005

CNPJ do estabelecimento

N

14

*

006

Data do movimento

D

8

*

007

Sequência da operação na data do movimento

N

4

*

008

Data e hora do início da operação

T

14

*

009

Data e hora do término da operação

T

14

*

010

ID da entidade cliente

N

8

*

011

Número do COO

N

6

*

012

Valor do ajuste no subtotal

N

10

2

*

013

Tipo da operaçãoVide tabela 1.3

N

2

*

014

CanceladoOnde:0 – Operação não cancelada1 – Operação cancelada

N

1

*

015

Login do usuário que cancelou a operação

C

10

016

Motivo do cancelamento

C

60

017

Valor do desconto no subtotal

N

10

2

*

018

Login do usuário que concedeu desconto no subtotal

C

10

019

Motivo do desconto no subtotal

C

40

020

Login do usuário que realizou o lançamento no caixa

C

10

021

Motivo do lançamento no caixa

C

60

022

Data e hora do lançamento no caixa

T

14

023

CPF ou CNPJ do cliente

N

0-11-14

024

Nome do cliente

C

60

025

Endereço do cliente

C

150

026

Número de série do ECF

C

20

*

027

Letra indicativa de memória fiscal adicional do ECF

C

1

*

028

Tipo do ECF

C

7

*

029

Marca do ECF

C

20

*

030

Modelo do ECF

C

20

*

031

Código do cupom fiscal (CCF)

N

6

*

032

Número do usuário do ECF

N

4

*

033

Id da entidade do guia

N

8

034

Nome do guia

N

60

035

Data do movimento DD/MM/AAAA HH:MM:SS

T

14

036

Valor total da operação

N

037

CNPJ ou CPF do cliente no cupom fiscal

N

14/11

038

Id da Filial da operação

N

1

039

Login do usuário Vendedor

C

10

040

Id da pré-venda registrada no retaguarda

N

8

041

NSU da pré-venda registrada no retaguarda

N

8

042

Código localizador da pré-venda

C

20

042

Chave NFC-e

C

44

Registro C012: Itens da operação do PDV

Este registro tem por objetivo retornar dados gerais dos itens de uma operação efetuada no PDV.

Layout para entrada de dados

Não se aplica

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “C012”

C

4

*

002

Sequência do registro no arquivo de retorno

N

8

*

003

ID da operação

N

8

*

004

ID do item da operação

N

8

*

005

CanceladoOnde:0 – Item não cancelado1 – Item cancelado

N

1

*

006

ID do produto

N

8

*

007

Descrição do produto

C

60

*

008

ID da variação

N

8

*

009

Sequência de item na operação

N

8

*

010

Código de barras do item

C

14

*

011

Número de série do item

C

30

*

012

Sigla da unidade de medida

C

3

*

013

Quantidade

N

9

3

*

014

Valor unitário bruto

N

10

2

*

015

Valor unitário líquido

N

10

2

*

016

Valor total líquido

N

10

2

*

017

Valor do desconto

N

10

2

*

018

Motivo do desconto

C

40

*

019

Login do usuário que concedeu o desconto

C

10

*

020

Valor do acréscimo

N

10

2

*

021

Valor de ajuste

N

10

2

*

022

Alíquota de ICMS

N

3

2

*

023

Login do usuário vendedor

C

10

*

024

Valor do ICMS do Item

N

2

*

025

Valor do COFINS do item

N

2

*

026

Valor PIS do Item

N

2

*

027

CFOP do faturamento de ICMS Normal

N

*

028

Código Totalizador Parcial de Redução Z

C

*

029

Código Situação tributária ICMS

N

*

030

Código Situação tributária PIS

N

*

031

Código da Situação tributário COFINS

N

*

032

Alíquota PIS

N

*

033

Alíquota COFINS

N

*

034

Referência interna do produto

C

20

*

Registro C013: Redução Z

Este registro tem por objetivo retornar dados gerais da Redução Z

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “C013”

C

4

*

002

Sequência do registro no arquivo de retorno

N

8

*

003

Numero de série de Fabricação do ECF

C

8

*

004

Contador da Redução Z (CRZ)

N

1

*

005

Data do movimento DDMMAAAA

T

8

*

006

Data e hora da emissão

T

14

*

007

Contador de Reinicio de Operação (CRO)  N  8  –

008

Contador de Ordem de Operação Inicial (COO inicial)
 N 8  –

009

Contador de Ordem de Operação Final (COO Final)
 N  8  –  –

010

Grande total Inicial  N  12 2  –

011

Grande total Final N  12  2  –

012

Venda bruta diária  N  12  2  –

013

Situação Replicação  N  8  –  –

014

Matriz Fiscal adicional  C 1  –  –

015

Tipo de ECF  C 7  –  –

016

Marca da ECF  C 20  –  –

017

Modelo da ECF  C  20  –  –

018

Versão do software da ECF  C  10  –  –

019

CNPJ do estabelecimento da impressão  C  14  –  –

020

Inscrição Estadual do estabelecimento  C  14  –

021

CNPJ da desenvolvedora  C  14  –  –

022

Inscrição Estadual da desenvolvedora  C  14  –  –

023

Inscrição Municipal da desenvolvedora C  14  –  –

024

Denominação desenvolvedora  C  40  –  –

025

Nome do aplicativo no PAF ECF  C  40  –  –

026

Versão do PAF ECF  C  10  –  –

027

Hash md5 PAF ECF  C  32  –  –

028

Versão da ER do PAF/ECF
 C  4  –  –

029

Data e hora do software básico do ECF
 T  14  –  –

030

Número do proprietário do PAF/ECF
 N 40  –  –

031

Número sequencial do ECF
 N  8  –  –

032

Contador de ordem de operação (COO)
 N  8  –  –

033

Hash MD-5
 C  32  –  –

034

Cancelamento de ICMS
 N  12 2  –

035

Desconto de ICMS
 N  12  2  –

036

Total de ISSQN  N  12  2  –

037

Cancelamento de ISSQN
 N  12  2  –

038

Desconto de ISSQN
 N  12  2  –

039

Valor da venda líquida diária
 N  12  2  –
040 Data e hora da gravação do registro
 T  14  –  –

Registro C014: Detalhes da Redução Z

Este registro tem por objetivo retornar dados de detalhes da Redução Z.

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “C014”

C

4

*

002

Sequência do registro no arquivo de retorno

N

8

*

003

Numero de série de Fabricação do ECF

C

20

*

004

CRZ

N

8

*

005

Código Totalizador Parcial

C

7

*

006

Valor

N

12

2

*

007

Hash MD5

C

32

*

Registro C015: Finalizadores da Operação de PDV

Este registro tem por objetivo retornar todos os finalizadores das operações de PDV e seus detalhes.

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “C015”

C

4

*

002

Sequência do registro no arquivo de retorno

N

8

*

003

Id da operação de PDV

N

8

*

004

Id do finalizador da operação

N

8

*

005

Valor

N

12

2

*

006

Parcela (para finalizador cartão de crédito)

N

8

*

007

Número do documento (para cartão de crédito, débito ou TEF)

C

20

*

008

Data de vencimento da parcela (para cartão de crédito)

D

8

*

009

Id do documento a receber (no caso de parcelamentos)

N

8

*

010

Id da operadora de cartão

N

8

*

011

NSU do TEF

N

8

*

012

Nome da rede (para cartão de crédito, débito ou TEF)

C

20

*

013

Nome da operadora (para cartão de crédito ou débito)

C

20

*

014

Tipo de transação (para cartão de crédito, débito ou TEF) 1 – Crédito / 2 – Débito

N

8

*

015

Autorização do TEF

N

8

*

016

Tipo de financiamento do TEF

N

8

*

017

Id da devolução de venda

N

8

*

018

Número da agência do cheque

C

20

*

019

Código da conta corrente do cheque

C

20

*

Registro C016: Recebimentos pelo PDV

Este registro tem por objetivo retornar todos os dados de recebimentos de contas a receber feitas pelo PDV.

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “C016”

C

4

*

002

Sequência do registro no arquivo de retorno

N

8

*

003

Id da operação de PDV

N

8

*

004

CPF / CNPJ do cliente

C

14

*

005

Data de vencimento

D

8

*

006

Valor original

N

12

2

*

007

Valor multa

N

12

      2

*

008

Valor juros

N

12

2

*

009

Valor total

N

12

2

*

010

Número do documento

C

30

*

011

Nome do tipo de documento

C

30

*

012

Valor de desconto

N

12

2

*

porModerniza

Moderniza Connection Bloco B

Bloco B: Logística

Registro B010: Produto

Este registro tem por objetivo o cadastro ou alteração de um produto.

Layout para entrada de dados

 

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B010”

C

4

I-A

002

Sequência do registro no arquivo

N

8

I-A

003

Operação: Onde:1 – Inclusão2 – Alteração

N

1

I-A

004

ID do produto cadastrado na base de dados (campo id_produto)

N

8

A

005

Tipo de geração do ID do produto Onde:1 – Sequência reduzida2 – Sequência normal

N

1

I

006

Nome do produto (campo nome)

C

60

I-A

007

Situação Onde:1 – Ativo2 – Inativo3 – Fora de linha (campo situacao)

N

1

I-A

008

CNPJ ou CPF da entidade fornecedor. A entidade deve estar cadastrada na base de dados com o documento (CNPJ ou CPF) informado (campo id_entidade_fornecedor)

N

11-14

I-A

009

Nome da marca do produto (campo id_marca_produto)

C

40

I-A

010

Código da hierarquia cadastrada na base de dados (campo id_hierarquia_produto)

C

64

I-A

011

Sigla da unidade de medida do produto (vide tabela 1.2). A unidade de medida deve estar cadastrada na base de dados como unidade de medida primária (campo id_unidade_medida)

C

3

I-A

012

Tipo de variação do produto, onde:0 – Sem variações1 – Variações simples2 – Variações compostas (campo tipo_variacao)

N

1

I-A

013

ID da tabela de variação (A)Informar quando o tipo de variação do produto for 1 ou 2 (campo id_tabela_variacao_a)

N

4

014

ID da tabela de variação (B)Informar quando o tipo de variação do produto for 2 (campo id_tabela_variacao_b)

N

4

015

Referência interna do produto (campo referencia_interna_produto)

C

20

016

Preço de custo (campo preco_custo)

N

10

3

I-A

017

Preço de aquisição (campo preco_aquisicao)

N

10

3

I-A

018

Preço de venda varejo (campo preco_venda)

N

10

2

I-A

019

Preço de venda atacado (campo preco_venda_atacado)

N

10

2

I-A

020

ID do NCM cadastrado na base de dados, caso não exista informar o campo abaixo (campo id_ncm)

C

10

I-A

021

Descrição para NCM caso não esteja cadastrada na base de dados

C

200

I

022

Produto possui tributação de PIS diferenciada (campo tributacao_diferenciada_pis)

B

1

I-A

023

Código da situação tributária de PIS (campo id_situacao_tributaria_pis)

N

2

I-A

024

Alíquota de PIS (campo aliquota_pis)

N

3

2

I-A

025

Produto possui tributação de COFINS diferenciada (campo tributacao_diferenciada_cofins)

B

1

I-A

026

Código da situação tributária de COFINS (campo id_situacao_tributaria_cofins)

N

2

I-A

027

Alíquota de COFINS (campo aliquota_cofins)

N

3

2

I-A

028

Código da situação tributária de IPI (campo id_situacao_tributaria_ipi)

N

2

I-A

029

Alíquota de IPI (campo aliquota_ipi)

N

3

2

I-A

030

Origem do produto, onde: (campo origem_produto)

0 – Nacional, exceto as indicadas nos códigos 3 a 5

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{4dc195c034367e69f32c21d7cc0e845305143d8f16ceb466f2b44734cb9cdfe6}

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.484/07

5-Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40{4dc195c034367e69f32c21d7cc0e845305143d8f16ceb466f2b44734cb9cdfe6}

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

N

1

I-A

031

Tipo do item. Vide tabela 1.1 (campo tipo_item)

N

2

I-A

032

Indicador de uso de quantidade inicial do produto (1 para usar)

B

1

I

033

ID do endereço de estoque cadastrado na base de dados

N

1

I

034

Quantidade incial do estoque do Produto

N

15

3

I

035

Operador da quantidade de estoque (+ ou -)

C

1

I

036

Informações adicionais do produto (campo informacao_adicional)

C

1024

I

037

Estoque crítico para a variação padrão do produto “Diversos”

N

15

2

I

038

Configuração para controlar números de série no cadastro do produto

B

1

I

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A

002

Sequência do registro no arquivo de entrada

N

8

I-A

003

Operação

N

1

I-A

004

Indicador de sucesso da operação

B

1

I-A

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

ID do produto cadastrado ou manipulado na operação

N

8

I-A

Registro B011: Variações do produto

Este registro tem por objetivo o cadastro ou alteração das variações de um produto.Ao cadastrar um produto, automaticamente será cadastrada a primeira variação deste.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

RegistroTexto fixo contendo “B011”

C

4

I-A

002

Sequência do registro no arquivo

N

8

I-A

003

OperaçãoOnde:1 – Inclusão2 – Alteração

N

1

I-A

004

ID do produto cadastrado na base de dados

N

8

I-A

005

ID da variação do produto cadastrada na base de dados

N

4

A

006

Primeira parte do nome da variação A primeira parte do nome da variação refere-se à descrição correspondente ao item da primeira tabela da variação, ou, no caso de um produto que não possua variações, deverá ser um texto livre.O nome da variação será formado pela junção da primeira e segunda parte do nome da variação.Exemplo:Se a primeira tabela da variação for ‘Cores’, a primeira parte do nome da variação será a descrição de uma cor.

C

40

I-A

007

Segunda parte do nome da variação. Deverá ser informada apenas se o tipo de variação do produto for 2.A segunda parte do nome da variação refere-se à descrição correspondente ao item da segunda tabela da variação.O nome da variação será formado pela junção da primeira e segunda parte do nome da variação.Exemplo:Se a segunda tabela da variação for ‘Tamanhos’, a segunda parte do nome da variação será a descrição de um tamanho.

C

40

008

Situação da variação Onde:1 – Ativa2 – Inativa3 – Fora de linha

N

1

I-A

009

ID do item da tabela de variação (A)Deverá ser informada apenas se o tipo de variação do produto for 1 ou 2.O ID deverá corresponder a um item da tabela de variação (A) informada para o produto.

N

4

010

ID do item da tabela de variação (B)Deverá ser informada apenas se o tipo de variação do produto for 2.O ID deverá corresponder a um item da tabela de variação (B) informada para o produto.

N

4

011

Referência interna da variação

C

20

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A

002

Sequência do registro no arquivo de entrada

N

8

I-A

003

Operação

N

1

I-A

004

Indicador de sucesso da operação

B

1

I-A

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

ID da variação cadastrada ou manipulada na operação

N

4

I-A

Registro B012: Unidades de medida secundárias do produto

Este registro tem por objetivo o cadastro, alteração ou exclusão das unidades de medida secundárias de um produto.

Ao cadastrar um produto, automaticamente será cadastrada a primeira unidade de medida do produto com a sigla da unidade de medida informada como parâmetro do cadastro.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B012”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Operação Onde:1 – Inclusão2 – Alteração3 – Exclusão

N

1

I-A-E

004

ID do produto cadastrado na base de dados

N

8

I-A-E

005

Sigla da unidade de medida secundária

C

3

I-A-E

006

Quantidade para conversão da unidade de medida secundária em unidade de medida primária. Exemplo:Para cadastrar uma unidade de medida secundária referente a um fardo com 6 unidade de um produto:– A sigla da unidade de medida secundária poderá ser: FD– A quantidade para conversão será: 6

N

9

3

I-A

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo de entrada

N

8

I-A-E

003

Operação

N

1

I-A-E

004

Indicador de sucesso da operação

B

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

Sigla da unidade de medida cadastrada ou manipulada na operação

N

4

I-A-E

Registro B013: Códigos de barras do produto

Este registro tem por objetivo o cadastro, alteração ou exclusão dos códigos de barras de uma variação do produto, não sendo possível cadastrar o mesmo código de barras para duas variações ou produtos diferentes.

Ao cadastrar um produto, automaticamente será cadastrada a variação 1(diversos) e o ID do produto como sendo seu primeiro código de barras.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B013”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Operação Onde:1 – Inclusão2 – Alteração3 – Exclusão

N

1

I-A-E

004

ID do produto cadastrado na base de dados

N

8

I-A-E

005

ID da variação do produto cadastrada na base de dados

N

8

I-A-E

006

Código de barras

C

14

I-A-E

007

Sigla da unidade de medida referente ao código de barras

C

4

I-A-E

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo de entrada

N

8

I-A-E

003

Operação

N

1

I-A-E

004

Indicador de sucesso da operação

B

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

Código de barras cadastrado ou manipulado na operação

N

4

I-A-E

Registro B014: Números de série do produto

Este registro tem por objetivo o cadastro, alteração ou exclusão dos números de série de uma variação do produto.

Layout para entrada de dados

 

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B014”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Operação Onde:1 – Inclusão2 – Alteração3 – Exclusão

N

1

I-A-E

004

ID do produto cadastrado na base de dados

N

8

I-A-E

005

ID da variação do produto cadastrada na base de dados

N

8

I-A-E

006

Número de série do produto e variação

C

30

I-A-E

007

CNPJ da filial do número de série

C

14

I-A

008

Id do endereço de estoque de alocação do número de série (passar 1 como padrão caso não deseje utilizar)

N

1

I-A

009

Número de série inativo (0 – Ativo, 1 – Inativo). Passar sempre 0 (ativo) como padrão

C

1

I-A

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo de entrada

N

8

I-A-E

003

Operação

N

1

I-A-E

004

Indicador de sucesso da operação

B

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

Número de série cadastrado ou manipulado na operação

N

4

I-A-E

Registro B015: Tabela de preço de produto

Este registro tem por objetivo o cadastro, alteração ou exclusão de tabelas de preço de produto.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B015”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Operação Onde:1 – Inclusão2 – Alteração3 – Exclusão

N

1

I-A-E

004

ID do produto cadastrado na base de dados

N

8

I-A-E

005

ID da tabela de preço cadastrada na base de dados

N

4

I-A-E

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo de entrada

N

8

I-A-E

003

Operação

N

1

I-A-E

004

Indicador de sucesso da operação

B

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

Número de série cadastrado ou manipulado na operação

N

4

I-A-E

Registro B016: Natureza de operação do Produto

Este registro tem por objetivo o cadastro ou exclusão do vínculo de NOP no produto.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B016”

C

4

I-E

002

Sequência do registro no arquivo

N

8

I-E

003

Operação Onde:1 – Inclusão3 – Exclusão

N

1

I-E

004

ID do produto cadastrado na base de dados

N

8

I-E

005

Código da NOP cadastrada na base de dados (informar uma NOP cadastrada do tipo venda e de saída interna, código iniciando por 5)

C

6

I-E

006

Utilizar a referencia interna do produto. (1 para utilizar)

B

1

I-E

007

Referencia Interna do produto

C

20

I-E

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-E

002

Sequência do registro no arquivo de entrada

N

8

I-E

003

Operação

N

1

I-E

004

Indicador de sucesso da operação

B

1

I-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

Registro B017: Marcas de Produtos

Este registro tem por objetivo o cadastro de marcas para os produtos.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B017”

C

4

I

002

Sequência do registro no arquivo

N

8

I

003

Operação Onde:1 – Inclusão

N

1

I

004

Nome da marca.

C

40

I

005

Indicador de marca própria

B

1

I

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I

002

Sequência do registro no arquivo de entrada

N

8

I

003

Operação

N

1

I

004

Indicador de sucesso da operação

B

1

I

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

Nome da marca cadastrada

C

40

I

Registro B018: Hierarquia do produto

Este registro tem por objetivo o cadastro de hierarquias de produto.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “B018”

C

4

I

002

Sequência do registro no arquivo

N

8

I

003

Operação Onde:1 – Inclusão, 2 – Alteração, 3 – Exclusão

N

1

I

004

ID da hierarquia a ser cadastrada

C

40

I

005

Nome da Hierarquia a ser cadastrada

C

40

I

006

ID da Hierarquia pai

C

40

I

007

Numero da sequencia da hierarquia

N

I

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I

002

Sequência do registro no arquivo de entrada

N

8

I

003

Operação

N

1

I

004

Indicador de sucesso da operação

B

1

I

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

Nome da hierarquia cadastrada

C

40

I

Registro B019: Saldos de Estoque do produto

Este registro tem por objetivo atualizar os saldos de estoque dos produtos caso necessário.

Layout para entrada de dados

001

Registro: Texto fixo contendo “B019”

C

4

I, A

002

Sequencia do registro no arquivo

N

8

I, A

003

Operação Onde:1 – Inclusão, 2 – Alteração, 3 – Exclusão

N

1

I, A

004

ID do produto cadastrado na base de dados

N

8

I-A

005

ID da variação

N

8

I-A

006

ID do endereço de estoque

N

8

I-A

007

Quantidade a ser adicionada/subtraída do estoque

N

12

3

I-A

008

Operador matemático da inclusão (+ para adicionar saldo, – para subtrair)

C

1

I-A

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I

002

Sequência do registro no arquivo de entrada

N

8

I

003

Operação

N

1

I

004

Indicador de sucesso da operação

B

1

I

005

ID do produto com saldo atualizado

8

I

006

ID da variação

8

I

Registro B020: Tabela de Variação

Este registro tem por objetivo cadastrar tabelas de variação.

Layout para entrada de dados

001

Registro: Texto fixo contendo “B020”

C

4

I, A, E

002

Sequencia do registro no arquivo

N

8

I, A, E

003

Operação Onde:1 – Inclusão, 2 – Alteração, 3 – Exclusão

N

1

I, A, E

004

ID da tabela de variação cadastrada na base de dados

N

8

A, E

005

Nome da tabela de variação

C

40

I, A

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I

002

Sequência do registro no arquivo de entrada

N

8

I

003

Operação

N

1

I

004

Indicador de sucesso da operação

B

1

I

005

ID da tabela de variação cadastrada

8

I

Registro B021: Itens de Tabela de Variação

Este registro tem por objetivo cadastrar itens para tabelas de variação.

Layout para entrada de dados

001

Registro: Texto fixo contendo “B021”

C

4

I, A, E

002

Sequencia do registro no arquivo

N

8

I, A, E

003

Operação Onde:1 – Inclusão, 2 – Alteração, 3 – Exclusão

N

1

I, A, E

004

ID da tabela de variação cadastrada na base de dados

N

8

I, A, E

005

ID do item da tabela de variação

N

8

A, E

006

Nome do item da tabela de variação

C

40

I, A

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I

002

Sequência do registro no arquivo de entrada

N

8

I

003

Operação

N

1

I

004

Indicador de sucesso da operação

B

1

I

005

ID da tabela de variação cadastrada

8

I

006

ID do item da tabela de variação cadastrada

8

I, A, E

porModerniza

Moderniza Connection Bloco A

Bloco A: Entidades

Registro A010: Pessoa física

Este registro tem por objetivo o cadastro, alteração ou exclusão de uma entidade pessoa física.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “A010”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Operação Onde:1 – Inclusão2 – Alteração3 – Exclusão

N

1

I-A-E

004

ID da entidade cadastrada na base de dados

N

8

A-E

005

Nome da pessoa física

C

80

I-A

006

Logradouro

C

80

I-A

007

Número do endereço

C

7

I-A

008

Bairro

C

80

I-A

009

Complemento

C

80

010

CEP

C

8

I-A

011

Código da cidade. O código deve estar relacionado à tabela de cidades do IBGE.

N

8

I-A

012

Observação

C

512

013

CPF

N

11

I-A

014

RG

C

15

I-A

015

Data de nascimento

D

8

I-A

016

Sexo Onde:1 – Masculino2 – Feminino

N

1

I-A

017

Telefone principal (formato 2 dígitos para DDD e no máximo 9 para o número, sem espaços ou caracteres especiais)

N

11

018

Telefone de algum contato – inclui um contato para a entidade(formato 2 dígitos para DDD e no máximo 9 para o número, sem espaços ou caracteres especiais)

N

11

019

E-mail

C

80

020

Indicação que o cliente é guia de turismo

B

1

021

Indicação que o cliente é fornecedor

B

1

022

Indicação que o cliente é transportadora

B

1

023

Indicação que o cliente é funcionário

B

1

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo de entrada

N

8

I-A-E

003

Operação

N

1

I-A-E

004

Indicador de sucesso da operação

B

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

ID da entidade cadastrada ou manipulada na operação

N

8

I-A-E

Registro A020: Pessoa jurídica

Este registro tem por objetivo o cadastro, alteração ou exclusão de uma entidade pessoa jurídica.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro Texto fixo contendo “A020”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Operação Onde:1 – Inclusão2 – Alteração3 – Exclusão

N

1

I-A-E

004

ID da entidade cadastrada na base de dados

N

8

A-E

005

Razão social

C

80

S

006

Nome de fantasia

C

80

S

007

Logradouro

C

80

S

008

Número do endereço

C

7

S

009

Bairro

C

80

S

010

Complemento

C

80

N

011

CEP

C

8

S

012

Código da cidade. O código deve estar relacionado à tabela de cidades do IBGE.

N

8

S

013

Observação

C

512

N

014

Site

C

80

N

015

CNPJ

N

14

S

016

Inscrição Estadual

N

14

N

017

SUFRAMA

N

9

N

018

Telefone principal (formato 2 dígitos para DDD e no máximo 9 para o número, sem espaços ou caracteres especiais)

N

10

N

019

Telefone de algum contato – inclui um contato para a entidade(formato 2 dígitos para DDD e no máximo 9 para o número, sem espaços ou caracteres especiais)

N

10

N

020

E-mail

C

80

N

021

Indicação que o cliente é guia de turismo

B

1

022

Indicação que o cliente é fornecedor

B

1

023

Indicação que o cliente é transportadora

B

1

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo de entrada

N

8

I-A-E

003

Operação

N

1

I-A-E

004

Indicador de sucesso da operação

B

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

C

512

006

ID da entidade cadastrada ou manipulada na operação

N

8

I-A-E

porModerniza

Moderniza Connection Bloco 0

Bloco 0: Dados gerais

Registro 0001: Abertura do arquivo

Este registro tem por objetivo identificar a abertura do arquivo, este registro deverá ser informado apenas na primeira linha do arquivo.

Layout para entrada de dados

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

Texto fixo contendo “0001”

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Data e hora de geração do arquivo

T

14

I-A-E

004

Situação do processamento

0 – Arquivo não processado

N

1

I-A-E

 

Layout do retorno

Descrição do campo

Tipo

Tam

Dec

Obr

001

Registro

C

4

I-A-E

002

Sequência do registro no arquivo

N

8

I-A-E

003

Data e hora de processamento do arquivo

T

14

I-A-E

005

Situação do processamento

Onde:

0 – Arquivo não processado

1 – Arquivo processado

2 – Arquivo Rejeitado

N

1

I-A-E

005

Texto descritivo da ocorrência de sucesso ou erro

N

8

A-E

 

porModerniza

Lojamix Connection – Introdução

Introdução

Qual a finalidade deste documento?

Este guia foi preparado para auxiliar os desenvolvedores na integração do Sistema Lojamix com outros sistemas de informação de qualquer natureza, através do aplicativo LojamixConnection, integrante do conjunto de ferramentas do Sistema Lojamix.
As informações descritas aqui devem ser utilizadas para a finalidade exclusiva de integração entre os sistemas, podendo causar efeitos inesperados se aplicadas para outros propósitos.

Entendendo os conceitos utilizados no guia

Por se tratar de um documento técnico, na sua elaboração foram utilizados termos e abreviações específicas, as quais são detalhadas a seguir.
Colunas das tabelas de layout

Tipos de dados (Tipo)

Cada campo mencionado neste layout está relacionado a um tipo de dado que representará o conjunto de caracteres que são aceitos para os dados do referido campo, conforme detalhado na tabela abaixo.

Sigla

Descrição

C

Campo para valores alfanuméricos

N

Campo para valores numéricos

B

Campo de afirmação ou negação.Os valores aceiros são:1 – Para representar afirmação, positividade, concordância0 – Para representar negação, não concordância

D

Campo para data (sem horas)Informar somente números, sem qualquer símbolo ou letra.Exemplo: Para a data e hora: 25/12/2011 20:15:10Informar: 25122011

T

Campo para data e horaInformar somente números, sem qualquer símbolo ou letra.Exemplo: Para a data e hora: 25/12/2011 20:15:10Informar: 25122011201510

Tamanho (Tam) e Decimais (Dec)

A coluna tamanho “Tam” representa a quantidade de dígitos que são aceitos para o campo do layout.
Quando se tratar de campos correspondentes a valores numéricos, e estes aceitarem casas decimais, a quantidade de dígitos aceitos para as casas decimais será informada na coluna “Dec”, para representar um número com Tam= 5 e Dec = 3 o conteúdo deverá estar separado por vírgula “,” conforme exemplo:99999,999

Obrigatoriedade do campo (Obr)

Alguns campos são opcionais, outros obrigatórios. Existem ainda os campos que são obrigatórios de acordo com a operação que se deseja realizar.
Na tabela a seguir são especificadas as siglas que representam as condições de obrigatoriedade dos campos. Quando as condições forem combinadas, as siglas serão separadas por hífen “-“.

Sigla

Descrição

I

Campo obrigatório apenas para a operação de inclusão

A

Campo obrigatório apenas para a operação de alteração

E

Campo obrigatório apenas para a operação de exclusão

*

Campo obrigatório em todas as situações

Campo opcional, seu preenchimento não é obrigatório

Regras de validação

Antes do processamento do arquivo o LojamixConnection vai realizar a validação do conteúdo do arquivo.
Caso ocorra algum erro na etapa de validação será gerado no diretório de saída,o arquivo de retornocom o registro 0000 contendo no campo Situação de processamento o valor 2 (Arquivo rejeitado) e no campo Texto descritivo da ocorrência de sucesso ou erro, o motivo da rejeição e número da linha do arquivo onde foi identificado o erro.
Os motivos para rejeição do arquivo são:

  • Ausência do registro de abertura do arquivo;
  • Situação de processamento inválido;
  • Código do registro inválido;
  • Sequência do registro inválida;
  • Quantidade de campos do registro inválido;
  • Ausência de registro filho obrigatório;
  • Número de linhas diferente do registro 9999; e
  • Ausência do registro de encerramento do arquivo;