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, elas estarão disponíveis a partir do release 12.1.8.
Pré-requisitos instalação/implantação/utilização
Cockpit Logístico na versão\release 5.6.1.
Parâmetros de aquisição ativos (acesso pelo menu em Administração - Integração).
Web Services ativos.
Datasul
Versão\release 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-se no programa Parâmetros de Integração Cockpit Logístico (CD0090) que pode ser acessado pelo menu 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 das mensagens de integração 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 Cockpit Logístico (Neolog) e Backoffice Datasul (Vendas e CRM) estarão aptas a fazer a primeira análise e quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Esse 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, a 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 na integração e são efetuadas sempre que ocorrerem, mesmo que apenas campos que não são integrados sejam alterados no Datasul. 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 considerá-la como restrição de eliminação dos registros no Datasul.
O sucesso das operações de inclusão e alteração de registros pode ser verificado acessando o programa de consulta no menu do Cockpit Logístico em: Interface - Log. O sistema de origem dos dados não recebe o status do processamento dos registros enviados, por isso considera integrado com base apenas 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 do Datasul em: Logística - Embarques - Cadastros.
As falhas de comunicação entre os sistemas e o registro das integração que não obtiveram sucesso na transmissão dos dados de cadastros poderão ser consultados pelo programa Parâmetros de Integração Cockpit Logístico (CD0090) que dá acesso aos programas CD0082 (Histórico de Falhas de Conexão) 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 no 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 (no menu do Cockpit Logístico em: Administração - Integração):
- Aquisição ligada
- Atualização permite inserir
- Aquisição ativa para localidades
Lista de programas relacionados aos Locais de Entrega de Cliente do Datasul que integram com o Cockpit Logístico:
CÓDIGO PROGRAMA | DESCRIÇÃO | LOCALIZAÇÃ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 acarretam alteração de dados dos Locais de Entrega |
| CD0401 | Manutenção Fornecedores | Cadastros Gerais - Cadastros | Inclusão e Alteração de Fornecedores que sejam Clientes e acarretam alteração de dados dos Locais de Entrega |
| CD1302 | Tarefas Importação Cliente/Fornecedor | Cadastros Gerais - Tarefas | Inclusão e Alteração de Clientes que acarretam 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 acarretam alteração de dados dos Locais de Entrega |
Correspondência entre os campos:
CAMPO COCKPIT LOGÍSTICO | CAMPO DATASUL | OBSERVAÇÕES |
|---|---|---|
| Regional | Código da regional informado nos Parâmetros de Integração - CD0090 | |
| Local Destino | Código do Cliente do Local de Entrega + "|Padrão" | |
| Nome | Nome Abreviado do Cliente do Local de Entrega + "|" + Código do Local de Entrega | |
| Tipo | 1 - Ambos ou 2 - Destino | 1 (Ambos) quando houver um estabelecimento cadastrado com o mesmo CNPJ do cliente/local de entrega |
| Código | Código do Cliente do Local de Entrega + "|" + Código do Local de Entrega | |
| Descrição | Nome do Cliente do Local de Entrega + "|" + Código do Local de Entrega | |
| CEP | CEP | |
| Endereço | Endereço | |
| UF | Estado | |
| Nº | Número contido no Endereço | Número obtido pelo mesmo critério usado nas rotinas de impressão de DANFE |
| Bairro | Bairro | |
| País | BR | |
| Cidade | Cidade |
TRANSPORTADORES
Para que a integração do cadastro de Transportadores seja realizada é obrigatório marcar os seguintes parâmetros (no menu do Cockpit Logístico em: Administração - Integração):
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:
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 relacionados aos Transportadores do Datasul que integram com o Cockpit Logístico:
CÓDIGO PROGRAMA | DESCRIÇÃO | LOCALIZAÇÃ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 |
|---|---|---|
| Regional | Código da regional informado nos Parâmetros de Integração - CD0090 | |
| Nome | Nome | |
| Código | Código | |
| Descrição | Nome abreviado |
ITENS
Lista de programas relacionados aos Itens do Datasul que integram com o Cockpit Logístico:
CÓDIGO PROGRAMA | DESCRIÇÃO | LOCALIZAÇÃO NO MENU | OPERAÇÕES INTEGRADAS |
|---|---|---|---|
CD0204 | Manutenção Cadastros Gerais Item | Cadastros Gerais - Cadastros | Inclusão e Alteração de Itens |
| CD0903 | Manutenção Informações Itens Item Faturamento | Cadastros Gerais - Cadastros | Alteração de Itens |
| CD0205 | Item Cadastros Alteração Código/Unidade Medida | Cadastros Gerais - Cadastros | Inclusão de Itens |
| CD0209 | Importação Itens | Cadastros Gerais - Tarefas | Inclusão e Alteração de Itens |
| BOIN172 | Business Object da tabela Item | Não é executado pelo menu. | Inclusão e Alteração de Itens |
Correspondência entre os campos:
TAG | CAMPO | OBSERVAÇÃO |
|---|---|---|
| Regional | Código da regional informado nos Parâmetros de Integração - CD0090 | |
| Embarcador | Embarcador padrão informado nos Parâmetros de Integração - CD0090 | |
| Código | Código | |
| Descrição | Descrição | |
| Altura | Altura | Multiplicar pelo fator de conversão de dimensões dos Parâmetros de Integração (CD0090) quando o fator for diferente de 0 (zero) 0,001 quando Altura igual a 0 (zero) |
| Comprimento | Comprimento | Multiplicar pelo fator de conversão de dimensões dos Parâmetros de Integração (CD0090) quando o fator for diferente de 0 (zero) 0,001 quando Comprimento igual a 0 (zero) |
| Largura | Largura | Multiplicar pelo fator de conversão de dimensões dos Parâmetros de Integração (CD0090) quando o fator for diferente de 0 (zero) 0,001 quando Largura igual a 0 (zero) |
| Peso | Peso Bruto | Multiplicar pelo fator de conversão de peso dos Parâmetros de Integração (CD0090) quando o fator for diferente de 0 (zero) 0,001 quando Peso Bruto igual a 0 (zero) |
| Forma | 0 - Caixa ou 2 - Cilindro ou 3 - Indefinido | 0 (caixa) quando Altura, Comprimento e Largura maiores que 0 (zero) |
| compositeQuantity | Quantidade composta | Em desuso |
Para que a integração do cadastro de Produtos seja realizada é obrigatório marcar os seguintes parâmetros (no menu do Cockpit Logístico em: Administração - Integração):
- Aquisição ligada
- Atualização permite inserir
- Aquisição ativa para produtos
Além disso é necessário cadastrar Produtos defaults no Cockpit Logístico e informá-los como Veículo Piso, Padrão e Teto na configuração de Entidades Padrões para cada formato (caixa, cilindro, etc.). No cadastro do Produto padrão devem ser informados todos os dados que são obrigatórios na operação de inclusão:
- Categoria de Produto
Sugere-se no cadastro dos Produtos que serão utilizados como "piso" informar o menor valor possível para peso, altura, largura e comprimento; e no cadastro dos Produtos que serão utilizados como "teto" informar o maior valor possível para peso, altura, largura e comprimento. è necessário haver um Produto piso exclusivo para cilindro, pois nesse formato a altura deve ser igual a zero.
TIPOS DE CARGA
Lista de programas relacionados aos Tipos de Carga (também chamados de Tipos de Embarque) do Datasul que integram com o Cockpit Logístico:
CÓDIGO PROGRAMA | DESCRIÇÃO | LOCALIZAÇÃO NO MENU | OPERAÇÕES INTEGRADAS |
|---|---|---|---|
FT0307 | Manutenção Informações Itens Tipo Carga | Logística - Embarques - Cadastros | Inclusão e Alteração de Tipos de Carga |
Correspondência entre os campos:
TAG | CAMPO | OBSERVAÇÃO |
|---|---|---|
| Regional | Código da regional informado nos Parâmetros de Integração - CD0090 | O código da regional é informado nos Parâmetros de Integração - CD0090. |
| Nome | Descrição | |
| Código | Código | |
| Descrição | Descrição |
Para que a integração do cadastro de Veículos seja realizada é obrigatório marcar os seguintes parâmetros (no menu do Cockpit Logístico em: Administração - Integração):
- Aquisição ligada
- Atualização permite inserir
- Aquisição ativa para veículos
Além disso é necessário cadastrar um Veículo default no Cockpit Logístico e informá-lo como Veículo 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:
- Similaridade (Veículo similar)
- Prioridade
- Baú
- Modal
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.