Layout´s de Exportação de dados para o ERP

De Wiki Trovata
Edição feita às 15h17min de 29 de dezembro de 2014 por Atendimento (Discussão | contribs)

Ir para: navegação, pesquisa

Arquivos TXT

NOMENCLATURA DOS ARQUIVOS: EAAMMDDT.SSS ONDE:
E = EMPRESA DO ARQUIVO
AA = ANO GERAÇÃO ARQUIVO
MM = MÊS GERAÇÃO ARQUIVO
DD = DIA GERAÇÃO ARQUIVO
T = TIPO ARQUIVO, ONDE: V=VENDA I=ITEM P=CLIENTE_NOVO_INCLUIDO C=CONTATOS_CLIENTE M=MOTIVOS_NAO_VENDA
SSS = SEQUÊNCIA DE GERAÇÃO NO DIA

ARQUIVO DE PEDIDO DE VENDA:

COLUNA
 TIPO
 OBSERVAÇÃO
EMPRESA
 INTEGER
ANO
 INTEGER
VENDA
 INTEGER
VENDEDOR
 INTEGER
CLIENTE
 INTEGER QUANDO CLIENTE JÁ CADASTRADO, OU SERÁ ZERO E TEMOS O CAMPO CLIENTE_INCLUIDO
TRANSPORTADOR
 INTEGER
FRETE
 VARCHAR(1) 
E=EMITENTE/CIF; D=DESTINATÁRIO/FOB
REDESPACHO
 INTEGER
FRETE_DREDESPACHO
 VARCHAR(1)  E=EMITENTE/CIF; D=DESTINATÁRIO/FOB
TIPO_VENDA
 VARCHAR(2) 
MOEDA
 INTEGER
PRAZO
 INTEGER
PRAZO_2
 INTEGER
TABELA_PRECO
 INTEGER
DATA_EMISSAO
 DATE
DATA_INCLUSAO
 DATE
PEDIDO_CLIENTE
 VARCHAR(20)
PEDIDO_VENDEDOR
 VARCHAR(35) CÓDIGO ÚNICO DO PEDIDO NO SFA, DEVE SER MANTIDO NO ERP PARA RELACIONAMENTO
PERC_DESCONTO_FINANCEIRO
 NUMERIC
DESCONTO_VALOR
 NUMERIC
PERC_DESCONTO_11
 NUMERIC
PERC_DESCONTO_12 NUMERIC
PERC_DESCONTO_13 NUMERIC
PERC_DESCONTO_21 NUMERIC
PERC_DESCONTO_22 NUMERIC
PERC_DESCONTO_23 NUMERIC
VALOR_TOTAL
 NUMERIC
QUANTIDADE_TOTAL
 NUMERIC
PERC_FATURAMENTO
 NUMERIC
COMISSAO_NEGOCIADA_1
 NUMERIC DESCONTO DE COMISSÃO DO VENDEDOR, NORMALMENTE QUANDO USOU DESCONTO DE PARCERIA NO PEDIDO
COMISSAO_NEGOCIADA_2
 NUMERIC
USUARIO
 VARCHAR(50)
SITUACAO
 VARCHAR(1)
DATA_ENTREGA
 DATE
OBSERVACAO_VENDA
 VARCHAR(256)
 OBSERVAÇÃO DO

SISTEMA
OBSERVACAO_NF
 VARCHAR(256)
 DESATIVADO
FORMA_PAGAMENTO
 INTEGER
TIPO_EMBALAGEM
 VARCHAR(5)
REGRA_VOLUME
 INTEGER
OBSERVACAO_VD
 VARCHAR(200)
 OBSERVAÇÃO INDICADA PELO VENDEDOR/USUÁRIO
CLIENTE_INCLUIDO
 INTEGER
 CÓDIGO PROVISÓRIO DO CLIENTE NOVO/INCLUÍDO, OU SERÁ ZERO SE O CLIENTE JÁ É CADASTRADO
CPF_CNPJ_CLIENTE
 VARCHAR(18)
OBSERVACAO_ORDEM_FAB
 VARCHAR(200)
 OBSERVAÇÃO PARA ORDEM DE FABRICAÇÃO
VALOR_FRETE
 NUMERIC


ARQUIVO DE ITEM DE PEDIDO DE VENDA:

COLUNA
 TIPO
 OBSERVAÇÃO
EMPRESA
 INTEGER
ANO
 INTEGER
VENDA
 INTEGER
SEQUENCIA
 INTEGER SEQUENCIA/ID DO ITEM NO PEDIDO DE VENDA
PRODUTO
 VARCHAR(15)
 REFERÊNCIA DO PRODUTO (SEM OS COMPLEMENTOS DE VARIAÇÃO)
COMPLEMENTO_1
 VARCHAR(10)
 CÓDIGO DA COR POR EXEMPLO (001=BRANCO, 002=AZUL, ETC)
COMPLEMENTO_2
 VARCHAR(10)
 CÓDIGO DO TAMANHO (20, 21, 22, ETC) OU DE OUTRO TIPO DE COMPLEMENTO
QUANTIDADE
 NUMERIC
 QUANTIDADE DESTE PRODUTO+COMPLEMENTO_1+COMPLEMENTO_2
PRECO_UNIT_NEGOCIADO
 NUMERIC PREÇO BRUTO DE VENDA SEM OS DESCONTOS DO ITEM OU DO CABEÇALHO DO PEDIDO
VALOR_DESCONTO
 NUMERIC
QUANTIDADE_TOTAL
 NUMERIC QUANTIDADE DO ITEM CONSIDERANDO A GRADE COMPLETA (TODOS OS COMPLEMENTO_2 DO ITEM)
CAIXAS
 INTEGER
 CAIXAS COLETIVAS
TIPO
 VARCHAR(1)
PERC_DESCONTO
 NUMERIC
PRECO_UNIT_TABELA_PRECO
 NUMERIC PREÇO ORIGINAL NA TABELA DE PREÇO PARA O PRAZO DE PAGAMENTO ESCOLHIDO NO PEDIDO
AGRUPAMENTO
 VARCHAR(15)
 CÓDIGO DO AGRUPAMENTO DE CAIXA COLETIVA DE PRONTA ENTREGA (ONLINE)
VALOR_INCENTIVO
 NUMERIC
DATA_ENTREGA
 DATE
PERC_COMIS1
 NUMERIC QUANDO A DATA DE ENTREGA É POR ITEM E NÃO ÚNICA PARA O PEDIDO TODO
PERC_COMIS2
 NUMERIC QUANDO O PERCENTUAL DE COMISSÃO DO VENDEDOR NO PEDIDO FOI RECALCULADO OU DIFERENCIADO NO ITEM
PERC_DESCONTO_11
 NUMERIC
PERC_DESCONTO_12 NUMERIC
PERC_DESCONTO_13 NUMERIC
PERC_DESCONTO_21 NUMERIC
PERC_DESCONTO_22 NUMERIC
PERC_DESCONTO_23 NUMERIC
COMPLEMENTO_3
 VARCHAR(10)
 CÓDIGO DO DE OUTRO TIPO DE COMPLEMENTO


ARQUIVO DE CLIENTE NOVO/INCLUÍDO OU ATUALIZAÇÃO DE CADASTRO:

COLUNA
 TIPO
 OBSERVAÇÃO
EMPRESA
 INTEGER
CLIENTE_INC_ALT
 INTEGER CÓDIGO PROVISÓRIO DO NOVO CLIENTE, NO ARQUIVO DE PEDIDO = CLIENTE_INCLUIDO
PESSOA
 INTEGER CÓDIGO DO CLIENTE JÁ CADASTRADO SE FOR UM ATUALIZAÇÃO/ALTERAÇÃO DE CADASTRO
CPF_CNPJ
 VARCHAR(18)
NOME_FANTASIA
 VARCHAR(50)
RAZAO_SOCIAL
 VARCHAR(40)
ENDERECO
 VARCHAR(200)
BAIRRO
 VARCHAR(30)
CIDADE
 INTEGER
DESCRICAO_CIDADE
 VARCHAR(30)
CEP
 VARCHAR(10)
CAIXA_POSTAL
 INTEGER
TELEFONE
 VARCHAR(15)
FAX
 VARCHAR(15)
RG_IE
 VARCHAR(20)
E_MAIL
 VARCHAR(60)
DATA_CADASTRO
 DATE
TIPO_TELEFONE
 INTEGER
HOME_PAGE
 VARCHAR(40)
CELULAR
 VARCHAR(15)
GRUPO_PESSOA
 INTEGER
CONCEITO
 VARCHAR(2)
VENDEDOR
 INTEGER
RAZAO_SOCIAL_VENDEDOR
 VARCHAR(40)
ROTEIRO
 VARCHAR(15)
ENDERECO_COBRANCA
 VARCHAR(200)
MARCA
 VARCHAR(4)
SITUACAO_CLIENTE
 VARCHAR(1)
CAIXA_POSTAL_COBRANCA
 INTEGER
DIA_COBRANCA
 INTEGER
SUFRAMA
 VARCHAR(15)
REDESPACHO
 INTEGER
OBSERVACAO
 VARCHAR(250)
PORTADOR
 INTEGER
CPF_CNPJ_ENTREGA
 VARCHAR(18)
LIMITE_CREDITO
 NUMERIC
CODIGO_REDUZ
 INTEGER
CODIGO_ANTERIOR
 INTEGER IGUAL AO CAMPO CLIENTE_INC_ALT
DATA_SUFRAMA
 DATE
IMPRIME_COMPLEMENTO
 VARCHAR(3)
TELEFONE_COBRANCA
 VARCHAR(15)
BAIRRO_COBRANCA
 VARCHAR(30)
VALIDADE_SINTEGRA
 DATE
OBSERVACAO_ENTREGA
 VARCHAR(250)
ENTREGA_ESPECIAL
 VARCHAR(3)
DATA_FUNDACAO
 DATE
TIPO_EMBALAGEM
 VARCHAR(1)
REGRA_VOLUME
 INTEGER
REGIAO
 INTEGER
TRANSPORTADOR
 INTEGER
RAZAO_SOCIAL_TRANSPORTADOR
 VARCHAR(40)
MIX_COMPRAS
 VARCHAR(3)
SIMPLES
 VARCHAR(3)
DATA_ANIVERSARIO
 DATE
QTDE_DECIMAIS_PRECO
 INTEGER
PORTADOR_REMESSA
 INTEGER
PERC_ENTREGA_MAIOR
 NUMERIC
PERC_ENTREGA_MENOR
 NUMERIC
CEP_COBRANCA
 VARCHAR(10)
TIPO_COBRANCA
 VARCHAR(1)
CLIENTE
 INTEGER
CIDADE_COBRANCA
 INTEGER
DESCRICAO_CIDADE_COBRANCA
 VARCHAR(30)
RAZAO_SOCIAL_REDESPACHO
 VARCHAR(40)


ARQUIVO DE CONTATOS DE CLIENTE:

COLUNA
 TIPO
 OBSERVAÇÃO
CLIENTE_INC_ALT
 INTEGER
 CÓDIGO DO CLIENTE RELACIONADO NO ARQUIVO DE CLIENTES
CONTATO_CLI_INC_ALT
 INTEGER
TIPO_CONTATO
 INTEGER
CONTATO
 VARCHAR(60)
TELEFONE
 VARCHAR(15)
CELULAR
 VARCHAR(15)
DATA_ANIVERSARIO
 DATE
DDD
 VARCHAR(7)
PROFISSSAO
 VARCHAR(15)
E_MAIL
 VARCHAR(60)
ENDERECO
 VARCHAR(36)
BAIRRO
 VARCHAR(30)
CIDADE
 INTEGER
DESCRICAO_CIDADE
 VARCHAR(30)
CEP
 VARCHAR(10)
CPF_CNPJ
 VARCHAR(18)
RG_IE
 VARCHAR(18)
TIME_FUTEBOL
 VARCHAR(30)
HOBBY
 VARCHAR(30)
SITUACAO
 VARCHAR(1)
ESTADO_CIVIL
 INTEGER
SEXO
 VARCHAR(3)
POSSUI_FILHOS
 VARCHAR(3)
QUANTOS_FILHOS
 INTEGER


ARQUIVO DE MOTIVO DE NÃO VENDA:

COLUNA
 TIPO
 OBSERVAÇÃO
PESSOA
 INTEGER
 CÓDIGO DO CLIENTE
DATA_INCLUSAO
 DATE
HISTORICO
 INTEGER
OBSERVACAO
 VARCHAR(256)


OBSERVAÇÕES:
-CAMPOS DELIMITADOS POR BARRA VERTICAL (|), SEM POSICIONAMENTO FIXO;
-UM REGISTRO (VENDA, ITEM/TAMANHO/COMPLEMENTO_2, CLIENTE, CONTATO, MOTIVO) POR LINHA DO ARQUIVO;
-DATA NO FORMATO: DD/MM/AAAA;
-USAR VÍRGULA PARA SEPARAR DECIMAIS

</font>

WebServices JSON ou XML


O formato será através de um Web Service, que vocês acessarão através de um URL específica passando alguns parâmetros de autentificação.
Os campos de Data do web service estão no padrão que vem do nosso banco de dados
MM/DD/AAAA<DATA_EMISSAO>03/26/2014</DATA_EMISSAO>

Os delimitador do campos de valores e o “.” padrão do banco de dados.
<VALOR_TOTAL_BRUTO_ITEM>664.44</VALOR_TOTAL_BRUTO_ITEM>

http://teste.trovata.com.br/ws_exporta_dados.php?chaveempresa=01175317&pedidos=S&clientes=N&motivonaovenda=N&diasfriltro=60&tipo=xml

Na qual deve passar seguintes variaveis:
-chaveempresa = 000000
-[passar o código que registra a empresa, no sistema Trovata. Campo not null]
-pedidos = S ou N
-[gera web service de Pedidos Sim ou Não. Por Padrão S se não passar.]
-clientes = S ou N
-[gera web service de clientes Sim ou Não. Por Padrão S se não passar.]
-motivonaovenda = S ou N
-[gera web service de motivo não venda Sim ou Não. Acredito que não vai ser usado. Por Padrão S se não passar.]
-diasfriltro = 60
-[Período de dias a ser buscado os Pedidos. Por Padrão 60 dias se não passar.]
-tipo = xml ou json
-[Formatos disponíveis para geração do web service.]

O método para postar o resultado da importação do pedido ou cliente.
depois de ler o web service:

http://teste.trovata.com.br/exporta_dados_confirmacao.php

Na qual deve passar seguintes variaveis:
-chaveempresa = 000000
-[passar o código que registra a empresa, no sistema Trovata.]
-tipo = P ou C ou M
-[qual a confirmação que seria P = pedido C = cliente ou M= motivo não venda a Bioextratus acredito que não vai usar]
-empresa = 1
-[qual a empresa que esta confirmando, podendo ser omitido pois a Bioestratus vai utilizar uma unica empresa e já pego ela automaticamente]
As próximas variáveis poderia ser passadas varias informações como se fosse um array dividido por | ex: 10|20|30.
Caso queira fazer um único post de todos os pedidos ou clientes.
-codigo_erp = 10|20|30||
-[O código que o pedido ou cliente gerou no vosso sistema, podendo ser vazio caso houver um erro]
-obs = Sucesso|Sucesso|Sucesso|Erro :X|Erro:Y
-[As mensagem de erro porque não gravou o pedido, ate para rastrearmos o motivo, ou de gravou pois , campo not null ]
-gravado = S|S|S|N|N
-[Campo na qual sera informado S = importado ou N = erro na importação, campo not null]
-codigo = 1025|1131|1145|1189|1200
-[Retornara para pedido o campo CODIGOVENDEDOR, para cliente CLIENTE_INC_ALT ]
EX: <PEDIDO_VENDEDOR>130001</PEDIDO_VENDEDOR>, <CLIENTE_INC_ALT>4</CLIENTE_INC_ALT>
-cnpj = ||09442168000121|35.480.879/0001-09
-[campo criado para apenas clientes, no caso de alguma integração não der para retornar o nosso código de cliente. Retornando o CPF_CNPJ podendo ser só números ou não. Campo not null se for passado deve ser gerado para todos os registros. Mais seria muito melhor se passa-se o nosso código pois e ele que e nossa chave primária, impedindo que ocorra algum problema na confirmação]

Só lembrando que se for passado em array, todos os campos devem ser gerados iguais mesmo se for em branco o conteúdo Ex:
-codigo_erp = 10 |20 |30 | |
-codigo = 1025|1131|1145|1189|1200
Os pedidos 1189,1200 deu erro não teria um código interno, mais geraria um valor vazio entre o |.
Não podendo ser assim.
-codigo_erp = 10 |20 |30
-codigo = 1025|1131|1145|1189|1200
Pois faço uma verificação no tamanho do array.

Arquivo XSD para importação dos pedido de venda, com as definições dos campos.

http://teste.trovata.com.br/ws_exporta_dados.xsd

mais um

afas

Disponível em "https://wiki.trovata.com.br/index.php?title=Layout´s_de_Exportação_de_dados_para_o_ERP&oldid=56"