Integracao Softsite x Datasul11

Integrao Backoffice x Datasul/Pedido Venda

19/08/2013


2 Verso 1.0

Sumrio

1 Contexto de negcio (Introduo) ............................................................................................. 3

2 Sistemas Envolvidos ................................................................................................................... 3

3 Integrao .................................................................................................................................. 3

4 Escopo ........................................................................................................................................ 7

5 Pr-requisitos instalao/implantao/utilizao ..................................................................... 9

5.1 Datasul ....................................................................................................................................... 9

5.2 Logix ........................................................................................................................................... 12

5.3 Protheus ..................................................................................................................................... 12

5.4 RM .............................................................................................................................................. 12

6 Instalao/Atualizao ............................................................................................................... 12

6.1. Segurana .................................................................................................................................... 13 6.1.1. Arquivo de Usurios WebService ..................................................................................................................... 13 6.1.2. Arquivo de Permisses WebService ................................................................................................................. 13 6.1.3. Procedimentos ................................................................................................................................................ 14 6.1.4. Programas ....................................................................................................................................................... 15 6.1.5. Procedimentos ................................................................................................................................................ 15 6.1.6. Cadastro de Papis .......................................................................................................................................... 16

6.2 Datasul ....................................................................................................................................... 17

6.3 Logix ........................................................................................................................................... 17

6.4 Protheus ..................................................................................................................................... 17

6.5 RM .............................................................................................................................................. 17

7 Controle de Verso .................................................................................................................... 17

8 Suporte ....................................................................................................................................... 17

9 Transaes/Entidades/Mensagens nicas ................................................................................. 18

10 Fluxo das Informaes ............................................................................................................... 19

10.1 Cadastros .................................................................................................................................... 21

10.2 Processos.................................................................................................................................... 24

11 Limitaes/Restries Gerais ..................................................................................................... 24

12 Como fazer ................................................................................................................................. 28

13 Situaes comuns....................................................................................................................... 28

14 Checklist de suporte da aplicao .............................................................................................. 29

15 Anexos ........................................................................................................................................ 29

3 Verso 1.0


1 Contexto de negcio (Introduo)

O objetivo desse Projeto integrar o Pedido de Venda do SoftSite com o ERP do Datasul 11 pelas mensagens nicas. Dessa forma possvel disponibilizar aos Representantes dos Clientes TOTVS uma forma fcil para entrada de Pedidos. O ERP Datasul gera as mensagens com os cadastros bsicos necessrios para que o Representante ao sincronizar seu Mobile com as informaes geradas consiga cadastrar Pedidos de Venda. Estes pedidos depois de cadastrados no mbile sero sincronizados com o ERP da Datasul no qual eles sero RECALCULADOS e atualizados na base de dados do ERP. Depois deste reclculo, o Representante do Pedido e o Cliente do Pedido sero notificados via E-mail com o relatrio do Pedido em anexo se parametrizado. Permitindo atender a uma necessidade do mercado que mobilidade.

2 Sistemas Envolvidos

Descrio dos sistemas envolvidos no contexto de negcio (e que sero envolvidos na integrao).

Sistema SoftSite: Prestadora de servios em tecnologia da informao desde 1996, a SoftSite tem como foco solues em Comunicao, Informao e Gesto em aplicaes para dispositivos mveis e portais de gerenciamento na web. Alm da mobilidade corporativa, a SoftSite atua nas reas de consultoria, desenvolvimento de sistemas, treinamento, outsourcing e representao de tecnologias de ponta.

http://www.softsite.com.br/

BackOffice(s): Esta integrao contempla o ERP TOTVS linha Datasul, por intermdio desta integrao, o ERP Datasul conseguir disponibilizar as principais informaes necessrias para cadastrar e gerenciar os Pedidos de Venda dos Representantes.

3 Integrao

O objetivo desta integrao de Pedido de Venda do SoftSite com o ERP do Datasul 11 pelas mensagens nicas disponibilizar aos Representantes dos Clientes TOTVS da linha Datasul uma forma fcil e rpida para entrada e gerenciamento dos Pedidos. O ERP Datasul vai gerar as mensagens com os cadastros necessrios para que o Representante ao sincronizar seu Mobile com as informaes geradas consiga cadastrar Pedidos de Venda. Estes Pedidos depois de cadastrados no sistema da SoftSite sero sincronizados Enviados para o ERP da Datasul no qual eles sero recalculados e atualizados na base de dados do ERP. Depois deste reclculo, o Representante do Pedido e o Cliente do Pedido sero notificados E-mail com o relatrio do Pedido em PDF. Esta integrao esta dividida em duas partes: SENDER: Estas tabelas sero enviadas do ERP TOTVS 11 via XML para o WebService da SoftSite. Estas informaes no sero alteradas ou excludas pelo sistema da SoftSite. Estas informaes somente sero enviadas do ERP para a SoftSite para fins de Consulta e cadastro dos Pedidos de Venda dentro do Sistema da SoftSite.


4 Verso 1.0

Tabela Datasul Tabela SoftSite Descrio Tabela Datasul Tabela SoftSite Descrio

EMITENTE CLIENTE Clientes TAB-UNIDADE UNIDADE_BASE Unidade de Medida

REPRES VENDEDOR Vendedores CONV-MAN-UN UNIDADE_CONVERSAO Unidade Converso

CONDPAGTO CONDICAO_PAGAMENTO Condies de Pagamento PED-VENDA PEDIDO Pedidos de Venda

PED-ITEM ITEM_PEDIDO Itens Pedidos de Venda

TRANSPORTE TRANSPORTADORA Transportadoras TIT_CRB TITULO Ttulos a Receber Financeiro

TAB-PRECO TABELA_PRECO Tabelas de Preos ESTABELEC ORGANIZACAO_VENDA Estabelecimento

PRECO-ITEM FAIXA_ PRECO_PRODUTO Itens da Tabela de Preos REF-ITEM PRODUTO_CARACTERISTICA

Referncias do Item

PRECO-ITEM LISTA_PRODUTO Itens da Tabela de Preos REFERENCIA CARACTERISTICA Referncia do Item

ITEM PRODUTO Produto ESTAB-CLI CLIENTE_ROTA Separao Cliente x Estab.

FAM-COMERC FAMLIA_PRODUTO Famlia de Comercial de Produto ROTA ROTA Rota de Atendimento

RECEIVER: Quando o representante cadastra um Pedido de Venda no Sistema da SoftSite, este enviado para o WebService do ERP TOTVS 11, esta integrao No on-line, executada via RPW de tempos em tempos. O WebService do Datasul 11 recebe as mensagens dos Pedidos da SoftSite, processa e Recalcula para obter os valores de: Impostos, Descontos, Totais, Prazo de Entrega, Avaliao de Crdito, Avaliao de Descontos, Quantidade de Estoque, entre outras. Depois de recalcular o processo RPW, verifica se deve notificar o Cliente/Representante, caso sim, envia um e-mail com o relatrio do pedido em anexo, desta forma o Cliente notificado.

Tabela Descrio

PED-VENDA Pedidos de Venda

PED-ITEM Item de Venda

Premissas: Datasul dever ser verso 11.5.8 ou posterior, quanto tiver integrao com a SoftSite.

Toda mensagem (XML) deve respeitar o modelo de integrao entre produtos da marca TOTVS mensagem nica.

Os nomes das TAGS devem ser em ingls.

Quando enviado a TAG com informao, o ERP Datasul respeita o valor informado, quando no informado a TAG ser assumido o Valor default do ERP conforme regras de negcios.

As mensagens devem ser definidas pela TOTVS e SoftSite (a quatro mos).

As mensagens devem ser submetidas para aprovao do comit de integrao atravs das reunies de consenso, deve ser entregue o XSD e exemplo XML da mensagem.

As mensagens devem respeitar o envelope definido pelo comit de integrao.

A homologao ser feita pela TOTVS e SoftSite (a quatro mos).

A SoftSite precisa criar o adapter de recebimento para ler a mensagem recebida (XML).

A SoftSite precisa criar o adapter de envio, para criar e enviar a mensagem (XML) ao Datasul, respeitando o modelo de mensagem nica.

A SoftSite precisa criar o Web Service (para receber as mensagens), respeitando o WSDL definido pelo comit de integrao.

Na definio da mensagem, o sistema que tiver a maior restrio (tipo, tamanho de campo, entre outros) ter que se adaptar ao outro sistema, exemplos:

o O sistema A possui um campo do tipo alfanumrico e no sistema B este campo do tipo numrico, neste caso, o sistema B tem que se adaptar ao sistema A.

5 Verso 1.0


o O sistema A possui um campo do tipo Caracter com tamanho 40 e no sistema B este campo do tipo Caracter com tamanho 30, neste caso, o sistema A tem que se adaptar ao sistema B.

Todas as transaes definidas para esta Integrao sero do Tipo de Envio Assncrona.

O clculo dos totais do pedido, total de descontos e impostos devem ser feitos pela funo Totaliza Pedido do Datasul, pois desta forma se garante os valores do Pedido e integridade dos clculos.

A informao de nome abreviado do cliente ser gerado ao inserir o Pedido de Venda na base de dados do ERP Datasul.

As modificaes no pedido no ERP sero enviadas para atualizao no SoftSite.

Dever ser previsto um indicador de origem do pedido como sendo "Mobile" para facilitar a diferenciao dos pedidos informados no SoftSite ou no ERP - Datasul 11.

A integrao ocorrer somente para itens normais.

A Integrao de Pedidos somente ocorrer para Pedidos do Tipo VENDA.

Todas as consistncias e atualizaes feitas pelo BO de pedidos devero ser efetuados tambm quando da entrada do pedido via XML.

Os pedidos informados no SoftSite, o preo de tabela do item gravado em um campo e sugerido no preo final, isto para o conceito do Datasul 11 ERP figura preo informado. Os pedidos da SoftSite entraro sempre no Datasul 11 com o tipo de preo INFORMADO. O pedido ao entrar no EMS no busca o preo nas tabelas de preo novamente.

O preo final unitrio do item vir conforme a Tabela de Preo criada pelo Cliente com ou sem ICMS incluso + TAXA FINANCEIRA, no ERP ser considerado como PREO INFORMADO.

PREO: Restrio da Integrao vai trabalhar somente com PREO CIF (Mim. CIF e Preo CIF).

Consistir as informaes contidas no XML enviado pela SoftSite, no permitido ao usurio cadastrar novas informaes no Softsite, pois a nica integrao de Recebimento ser a de Pedidos/Item.

Na integrao, sero permitidos somente Pedidos de Venda Espcie Pedido Simples: So os pedidos de venda sem programao de entrega; so os pedidos de venda sem um contrato de fornecimento. o tipo de pedido de venda no qual cada sequncia do pedido de venda possui apenas uma data de entrega.

Impostos: A SoftSite deve externalizar a entrada da sua tabela de impostos, desta forma quando o Cliente desejar o Total do Pedido com impostos alimentar esta Tabela. Ainda que calculado imposto no SoftSite, ao entrar este pedido no ERP Datasul, ser recalculado por completo.

Frete: O ERP Datasul obedece aos valores do FRETE informado na TAG de Frete, quando no enviado recalculado conforme REGRA do ERP Datasul.

Os relacionamento das tabelas do SoftSite devero ser gerados pelos processos de sincronizao da SoftSite. Estas informaes visam facilitar o cadastro dos pedidos dentro do sistema. Alguns exemplos: Cliente x Transportadora; Cliente x Produto, Cliente x Condio de Pagamento.

Restries: O Datasul no tem as informaes separadas por Empresa/Estabelecimento, desta forma no ser

considerado Empresa/Estabelecimento para gerar as informaes.

As mensagens j definidas s podero ser alteradas para incluso de novas TAGS, as TAGS j existentes no podero ser alteradas porque j houve consenso entre as marcas (Protheus, Datasul, RM e Logix).

Para a Tabela (Empresa) no ter rotinas de carga, deve ser cadastro manual na implantao quando necessrio.

Metas do Representante no sero integradas nesta FASE.

Ser considerado o desconto informado que o desconto no qual o representante aplica no Sistema da SoftSite, este o nico Desconto que se encaixa no conceito do ERP x SoftSite. Visto que as outras parametrizaes de Descontos do ERP s sero aplicadas se parametrizados dentro do ERP.

As informaes de representantes indiretos sero geradas no pedido quando este for inserido na base de dados do Datasul, pois o Sistema da SoftSite no contempla esta informao.


6 Verso 1.0

Condio de pagamento Especial do Datasul no ser tratado; o representante no conseguir definir uma condio de pagamento pelo sistema da SoftSite.

O Datasul 11 no trabalha com Desconto Fornecedor, desta forma no ser considerado na integrao.

Contatos: No sero integrados os contatos dos Clientes com o Sistema da SoftSite.

Mltiplas entregas para o mesmo item do pedido, no ser previsto na integrao, o item de pedido no poder conter varias datas de entrega.

Programao de entrega: No ser possvel cadastrar pedidos com Programao de Entrega.

Contrato de fornecimento: No ser possvel cadastrar pedidos para Contrato de fornecimento.

No sero permitidas alteraes nos pedidos no SoftSite, pois um pedido poder estar atendido, embarcado ou mesmo alocado no ERP, ento no Sistema da SoftSite no ser permitido executar alteraes.

O ERP Datasul no trabalha com Pedido do tipo: Troca. Desta forma no poder ser executado este tipo de pedido pela SoftSite.

O ERP Datasul no trabalha com Pedido do tipo: Complementar. Desta forma no poder ser executado este tipo de pedido pela SoftSite.

No ser Previsto item composto e item configurado na integrao.

No sero tratados os Itens do tipo: o Produtos Caractersticas: No sero Integradas as informaes adicionais para os produtos

comercializados pela empresa no Datasul 11, como argumento de vendas, caractersticas, entre outros.

o Produtos Componentes: No ser Integradas as informaes de relacionamento dos itens a um produto Pai, Bundle ou kit.

Exemplo: Lanche nmero 1 do Bobs: o Produto Kit: No sero integrado as informaes para o tipo de Produto Kit.

Exemplo: Nmero 1 - Mac feliz.

Componentes: o 1 Batata Frita Mdia. o 1 Refrigerante Mdio. o 1 Sanduche de Atum.

o Produtos Equivalentes: No sero integradas as informaes dos produtos considerados equivalentes ao selecionado (sempre que um produto obtiver caractersticas similares a outros).

Exemplo: No momento do pedido de venda, o vendedor poder consultar todos os produtos equivalentes. Dessa forma, na ausncia de um determinado produto, o vendedor poder oferecer seu equivalente.

o Produtos Obrigatrios: No sero integradas as informaes dos produtos obrigatrios e suas informaes.

Exemplo: Impressora e cabo da impressora: a impressora no funcionar sem o cabo, o cabo da impressora um item obrigatrio para a impressora e ser nessa tela que far o relacionamento.

o Produtos Cross Selling: No sero integradas as informaes dos produtos que podem ser vendidos juntamente com algum outro (venda cruzada). Este tipo de funcionalidade permite que o vendedor incremente a venda do produto.

Exemplo: quando o cliente efetua a compra de um carro, pode-se vender juntamente um aparelho de som, tapetes ou outros acessrios. Nesse caso, este relacionamento ser cadastrado e mantido nessa janela. Feito este relacionamento, o vendedor poder visualizar esse relacionamento no momento do pedido de venda.

7 Verso 1.0


o Produtos Up Selling: No sero integradas as informaes dos produtos como sugestes de compra de produtos superiores a ele.

Exemplo: Cliente liga pedindo um Pentium II, verificado que no tem no estoque. Permite tentar vender um produto superior a ele como, por exemplo, um Pentium III.

Campanha no Pedido de Venda: No sero integradas as informaes de Campanha no Pedido de Venda da SoftSite. Informaes como:

o Desconto da Campanha. o Tabela de Preo por campanha. o Condio de Pagamento por campanha.

No sero consideradas as informaes de Contatos no Pedido de Venda; o sistema da SoftSite no est preparado para que seja informado um contato para o Pedido no momento da incluso.

Pedido de Antecipao: No ser possvel fazer pedidos de Antecipao, pois o Sistema da SoftSite no contempla.

Pedido Operao Triangular: No ser considerado na integrao.

4 Escopo

1. O escopo desta integrao gerar e disponibilizar as informaes dos cadastros do Datasul em forma de

mensagens e disponibilizar no WebService; as seguintes informaes esto dentro do escopo proposto pela integrao.

Descrio Descrio

Clientes Unidade de Medida

Vendedores Unidade Converso

Condies de Pagamento Estabelecimento

Meio de Pagamento Referncias do Item

Transportadoras Referncia x Item

Tabelas de Preos Rota

Itens da Tabela de Preos Famlia de Comercial

Estabelecimentos x Cliente Produto

de responsabilidade do ERP TOTVS 11 linha Datasul gerar estas informaes utilizando o EAI2 como padro. de responsabilidade da SoftSite ler e atualizar a sua base de dados com as informaes geradas pelo ERP TOTVS 11 linha Datasul. As tabelas especficas do sistema SoftSite no so geradas pela integrao; de responsabilidade da SoftSite disponibilizar ao usurio uma forma de parametrizar e cadastrar as informaes que no so geradas pela integrao. A Integrao ter os seguintes passos macros:

1. Responsvel: Usurio parametrizar o envio RPW: a. Sistema Datasul gera os Pedidos no RPW:

i. Pedido envio das tabelas bsicas. ii. Pedido envio das informaes de Ttulos Contas a Receber.

iii. Pedido envio das informaes dos Pedidos de Venda. iv. Pedido Recebimento das informaes dos Pedidos de Venda.

b. Sistema Datasul gera Relatrio dos Parmetros e Filtros RPW.


8 Verso 1.0

2. Responsvel: Datasul gera as informaes das mensagens que deve disponibilizar no WebService. 3. Responsvel: SoftSite consome as mensagens disponibilizadas pela Datasul:

a. SoftSite abre e insere as informaes atualizando a base do Mobile. b. Usurio parametriza as informaes necessria para seu Sistema.

4. Responsvel: Usurio: cadastra Pedido de Venda no Mobile. 5. Responsvel: Usurio: sincroniza o mbile com GeoSales. 6. Responsvel: GeoSales gera e disponibiliza as mensagens no WebService SoftSite. 7. Responsvel: Datasul abre e insere os Pedidos de Venda na base de dados:

a. Sistema Datasul calcula o Total do Pedido. b. Sistema Datasul gera e retorna e-mail para Cliente/Representante com as informaes do Pedido

de Venda. c. Sistema Datasul gera e retorna mensagem do Pedido de venda Calculado para WebService.

8. Responsvel: SoftSite sincroniza as informaes: a. Sistema SoftSite abre e insere as informaes atualizando a base do Mobile com o Total dos

Pedidos. Fluxo do Processo:

9 Verso 1.0


5 Pr-requisitos instalao/implantao/utilizao

EAI2: Instalado e configurado. Datasul TOTVS 11: Instalado e configurado. SoftSite: Instalado e configurado. Entre os tpicos deste tpico podemos citar:

Datasul TOTVS 11: Verso 11.5.8 ou superior. Ferramentas que so necessrias a integrao: EAI2, servidor de WebService.

5.1 Datasul

Relao entre ESTAB-CLI e CLIENTE_ROTA Observao: Nesta integrao o detalhe a sequncia de atendimento que existe no SoftSite e no existe no ERP Datasul 11, para solucionar esta situao, estamos considerando duas formas:

1. O Cliente pode atualizar pelo GeoSales a sequencia, entrando no cadastro e informando a sequencia de atendimento.

2. O Cliente pode usar o campo Distncia (KM) informando a sequencia no ERP no PD0507. Desta forma a manuteno fica somente no ERP e quando integrado j fica 100% configurado no Geosales.

distance distancia N Sim Distncia em KM usado para sequencia

Relao entre TAB-PRECO e TABELA_PRECO / TABELA_PRECO_APLICACAO Observao: A Tabela de Preo poder ser sem impostos ou com impostos; a Empresa dever decidir como deseja trabalhar. No entanto, ao enviar uma Tabela de Preo S/ IMPOSTOS para SOFTSITE, este devolve o Pedido de Venda e seus itens com Preo S/ IMPOSTOS. Pois quando entrar este Pedido na base do ERP, ser considerado PREO INFORMADO e sendo assim o ERP no ir mais adicionar os impostos no Preo. Preo enviado para SOFTSITE sem valor de FRETE.

PREO: Restrio da Integrao vai trabalhar somente com PREO CIF (Mim. CIF e Preo CIF). O Retorno deste Pedido para o ERP no ter problema. Pois como a SoftSite vai enviar o Tipo de Frete

CIF/FOB e o Preo do item ser do tipo INFORMADO para o ERP significa que no ter ao em cima deste Preo praticado.

Relao entre PRECO-ITEM e FAIXA_PRECO_PRODUTO Observao: A Tabela de Preo poder ser sem impostos ou com impostos; a Empresa dever decidir como deseja trabalhar. No entanto, ao enviar uma Tabela de Preo S/ IMPOSTOS para SOFTSITE, este devolve o Pedido de Venda e seus itens com Preo S/ IMPOSTOS. Pois quando entrar este Pedido na base do ERP, ser considerado PREO INFORMADO e sendo assim o ERP no ir mais adicionar os impostos no Preo. A SoftSite no possui o conceito de Data inicial no Item, desta forma na Integrao no ser considerada esta informao. A SoftSite possui um conceito de Preo Mximo para o Item da Tabela de Preo, este conceito no existe no ERP Datasul, pois o controle mais amplo tendo um Mdulo Rentabilidade para gerenciar este conceito. Sendo assim, a SOFTSITE vai considerar 99999,99 para o Preo Mximo. Motivo: Caso no seja feito desta forma, o Pedido efetuado pelo Representante pode parar no mdulo de Gerenciamento da SoftSite de Controle de Preo, sendo necessrio o RESPONSVEL desbloquear este Pedido para que ele siga o fluxo para o ERP. No entanto, ao entrar no ERP, este controle ser executado no ERP conforme


10 Verso 1.0

parametrizao da Empresa e poder BLOQUEAR novamente, sendo necessrio mais uma vez o RESPONSVEL liberar este Pedido para que ele possa prosseguir o Fluxo. Preo Mnimo / Mximo: Ainda que enviado o Preo mnimo do ERP e considerado mximo como 9999, o Cliente poder parametrizar o Sistema da SoftSite para Validar o Preo praticado no Pedido; o Cliente final poder decidir se deseja trabalhar com o mdulo de validao de Preo da SoftSite ou somente esta validao deva ocorrer dentro do ERP. Preo Escalonado: SoftSite tem este conceito que uma variao do preo do item X quantidade vendida. Tem este conceito no ERP no qual possvel parametrizar a Tabela de Preo diferenciando o Preo do Item conforme a quantidade de itens vendidos. No Caso do ERP: So usados os campos de Quantidade Mnima e Desconto na Quantidade para aplicar o desconto conforme a quantidade vendida no Pedido.

Relao entre MOVTO-ESTOQ / saldo-estoq e ESTOQUE + PRODUTO_ESTOQUE Observao: Nesta fase no integrar Consulta de Estoque, pois se entende que esta integrao deva ocorrer de forma on-line, caso contrrio, ter muitos problemas de estoque. Pois partindo do princpio que este SALDO enviado no ser atualizado at a prxima sincronizao, os Representantes podero vender produtos que no esto disponveis em estoque. Desta forma, ser avaliada a possibilidade de integrar o Estoque On-line numa FASE futura.

Relao entre COND-PAGTO e CONDICAO_PAGAMENTO Meio de Pagamento: No ERP, o meio de pagamento est na espcie do documento relacionada a Natureza de Operao, Exemplo: duplicata, cheque, entre outros. O sistema assume esta espcie para gerar o Titulo. Entretanto, a informao de Natureza de Operao somente ser reconhecida no momento em que o usurio informar a Natureza de Operao no ERP Faturamento, por default na entrada do Pedido na base do ERP Datasul esta informao a Natureza de Operao DEFAULT do Cliente. Desta forma quando existir a necessidade da SoftSite mandar o Meio de Pagamento dever: Envia no Pedido de Venda uma observao informando qual o Meio de Pagamento desejado:

Desta forma o Usurio Faturista no ERP enxerga esta mensagem e considera na hora de buscar a Natureza de Operao.

Relao entre EMITENTE e FORNECEDOR Observao: No existe integrao de fornecedores com a SoftSite, pois o conceito da softsite de fornecedor de: Fornecedor de Mercadoria final Produto Acabado. Enquanto no ERP Fornecedor de Matria Prima.

Relao entre ESTABELEC E ORGANIZACAO_VENDA Observao: Foi detectado durante a homologao, a necessidade de gerar valor para esta tabela do sistema da SoftSite: ORG_VENDA_CLIENTE CD_ORG_VENDA CD_CLIENTE CD_VENDEDOR CD_TAB_PRECO CD_GRUPO_MPGTO O que deve ser feito: A SoftSite deve criar um Mtodo para popular esta Tabela com as informaes vindas das Mensagens (Cliente, Estabelecimento, Produto e Tabela de Preo).

11 Verso 1.0


Motivo: No existe uma tabela equivalente no ERP Datasul 11. Desta forma no possvel gerar e homologar uma mensagem que criada com base em vrias TABELAS. Este mtodo dever popular a tabela ORG_VENDA_CLIENTE executando a combinao destas 4 mensagens (Cliente, Estabelecimento, Produto e Tabela de Preo).

Relao entre EMITENTE e CLIENTE Observao: Nesta fase do Projeto no est sendo previsto a possibilidade de incluso de Lead/Prospect ou Cliente pelo sistema da SoftSite.

Relao entre REPRES e VENDEDOR / TUSUARIO Observao: A SoftSite possui uma hierarquia de Supervisor e Representantes, esta hierarquia no existe atualmente no ERP. Desta forma para contemplar esta necessidade, deve-se usar o mdulo de gerenciamento do SoftSite para parametrizar esta funcionalidade. Pois esta hierarquia usado no SoftSite para gerenciamento da alada de descontos.

Relao entre rota e rota Observao: O Conceito de ROTA para o ERP neste caso Rota de Entrega dos Pedidos executados. O Conceito de ROTA para SoftSite Rota de Atendimento do Representante. No entanto, caso a Empresa deseje parametrizar a Rota de Entrega, esta ser enviada para o SoftSite para ser usado como Rota de Atendimento.

Relao entre Referencias do Item (refer-item) / produto_caracteristica Observao: A SoftSite possui o conceito de mltiplas Referncias por item. Exemplo: Item = Camisa Polo, Referncia = Cor, Referncia = Tamanho. Desta forma, ao cadastrar um Pedido de Venda no Mobile, o Representante poder visualizar uma Grade da seguinte forma:

Item Tamanho Cor

Camisa Polo G Rosa

Camisa Polo G Preta

Camisa Polo P Branca

Porm, este conceito no existe no ERP, desta forma, caso necessrio, o Cliente pode:

1. Parametrizar no GeoSales para que seja possvel usar esta opo no Mobile. 2. Cadastrar no ERP o Item + Referncia Tamanho e na referncia definir COR.

Relao entre TAB-PRECO e TABELA_PRECO / TABELA_PRECO_APLICACAO

Relao entre Pedido de Venda Observao: A SoftSite envia as mensagens do Pedido de Venda, conforme os atributos do XSD definido. O Processo de RECEIVER dever seguir os seguintes passos:

1. Ler a Mensagem e inserir os Pedidos na base de dados: Quando no tiver a TAG na mensagem, deve-se assumir o Default do ERP. Quando tiver a TAG na mensagem e esta no possuir valor, deve-se assumir o Default do ERP. Quando tiver a TAG na mensagem e esta possuir valor, deve-se assumir valor passado.


12 Verso 1.0

2. Os Pedidos devem entrar como:

Situao ABERTO Include: i03di149.i - Campo: cod-sit-ent = val1 Aberto Aval. Crdito No avaliado Include: i03di159.i - Campo: cod-sit-aval = val1 No Avaliado Aval. Comercial No Avaliado diinc/i05di154.i - campo: cod-sit-com = val1 No Avaliado Preo INFORMADO; Include: i01di145.i - Campo: tp-preco = val1 Preo Informado Forma de Implantao inc/i01di159.i - campo: ind-imp-ped = val2 Batch Situao de Alocao Include: i04di149.i - Campo: cod-sit-pre - val1 No Alocado Origem do Pedido Include: i02di152.i - Campo: cd-origem - val1 Usuario Origem do Pedido Include: i07di159.i - Campo: origem - val20 Mobile criar um nova origem Mobile. &global val20 Mobile

5.2 Logix

No existem informaes pertinentes ao Logix.

5.3 Protheus

No existem informaes pertinentes ao Protheus.

5.4 RM

No existem informaes pertinentes a RM.

6 Instalao/Atualizao

Este tpico tem por objetivo orientar a instalao da integrao, visando o seu funcionamento completo. As instalaes de produtos ou ferramentas necessrias podem referenciar outros documentos existentes desde que estejam disponveis no repositrio de documentao da TOTVS ou sejam enviadas junto com o documento da integrao em si. As informaes mnimas necessrias para teste tpico so: Procedimentos que devem ser observados quando um dos produtos for atualizado.

Configurao necessria: Configurao do WebService EAI2

O EAI2 permite que o Datasul 11 se comunique com outros sistemas, recebendo ou enviando mensagens, por intermdio de WebService. No caso de recebimento de uma mensagem, necessrio que seja feita autenticao no servidor WebService EAI 2 do Datasul 11. Este documento esclarece itens importantes para o acesso ao WebService EAI 2.

13 Verso 1.0


Para acessar o WSDL do EAI 2 do Datasul 11, deve-se utilizar a seguinte URL: http://:/eai2-ws/EAIService?wsdl.

6.1. Segurana

Para realizar integrao com o Datasul 11, necessrio autenticar no EAI 2 (autenticao HTTP Basic). Para configurar um usurio que permita integrao, necessrio alterar os seguintes arquivos:

[diretrio-arquivos-datasul11]/jboss/server/[alias-produto]/conf/props/jbossws-users.properties

[diretrio-arquivos-datasul11]/jboss/server/[alias-produto]/conf/props/jbossws-roles.properties

6.1.1. Arquivo de Usurios WebService

O arquivo jbossws-users.properties armazena os nomes de usurios e suas respectivas senhas (usurio=senha). Exemplo: eai=eai@123 sistemaX=sysXPTO Os usurios listados aqui, no necessariamente tm permisso para realizar integrao com o Datasul 11, apenas cadastra usurio e senha. A permisso ser concedida no Arquivo de Permisses WebService.

6.1.2. Arquivo de Permisses WebService

Para que seja possvel realizar integrao com o Datasul 11, os usurios cadastrados no Arquivo de Usurios WebService devem estar cadastrado no arquivo de permisses WebService (jbossws-roles.properties) com a propriedade eai2allowed (usurio=eai2allowed). Exemplo: eai=eai2allowed sistemaX=eai2allowed Abaixo segue um exemplo de onde as informaes mencionadas acima devem estar cadastradas:


14 Verso 1.0

Arquivos diversos que devem ser mantidos nos locais para o funcionamento da integrao: xsd.

No existem atualizaes em banco de dados para esta integrao.

2. Processos Datasul x SoftSite que sero integrados (Fase I) Processo Direo XSD

Clientes (emitente) Datasul SoftSite CustomerVendor_2_001.xsd

Produtos (item) Datasul SoftSite Item_3_001.xsd

Familia Comercial Datasul SoftSite CommercialFamily_1_000.xsd

Vendedor (repres) Datasul SoftSite Seller_1_000.xsd

Condies de Pagamento(cond-pagto) Datasul SoftSite PaymentCondition_2_001.xsd

Transportadora (transporte) Datasul SoftSite Carrier_2_000.xsd

Tabela de Preos (tab-preco / preo-item) Datasul SoftSite PriceListHeaderItem_1_001.xsd

Unidade de medida Datasul SoftSite UnitOfMeasure_2_000.xsd

Converso Unidade de Medida Datasul SoftSite UnitOfMeasureConversion_1_000.xsd

Contas a Receber Datasul SoftSite AccountReceivableDocument_2_000.xsd

Estabelecimento Datasul SoftSite Establishment_1_000.xsd

Referencias Datasul SoftSite Reference_1_000.xsd

Referncias dos Item Datasul SoftSite ItemReference_1_000.xsd

Cliente x Estabelecimentos Datasul SoftSite CustomerEstablishment_1_000.xsd

Rota Datasul SoftSite Route_1_000.xsd

Pedidos / Itens de Pedidos (ped-venda / ped-item) Datasul SoftSite Order_4_000.xsd


Atualizao do Menu para liberao do programa de Carga da Integrao SoftSite RPW.

6.1.3. Procedimentos

Procedimento mpd.FFCargaInfoSoftSiteRPW Descrio Carga das Informaes com SoftSite via RPW

Mdulo MPD

Programa base mpd. FFCargaInfoSoftSiteRPW Nome Menu Carga das Informaes com SoftSite via RPW

Interface Metadados

Registro padro Sim

Visualiza Menu Sim

Release de/at A partir da 11.5.8

15 Verso 1.0


6.1.4. Programas

Programa mpd.FFCargaInfoSoftSiteRPW Descrio Carga das Informaes com SoftSite via RPW

Nome Externo mpd.FFCargaInfoSoftSiteRPW Nome Menu Carga das Informaes com SoftSite via RPW

Nome Verbalizado1 Carga das Informaes com SoftSite via RPW

Programa UPC -

Procedimento mpd.FFCargaInfoSoftSiteRPW Template Cadastro Simples Alterao

Tipo2 Tarefas

Interface Flex

Categoria3 Window (Metadados)

Executa via RPC No

Registro padro Sim

Outro Produto No

Visualiza Menu Sim

Query on-line No

Log Exec. No

Web Enable Sim

Rotina (EMS)

Sub-Rotina (EMS)

Localizao dentro da Sub Rotina (EMS)

Compact4 ?

Home5 ?

Posio do Portlet6 0

Informar os papeis com os quais o programa deve ser vinculado7 REP

Informar o diretrio do mdulo FLEX8 fnd.swf

6.1.5. Procedimentos

Procedimento mpd.FFNotificaCliPed Descrio Parmetros para Notificao do Pedido x Cliente

Mdulo MPD

Programa base mpd. FFNotificaCliPed Nome Menu Parmetros para Notificao do Pedido x Cliente

Interface Metadados

Registro padro Sim

Visualiza Menu Sim

Release de/at A partir da 11.5.8

1 Nome Verbalizado obrigatrio para desenvolvimentos no Datasul 10 em diante.

2 Tipo obrigatrio para desenvolvimento no Datasul 10 em diante

3 Categorias so obrigatrias para os programas FLEX.

4 Obrigatrio quando o projeto for FLEX






16 Verso 1.0

Programas: Programa mpd. FFNotificaCliPed Descrio Parmetros para Notificao do Pedido x Cliente

Nome Externo mpd. FFNotificaCliPed Nome Menu Parmetros para Notificao do Pedido x Cliente

Nome Verbalizado9 Parmetros para Notificao do Pedido x Cliente

Programa UPC -

Procedimento mpd. FFNotificaCliPed Template Cadastro Simples Alterao

Tipo10 Tarefas

Interface Flex

Categoria11 Window (Metadados)

Executa via RPC No

Registro padro Sim

Outro Produto No

Visualiza Menu Sim

Query on-line No

Log Exec. No

Web Enable Sim

Rotina (EMS)

Sub-Rotina (EMS)

Localizao dentro da Sub Rotina (EMS)

Compact12 ?

Home13 ?

Posio do Portlet14 0

Informar os papeis com os quais o programa deve ser vinculado15 REP

Informar o diretrio do mdulo FLEX16 fnd.swf

6.1.6. Cadastro de Papis

No tem novos Papeis.

Instrues para habilitar a comunicao da ferramenta EAI entre as partes, quais rotas devem ser definidas ou como as transaes devem ser habilitadas.

Observao: evite o uso de Prints de telas, facilitando assim o trabalho de traduo e versionamento deste documento.

9 Nome Verbalizado obrigatrio para desenvolvimentos no Datasul 10 em diante.

10 Tipo obrigatrio para desenvolvimento no Datasul 10 em diante

11 Categorias so obrigatrias para os programas FLEX.






17 Verso 1.0


6.2 Datasul

No existem informaes pertinentes a Datasul.

6.3 Logix

No existem informaes pertinentes ao Logix.

6.4 Protheus

No existem informaes pertinentes ao Protheus.

6.5 RM

No existem informaes pertinentes a RM.

7 Controle de Verso

O grupo TOTVS representado por suas marcas administra as demandas de evoluo dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberao de release. Todas as evolues programadas devero ser discutidas e aprovadas pelas marcas antes do incio do desenvolvimento e somente sero desenvolvidas em caso de concordncia das marcas e alinhamento com as diretivas definidas pelo Comit de Integrao TOTVS.

8 Suporte

O suporte aos recursos da Integrao ser de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estaro aptas a fazer a primeira anlise e, quando necessrio, repassar para a equipe mais adequada em cada caso. Observao: Este modelo de suporte est sendo revisado pela TOTVS.


18 Verso 1.0

9 Transaes/Entidades/Mensagens nicas

As transaes/entidades que so trocadas e quem envia a informao para quem.

2. Processos Datasul x SoftSite que sero integrados (Fase I) Processo Direo XSD

Clientes (emitente) Datasul SoftSite CustomerVendor_2_001.xsd

Produtos (item) Datasul SoftSite Item_3_001.xsd

Familia Comercial Datasul SoftSite CommercialFamily_1_000.xsd

Vendedor (repres) Datasul SoftSite Seller_1_000.xsd

Condies de Pagamento(cond-pagto) Datasul SoftSite PaymentCondition_2_001.xsd

Transportadora (transporte) Datasul SoftSite Carrier_2_000.xsd

Tabela de Preos (tab-preco / preo-item) Datasul SoftSite PriceListHeaderItem_1_001.xsd

Unidade de medida Datasul SoftSite UnitOfMeasure_2_000.xsd

Converso Unidade de Medida Datasul SoftSite UnitOfMeasureConversion_1_000.xsd

Contas a Receber Datasul SoftSite AccountReceivableDocument_2_000.xsd

Estabelecimento Datasul SoftSite Establishment_1_000.xsd

Referencias Datasul SoftSite Reference_1_000.xsd

Referncias dos Item Datasul SoftSite ItemReference_1_000.xsd

Cliente x Estabelecimentos Datasul SoftSite CustomerEstablishment_1_000.xsd

Rota Datasul SoftSite Route_1_000.xsd


Pedidos / Itens de Pedidos (ped-venda / ped-item) SoftSite Datasul Order_4_000.xsd

3. Tabelas envolvidas no processo Datasul x SoftSite

Tabela Datasul Tabela SoftSite Descrio

EMITENTE CLIENTE Clientes

REPRES VENDEDOR Vendedores

COND-PAGTO CONDICAO_PAGAMENTO Condies de Pagamento

TRANSPORTE TRANSPORTADORA Transportadoras

TAB-PRECO TABELA_PRECO Tabelas de Preos

PRECO-ITEM FAIXA_ PRECO_PRODUTO Itens da Tabela de Preos

PRECO-ITEM LISTA_PRODUTO Itens da Tabela de Preos

ITEM PRODUTO Produto

19 Verso 1.0


FAM-COMERC FAMLIA_PRODUTO Famlia de Comercial de Produto

TAB-UNIDADE UNIDADE_BASE Unidade de Medida

CONV-MAN-UN UNIDADE_CONVERSAO Unidade Converso

PED-VENDA PEDIDO Pedidos de Venda

PED-ITEM ITEM_PEDIDO Itens Pedidos de Venda

TIT_CRB TITULO Ttulos a Receber Financeiro

ESTABELEC ORGANIZACAO_VENDA Estabelecimento

REF-ITEM PRODUTO_CARACTERISTICA Referncias do Item

REFERENCIA CARACTERISTICA Referncia do Item

ESTAB-CLI CLIENTE_ROTA Relacionamento Cliente x Estabelecimentos

ROTA ROTA Rota

10 Fluxo das Informaes

O propsito deste desenvolvimento utilizar o framework EAI para enviar e receber as informaes das tabelas envolvidas na integrao com a SoftSite, utilizando mensagens XML. Para isso, ser necessrio o desenvolvimento de Adpater SENDER e RECEIVER para as Mensagens. A funo deste programa ser montar e enviar as mensagens XML, extrair as informaes contidas na Base de Dados conforme filtros estabelecidos e efetivar a transao das mensagens com WebService da SoftSite.

Estas informaes esto modeladas conforme XML Schema (XSD) padro da transao definidas abaixo.

1. Parametrizao das informaes que sero sincronizadas: O Sistema criar os pedidos de execuo no RPW: 1. Pedido de Execuo para as informaes de Tabelas bsicas (SENDER): Quando esta opo estiver

assinalada, indica que ser gerado e disponibilizado as seguintes mensagens no WebService:

Descrio Descrio










20 Verso 1.0

2. Pedido de Execuo para as informaes de Pedido de Venda (SENDER): Quando esta opo estiver assinalada, indica que sero enviadas as mensagens dos Pedidos de venda. Conforme os Pedidos da Carteira de Clientes do Representante.

3. Pedido de Execuo para as informaes de Pedido de Venda (RECEIVER): Quando esta opo estiver assinalada, indica que ir RECEBER as mensagens dos Pedidos de venda cadastrados no sistema da SoftSite.

4. Pedido de Execuo para as informaes dos Ttulos Contas a Receber (SENDER): Quando esta opo estiver assinalada, indica que ser enviado as mensagens dos Ttulos a receber dos Clientes da Carteira de Clientes do Representante.

Depois de salvar os agendamentos dos Pedidos no RPW, ser gerado um Relatrio com os parmetros usados para criao do Pedido RPW. As informaes enviadas podem ser como: Carga Inicial: Na qual o sistema enviar todas as informaes das tabelas selecionadas conforme filtro selecionado, esta Carga ser usada para os casos em que se faz necessrio o envio de todas as informaes para o sistema da SoftSite. No caso de Pedidos, vamos enviar na Carga Inicial somente os Pedidos de Venda que estejam com Situao diferente de Suspenso, Cancelado e Faturado. Carga diria: Esta carga somente envia as informaes alteradas a partir da ltima sincronizao. Nem todos os cadastros possuem controle de atualizao no ERP, desta forma muitas das mensagens sempre sero enviadas por completas. As informaes enviadas devem seguir as seguintes REGRAS:

Representantes: Informao Obrigatria - So enviadas as informaes de todos os representantes CD0708 conforme filtro selecionado pelo usurio. O usurio dever informar quais representantes devem ser integrados.

Estabelecimento: Informao Obrigatria - Sero enviados Todos os Registros da tabela Estabelecimento CD0403 para o WebService, conforme os estabelecimentos selecionados pelo usurio.

Clientes: So enviados as informaes dos Clientes CD0704 conforme as Regras para montagem da Carteira de Clientes do Representante definidas no ERP Datasul. A Gerao da Carteira poder ser de 3 Formas:

1. Quando a Empresa estiver usando Regra de Times: Neste caso sero consideradas as Regras de Times para montar a Carteira de Clientes dos representantes que sero integrados.

Nesta opo vrios Representantes podem atender um nico Cliente.

Os Clientes com nvel de acesso = Geral no sero enviados para o sistema Mobile. 2. Quando a Empresa usar Representante do Cliente:

Neste caso sero enviados somente os Clientes CD0704 Tabela Emitente que esto ativos e que o Representante responsvel.

Nesta opo somente um Representante pode atender o Cliente.

Somente deve integrar as contas que o Representante responsvel. 3. Quando a Empresa usar Canal Venda CD1517 e CD1521:

Neste caso sero enviados somente os Clientes CD0704 Tabela Emitente que esto ativos e que atendam o Cliente pelo Canal de Venda.

Nesta opo vrios Representantes podem atender o mesmo Cliente.

Clientes x Estabelecimento: Quando selecionada esta opo, indica que a Carteira de Clientes do Representante ser filtrada conforme os Estabelecimentos selecionados pelo usurio. Exemplo: Representante possui uma carteira de 500 Clientes. Destes 400 so do estabelecimento 1 e 100

21 Verso 1.0


so do estabelecimento 2. O usurio selecionou somente o Estabelecimento 2 para enviar para o Mobile, desta forma ser enviado somente os 100 Clientes que pertence ao Estabelecimento 2. Quando no marcado este parmetro, ser enviado seguindo este mesmo exemplo, os 500 Clientes da Carteira do Representante.

Tabelas de Preos: Sero enviadas todas as Tabelas de Preos CD1508 selecionadas pelo usurio para o WebService.

Filtros de Produtos: Sero enviados todos os Produtos CD0204, conforme as Tabelas de Preo enviadas para o WebService; somente sero enviados os itens que estiverem nas tabelas de Preo selecionadas.

Ttulos Financeiro: Sero enviadas todos os Ttulos em aberto conforme a Carteira de Clientes do Representante enviados para o WebService.

As demais tabelas sero enviadas por completo pois so consideradas com pequeno volume de informao, por isso no foi disponibilizado Filtros para o usurio.

Condies de Pagamento: Sero enviadas todas as Condies de Pagamento CD0404 para o WebService.

Transportadoras: Sero enviadas todas as Transportadoras CD0402 para o WebService.

Famlia Comercial: Sero enviadas todos os Registros da tabela fam_comerc CD0206 para o WebService.

Unidade de Medida: Sero enviadas todos os Registros da tabela tab-Unidade CD0203 para o WebService.

Fator Converso Unidade de Medida: Sero enviados todos os Registros da tabela FATOR-CONVER CD0247 para o WebService.

Rota: Sero enviados todos os Registros da tabela rota CD0706 para o WebService.

Pedido Venda: Sero enviados todos os Pedidos recalculados, do representante para atualizao da situao do Pedido na SoftSite. Sempre que um Pedido for alterado dentro do ERP ser gerada a mensagem nica para atualizao no Mobile. Desta forma o Cliente e o representante sempre estaro atualizados com as informaes dos Pedidos.

10.1 Cadastros

Relao entre REPRES e VENDEDOR / TUSUARIO Nome XSD: Seller_1_000.xsd Relao entre EMITENTE e CLIENTE Nome XSD: CustomerVendor_2_001.xsd Relao entre ESTAB-CLI e CLIENTE_ROTA Nome XSD: CustumerEstablishment_1_000.xsd Relao entre rota e rota Nome XSD: Route_1_000.xsd Relao entre ITEM e PRODUTO Nome XSD: Item_3_001.xsd Relao entre REFERENCIAS E CARACTERSTICAS Nome XSD: Reference_1_000.xsd


22 Verso 1.0

Relao entre REFERENCIAS DO ITEM (REFER-ITEM) / PRODUTO_CARACTERISTICA Nome XSD: ItemReference_1_000.xsd Relao entre TAB-PRECO e TABELA_PRECO / TABELA_PRECO_APLICACAO Nome XSD: PriceListHeaderItem_1_001.xsd Relao entre PRECO-ITEM e LISTA_PRODUTO + SEQUENCIAL + FAIXA_PRECO_PRODUTO Nome XSD: PriceListHeaderItem_1_001.xsd Relao entre PRECO-ITEM e FAIXA_PRECO_PRODUTO Nome XSD: PriceListHeaderItem_1_001.xsd Relao entre COND-PAGTO e CONDICAO_PAGAMENTO Nome XSD :PaymentCondition_2_000.xsd Relao entre TRANSPORTE e TRANSPORTADORA Nome XSD: Carrier_2_001.xsd Relao entre FAM_COMERC E FAMILIA_PRODUTO Nome XSD: CommercialFamily_1_000.xsd Relao entre TAB-UNIDADE E UNIDADE_BASE Nome XSD: UnitOfMeasure_2_000.xsd Relao entre CONV-MAN-UN E UNIDADE_CONVERSAO Nome XSD: UnitOfMeasureConversion_1_000.xsd Relao entre ESTABELEC E ORGANIZACAO_VENDA Nome XSD: Establishment_1_000.xsd Relao entre TITULO E TIT_ACR Nome XSD: AccountReceivableDocument_2_000.xsd INFORMAES RECEBIDAS PELA DATASUL: Pedido de Venda: A SoftSite envia as mensagens do Pedido de Venda conforme os atributos do XSD definido. O Processo de RECEIVER dever seguir os seguintes passos:

1. Ler a Mensagem e inserir os Pedidos na base de dados:

Quando no tiver a TAG na mensagem, deve-se assumir o Default do ERP.

Quando tiver a TAG na mensagem e esta no possuir valor, deve-se assumir o Default do ERP.

Quando tiver a TAG na mensagem e esta possuir valor, deve-se assumir valor passado. 2. Os Pedidos devem entrar como:

Situao ABERTO Aval. Crdito No avaliado Aval. Comercial No Avaliado Preo INFORMADO

Situao de Alocao No Alocado

23 Verso 1.0


Origem do Pedido Usuario Origem do Pedido Mobile.

Campos Obrigatrio do Pedido e seus valores:

Ped Venda

Atributo Tipo Formato Descrio Obr.

cod-estabel C x(3) Cdigo do Estabelecimento Sim esta na Mensagem

Nome-abrev C x(12) Nmero Abreviado do Cliente Sim Buscar atravs do Cdigo

nr-pedcli C x(12) Nmero do Pedido do Cliente Sim esta na Mensagem

dt-emissao Date 99/99/9999 Data Emisso Pedido feita pelo representante/cliente Sim esta na Mensagem

dt-implant Date 99/99/9999 Data em que o Pedido foi implantado no sistema Sim Data Atual

dt-entrega Date 99/99/9999 Data prevista para entrega do Pedido Sim Data Atual

dt-entorig Date 99/99/9999 Data de entrega solicitada pelo cliente Sim Data Atual

nat-operacao C x(06) Natureza de operao Sim Buscar a Default do Cliente Emitente.nat-operacao

nr-tab-finan Int >>9 Nmero da tabela de financiamento Sim Buscar a Default do condio de pagamento

cod-entrega C x(12) Cdigo do endereo de entrega Sim Buscar a Default do Cliente

cod-portador Int >>>>9 Cdigo do portador Sim Buscar a Default do Cliente emitente.portador

Modalidade Int 9 Modalidade de Cobrana Sim Buscar a Default do Cliente emitente.modalidade

cod-mensagem Int >>9 Cdigo da mensagem que dever sair na nota fiscal Sim Buscar a Default do Cliente Emitente. cod-mensagem

cod-des-merc Int 99 Destino da mercadoria Sim Buscar a Default do Cliente

ind-icm-ret Log yes/no Informa se haver reteno de ICMS na fonte Sim

Nome-transp C x(12) Nome do transportador Sim Esta na Mensagem

tp-preco Int 99 Tipo de preo Sim informado

ind-fat-par Log yes/no Aceita faturamento parcial? Sim No

mo-codigo Int >9 Cdigo da moeda de referncia dos valores Sim Buscar a Default do Cliente

cod-rota C x(12) Rota de atendimento a que este pedido pertence Sim ??

ind-lib-nota Log yes/no Libera nota fiscal sem saldo em estoque? Sim

nr-ind-finan Int >9 Nmero do ndice de financiamento Sim

no-ab-reppri C x(12) Nome abreviado do representante principal Sim Esta na mensagem

ind-antecip Log yes/no Existe valor antecipado para o pedido? Sim No

tip-cod-desp Int 99 Tipo de cobrana das despesas Sim

cod-emitente int >>>>>>>>9 Cdigo do cliente Sim Esta na mensagem

esp-ped int 99 Espcie do pedido Sim Esta na mensagem

cd-origem int 99 Origem Sim Usuario

Origem inte 99 Origem do pedido Sim SoftSite

log-usa-tabela-desconto log Sim/No Usa a tabela de descontos no tratamento deste pedido?

Sim SIM

log-ped-bonif-pendente log Sim/No Gerao do pedido de bonificao est pendente? Sim Nao

log-cotacao log yes/no Indica se uma cotao Sim No

3. Os Pedidos que entrarem pela Integrao passar obrigatoriamente pelas BOs de Pedido e pela rotina

Totaliza Pedidos. Relao entre PED-VENDA e PEDIDO + ITEM_PEDIDO Nome XSD: Order_4_000.xsd Relao entre PED-ITEM e ITEM_PEDIDO + ITEM_PEDIDO_PRECO_TABELA Nome XSD: Order_4_000.xsd


24 Verso 1.0

10.2 Processos

Todas as Mensagens so geradas e validadas pelo Mapa XSD.

O EAI responsvel pelo envio das informaes.

11 Limitaes/Restries Gerais

Premissas: Datasul dever ser verso 11.5.8 ou posterior, quanto tiver integrao com a SoftSite.

Toda mensagem (XML) deve respeitar o modelo de integrao entre produtos da marca TOTVS mensagem nica.

Os nomes das TAGS devem ser em ingls.

Quando enviado a TAG com informao, o ERP Datasul ir respeitar o valor informado, quando no informado a TAG ser assumido o Valor default do ERP, conforme regras de negcios.

As mensagens devem ser definidas pela TOTVS e SoftSite (a 4 mos).

As mensagens devem ser submetidas para aprovao do comit de integrao por intermdio das reunies de consenso, deve ser entregue o XSD e exemplo XML da mensagem.

As mensagens devem respeitar o envelope definido pelo comit de integrao.

A homologao ser feita pela TOTVS e SoftSite (a 4 mos).

A SoftSite precisa criar o adapter de recebimento para ler a mensagem recebida (XML).

A SoftSite precisa criar o adapter de envio, para criar e enviar a mensagem (XML) ao Datasul, respeitando o modelo de mensagem nica.

A SoftSite precisa criar o Web Service (para receber as mensagens), respeitando o WSDL definido pelo comit de integrao.

25 Verso 1.0


Na definio da mensagem, o sistema que tiver a maior restrio (Tipo, tamanho de campo, entre outros) ter que se adaptar ao outro sistema, exemplos:

o O sistema A possui um campo do tipo Alfanumrico e no sistema B este campo do tipo numrico, neste caso, o sistema B tem que se adaptar ao sistema A.

o O sistema A possui um campo do tipo Caracter com tamanho 40 e no sistema B este campo do tipo Caracter com tamanho 30, neste caso, o sistema A tem que se adaptar ao sistema B.

Todas as transaes definidas para esta Integrao sero do Tipo de Envio Assncrona.

O clculo dos totais do pedido, total de descontos e impostos devem ser feitos pela funo Totaliza Pedido do Datasul, pois desta forma se garante os valores do Pedido e integridade dos clculos.

A informao de nome abreviado do cliente ser gerado ao inserir o Pedido de Venda na base de dados do ERP Datasul.

As modificaes no pedido no ERP sero enviadas para atualizao no SoftSite.

Dever ser previsto um indicador de origem do pedido como sendo Mobile para facilitar a diferenciao dos pedidos informados no SoftSite ou no ERP - Datasul 11.

A integrao ocorrer somente para itens normais.

A Integrao de pedidos somente ocorrer para Pedidos do Tipo VENDA.

Todas as consistncias e atualizaes feitas pelo BO de pedidos devero ser efetuados tambm quando ocorre a entrada do pedido via XML.

Os pedidos informados no SoftSite, o preo de tabela do item gravado em um campo e sugerido no preo final, isto para o conceito do Datasul 11 ERP figura preo informado. Os pedidos da SoftSite entraro sempre no Datasul 11 com o tipo de preo INFORMADO. O pedido ao entrar no EMS no buscar o preo nas tabelas de preo novamente.

O preo final unitrio do item vir conforme a Tabela de Preo criada pelo Cliente com ou sem ICMS incluso + TAXA FINANCEIRA, no ERP ser considerado como PREO INFORMADO.

PREO: Restrio da Integrao vai trabalhar somente com PREO CIF (Mim. CIF e Preo CIF).

O Retorno deste Pedido para o ERP no ter problema, pois como a SoftSite vai enviar o Tipo de Frete CIF/FOB e o Preo do item ser do tipo INFORMADO para o ERP significa que no existe ao em cima deste Preo praticado.

Consistir as informaes contidas no XML enviado pela SoftSite, no ser permitido ao usurio cadastrar novas informaes no Softsite, pois a nica integrao de Recebimento ser a de Pedidos/Item.

Na integrao, sero permitidos somente Pedidos de Venda Espcie Pedido Simples: So os pedidos de venda sem programao de entrega; so os pedidos de venda sem um contrato de fornecimento. o tipo de pedido de venda no qual cada sequncia do pedido de venda possui apenas uma data de entrega.

Impostos: A SoftSite deve externalizar a entrada da sua tabela de impostos, desta forma quando o Cliente desejar o Total do Pedido com impostos dever alimentar esta Tabela. Ainda que calculado imposto no SoftSite, ao entrar este pedido no ERP Datasul, ser recalculado por completo.

Frete: O ERP Datasul obedecer aos valores do FRETE informado na TAG de Frete, quando no enviado ser recalculado conforme REGRA do ERP Datasul.


26 Verso 1.0

Os relacionamento das tabelas do SoftSite devero ser gerados pelos processos de sincronizao da SoftSite. Estas informaes visam facilitar o cadastro dos pedidos dentro do sistema. Alguns exemplos: Cliente x Transportadora; Cliente x Produto, Cliente x Condio de Pagamento.

Restries: O Datasul no tem as informaes separadas por Empresa/Estabelecimento, dessa forma no ser

considerado Empresa/Estabelecimento para gerar as informaes.

As mensagens j definidas somente podero ser alteradas para incluso de novas TAGS, as TAGS j existentes no podero ser alteradas porque j houve consenso entre as marcas (Protheus, Datasul, RM e Logix).

Para a Tabela (Empresa) no ter rotinas de carga, dever ser cadastro manual na implantao quando necessrio.

Metas do Representante no sero integradas nesta FASE.

Ser considerado o desconto informado que o desconto no qual o representante aplica no sistema da SoftSite, este o nico Desconto que se encaixa no conceito do ERP x SoftSite. Visto que as outras parametrizaes de Descontos do ERP somente sero aplicadas se parametrizados dentro do ERP.

As informaes de representantes indiretos sero geradas no pedido quando este for inserido na base de dados do Datasul, pois o sistema da SoftSite no contempla esta informao.

Condio de pagamento Especial do Datasul no ser tratado; o representante no conseguir definir uma condio de pagamento pelo sistema da SoftSite.

O Datasul 11 no trabalha com Desconto Fornecedor, desta forma no ser considerado na integrao.

Contatos: No sero integrados os contatos dos Clientes com o sistema da SoftSite.

Mltiplas entregas para um nico item do pedido no ser prevista na integrao, o item de pedido no poder conter vrias datas de entrega.

Programao de entrega: No ser possvel cadastrar pedidos com Programao de Entrega.

Contrato de fornecimento: No ser possvel cadastrar pedidos para Contrato de fornecimento.

No sero permitidas alteraes nos pedidos no SoftSite, pois um pedido poder estar atendido, embarcado ou mesmo alocado no ERP; no Sistema da SoftSite no ser permitido executar alteraes.

O ERP Datasul no trabalha com pedido do tipo Troca. Desta forma no poder ser executado este tipo de pedido pela SoftSite.

O ERP Datasul no trabalha com pedido do tipo Complementar. Desta forma no poder ser executado este tipo de pedido pela SoftSite.

No ser previsto item composto e item configurado na integrao.

No sero tratados os Itens do tipo:

o Produtos Caractersticas: No sero integradas as informaes adicionais para os produtos comercializados pela empresa no Datasul 11, como argumento de vendas, caractersticas, entre outros.

o Produtos Componentes: No sero Integradas as informaes de relacionamento dos itens a um produto Pai, Bundle ou kit.

27 Verso 1.0


Exemplo: Lanche nmero 1 do Bobs.

o Produto Kit: No sero integradas as informaes para o tipo de Produto Kit.

Exemplo:

Nmero 1 Mac feliz.

Componentes: o 1 Batata Frita Mdia. o 1 Refrigerante Mdio. o 1 Sanduche de Atum.

o Produtos Equivalentes: No sero integradas as informaes dos produtos considerados equivalentes ao selecionado (sempre que um produto obtiver caractersticas similares a outros).

Exemplo: No momento do pedido de venda, o vendedor poder consultar todos os produtos equivalentes. Dessa forma, na ausncia de um determinado produto, o vendedor poder oferecer seu equivalente.

o Produtos Obrigatrios: No sero integradas as informaes dos produtos obrigatrios e suas informaes.

Exemplo: Impressora e cabo da impressora: a impressora no funcionar sem o cabo, o cabo da impressora um item obrigatrio para a impressora e ser nessa tela que far o relacionamento.

o Produtos Cross Selling: No sero integradas as informaes dos produtos que podem ser vendidos juntamente com algum outro (venda cruzada). Este tipo de funcionalidade permite que o vendedor incremente a venda do produto.

Exemplo: quando o cliente efetua a compra de um carro, pode-se vender juntamente um aparelho de som, tapetes ou outros acessrios. Nesse caso, este relacionamento ser cadastrado e mantido nessa janela. Feito este relacionamento, o vendedor poder visualizar esse relacionamento no momento do pedido de venda.

o Produtos Up Selling: No sero integradas as informaes dos produtos como sugestes de compra de produtos superiores a ele.

Exemplo: Cliente liga pedindo um Pentium II, verificado que no tem o mesmo no estoque. Ento posso tentar vender um produto superior ao mesmo como, por exemplo, um Pentium III.

Campanha no Pedido de Venda: No sero integradas as informaes de Campanha no Pedido de Venda da SoftSite. Informaes como:

o Desconto da Campanha.

o Tabela de Preo por campanha.

o Condio de Pagamento por campanha.

No sero consideradas as informaes de Contatos no Pedido de Venda; o sistema da SoftSite no est preparado para que seja informado um contato para o Pedido no momento da incluso.

Pedido de Antecipao: No ser possvel fazer pedidos de Antecipao, pois o Sistema da SoftSite no contempla.

Pedido Operao Triangular: No ser considerado na integrao.


28 Verso 1.0

12 Como fazer

Passos para viabilizar a integrao:

No ERP da Datasul, efetue os cadastros das seguintes informaes:

Descrio Descrio









No Datasul, efetuar toda a parametrizao necessria para diviso da Carteira de Clientes do Representante.

No Datasul, efetuar toda a parametrizao necessria para criao dos Pedidos de Execuo RPW.

o No Datasul, efetuar o processo de envio para as mensagens via RPW.

o No Datasul, efetuar o processo de recebimento das mensagens de Pedido via PRW.

No Datasul, efetuar um processamento de clculo, efetuando o calculo dos pedidos recebidos.

No Datasul, verificar se deve ser notificado o Cliente.

o No Datasul, efetuar um processo de gerao do relatrio do Pedido.

o No Datasul, efetuar um processo de envio do relatrio do Pedido para o Cliente, cpia Representante

No Datasul, efetuar a gerao da mensagem de envio do pedido de venda recebido e calculado.

No SoftSite, atualizar as informaes.

o Atualizar as informaes de cadastros e parametrizaes.

o Atualizar as informaes dos Pedidos de Venda recalculados pelo Datasul.

13 Situaes comuns

No existem informaes pertinentes as situaes comuns.

29 Verso 1.0


14 Checklist de suporte da aplicao

No existem informaes pertinentes ao checklist de suporte da aplicao.

15 Anexos

No existem anexos a serem disponibilizados nesta integrao.

Documents

Integracao Softsite x Datasul11