Histórico da Página
Objetivo
A integração entre o BackOffice Datasul e a Plataforma de Força de Vendas MasterSales tem como objetivo realizar a comunicação entre a implantação de pedidos efetuados no MasterSales com o Datasul.
Sistemas Envolvidos
Linha MasterSales:
- Especializado em gestão comercial e gestão de clientes, integrando equipes internas e externas, oferecendo uma visão 360º do cliente, desde a geração de demanda até o pós venda.
Linha Datasul:
- Sistema de BackOffice para gestão de empresas com ênfase no segmento de Manufatura. Disponibiliza módulos de gestão e controle da distribuição com foco nos requisitos comerciais, fiscais e tributários, entre eles: Pedidos de Venda, Faturamento e Embarques.
Integração
A integração entre Datasul x MasterSales disponibiliza para os clientes mais uma forma de inserção de Pedido de Vendas no BackOffice através dos representantes em campo, trazendo uma opção a mais para que o cliente possa escolher o que melhor se adequar a sua rotina.
Para que seja possível atender essa demanda e possibilitar uma nova oferta de mercado TOTVS, por meio desta integração será possível a utilização da solução MasterSales integrado com o módulo de Pedido de Vendas do BackOffice da linha Datasul.
- Premissas:
- Possibilitar a integração de cadastros principais como: Estabelecimento, Empresa, Cidade, Família Comercial, Endereço de Entrega, Itens, Condição de Pagamento, Tabela de Preço, Canal de Venda, Unidade de Medida, Estoque do Item, Cliente/Fornecedor, Representantes, Títulos do Contas a Receber e Notas Fiscais.
- Integrar a solução MasterSales com o módulo de Pedido de Vendas do BackOffice Datasul.
- Arquitetura (Tecnologia):
- A integração ocorrerá utilizando o EAI - Enterprise Application Integration com o padrão de Mensagem Única.
- O Tipo de Canal de comunicação no EAI deve ser do tipo REST.
Escopo
Possibilitar a integração de cadastros principais do Datasul para o MasterSales.
Possibilitar para que todo o pedido que será criado no MasterSales e enviado que os pedidos criados no MasterSales, sejam enviados para o BackOffice Datasul seja e devidamente cadastradocadastrados, calculado calculados e devolvido devolvidos ao MasterSales com os todos os resultados dos cálculos e/ou validações padrões que foram feitas.
Pré-requisitos instalação/implantação/utilização
Datasul
Os requisitos para a utilização da integração entre Datasul e MasterSales são:
- Versão/Release: 12.1.24;
- Deve ser usado e configurado a Sugestão Automática da Natureza de Operação;
- Ter o EAI previamente configurado com as rotas ativas de cada mensagem que será transitada e ativo nos Parâmetros Gerais do Datasul (CD0101);
Recomendado a instalação do Progress 11.7, ou então substituir as bibliotecas do Progress 11.6 pelas do 11.7. São duas: DLC\gui\OpenEdge.Core.pl e DLC\gui\netlib\OpenEdge.Net.pl.
Instalação/Atualização
Quando houver a atualização de alguns dos sistemas deve estar atento as versões das Mensagens Únicas. As mensagens e versões homologadas entre as partes está descrita no tópico: Transações/Entidades/Mensagens Únicas.
Controle de Versão
O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
Suporte
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão Datasul e MasterSales estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
Transações/Entidades/Mensagens únicas
Datasul para MasterSales
Método | ID | Descrição | Origem | Destino | XSD |
Cadastros | 01 | Estabelecimento | Datasul | MasterSales | Branch_2_001.xsd |
02 | Cidade | Datasul | MasterSales | City_2_000.xsd | |
03 | Família Comercial | Datasul | MasterSales | CommercialFamily_1_000.xsd | |
04 | Empresa | Datasul | MasterSales | Company_2_002.xsd | |
05 | Endereço de Entrega | Datasul | MasterSales | CustomerShippingAddress_1_002.xsd | |
06 | Notas Fiscais | Datasul | MasterSales | Invoice_3_013.xsd | |
07 | Condição de Pagamento | Datasul | MasterSales | PaymentCondition_2_001.xsd | |
08 | Tabela de Preço | Datasul | MasterSales | PriceListHeaderItem_2_002.xsd | |
09 | Canal de Venda | Datasul | MasterSales | SalesChannel_2_000.xsd | |
10 | Estoque do Item | Datasul | MasterSales | StockTurnover_1_005.xsd | |
11 | Unidade de Medida | Datasul | MasterSales | UnitOfMeasure_2_000.xsd | |
12 | Cliente/Fornecedor | Datasul | MasterSales | CustomerVendor_2_006.xsd | |
13 | Representante | Datasul | MasterSales | Seller_3_000.xsd | |
14 | Títulos do Contas a Receber | Datasul | MasterSales | AccountReceivableDocument_2_008.xsd | |
Processos | 15 | Pedido de Vendas | Datasul | MasterSales | Order_4_007.xsd |
MasterSales para Datasul
Método | ID | Descrição | Origem | Destino | XSD |
Cadastros | 01 | Cliente/Fornecedor | MasterSales | Datasul | CustomerVendor_2_006.xsd |
02 | Representante | MasterSales | Datasul | Seller_3_000.xsd | |
Processos | 15 | Pedido de Vendas | MasterSales | Datasul | Order_4_007.xsd |
Fluxo das Informações
Cadastros
Cada cadastro destacado no tópico Transações/Entidades/Mensagens Únicas, quando inserido um novo registro no Datasul, será disparada a mensagem correspondente (no EAI) para que o mesmo registro seja devidamente cadastrado no lado do MasterSales.
Existe um programa responsável por executar uma carga de todos os cadastros que serão usados na integração. Para saber mais como usar esse programa clique aqui.
Os únicos cadastros que serão recebidos pelo Datasul serão: Cliente/Fornecedor e Representante. Os demais cadastros serão inseridos somente no Datasul e enviados para o MasterSales.
As mensagens de cadastros que serão transitadas via EAI serão todas no modo assíncrono.
A imagem a seguir demonstra como será a comunicação e o envio dos cadastros para o MasterSales:
Notas:
Os códigos "chaves" de cada entidade, não serão os mesmos nos dois sistemas, para isso o EAI usará o de/para das chaves pra identificar cada registro.
Processos
Transação/Processo
Tipo de Fluxo: MasterSales -> Datasul
Mensagem: Order_4_007
Versão: 4.007
O processo principal da integração é a inserção de Pedidos de Vendas do MasterSales para o Datasul. Essa ferramenta será usada principalmente pelos representantes, que irão visitar seus clientes e cadastrar os pedidos na hora da visita e assim enviá-los ao Datasul que será o responsável por todo o cálculo de imposto e controle de estoque.
O fluxo do processo acontecerá da seguinte maneira:
O OrderAdapter é o responsável por ler todo o XML que é enviado na mensagem e criar as tabela temporárias que terão os dados para a criação do Pedido.
A PDAPI517 é a responsável por fazer as validações iniciais, como campos com informações incorretas, e posteriormente chamar a PDAPI500 que é responsável por criar o pedido e chamar todas as BO's de validação e cálculos do pedido.
Quando o processo é executado sem nenhum erro, o Datasul responde a mensagem de Order recebida pelo MasterSales, com o número do pedido criado, e depois ele envia uma nova mensagem de Order com os mesmos dados do pedido só que com todos os cálculos aplicados, para que os valores do pedido no MasterSales fiquem corretos.
Se no processo ocorrer alguma validação de negócio, o Datasul responderá a mensagem de Order com o código e a descrição do erro ocorrido, e não enviará a nova mensagem de Order com o pedido calculado, pois o mesmo não foi criado.
Notas:
Para essa integração é obrigatório a utilização da Sugestão Automática da Natureza de Operação. O tipo de operação é o que determina qual a natureza será usada (de acordo com o que foi parametrizado), e esse cadastro não possui integração entre os produtos, então ele deve ser cadastrado tando no Datasul (CD0640) quanto no MasterSales, com o mesmo código.
Limitações / Restrições Gerais
Tabela de preço:
- Serão enviadas para o MasterSales somente as tabelas de preço com a data de validade vigente.
- Para os itens da tabela se aplica o mesmo.
Itens:
- Serão enviados somente itens faturáveis.