DOCS - ARQUIVOS - ANDROID

Analista Responsável: Gustavo Henrique Braga Fernandes

1. Especificação dos arquivos


 Softensistemas Logo

 Projeto/Sistema:

DOCS - ARQUIVOS - ANDROID

 Versão do Template:
1.1
Processo:

Especificação dos arquivos

 Versão do Documento:
1.0
Responsável(eis): 
Gustavo Fernandes

Data: 

08/10/2024
1. Introdução

Este processo visa explicar cada arquivo gerado na integração Android, do SIEM para Android e do Android para SIEM (Retorno).

Processos Relacionados

1. Como exportar e importar dados no Android

2. Detalhamento campos - SIEM para Android

3. Detalhamento campos - Android para SIEM

2. Arquivos SIEM para ANDROID:

Este procedimento tem por objetivo demostrar e explicar os arquivos gerados na integração Android no SIEM.

image-1728396745834.png

I - Exemplo de possibilidades para gerar arquivos SIEM pro Android, integração.

image-1728397547243.png

II - Exemplo arquivos gerados SIEM pro ANDROID

Descrição dos arquivos:

Campo do sistema

Arquivo gerado

OBS

FOTO DO PRODUTO

128638.jpg

Neste exemplo só um produto tem foto, se forem vários, ficará com vário arquivos, o que pode pesar no dropbox, eles são referenciados no arquivo PRODUTO.txt no campo específico.

-

AcessoDados.dll

Lib(biblioteca) que o LeAndroid precisa pra acessar o DB

CLIENTE

CLIENTE.txt

Dados referente a clientes cadastrados.

CÓDIGO DE BARRA

CODIGOBARRA.txt

Somente gera dos produtos que tem código de barras cadastrado.

-

DBRede.ini

Contém o local do banco de dados do SIEM, exemplo:
Provider=Microsoft.Jet.OLEDB.4.0;Data Source='C:\SoftenSIEM\EMPRESA3\Siem.mdb';Persist Security Info=True;Jet OLEDB:Database Password=soften03JB-BR

DADOS DA EMPRESA

EMPRESA.txt

Dados referente a empresa que gerou os arquivos

-

ESTOQUE.txt

Somente gera dos produtos que tem estoque positivo.

FORMA DE PAGAMENTO

FORMA_PAGAMENTO.txt

Dados referente as formas de pagamentos cadastradas.

-

GRADE.txt

Dados referente as cores cadastradas.

-

LeAndroid.exe

Comunica e importa os dados (txt) do SoftenSIEM Android para o banco de dados do SIEM.

-

metadata.soften

Temos uma API que funciona como um "DropBox" pra esses arquivos de integração. O LeAndroid usa esse arquivo pra saber a URL dessa API e mandar os arquivos de integração, especificamente esse arquivo serve pro LeAndroid saber se tem integração nova pra mandar pra API ou não

PRODUTO

PRODUTO.txt

Dados referente a produtos cadastrados.

TABELAS DE PREÇO

TABELAS_PRECO.txt

Neste exemplo foi gerado com todas as tabelas de preço do sistema, todas selecionadas.

VENDEDOR

VENDEDOR.txt

Dados referente a vendedores cadastrados.

 

3. Arquivos ANDROID para SIEM:

Este procedimento tem por objetivo demostrar e explicar os arquivos gerados ao exportar dados do Android pro SIEM.

image-1728483651416.jpg

I - Exemplo de possibilidades para gerar arquivos do Android pro SIEM (Exportar)

image-1728485999568.png

II - Arquivos exportardos do Android pro SIEM (Exportar)

Descrição dos arquivos:

OBS: Todos os outros arquivos que ficam na pasta integracao(dropbox) já estão explicados a cima na descrição do SIEM pro Android.

Campo do sistema

Arquivo gerado

OBS

Pedidos

PEDIDO_1.sss

Dados referente a pedidos emitidos do vendedor 1.
Neste exemplo,  o número "1" depois do "PEDIDO_" é o código do vendedor, se fosse o vendedor de código 3, ficaria por ex:
PEDIDO_3.sss

Orçamentos

ORÇAMENTO_1.sss

Dados referente a orçamentos emitidos do vendedor 1.
Mesma regra do pedido, pro vendedor 3, ficaria por ex:
ORCAMENTO_3.sss

©SOFTEN SISTEMAS 2024

 

 

 

 

2. Detalhamento campos - SIEM para Android


 Softensistemas Logo

 Projeto/Sistema:
DOCS - ARQUIVOS - ANDROID		 Versão do Template:
1.1
Processo:
Detalhamento campos - SIEM para Android		 Versão do Documento:
1.0
Responsável(eis): 
Gustavo Fernandes

Data: 

08/10/2024
1. Introdução

Este processo visa explicar detalhadamente cada txt gerado do SIEM para o ANDROID e seus respectivos campos.

Processos Relacionados

1. Especificação dos arquivos

2. Detalhamento campos - Android para SIEM

Detalhamento arquivos TXT:

image-1728409408844.png

I - Exemplo arquivos txt gerados

CLIENTE.txt:

1. Exemplo de linha do arquivo:

2|GUSTAVO HB FERNANDES|1|475.351.888-42|RUA 15 DE NOVEMBRO, 715|CENTRO|JOSE BONIFACIO-SP|||||NORMAL|1|||||
Descrição dos Campos CLIENTE.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

2

Cód interno do cliente

Sim

2

GUSTAVO HB FERNANDES

Nome/Razão social

Sim

3

1

Tipo de pessoa, sendo 1 = "FÍSICA" e 2 = "JURÍDICA"

Sim

4

475.351.888-42

CPF/CNPJ

Sim

5

RUA 15 DE NOVEMBRO, 715

Endereço e número após a vírgula

Sim

6

CENTRO

Bairro

Sim

7

JOSE BONIFACIO-SP

Nome da cidade

Sim

8

-

Fone 1

Não

9

-

Fone 2

Não

10

-

Fone 3

Não

11

-

Email

Não

12

NORMAL

Situação Crédito

Sim

13

1

Cód interno cadastro vendedor

Sim

14

-

Forma de pagamento padrão

Não

15

 - Limite de crédito

Não

16

-

Dias da conta

Não

17

-

Saldo da conta

Não
 
CODIGOBARRA.txt:

1.Exemplo de linha do arquivo:

2.20.17|100000000029|
Descrição dos Campos CODIGOBARRA.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

2.20.17

Cód interno do item

Sim

2

100000000029

Código de barras cadastrado no item acima

Sim
 
EMPRESA.txt:

1.Exemplo de linha do arquivo:

SOFTEN SISTEMAS|RUA DONATO VISSECHI, 417|Centro|JOSE BONIFACIO|15.200-000|07.587.030/0001-95|405076124110|||
Descrição dos Campos EMPRESA.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

SOFTEN SISTEMAS

Nome Fantasia

Sim

2

RUA DONATO VISSECHI, 417

Endereço e número após a vírgula

Sim

3

Centro

Bairro

Sim

4

JOSE BONIFACIO

Nome da cidade

Sim

5

15.200-000

CEP

Sim

6

07.587.030/0001-95

CPF/CNPJ

Sim

7

405076124110

Inscrição Estadual

Sim

8

-

Telefone

Não

9

-

Email

Não
 
ESTOQUE.txt:

1.Exemplo de linha do arquivo:

134.1.4|80.000|||||
Descrição dos Campos ESTOQUE.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

134.1.4

Cód interno do item

Sim

2

80.000

Quantidade em estoque

Sim

3

-

Lote

Não

4

-

Validade

Não

5

-

Tamanho

Não

6

-

Cor

Não
 
FORMA_PAGAMENTO.txt:

1.Exemplo de linha do arquivo:

1|VENDA A VISTA|
Descrição dos Campos FORMA_PAGAMENTO.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

1

Cód interno da forma de pagamento

Sim

2

VENDA A VISTA

Descrição da forma de pagamento

Sim
 
GRADE.txt:

1.Exemplo de linha do arquivo:

1|BRANCO|
Descrição dos Campos GRADE.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

1

Cód interno da cor (manual)

Sim

2

BRANCO

Descrição da cor cadastrada

Sim
 
PRODUTO.txt:

1.Exemplo de linha do arquivo:

1|PRODUTO EXEMPLO|PC|9.500|13.000|15.000|17.000|0.000|0.000|0.000|0.000|0.000|8|109.000|128638.jpg|ELETRICA - SEM SUBGRUPO|0|
Descrição dos Campos PRODUTO.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

1

Cód interno do produto

Sim

2

PRODUTO EXEMPLO

Descrição

Sim

3

PC

Unidade
(Não é descrição que seria "PEÇA" e sim unidade mesmo, resumida "PC")

Sim

4

9.500

Preço de venda "AVISTA" que no SIEM é a 1° tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

5

13.000

Preço de venda "APRAZO" que no SIEM é a 2º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

6

15.000

Preço de venda "VAREJO" que no SIEM é a 3º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

7

17.000

Preço de venda "PARCELA" que no SIEM é a 4º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

8

0.000

Preço de venda "PARCELA" que no SIEM é a 5º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

9

0.000

Preço de venda "PARCELA" que no SIEM é a 6º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

10

0.000

Preço de venda "PARCELA" que no SIEM é a 7º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

11

0.000

Preço de venda "PARCELA" que no SIEM é a 8º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

12

0.000

Preço de venda "PARCELA" que no SIEM é a 9º tabela de preço cadastrada (poderia ser outro nome a tabela)

Sim

13

8

Prioridade consulta do item

Sim

14

109.000

Quantidade em estoque

Sim

15

128638.jpg

Nome do arquivo de foto

Não

16

ELETRICA - SEM SUBGRUPO

Descrição do grupo - subgrupo do item

Sim

17

0

Tipo de estoque (padrão 0)

Sim

 

TABELAS_PRECO.txt:

1.Exemplo de linha do arquivo:

AVISTA
Descrição dos Campos TABELAS_PRECO.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

AVISTA

Apenas o nome da tabela de preço cadastrada, no SIEM vão até quatro tabelas ("AVISTA, "APRAZO", "VAREJO", "PARCELA").

Sim

 

VENDEDOR.txt:

1.Exemplo de linha do arquivo:

1|VENDEDOR 1|60|
Descrição dos Campos VENDEDOR.txt:

Posição

Valor do campo

Descrição do campo

Obrig.?

1

1

Cód interno do vendedor

Sim

2

VENDEDOR 1

Nome

Sim

3

60

Saldo Crédito
(Usado pra armazenar para utilização no app, é o valor máximo que o vendedor pode dar de desconto).

Sim
 

©SOFTEN SISTEMAS 2024

 

 

 

 

3. Detalhamento campos - Android para SIEM


 Softensistemas Logo

 Projeto/Sistema:
DOCS - ARQUIVOS - ANDROID		 Versão do Template:
1.1
Processo:
Detalhamento campos - Android para SIEM		 Versão do Documento:
1.0
Responsável(eis): 
Gustavo Fernandes

Data: 

09/10/2024
1. Introdução

Este processo visa explicar detalhadamente cada arquivo gerado do ANDROID para o SIEM e seus respectivos campos.

Processos Relacionados

1. Especificação dos arquivos

2. Detalhamento campos - SIEM para Android

Detalhamento arquivos SSS:

image-1728500331367.png

I - Exemplo arquivos gerados

ORCAMENTO_1.sss:

1. Exemplo do arquivo:

c8afb441-e54a-3599-af87-8a9ec391b3e8
OM|1000001|9/10/2024|1|8|teste observação|1|1,00|
LO|1000001|1|2.0|22,78|

Posição

Linha

Valor do campo

Descrição do campo

Obrig.?

1

1

c8afb441-e54a-3599-af87-8a9ec391b3e8

ID do aparelho

Sim

1

2

OM

Orçamento Mestre

Sim

2

2

1000001

Número do orçamento gerado no Android, inicia-se sempre com o número do código do vendedor, neste contexto é "1000001", pois, se trata do primeiro vendedor, código "1", se fosse o segundo vendedor cadastrado, seria código "2" e o orçamento seria "2000001"

Sim

3

2

9/10/2024

Data emissão

Sim

4

2

1

ID do vendedor

Sim

5

2

8

Cód interno cliente cadastrado no siem

Sim

6

2

teste observação

Observação orçamento

Sim

7

2

2

Cód interno forma de pagamento cadastrada no siem

Sim

8

2

1,00

Valor desconto do orçamento

Sim

1

3

LO

Linha Orçamento

Sim

2

3

1000001

Número orçamento, neste caso só tem uma linha, pois, só havia um produto, ele gera uma linha para cada item (movimentação).

Sim

3

3

1

Cód interno do item cadastrado no siem

Sim

4

3

2.0

Quantidade do item

Sim

5

3

22,78

Valor unit do item

Sim
 
PEDIDO_1.sss:

1. Exemplo do arquivo:

c8afb441-e54a-3599-af87-8a9ec391b3e8
PM|1000021|9/10/2024|1|2|Teste observação|1|||||||1|15,00|10/10/2024|
LP|1000021|1|4.0|103,00|1.0|2.0| Teste de informações adicionais|2,50|AVISTA|||||0.63|

Posição

Linha

Valor do campo

Descrição do campo

Obrig.?

1

1

c8afb441-e54a-3599-af87-8a9ec391b3e8

ID do aparelho

Sim

 1

2

PM

"Pedido Mestre"

Sim

2

2

1000021

Número do pedido gerado no Android, mesmas regras do orçamento.

Sim

3

2

9/10/2024

Data emissão

Sim

4

2

1

ID do vendedor

Sim

5

2

2

Cód interno cliente cadastrado no siem

Sim

6

2

Teste observação

Observação do pedido

Sim

7

2

1

Cód interno forma de pagamento cadastrada no siem

Sim

8

2

Será removido

Será removido

Não

9

2

Será removido

Será removido

Não

10

2

Será removido

Será removido

Não

11

2

Será removido

Será removido

Não

12

2

Será removido

Será removido

Não

13

2

Será removido

Será removido

Não

14

2

1

Indicador se foi marcado frete ou não no app

Sim

15

2

15,00

 Valor desconto total do pedido

Sim

16

2

10/10/2024

Data entrega

Sim

1

3

LP

Linha Pedido

Sim

2

3

1000021

Número do pedido, movimento, mesma regra do orçamento

Sim

3

3

1

Cód item cadastrado no siem

Sim

4

3

4.0

Quantidade do item

Sim

5

3

103,00

Valor unit do item + Vl de acréscimo

Sim

6

3

1.0

Quantidade troca

Sim

7

3

2.0

Qtd bonificação

Sim

8

3

Teste de informações adicionais

Informações adicionais do item

Sim

9

3

2,50

Desconto do item

Sim

10

3

AVISTA

Descrição da tabela de preço

Sim

11

3

-

Lote do item

Não

12

3

-

Validade do Item

Não

13

3

-

Tamanho do Item

Não

14

3

-

Cor do Item

Não

15

3

0.63

Percentual de desconto do item

Sim

©SOFTEN SISTEMAS 2024