Histórico da Página
INTEGRAÇÃO DATASUL X
NTEGRAÇÃ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
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 ( a partir do release 12.1.7)
Possibilitar as integrações dos processos de envio de pedidos de venda, através das simulações ou embarques-remessa ao Cockpit e gerar os embarques no Datasul com o resultado as viagens planejadas no Cockpit (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/12.1.8
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.
(ver configuração JBOSS para instalação dos serviços de recepção das informações do Cockpit)
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 | Neolog | LocalityAcquisitionService |
02 | Transportadores | Datasul | Neolog | CarrierAcquisitionService | |
03 | Itens | Datasul | Neolog | ProductAcquisitionService | |
04 | Tipos de Carga | Datasul | Neolog | VehicleAcquisitionService | |
| Processos | 05 | Envio de Pedidos | Datasul | Neolog | OrderAquisitionService |
| 06 | Liberação da Viagem | Neolog | Datasul | ReleasedTripPublishRequestService | |
| 07 | Desbloqueio da Viagem | Datasul | Neolog | UnblockReleasedTripAcquisitionService | |
| 08 | Reprogramação e cancelamento da Viagem | Neolog | Datasul | PublishReprogramingService |
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ístico 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
A Solução de Programação da Neolog automatiza a inteligência logística da empresa. É ela a responsável por receber as demandas de transporte, olhar todas as possibilidades da malha logística da empresa e encontrar a melhor e mais rentável opção para entrega de todos os pedidos.
•A geração do pedido de transporte deve ser um numero único na base do Neolog.
•Somente deverá ser gerado um pedido de transporte que tenha quantidade para ser atendido. Para não otimizar o que não se tem para atender.
•Enquanto esta sendo feito o processo no Neolog, o processo no ERP deve estar bloqueado.
•Deverá haver um processo de contingencia, para a liberação do processo, caso falhe o retorno do Neolog.
•A opção de junta pedido, somente deverá ocorrer quando for retornado do Neolog com a otimização realizada.
•As quantidades que não puderem ser embarcadas no Neolog, serão consideradas como quebras e a chave única devera ser equalizadas pelo ERP.
•Fazer correspondência da viagem X embarque. Ex. Faturar uma viagem.
Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.
Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos
Processo de integração das transações de envio de pedidos, liberação de viagens e desbloqueio de viagens:
Fluxos de processos que contemplam a solução de integração:
1) Envio de pedidos de venda
Tipo de Fluxo: Datasul -> Cockpit-Neolog
Mensagem: OrderAquisitionService
Versão: 1.000
O envio de pedido de venda poderá ocorrer através das simulações (sem empenho do estoque) ou através dos embarques (com empenho do estoque), deverá ser parametrizado no programa de configuração da integração (cd0090) se o envio dos pedidos será a partir do programa de geração de simulações (eq0503) ou se será a partir da preparação de embarque (eq0506).
Quando a configuração é feita para ser realizada pela simulação, ao clicar no check verde da simulação, apos a escolha dos pedidos, é realizado o envio dos pedidos da simulação para o Neolog.
Quando a configuração é feita para ser realizada pelo embarque, ao clicar no check verde do embarque, apos a escolha dos pedidos, é realizado o envio dos pedidos do embarque para o Neolog. Também será realizado o envio dos pedidos do embarque pela rotina de geração batch de embarques. Estes embarques são chamados de embarque-remessa, e não poderão ser enviado ao WMS, nem faturados, pois servirão apenas para envio dos pedidos ao Neolog com a reserva do estoque.
Todos os pedidos escolhidos em uma simulação ou embarque-remessa, terão seu numero de controle no Neolog formado pela composição da chave : numero do pedido (nr-pedido) + nr simulação ou numero do embarque.
Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.
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 |
|---|---|---|---|
EQ0503 | Simulação de Embarque | Logística - Embarques - Tarefas | Inclusão e Alteração de Simulações |
| EQ0506 | Preparação do Faturamento | Logística - Embarques - Tarefas | Inclusão e Alteração de Embarques |
EQ0505 | Preparação automática | Logística - Embarques - Tarefas | Inclusão de Embarques |
Quando o parâmetro da integração estiver marcado para envio dos pedidos pela rotina de pre-faturamento, o embarque,assumirá as seguintes situações:
Um embarque que for enviado para ser otimizado pela integração com o Neolog não poderá ser faturado ou alterado enquanto estiver no Neolog.
Quando o embarque for enviado para a Neolog, a situação do embarque é alterada para que possa haver um controle no Datasul, não permitindo alterar um embarque enquanto não seja retornado.
int-2 = 0 - Não Otimiza - no momento da geração do embarque, se o tipo de embarque/carga nao estiver marcando, não serão enviados os pedidos do embarque para o Cockpit Logístico.
Int-2 = 1 - Envio OK - O sistema realizou o envio da mensagem para o Neolog sem erros no envio.(estrutura)
int-2 = 2 - Erro Envio - deveria integrar (função parametrizada e tipo de carga para integrar com Neolog ) mas ocorreu algum erro na hora de envio para o Neolog. Ex: Erro chamada ao web service.
Int-2 = 3 - Em Otimização - Quando o embarque esta em alguma otimização no Neolog (parâmetro previsto, mas não atualizado pelo CPL).
Int-2 = 4 - Desbloqueado – usuário desbloqueou manualmente o embarque, para alterá-lo ou fatura-lo sem aguardar a viagem do Cockpit Logístico.
Quando o parâmetro da integração estiver marcado para envio dos pedidos pela simulação de embarque, as simulações assumirão as seguintes situações:
int-2 = 0 - Não Otimiza - no momento da geração da simulação, se o tipo de embarque/carga não estiver marcando, não serão enviados os pedidos da simulação para o Cockpit Logístico.
Int-2 = 1 - Envio OK - O sistema realizou o envio da mensagem para o Neolog sem erros no envio.(estrutura)
int-2 = 2 - Erro Envio - deveria integrar (função parametrizada e tipo de carga para integrar com Neolog ) mas ocorreu algum erro na hora de envio para o Neolog. Ex: Erro chamada ao web service.
Int-2 = 3 - Em Otimização - Quando a simulação esta em alguma otimização no Neolog.(parâmetro previsto, mas não atualizado pelo CPL).
Int-2 = 4 - Desbloqueado – usuário desbloqueou manualmente poderá ser alterado a simulação ou gerado o embarque manualmente.
A mensagem de envio de pedidos de venda ao Cockpit Logístico é composta pelos seguintes campos:
| campo | Descrição | Campo Datasul |
| regionSourceId | Identificador da regional; | A regional é definida no Parâmetros da integração (cd0090). Campo Regional. |
| identifier (order) | ID do pedido de transporte; | ID único gerado a partir da composição de informações que serão enviadas: nr-pedido(>>>,>>>,>>9) | Nr-simul >>>,>>9 (6) ou nr-pedido(>>>,>>>,>>9) | cdd-Embarq >>>>>>>>>>>>>>>9 (16) |
| code | Descrição do pedido de transporte; | nr-pedcli (>>>,>>>,>>9) | nome-abrev (x(12) | Nr-simul >>>,>>9 (6) ou cdd-embarq | nr-resumo | nome-abrev | nr-pedcli |
| shipperId | ID do embarcador; | Parâmetros da integração de Integracao (cd0090) campo Embarcador. |
| priority | Prioridade do pedido de transporte; | é enviado o valor 0 (zero) como padrão para todos os pedidos. |
| pickupStart | Data/hora de início da janela de embarque; | Dt de alocação do estoque da mercadoria; simul-emb.dt-embarque |
| deliveryStart | Data/hora de início da janela de entrega; | O campo deliverystart deve ser o prazo de entrega. Data de entrega do pedido de venda (Ped-venda.dt-entrega) com o horário de 00:00. |
| deliveryEnd | Data/hora de término da janela de entrega; | O campo deliveryend deve ser o prazo de entrega. Data de entrega do pedido de venda (Ped-venda.dt-entrega) com o horário de "23:59". |
| destinationId | ID da localidade de destino do pedido de transporte (endereço principal de entrega); | Neste campo será informado o destino de entrega do pedido (Ped-venda.cod-emitente | ped-venda.cod-entrega) OBS:quando operacao triangular (ped-venda.nome-brev-tri) será gerado o local de entrega do cliente da operação triangular. |
| integrationDataSource | ID da origem de dados; | Definido nos parametros da integração no Neolog, (valor padrão "DATASUL") |
| modal | ID do modal do pedido de transporte; | Enviado valor fixo 1-Rodoviário. Os demais modais ( 2=Aquaviário; 3=Ferroviário; 4=Aéreo) nao serão tratados neste momento. |
| incoterm | Incoterm do pedido de transporte; | Se informado a Cidade CIF no pedido de venda (ped-venda.cidade-cif <> “ “) será enviado o valor 1 (CIF) ; senão 0 (FOB) . Os demais tipos 2=FOBTe 3=OP, serão tratados apenas no CPL. |
| erpCreationDt | Data de criação do pedido de transporte no sistema legado; | Data de implantacao do pedido de venda no Datasul (ped-venda.dt-implant). |
| reference (order) | Campo texto livre; | Este campo ira conter a chave primaria e única completa dos registro das tabelas do Datasul Chave unica da tabela simul-ped: Nr-simul | nr-pedcli | nome-abrev Chave única da tabela embarque: cdd-embarq | nr-resumo | nome-abrev | nr-pedcli |
| orderItems (início) | Entidade de agrupamento dos itens de um pedido de transporte; | A lista de itens de pedido não pode ser vazia (deve ter pelo menos 1 item de pedido); |
| orderId | ID do pedido de transporte; | Mesmo valor do campo identifier (order); nr-pedido(>>>,>>>,>>9) | Nr-simul >>>,>>9 (6) ou nr-pedido(>>>,>>>,>>9) | cdd-Embarq >>>>>>>>>>>>>>>9 (16) |
| sourceId | ID do item de pedido de transporte; | Chave primaria e única do item da simulacao: nr –sequencia (>>,>>9) (5) | nr-pedido (>>>,>>>,>>9) (9) | Nr-simul >>>,>>9 (6) | Nr-entrega >>>9 | contador (para os itens que repetem o nr-sequencia incluir um contador ao final) ou Chave primaria e unica do item do embarque: nr –sequencia (>,>>9) (4) | nr-pedido (>>>,>>>,>>9) (9) | Nr-embarque (x13) | Nr-entrega >>9 | contador (para os itens que repetem o nr-sequencia incluir um contador ao final) |
| productId | ID do SKU; | Codigo do item da simulacao ou do embarque (simul-ent.it-codigo ou it-pre-fat.it-codigo) |
| originId | ID da localidade de origem do item de pedido; | Neste campo é indicado uma localidade de origem, de onde a mercadoria estará saindo. A localidade de origem é considerado o cliente com o mesmo cnpj do estabelecimento do embarque (simul-emb.cod-estabel ou embarq.cod-estabel) e enviado o local de entrega deste cliente ( cod-emitente |cod-entrega) |
| proportionalityId | Indicador de quais SKUs devem ser mantidos em uma mesma proporção dentro de uma carga (exemplo: 1 pote = 1 tampa + 1 envase); | Para produtos compostos e configurados se pai não baixa estoque, enviar o código do item pai. |
| shipmentUnitWrapperCode | Código da categoria de invólucro de embarque; | Uma categoria de invólucro está associada a um tipo: 1=Pacote; 2=Granel não unitizável; 3=Pallet; 4=Granel unitizável; 5=Bobina; 6=Skid; 7=Tubo; 8=Feixe de tubos; Esta categoria está informada nos parâmetros de integração. |
| price | Valortotalde unidades de produtos em todas as unidades de embarque deste item; | Preco unitario do item do pedido (Ped-item.vl-pre-uni) X campo de quantidade (quantity) |
| quantity | Quantidade total de unidades de produtos em todas as unidades de embarque deste item; | |
| quantityInShipmentUnits | Quantidade de unidades de embarque; | ao campo quantity |
| MIT | "Merge in Transit"; | Para os pedidos com bonificação será enviado neste campo o numero do pedido do cliente do pedido original, se pedido original e pedido de bonificacao estiverem na mesma simulação/emabrque, senão não será enviada a tag. Se o cliente nao permite faturamento parcial ( NOT ped-venda.ind-fat-par) o numero do pedido (nr-pedido) também será atualizada neste campo dos itens , pois o cliente não aceita faturamento parcial, e o Neolog deverá realizar a otimização do pedido como um todo, não permitindo atendimento parcial. |
| reference (order item) | Campo texto livre; | Este campo ira conter a chave primaria e única completa dos registro das tabelas do Datasul Chave unica da tabela simul-ent: Nr-simul | nr-pedcli | nome-abrev | nr –sequencia | it-codigo | cod-refer X(8) | nr-entrega | ped-item.ind-componen OU Chave única da tabela it-pre-fat: cdd-embarq | nr-resumo | nome-abrev | nr-pedcli | nr-sequencia | it-codigo | cod-refer | nr-entrega |
Os pedidos gerados na integração poderão consultados na "cesta" no modulo programacao, na rotina analise disponível no aplicativo CPL do Neolog.
2) Liberação de viagem
Tipo de Fluxo: Cockpit-Neolog -> Datasul
Mensagem: ReleasedTripPublishRequestService
Versão: 1.000
Quando uma viagem é elaborada no CPL, ela é realizada a partir de pedidos de transporte, que podem ter sido enviados por várias simulações ou vários embarques-remessas enviados do Datasul.
Como a identificação do pedido de transporte no CPL, seguirá o mesmo código do pedido de venda no Datasul, o usuário poderá visualizar os pedidos que estão na viagem.
As viagens são elaborados no modulo programação, na rotina analise disponível no aplicativo CPL do Neolog, apos a seleção dos pedidos e montagem da carga a viagem é liberada.
Quando uma viagem é elaborada e liberada no CPL pelo webservice ReleaseTripPublishRequestService , este processo ocorre de forma assíncrona, ou seja, é enviada a mensagem do Neolog, porem o retorno que será aguardado será apenas se a mensagem chegou e pode ser lida. Este retorno deverá ser pelo webservice publishReleasedTripResponse. O processo é definido assim para evitar timeout pois a mensagem de embarque exige vários processamentos.
Apos a geração da pendência de processamento no ERP, pelo pedido de execução gerado para o RPW,o processo segue sem a intervenção do usuário com o processamento da viagem, ou seja , a geração do embarque.
As informações que foram captadas na recepção do XML, serão repassadas para as tabelas que irao gerar as informações para o embarque.
Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.
O relacionamento da geração do embarque para o viagem poderá se consultado no monitor da integração, assim como os erros que
Processo de integração das transações de envio de pedidos, liberação de viagens e desbloqueio de viagens:
tripReleaseRequests (ttTripReleaseRequest)
Campo XML | Descrição | Campo Datasul |
|---|---|---|
| basketSourceId | Numero da cesta que elaborou a viagem. | Informação nao será utilizada no Datasul. |
| carrierId | ID da transportadora da viagem (x 255) | Será verificado se o código enviado no xml esta cadastrado na tabela de transporte , então será assumido o embarque.nome-transportador com o nome abreviado do transportador. Senão estiver cadastrado, ira assumir " " (branco) pois nao é uma informacao obrigatorio no cadastros do embarque no ERP. |
freightValue | O valor do frete utilizado no Neolog é apenas sugestivo para escolha da transportadora. O frete correto será considerado na integração com o GFE, conforme integração padrão. | |
| identifier (trip) - | ID da viagem cuja liberação está sendo solicitada pelo CPL; | Será armazenado no Datasul este identificador para enviar na solicitação de cancelamento ou reprogramação é enviado este código.Gravado na tabela embarque.dec-1 |
| truckLicensePlate | Placa do caminhão da viagem | Nao sempre estará informado no CPL, mas quando vier conteúdo será gravado em embarque.placa |
truckLicensePlateState | Estado da placa do caminhão da viagem; nem sempre estará informado no CPL. | mas quando vier conteúdo gravar em embarque.uf-placa |
vehicleDescription | Informação não será utilizada no Datasul. | |
| vehicleId | ID do tipo de veículo da viagem; | encontrado o tipo-carga correspondente no Datasul e atualizado o embarque.tipo-emb. Caso codigo nao esteja cadastrado no ERP, será gerado erro na integracao. |
Demais campos deste bloco não serão utilizados no Datasul:
- truckStatusId
- truckStatusDescription
- truckAxlesQuantity
| Campos XML | Descrição | Campo Datasul |
|---|---|---|
| identifier (delivery unit) | ID da unidade de entrega; | (ped-venda.cod-emitente) + " | " + STRING(ped-venda.cod-entrega) |
| orderSourceId | ID do pedido de transporte da unidade de entrega; | Indica um pedido de uma simulação que foi utilizado na viagem nr-pedido (>>>,>>>,>>9) + " | " +Nr-simul >>>,>>9 (6). Este campo de ID foi gravado no simul-ped.char-1 quando do envio da simulação. OVERLAY(b-it-pre-fat.char-2,1,100) = cSourceId. |
| orderTypeSourceId | Código do tipo do pedido; | Não será utilizado no ERP. |
| orderItemSourceId | ID do item de pedido de transporte da unidade de entrega | Indica um item de um pedido de uma simulação que foi utilizado na viagem nr –sequencia | nr-pedido | Nr-simul | nr-entrega contador nr –sequencia (>>,>>9) (5) + "|" + Este campo foi gravado no campo simul-ent.char-1 quando do envio da simulação. |
| productSourceId | ID do produto da unidade de entrega; | Não será utilizado no ERP. |
| sequenceComposition | Sequência da composição do SKU da unidade de entrega (apenas para SKUs que são multi-volume); | Não será utilizado no ERP. |
| quantity | Quantidade das unidades de entrega; | Estas quantidades necessitam ser acumuladas pelas subparadas. |
| price | Preço das unidades de entrega | não será utilizado na geração do embarque. |
| deliveryDate | Data planejada de entrega da unidade de entrega | Esta data é a nova data que deverá ser considerada para a geração do novo pedido de transporte indicado na bloco das quebras realizadas no CPL. |
| integrationSource | ID da origem de dados; | |
atibute name Totvs12_CPL_Order_Reference | Chave unica da tabela simul-ped enviada para o Neolog. Nr-simula | nr-pedcli | nome-abrev Através do conteúdo deste campo é possível identificar qual pedido da simulação que esta sendo referenciado na viagem e que será utilizado para gerar o embarque-viagem, | |
atribute name Totvs12_CPL_Order_Item_Reference | Chave unica da tabela simul-ent enviada para o Neolog. Nr-simul | nr-pedcli | nome-abrev| nr –sequencia |item | cod-refer | nr-entrega | ped-item.ind-componen Através do conteúdo deste campo é possível identificar qual o item da simulação que esta sendo referenciado na viagem e que será utilizado para gerar o os itens do embarque-viagem, |
Os embarques criados pela integração terão o campo de identificador com o valor Neolog (embarque.identific).
simul-ped.char-1,122,16) = TRIM(STRING(de-cdd-embarq))
QUEBRAS: ttorderBreakPart
Um pedido de transporte enviado para o CPL, poderá ser colocado em uma viagem com todos as quantidades dos itens que foram enviadas, ou poderá ser realizado de forma parcial. Quando por alguma razão um item de um pedido não irá ser enviado totalmente em uma viagem, este atendimento parcial do pedido de transporte é considerado uma quebra.
Exemplo: Foi enviado ao CPL um pedido de transporte para o item A com 50 unidades.
Após a programação, foi criada uma viagem com apenas 15 unidades das 50 que foram enviadas no pedido de transporte.
No XML na parte da quebra ira ser indicado na parte orderBreakPart, os itens que tiveram uma programação parcial ou seja as 15 unidades.
orderBreakPart
| Campo XML | Descrição | Campo Datasul |
|---|---|---|
| regionSourceId | Será enviado um valor fixo definido na integração, parâmetros de integração. | Nao será utilizado |
| orderBreakPartId | este é um número gerado pelo CPL que precisa ser armazenado no ERP porque na interface de liberação da viagem deverá ser enviado para o cpl. | A identificação do numero da quebra será gravado na simulação que foi gerada com as quebras enviadas na mensagem releaseTrip. |
| orderSourceId | Indica que este pedido de transporte sofreu uma quebra. Este campo é o identificador do pedido de transporte recebido na interface de pedidos | se um pedido de transporte está dentro da estrutura orderBreakParts significa que este sofreu quebra |
| orderTypeSourceId | Não sera utilizado | |
| orderItemSourceId | Indica que este item do pedido de transporte sofreu uma quebra. Este campo é o identificador do item do pedido de transporte recebido na interface de pedidos; | Se um item de pedido de transporte está dentro da estrutura orderBreakParts significa que este item (que está dentro do pedido orderSourceId) sofreu quebra;
|
| loadId | código da carga aonde está o pedido que sofreu a quebra, esta carga está no mesmo XML, no bloco de informações da viagem. | Este campo server para associar o pedido de transporte (campos orderSourceId e orderItemSourceId) com a carga gerada pelo CPL nesta interface; como cada viagem terá apenas uma carga, não será necessário gravar esta informação. |
| shipmentUnitId | não utilizar | |
| quantShipmUnits | Quantidade de produtos quebrado em relação ao total origina. esta quantidade será a mesma que ja foi atualizada no embarque pela criação da viagem. desta forma nao será necessário armazená-la. Ex: foi enviado 50 unidades no pedido de transporte original, foi quebrado 15 e enviados os 15 na viagem. Neste campo vem os 15. |
3) Desbloqueio de Viagem
Tipo de Fluxo: Datasul -> Cockpit-Neolog
Mensagem: UnblockReleasedTripAcquisitionService
Versão: 1.000
Quando o CPL envia uma viagem ao Datasul, a viagem ficará como bloqueada no Cockpit, até receber uma mensagem de UnblockReleasedTripAcquisition para a viagem.
Este processo de desbloqueio, com a geração da mensagem de unblock se dará de forma on-line, apos a criação do embarque.
A mensagem de retorno será gerada para ambas as situações, se a criação do embarque foi com sucesso ou mesmo se ocorreram erros no processamento.
Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.
A mensagem de desbloqueio fornece ao Neolog um retorno para cada item de cada pedido que foi enviado na viagem:
Campo XML | Descrição | Campo Datasul |
|---|---|---|
| regionSourceId | Identificador da regional; | Esta informacao é enviado conforme o que foi parametrizado para a integração (ver parâmetros da integração cd0090) |
| tripCode | ID da viagem do CPL; | Esta informacao vem nao campo identifier (trip) da mensagem ReleaseTripPublishRequestService que veio do CPL e foi gravado no embarque (embarque.dec-1) |
| orderSourceId | ID do pedido de transporte associado à viagem; | Números dos pedidos de transporte que vieram na viagem. Informação gravada no campo : pre-fatur.char-1 (Id Pedido da viagem) Posição inicial 4 – 30 posições |
| itemId | ID do item do pedido de transporte Este campo deve receber um ID de item de pedido válido para o pedido da viagem; o sistema externo deverá dar um retorno para todos os itens de pedido existentes na viagem para que esta seja liberada; | Codigos dos itens dos pedidos de transporte que vieram na viagem. Informação gravada no it-pre-fat.char-2 - (IdItemSource) Posição inicial 1, 100 posições |
| Status | Deverá ser enviado um Ok para todos os itens da viagem para que esta seja liberada no CPL. 0=Não desbloqueia a viagem; | Se a criação dos itens da viagem no emabrque no Datasul foram criados com sucesso será enviado para cada item da viagem o valor 1=Desbloqueia a viagem; Se nao, se algum item nao puder ser criado, é enviado o valor 0=Não desbloqueia a viagem; Nao ha desbloqueio parcial de uma viagem. |
| msg | Resposta do ERP se conseguiu gerar o item do pedido no embarque, caso não tenha sido possível, retornar o erro neste campo. | Se retorno negativo o processo deverá ser liberado manualmente no CPL e no ERP. |
Quando a viagem contiver atendimentos parciais nos pedidos enviados ao Neolog, estes são tratados como quebras pelo Cockpit. Este espera receber na mensagem de desbloqueio da viagem, o retorno se foi possível ou não a criação nos novo numero de simulações ou embarques para comportar estas quebras.
A parte do xml que conterá o retorno referente as quebras contem os seguintes campos. (só enviado o retorno com quebra se viagem teve atendimentos parciais no Neolog).
Campo XML | Descrição | Campo Datasul |
|---|---|---|
regionSourceId | Identificador da regional; | Esta informação é enviado conforme o que foi parametrizado para a integração (ver parâmetros da integração cd0090) |
breakId | ID da quebra do CPL; | O ERP deverá dar um retorno para todos os breakIds gerados pelo CPL na interface de liberação de viagem para que esta seja liberada; este campo é gravado no ERP na mensagem ReleaseTripPublishRequestService com o nome de orderBreakPartId. |
orderId | ID do pedido de transporte associado à quebra; | Novo código de pedido gerado no ERP devido a informação de quebra enviada pelo CPL.Ped-venda.nr-pedido + "|" + simul-emb.nr-simul (simulação gerada na quebra) |
orderItemId | ID do item do pedido de transporte associado à quebra; | nr –sequencia (>>,>>9) (5) + "|" +nr-pedido (>>>,>>>,>>9) (9)+ “|” + Nr-simul >>>,>>9 (6) + "|" + Nr-entrega >>>9 + "|" contador |
status | Status de resposta do ERP sobre a quebra do CPL;0=Quebra não realizada; 1=Quebra realizada | se encontrar o it-pre-fat no simu-ent (da quebra), enviar 1- Quebra realizada, caso contrario 0- Quebra nao realizada. |
msg | Quando a quebra não for realizada, informar o erro ou motivo da não quebra. | Motivo da não quebra - segundo abaixo. |
IMPORTANTE: Este ultimo bloco estará sendo retornado apenas se o embarque foi criado com sucesso, não haverá desbloqueio parcial de uma vigem, onde somente alguns itens ou pedidos ficariam liberados, pois não teríamos como reprocessar de forma parcial a viagem no ERP. Se ocorrer erro, deverá ser reenviada a viagem pelo Neolog, para ser reprocessado no Datasul.
A seguir descrever as variações, particularidades da mensagem e processos (desta integração) de acordo com cada marca
4) Reprogramação de Viagem
Tipo de Fluxo: Cockpit-Neolog - Datasul
Mensagem: PublishReprogramingService
Versão: 1.000
Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.
Processo de integração das transações de envio de pedidos, liberação de viagens e desbloqueio de viagens:
A seguir descrever as variações, particularidades da mensagem e processos (desta integração) de acordo com cada marca
Notas:
Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela
Mesmo se a paletização estiver desligada no CPL o envio para o WMS somente será realizado depois do retorno do Neolog.Limitações/Restrições
Produto configurado e produto composto
Descreva limitações e restrições para a integração que está sendo descrita.
Limitações / Restrições Gerais
Integração de produto configurado/composto
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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas