Páginas filhas
  • DI_Integração_Datasul_X_Cockpit_Logístico

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

INTEGRAÇÃO DATASUL X COCKPIT LOGÍSTICO

A integração entre o ERP Datasul e o Cockpit Logístico tem como objetivo automatizar e otimizar a programação e a roteirização das entregas de mercadorias e materiais. 

Sistemas Envolvidos

Cockpit Logístico

Sistema vertical desenvolvido pela Neolog, empresa do ecossistema TOTVS, que dispõe de módulos para Planejamento da Malha de Distribuição, Programação de Transportes e Monitoramento de Cargas. A Programação de Transportes gera a roteirização e o arranjo das cargas, com base na demanda de transportes enviada pelo ERP, considerando as configurações das restrições logísticas e as funções-objetivos da otimização; São exemplos de funções-objetivo: máximo aproveitamento e máxima ocupação dos veículos, diminuição da quantidade de viagens e diminuição da despesa de frete total. 

ERP 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 é realizada por intermédio de arquivo XML, utilizando os Web Services disponibilizados pelo Cockpit Logístico, sem transformação de mensagens e sem utilização de sistemas intermediários (TOTVS EAI, TOTVS ESB, etc.).

Escopo (Cadastros)

Possibilitar a integração dos Cadastros de Transportadores, Locais de Entrega, Itens e Tipos de Carga do Datasul para o Cockpit Logístico da Neolog. 

As integrações dos processos completam a integração entre os sistemas, mas estarão disponíveis a partir da versão 12.1.8.

Pré-requisitos instalação/implantação/utilização

Cockpit Logístico na versão 5.6.1.
Parâmetros de aquisição ativos (acesso pelo menu em Administração - Integração).
Web Services ativos.

Datasul

Versão 12.1.7.
Parâmetro de integração via Web Service ativo.
Parâmetros de  integração com Cockpit Logístico ativo.
Parâmetros de integração de cada cadastro ativo.

Todos os parâmetros citados encontram no programa Parâmetros de Integração Cockpit Logístico (CD0090) que pode ser acessado pelo menu em Logística -> Embarques -> Cadastros.

Logix

Não se aplica.

Protheus

Não se aplica.

RM

 Não se aplica.

Instalação/Atualização

 Vide tópico Pré-requisitos instalação/implantação/utilização.

Datasul

 Vide tópico Pré-requisitos instalação/implantação/utilização.

Logix

Não se aplica.

Protheus

Não se aplica.

RM

Não se aplica.

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 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 

Método

ID

Descrição

Origem

Destino

Web Service

Cadastros

01

Locais de Entrega

Datasul

Protheus

LocalityAcquisitionService

02

Transportadores

Datasul

Protheus

CarrierAcquisitionService

03

Itens

Datasul

Protheus

ProductAcquisitionService

04

Tipos de Carga

Datasul

Protheus

VehicleAcquisitionService

Fluxo das Informações

Os cadastros devem ser realizados no Datasul e integrados para o Cockpit Logístico; ativação da integração, no entanto, não impede a inclusão, alteração e exclusão de registros no Cockpit Logístico, mas esse procedimento não é recomendado pois as operações realizadas sobre os cadastros no Cockpit Logísticas não são replicadas para os respectivos cadastros no Datasul.

Apenas as operações de inclusão e alteração são consideradas para integração e são efetuadas sempre que ocorrerem, mesmo que apenas campos que não são integrados sejam alterados. A operação de eliminação sobre os registros de cadastros não é integrada pois não é possível verificar a integridade referencial no sistema de destino para considera-la como restrição da eliminação dos registros no Datasul.

O sucesso das operações de inclusão e alteração de registros podem ser verificados no Cockpit Logístico pelo menu em: Interface - Log. O sistema de origem dos dados não recebe o status do processamento dos registros enviados, por isso considera integrado apenas com base na confirmação de recepção da mensagem de integração.

Os cadastros possuem um programa (CD9190 - Integração Batch Cockpit Logístico) que possibilita a carga/atualização dos registros em lote, ele pode ser acessado pelo menu em Logística - Embarques - Cadastros.

As falhas de comunicação entre os sistemas para integração dos cadastros e registro das integração que não obtiveram sucesso na transmissão dos dados poderão ser consultados pelo programa Parâmetros de Integração Cockpit Logístico (CD0090) que dá acesso aos programas CD0082 e CD0092 (Reprocessar Integração Cockpit Logístico ), responsáveis por listar essas informações, respectivamente. O programa CD0092 (no menu em Logística - Embarques - Cadastros ) também possibilita o reenvio dos registros com falha de transmissão, manualmente ou por intermédio de agendamento RPW (CD0092RP).  

Para as ocorrências de falha de comunicação também é possível configurar o envio de aviso eletrônico por intermédio de parâmetros disponíveis no programa CD0090.

Nas ocasiões em que o sistema destino precisar ficar indisponível para integração é possível informar ao Datasul que a integração está temporariamente suspensa (CD0090) evitando perda de desempenho com tentativas de transmissão de dados sem sucesso. Nesse caso os registros incluídos ou alterados serão registrados como pendentes de envio na lista de falhas de integração e poderão ser reenviados pelo programa CD0092.

Cadastros

A seguir o diagrama de fluxo de informações relacionando os cadastros integrados entre Datasul e Cockpit Logístico. Após o diagrama serão descritos os detalhes da integração de cada cadastro.

 

LOCAIS DE ENTREGA DE CLIENTES

Para que a integração do cadastro de Localidades seja realizada é obrigatório marcar os seguintes parâmetros (menu Administração/Integração) do Cockpit Logístico:

  • Aquisição ligada
  • Atualização permite inserir
  • Aquisição ativa para localidades

 Lista de programas que integram com o Cockpit Logístico:

CÓDIGO PROGRAMA

DESCRIÇÃOLOCALIZAÇÃO NO MENU OPERAÇÕES INTEGRADAS

CD0705

  Manutenção Embarque Vendas Endereço Entrega

Cadastros Gerais - Cadastros 

 Inclusão e Alteração de Locais de Entrega
CD0704 Manutenção Clientes 

Cadastros Gerais - Cadastros

Inclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega
CD0401  Manutenção Fornecedores Cadastros Gerais - CadastrosInclusão e Alteração de Fornecedores que sejam Clientes e acarretem em alteração de dados dos Locais de Entrega 
CD1302 Tarefas Importação Cliente/Fornecedor Cadastros Gerais - TarefasInclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega 
CDAPI366 API Manutenção Cliente/Fornecedor Não é executado pelo menu. Inclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega 

Correspondência entre os campos:

 
TAG
CAMPO
OBSERVAÇÕES
regionSourceIdSUBSTRING(tab-generica.char-2,167,30) do registro único da tabela tab-generica  no qual tab-generica.utilizacao = "SETNLOG"O código da regional é informado nos Parâmetros de Integração - CD0090.
preferredDestinationLocalitySourceIdb-emitente.cod-emitente + "|Padrão"b-emitente no qual b-emitente.nome-abrev = emitente.nome-tr-red para o emitente no qual emitente.nome-abrev = loc-entr.nome-abrev
nameloc-entr.nome-abrev + " - " + loc-entr.cod-entrega 
logisticRoleId1 
identifieremitente.cod-emitente + "|" + loc-entr.cod-entregaemitente no qual emitente.nome-abrev = loc-entr.nome-abrev
descriptionemitente.nome-emit + " - " + loc-entr.cod-entregaemitente no qual emitente.nome-abrev = loc-entr.nome-abrev
adressZipCodeloc-entr.cep 
adressStreetloc-entr.endereco 
adressStateAcronymloc-entr.estado 
adressNumbernúmero do endereço contigo em loc-entr.enderecoexecutar a procedure pi-trata-endereco da cdapi704 para obter o número do endereço (loc-entr.endereco)
adressDistrictloc-entr.bairro 
adressCountryAcronymBR  
adressCityloc-entr.cidade 

TRANSPORTADORES

Para que a integração do cadastro de Transportadores seja realizada é obrigatório marcar os seguintes parâmetros (menu Administração/Integração) do Cockpit Logístico:
    Aquisição ligada
    Atualização permite inserir
    Aquisição ativa para transportadora

Além disso é necessário cadastrar um Transportador default no Cockpit Logístico e informá-lo como Transportador Piso, Padrão e Teto na configuração de Entidades Padrões. No cadastro do Transportador default devem ser informados todos os dados que são obrigatórios na operação de inclusão, entre eles aqueles que não são disponibilizados no XML de integração:
    Calculador de Tipo de Serviço
    Agrupador
    Máxima Distância de Dead-head
    Máxima Distância Total de Dead-head
    Horizonte de Abertura
    Calculador de Frete para Viagem
    Justificativa de Auto-rejeite

Lista de programas que integram com o Cockpit Logístico:

CÓDIGO PROGRAMA

DESCRIÇÃOLOCALIZAÇÃO NO MENU OPERAÇÕES INTEGRADAS

CD0402

Manutenção Cadastro Cotações Transportador

Logística / Embarques / Cadastros

 Inclusão e Alteração de Transportadores

 Correspondência entre os campos:

CAMPO COCKPIT LOGÍSTICO
CAMPO DATASUL
OBSERVAÇÃO
RegionalCódigo da regional informado nos Parâmetros de Integração - CD0090 
Nometransporte.nome 
Códigotransporte.cod-transp 
E-mail transporte.e-mail  
Descriçãotransporte.nome-abrev 

ITENS

CÓDIGO PROGRAMA

DESCRIÇÃOLOCALIZAÇÃO NO MENU OPERAÇÕES INTEGRADAS

CD0705

 Manutenção Embarque Vendas Endereço Entrega

Cadastros Gerais - Cadastros

 Inclusão e Alteração de Locais de Entrega
CD0704 Manutenção Clientes 

Cadastros Gerais - Cadastros

Inclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega
CD0401  Manutenção Fornecedores Cadastros Gerais - CadastrosInclusão e Alteração de Fornecedores que sejam Clientes e acarretem em alteração de dados dos Locais de Entrega 
CD1302 Tarefas Importação Cliente/Fornecedor Cadastros Gerais - TarefasInclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega 
CDAPI366 API Manutenção Cliente/Fornecedor Não é executado pelo menu. Inclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega 

TIPOS DE CARGA 

 

CÓDIGO PROGRAMA

DESCRIÇÃOLOCALIZAÇÃO NO MENU OPERAÇÕES INTEGRADAS

CD0705

 Manutenção Embarque Vendas Endereço Entrega

Cadastros Gerais - Cadastros

 Inclusão e Alteração de Locais de Entrega
CD0704 Manutenção Clientes 

Cadastros Gerais - Cadastros

Inclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega
CD0401  Manutenção Fornecedores Cadastros Gerais - CadastrosInclusão e Alteração de Fornecedores que sejam Clientes e acarretem em alteração de dados dos Locais de Entrega 
CD1302 Tarefas Importação Cliente/Fornecedor Cadastros Gerais - TarefasInclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega 
CDAPI366 API Manutenção Cliente/Fornecedor Não é executado pelo menu. Inclusão e Alteração de Clientes que acarretem em alteração de dados dos Locais de Entrega 

Processos

Vide tópico fluxo de informações.

Limitações/Restrições

Vide tópico fluxo de informações.

Limitações / Restrições Gerais

Não se aplica.

Como fazer

Não se aplica. 

Situações comuns (opcional)

Não se aplica.

Checklist de suporte da aplicação

Não se aplica.

Instalação/Configuração

Não se aplica. 

Checklist de Verificações:

Não se aplica.

Anexos

Não há anexos.