Mudanças entre as edições de "Layout´s de Exportação de dados para o ERP"
(→WebServices JSON ou XML) |
|||
| (5 revisões intermediárias por um outro usuário não estão sendo mostradas) | |||
| Linha 1 241: | Linha 1 241: | ||
</font> | </font> | ||
== WebServices JSON ou XML == | == WebServices JSON ou XML == | ||
| − | + | <br> | |
| + | 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.<br> | ||
| + | Os campos de Data do web service estão no padrão que vem do nosso banco de dados<br> '''MM/DD/AAAA<DATA_EMISSAO>03/26/2014</DATA_EMISSAO>'''<br> | ||
| + | <br> | ||
| + | Os delimitador do campos de valores e o “.” padrão do banco de dados.<br> | ||
| + | '''<VALOR_TOTAL_BRUTO_ITEM>664.44</VALOR_TOTAL_BRUTO_ITEM>'''<br> | ||
| + | |||
| + | http://teste.trovata.com.br/ws_exporta_dados.php?chaveempresa=01175317&pedidos=S&clientes=N&motivonaovenda=N&diasfriltro=60&empresa=1&tipo=xml | ||
| + | |||
| + | Na qual deve passar seguintes variaveis:<br> | ||
| + | -'''chaveempresa''' = 000000<br> | ||
| + | -[passar o código que registra a empresa, no sistema Trovata. Campo not null]<br> | ||
| + | -'''pedidos''' = S ou N<br> | ||
| + | -[gera web service de Pedidos Sim ou Não. Por Padrão S se não passar.]<br> | ||
| + | -'''clientes''' = S ou N<br> | ||
| + | -[gera web service de clientes Sim ou Não. Por Padrão S se não passar.]<br> | ||
| + | -'''motivonaovenda''' = S ou N<br> | ||
| + | -[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.]<br> | ||
| + | -'''diasfriltro''' = 60<br> | ||
| + | -[Período de dias a ser buscado os Pedidos. Por Padrão 60 dias se não passar.]<br> | ||
| + | -'''empresa''' = 1<br> | ||
| + | -[código da empresa no sistema da Trovata]<br> | ||
| + | -'''tipo''' = xml ou json<br> | ||
| + | -[Formatos disponíveis para geração do web service.]<br> | ||
| + | <br> | ||
| + | O método para postar o resultado da importação do pedido ou cliente.<br> | ||
| + | depois de ler o web service:<br> | ||
| + | <br> | ||
| + | http://teste.trovata.com.br/exporta_dados_confirmacao.php | ||
| + | |||
| + | Na qual deve passar seguintes variaveis:<br> | ||
| + | -'''chaveempresa''' = 000000<br> | ||
| + | -[passar o código que registra a empresa, no sistema Trovata.]<br> | ||
| + | -'''tipo''' = P ou C ou M <br> | ||
| + | -[qual a confirmação que seria P = pedido C = cliente ou M= motivo não venda a Bioextratus acredito que não vai usar]<br> | ||
| + | -'''empresa''' = 1 <br> | ||
| + | -[qual a empresa que esta confirmando, podendo ser omitido para integração que vai utilizar uma unica empresa e pego automaticamente]<br> | ||
| + | As próximas variáveis poderia ser passadas varias informações como se fosse um array dividido por | ex: 10|20|30.<br> | ||
| + | Caso queira fazer um único post de todos os pedidos ou clientes.<br> | ||
| + | -'''codigo_erp''' = 10|20|30|| <br> | ||
| + | -[O código que o pedido ou cliente gerou no vosso sistema, podendo ser vazio caso houver um erro]<br> | ||
| + | -'''obs''' = Sucesso|Sucesso|Sucesso|Erro :X|Erro:Y <br> | ||
| + | -[As mensagem de erro porque não gravou o pedido, ate para rastrearmos o motivo, ou de gravou pois , campo not null ]<br> | ||
| + | -'''gravado''' = S|S|S|N|N <br> | ||
| + | -[Campo na qual sera informado S = importado ou N = erro na importação, campo not null]<br> | ||
| + | -'''codigo''' = 1025|1131|1145|1189|1200 <br> | ||
| + | -[Retornara para pedido o campo PEDIDOVENDEDOR, para cliente CLIENTE_INC_ALT ]<br> | ||
| + | EX: <PEDIDO_VENDEDOR>130001</PEDIDO_VENDEDOR>, <CLIENTE_INC_ALT>4</CLIENTE_INC_ALT><br> | ||
| + | -'''cnpj''' = ||09442168000121|35.480.879/0001-09<br> | ||
| + | -[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]<br> | ||
| + | <br> | ||
| + | Só lembrando que se for passado em array, todos os campos devem ser gerados iguais mesmo se for em branco o conteúdo | ||
| + | Ex:<br> | ||
| + | -'''codigo_erp''' = 10 |20 |30 | |<br> | ||
| + | -'''codigo''' = 1025|1131|1145|1189|1200<br> | ||
| + | Os pedidos 1189,1200 deu erro não teria um código interno, mais geraria um valor vazio entre o |.<br> | ||
| + | Não podendo ser assim.<br> | ||
| + | -'''codigo_erp''' = 10 |20 |30<br> | ||
| + | -'''codigo''' = 1025|1131|1145|1189|1200<br> | ||
| + | Pois faço uma verificação no tamanho do array.<br> | ||
| + | <br> | ||
| + | Arquivo XSD para importação dos pedido de venda, com as definições dos campos.<br> | ||
| + | <br> | ||
| + | http://teste.trovata.com.br/ws_exporta_dados.xsd | ||
Edição atual tal como às 18h21min de 30 de março de 2015
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>
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.]
-empresa = 1
-[código da empresa no sistema da Trovata]
-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 para integração que vai utilizar uma unica empresa e pego 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 PEDIDOVENDEDOR, 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.
