Integracao Softsite X Datasul11

Integrao Backoffice x Datasul/Pedido Venda
19/08/2013
Sumrio
1
Contexto de negcio (Introduo) ............................................................................................. 3
Sistemas Envolvidos ................................................................................................................... 3
Integrao .................................................................................................................................. 3
Escopo ........................................................................................................................................ 7
Pr-requisitos instalao/implantao/utilizao ..................................................................... 9
5.1
Datasul ....................................................................................................................................... 9
5.2
Logix ........................................................................................................................................... 12
5.3
Protheus ..................................................................................................................................... 12
5.4
RM .............................................................................................................................................. 12
Instalao/Atualizao ............................................................................................................... 12
6.1.
Segurana .................................................................................................................................... 13
6.1.1.
6.1.2.
6.1.3.
6.1.4.
6.1.5.
6.1.6.
Arquivo de Usurios WebService.....................................................................................................................13

Arquivo de Permisses WebService .................................................................................................................13
Procedimentos ................................................................................................................................................14
Programas.......................................................................................................................................................15
Procedimentos ................................................................................................................................................15
Cadastro de Papis ..........................................................................................................................................16
6.2
Datasul ....................................................................................................................................... 17
6.3
Logix ........................................................................................................................................... 17
6.4
Protheus ..................................................................................................................................... 17
6.5
RM .............................................................................................................................................. 17
Controle de Verso .................................................................................................................... 17
Suporte ....................................................................................................................................... 17
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
Verso 1.0
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.
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.
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.
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
Referncias do Item
PRECO-ITEM
LISTA_PRODUTO
REFERENCIA
PRODUTO_CARACTERIST
ICA
CARACTERISTICA
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
Referncia do Item
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
PED-VENDA
PED-ITEM
Descrio
Pedidos de Venda
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.
Verso 1.0
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.
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.
Verso 1.0
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.
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
Estabelecimento
Meio de Pagamento
Referncias do Item
Transportadoras
Referncia x Item
Tabelas de Preos
Rota
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.
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:
Verso 1.0
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
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.
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
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).
10
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
Rosa
Camisa Polo
Preta
Camisa Polo
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 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.
Verso 1.0
11
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.
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.
12
Verso 1.0
Para acessar o WSDL do EAI 2 do Datasul 11, deve-se utilizar a seguinte URL: http://<servidor-datasul-11>:<portadatasul-11>/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:
Verso 1.0
13
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
Clientes (emitente)
Direo
Datasul SoftSite
XSD
CustomerVendor_2_001.xsd
Produtos (item)
Familia Comercial
Vendedor (repres)
Datasul SoftSite
Datasul SoftSite
Datasul SoftSite
Item_3_001.xsd
CommercialFamily_1_000.xsd
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
Datasul SoftSite
Order_4_000.xsd
Atualizao do Menu para liberao do programa de Carga da Integrao SoftSite RPW.
6.1.3. Procedimentos
Procedimento
Descrio
Mdulo
Programa base
Nome Menu
Interface
Registro padro
Visualiza Menu
Release de/at
mpd.FFCargaInfoSoftSiteRPW
Carga das Informaes com SoftSite via RPW
MPD
mpd. FFCargaInfoSoftSiteRPW
Metadados
Sim
Sim
A partir da 11.5.8
14
Verso 1.0
6.1.4. Programas
Programa
Descrio
Nome Externo
Nome Menu
Nome Verbalizado1
Programa UPC
Procedimento
Template
Tipo2
Interface
Categoria3
Executa via RPC
Registro padro
Outro Produto
Visualiza Menu
Query on-line
Log Exec.
Web Enable
Rotina (EMS)
Sub-Rotina (EMS)
Localizao dentro da Sub Rotina (EMS)
Compact4
Home5
Posio do Portlet6
Informar os papeis com os quais o programa deve ser
vinculado7
Informar o diretrio do mdulo FLEX8
Cadastro Simples Alterao
Tarefas
Flex
Window (Metadados)
No
Sim
No
Sim
No
No
Sim
?
?
0
REP
fnd.swf
6.1.5. Procedimentos
Procedimento
Descrio
Mdulo
Programa base
Nome Menu
Interface
Registro padro
Visualiza Menu
Release de/at
mpd.FFNotificaCliPed
Parmetros para Notificao do Pedido x Cliente
MPD
mpd. FFNotificaCliPed
Metadados
Sim
Sim
A partir da 11.5.8
Nome Verbalizado obrigatrio para desenvolvimentos no Datasul 10 em diante.

Tipo obrigatrio para desenvolvimento no Datasul 10 em diante
3
Categorias so obrigatrias para os programas FLEX.
4
Obrigatrio quando o projeto for FLEX
5
6
7
8
2
Verso 1.0
15
Programas:
Programa
Descrio
Nome Externo
Nome Menu
Nome Verbalizado9
Programa UPC
Procedimento
Template
Tipo10
Interface
Categoria11
Executa via RPC
Registro padro
Outro Produto
Visualiza Menu
Query on-line
Log Exec.
Web Enable
Rotina (EMS)
Sub-Rotina (EMS)
Localizao dentro da Sub Rotina (EMS)
Compact12
Home13
Posio do Portlet14
Informar os papeis com os quais o programa deve ser
vinculado15
Informar o diretrio do mdulo FLEX16
Cadastro Simples Alterao
Tarefas
Flex
Window (Metadados)
No
Sim
No
Sim
No
No
Sim
?
?
0
REP
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.
Nome Verbalizado obrigatrio para desenvolvimentos no Datasul 10 em diante.

Tipo obrigatrio para desenvolvimento no Datasul 10 em diante
11
Categorias so obrigatrias para os programas FLEX.
12
13
14
15
16
10
16
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.
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.
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.
Verso 1.0
17
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
Clientes (emitente)
Direo
Datasul SoftSite
XSD
CustomerVendor_2_001.xsd
Produtos (item)
Familia Comercial
Vendedor (repres)
Datasul SoftSite
Datasul SoftSite
Datasul SoftSite
Item_3_001.xsd
CommercialFamily_1_000.xsd
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
Datasul SoftSite
Order_4_000.xsd
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
TRANSPORTE
TRANSPORTADORA
Transportadoras
TAB-PRECO
TABELA_PRECO
Tabelas de Preos
PRECO-ITEM
FAIXA_ PRECO_PRODUTO
PRECO-ITEM
LISTA_PRODUTO
ITEM
PRODUTO
Produto
18
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:
Verso 1.0
Descrio
Descrio
Clientes
Unidade de Medida
Vendedores
Unidade Converso
Estabelecimento
Meio de Pagamento
Referncias do Item
Transportadoras
Referncia x Item
Tabelas de Preos
Rota
Famlia de Comercial
Produto
19
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
20
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
Verso 1.0
21
Relao entre REFERENCIAS DO ITEM (REFER-ITEM) / PRODUTO_CARACTERISTICA

Nome XSD: ItemReference_1_000.xsd
Nome XSD: PriceListHeaderItem_1_001.xsd
Relao entre PRECO-ITEM e LISTA_PRODUTO + SEQUENCIAL + FAIXA_PRECO_PRODUTO
Relao entre PRECO-ITEM e FAIXA_PRECO_PRODUTO
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
22
Verso 1.0
Origem do Pedido Usuario

Origem do Pedido Mobile.
Campos Obrigatrio do Pedido e seus valores:
Ped Venda
Atributo
cod-estabel
Nome-abrev
nr-pedcli
dt-emissao
dt-implant
dt-entrega
dt-entorig
nat-operacao
Tipo
C
C
C
Date
Date
Date
Date
C
Formato
x(3)
x(12)
x(12)
99/99/9999
99/99/9999
99/99/9999
99/99/9999
x(06)
Descrio
Cdigo do Estabelecimento
Nmero Abreviado do Cliente
Nmero do Pedido do Cliente
Data Emisso Pedido feita pelo representante/cliente
Data em que o Pedido foi implantado no sistema
Data prevista para entrega do Pedido
Data de entrega solicitada pelo cliente
Natureza de operao
Obr.
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
nr-tab-finan
Int
>>9
Nmero da tabela de financiamento
Sim
cod-entrega
cod-portador
C
Int
x(12)
>>>>9
Cdigo do endereo de entrega

Cdigo do portador
Sim
Sim
Modalidade
Int
Modalidade de Cobrana
Sim
cod-mensagem
Int
>>9
Cdigo da mensagem que dever sair na nota fiscal
Sim
cod-des-merc
ind-icm-ret
Nome-transp
tp-preco
ind-fat-par
mo-codigo
cod-rota
ind-lib-nota
nr-ind-finan
no-ab-reppri
ind-antecip
tip-cod-desp
cod-emitente
esp-ped
cd-origem
Origem
log-usa-tabela-desconto
Int
Log
C
Int
Log
Int
C
Log
Int
C
Log
Int
int
int
int
inte
log
99
yes/no
x(12)
99
yes/no
>9
x(12)
yes/no
>9
x(12)
yes/no
99
>>>>>>>>9
99
99
99
Sim/No
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Sim
log-ped-bonif-pendente
log-cotacao
log
log
Sim/No
yes/no
Destino da mercadoria
Informa se haver reteno de ICMS na fonte
Nome do transportador
Tipo de preo
Aceita faturamento parcial?
Cdigo da moeda de referncia dos valores
Rota de atendimento a que este pedido pertence
Libera nota fiscal sem saldo em estoque?
Nmero do ndice de financiamento
Nome abreviado do representante principal
Existe valor antecipado para o pedido?
Tipo de cobrana das despesas
Cdigo do cliente
Espcie do pedido
Origem
Origem do pedido
Usa a tabela de descontos no tratamento deste
pedido?
Gerao do pedido de bonificao est pendente?
Indica se uma cotao
Sim
Sim
esta na Mensagem
Buscar atravs do Cdigo
esta na Mensagem
esta na Mensagem
Data Atual
Data Atual
Data Atual
Buscar a Default do Cliente
Emitente.nat-operacao
Buscar a Default do
condio de pagamento
emitente.portador
emitente.modalidade
Emitente. cod-mensagem
Esta na Mensagem
informado
No
??
Esta na mensagem
No
Esta na mensagem
Esta na mensagem
Usuario
SoftSite
SIM
Nao
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
Verso 1.0
23
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.
24
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 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.
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.
Verso 1.0
25
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.
Produtos Componentes: No sero Integradas as informaes de relacionamento dos itens a um

produto Pai, Bundle ou kit.
26
Verso 1.0
Exemplo: Lanche nmero 1 do Bobs.
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.
Produtos Equivalentes: No sero integradas as informaes dos produtos considerados
equivalentes ao selecionado (sempre que um produto obtiver caractersticas similares a outros).
Produtos Obrigatrios: No sero integradas as informaes dos produtos obrigatrios e suas

informaes.
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.
Produtos Up Selling: No sero integradas as informaes dos produtos como sugestes de

compra de produtos superiores a ele.
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.
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: 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.
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.
Tabela de Preo por campanha.
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.
Verso 1.0
27
12
Como fazer
Passos para viabilizar a integrao:

No ERP da Datasul, efetue os cadastros das seguintes informaes:
Descrio
Descrio
Clientes
Unidade de Medida
Vendedores
Unidade Converso
Estabelecimento
Meio de Pagamento
Referncias do Item
Transportadoras
Referncia x Item
Tabelas de Preos
Rota
Famlia de Comercial
Produto
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.
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.
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.
13
Atualizar as informaes de cadastros e parametrizaes.
Atualizar as informaes dos Pedidos de Venda recalculados pelo Datasul.
Situaes comuns
No existem informaes pertinentes as situaes comuns.
28
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.
Verso 1.0
29

Integracao Softsite X Datasul11

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Integracao Softsite X Datasul11

Enviado por

Direitos autorais:

Formatos disponíveis

Integrao Backoffice x Datasul/Pedido Venda

Integrao Backoffice x Datasul/Pedido Venda

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

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

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

Arquivo de Usurios WebService.....................................................................................................................13

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

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

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

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

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

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

Integrao Backoffice x Datasul/Pedido Venda

Contexto de negcio (Introduo)

Integrao Backoffice x Datasul/Pedido Venda

Itens Pedidos de Venda

Ttulos a Receber Financeiro

Itens da Tabela de Preos

Itens da Tabela de Preos

Separao Cliente x Estab.

Famlia de Comercial de Produto

Integrao Backoffice x Datasul/Pedido Venda

Integrao Backoffice x Datasul/Pedido Venda

Integrao Backoffice x Datasul/Pedido Venda

Itens da Tabela de Preos

Integrao Backoffice x Datasul/Pedido Venda

Integrao Backoffice x Datasul/Pedido Venda

EAI2: Instalado e configurado.

Distncia em KM usado para sequencia

Relao entre TAB-PRECO e TABELA_PRECO / TABELA_PRECO_APLICACAO

Relao entre PRECO-ITEM e FAIXA_PRECO_PRODUTO

Integrao Backoffice x Datasul/Pedido Venda

Relao entre MOVTO-ESTOQ / saldo-estoq e ESTOQUE + PRODUTO_ESTOQUE

Relao entre COND-PAGTO e CONDICAO_PAGAMENTO

Relao entre EMITENTE e FORNECEDOR

Relao entre ESTABELEC E ORGANIZACAO_VENDA

Integrao Backoffice x Datasul/Pedido Venda

Relao entre EMITENTE e CLIENTE

Relao entre REPRES e VENDEDOR / TUSUARIO

Relao entre rota e rota

Relao entre Referencias do Item (refer-item) / produto_caracteristica

Relao entre Pedido de Venda

Integrao Backoffice x Datasul/Pedido Venda

2. Os Pedidos devem entrar como:

No existem informaes pertinentes ao Logix.

No existem informaes pertinentes ao Protheus.

No existem informaes pertinentes a RM.

Integrao Backoffice x Datasul/Pedido Venda

6.1.1. Arquivo de Usurios WebService

6.1.2. Arquivo de Permisses WebService

Integrao Backoffice x Datasul/Pedido Venda

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

Tabela de Preos (tab-preco / preo-item)

Converso Unidade de Medida

Referncias dos Item

Pedidos / Itens de Pedidos (ped-venda / ped-item)

Pedidos / Itens de Pedidos (ped-venda / ped-item)

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

Integrao Backoffice x Datasul/Pedido Venda

Nome Verbalizado obrigatrio para desenvolvimentos no Datasul 10 em diante.

Integrao Backoffice x Datasul/Pedido Venda

6.1.6. Cadastro de Papis