English
Español
Conexão com os sistemas Jetta Cargo
A integração entre o Gestão de Armazenagem | WMS Senior e a plataforma Jetta Cargo tem como objetivo otimizar a definição de volumes no processo logístico, utilizando inteligência de cálculo de cubagem para melhor aproveitamento do espaço e redução de custos operacionais.
Por meio dessa integração, o WMS envia informações de produtos, caixas para a Jetta Cargo, que processa esses dados e retorna uma sugestão otimizada de volumes, indicando quais caixas utilizar e como os produtos devem ser organizados em cada volume.
Particularidades
Benefícios da integração
- Sugestão da definição de volumes de expedição.
- Melhorar a cubagem e o aproveitamento do espaço.
- Reduzir custos operacionais e de frete.
- Permitir acompanhamento detalhado da sugestão enviada na tela Integração Jetta Cargo
Requisitos
- A autenticação é realizada por meio de um Bearer Token, obtido a partir do e-mail e da senha cadastrados na plataforma.
Antes de ativar a integração, é necessário:
- Definir em Configuração de Onda os momentos em que os dados serão enviados para a Jetta Cargo.
- Ter a Configuração Geral do WMS ajustada para permitir integração com a Jetta Cargo.
- Ter os parâmetros de autenticação e a URL base definidos na Configuração Geral.
Restrições
- Caso as integrações de onda não estejam parametrizadas, nenhum envio será realizado.
- As importações da Jetta Cargo não poderão ser reintegradas, a reintegração deverá acontecer apenas na exportação.
- O preenchimento dos campos Altura, Largura, Comprimento, Peso e Peso Máximo no cadastro da Caixa de Volume será obrigatório quando a Configuração Geral estiver parametrizada com Integração à Jetta Cargo.
- Pedidos com Caixa Fechada: Caso o pedido contenha produto identificado com código de barras referente à Caixa Fechada na embalagem, a exportação para a Jetta Cargo não será realizada. Nesses casos, o produto já possui sua caixa própria previamente definida, não sendo necessário submetê-lo ao processo de otimização e cálculo de cubagem da Jetta Cargo.
O envio para integração ocorrerá apenas para os demais produtos elegíveis, respeitando as regras de onda e os momentos configurados.
Compatibilidade
Com o Gestão de Armazenagem | WMS Senior.
| Funcionalidade | Versão | Referência |
|---|---|---|
| Criação da conexão com os sistemas Jetta Cargo | 8.12.8.133 | WMS-21558 |
Parametrizações
Configuração Geral
Acesse Configuração > Configuração Geral > botão Alterar > guia Integração Jetta Cargo
- Integrar com Jetta Cargo: quando marcado, ativa a integração com a plataforma Jetta Cargo, tornando obrigatório o preenchimento dos campos descritos abaixo.
Autenticação
- E-mail: endereço de e-mail utilizado para autenticação na plataforma Jetta Cargo.
- Senha: senha utilizada para autenticação na plataforma Jetta Cargo.
Comunicação
- URL para obtenção do Token de Acesso: indica a URL que será utilizado para autenticação e geração do token de acesso à plataforma Jetta Cargo.
- URL Enviar Produtos/Caixas: indica a URL para a qual será enviada a requisição de dados de Produtos/Caixas na API de Cargas (Cargos Optimization) da Jetta Cargo.
- URL Enviar Caixas: indica a URL para a qual será enviada a requisição de dados de Caixas na API de Transports da Jetta Cargo.
Validar E-mail e Senha: botão que verifica e autentica as credenciais informadas, garantindo que o acesso esteja corretamente configurado.
Validar URL Token: botão que realiza a validação da URL utilizada para obtenção do token de autenticação, garantindo que o endpoint esteja acessível e sem erros de comunicação.
Validar URLs de Envio: botão que verifica se os dados inseridos estão corretos, realizando a validação diretamente nos sistemas da Jetta Cargo.
Acesse Configuração > Configuração Geral > botão Exportar Caixas Volume Jetta Cargo
- Realiza o envio de todas as caixas de volume cadastradas no sistema para a plataforma Jetta Cargo, executando a carga inicial das informações conforme o JSON definido e seus respectivos endpoints.
Configuração da Onda
Acesse Configuração > Configuração da Onda > botão Alterar > guia Exportação
- Integrar com Jetta Cargo: quando ativado, permite definir em quais etapas ou momentos os dados serão enviados para a plataforma Jetta Cargo. Esta opção só ficará disponível se o parâmetro Integrar com Jetta Cargo estiver habilitado nas Configurações Gerais.
- Momentos de Integração com Jetta Cargo: este parâmetro ficará disponível somente quando o parâmetro Integrar com Jetta Cargo estiver habilitado. Trata-se de uma parametrização de múltipla escolha, permitindo selecionar um ou mais momentos de integração. As exportações para a Jetta Cargo ocorrerão conforme as opções selecionadas, sendo realizada uma exportação a cada evento configurado.
- Após a liberação da onda: a integração ocorre após a liberação da onda.
- Após a formação da onda: a integração ocorre após a formação da onda.
- Após a separação do pedido: a integração ocorre após a separação do pedido.
- Após faturamento do pedido: a integração ocorre após o faturamento do pedido. Caso o faturamento seja realizado por integração, a exportação será realizada somente após a impressão do DANFE.
Integrações
WMS > Jetta Cargo
A integração pode ser executada nos seguintes momentos da operação:
- Após a liberação da onda
- Após a formação da onda
- Após a separação do pedido
- Após faturamento do pedido
Criar Gancho
Método: POST
URL: {Base URL}/api/v2/{operação}
Request
JSON
{
"id": "",
"description": "",
"items": [
{
"id": "",
"alias": "",
"description": "",
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"supportedWeight": 0,
"maximumStacking": 0,
"stackingUnit": "",
"category": "",
"type": "",
"color": "",
"rotation": {
"position1": true,
"position2": true,
"position3": true,
"position4": true,
"position5": true,
"position6": true
},
"quantity": 0,
"priority": 0
}
],
"transports": [
{
"_id": "0",
"quantity": 0,
"unlimited": true
}
],
"cargoProfile": ""
}
Response
Retorno da API da Jetta Cargo
{
"_id": "",
"id": "",
"description": "",
"date": "",
"status": "",
"result": {
"itemsQuantity": 0,
"itemsLoaded": 0,
"items": 0,
"cubageTotal": 0,
"cubageLoaded": 0,
"cubage": 0,
"floorTotal": 0,
"floorLoaded": 0,
"floor": 0,
"weightTotal": ,
"weightLoaded": ,
"weight": ,
"allocatedItems": [
{
"_id": "",
"rotation": 0,
"rotateInY": false,
"x": 0,
"y": 0,
"z": 0,
"type": "",
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"description": "",
"color": "",
"category": "",
"id": "",
"alias": "",
"customImageURL": "",
"enableTextImage": false,
"enableAllocationOnlyRestrictedArea": false,
"customField": "",
"requiredSpaceBetween": {
"length": null,
"width": null,
"height": null
},
"tempID": 0,
"layer": 0,
"text": "",
"text2d": "",
"quantity": 0,
"comprimento": 0,
"largura": 0,
"altura": 0,
"peso": 0,
"descricao": "",
"apelido": "",
"index": null
}
],
"unallocatedItems": [],
"transports": [
{
"_id": "",
"id": "",
"description": "",
"descricao": "",
"allocatedItems": 0,
"cubageTotal": 0,
"cubageLoaded": 0,
"cubage": 0,
"floorTotal": 0,
"floorLoaded": 0,
"floor": 0,
"weightTotal": 0,
"weightLoaded": 0,
"weight": 0,
"axlesWeight": [],
"containers": [
{
"allocatedItems": 0,
"cubageTotal": 0,
"cubageLoaded": 0,
"cubage": 0,
"floorTotal": 0,
"floorLoaded": 0,
"floor": 0,
"weightTotal": 0,
"weightLoaded": 0,
"weight": 0,
"sequence": 0,
"distances": {
"front": 0,
"back": 0,
"left": 0,
"right": 0
},
"items": [
{
"_id": "",
"id": "",
"alias": "",
"layer": 0,
"rotation": 0,
"rotateInY": false,
"x": 0,
"y": 0,
"z": 0,
"groupId": null
},
{
"_id": "",
"id": "",
"alias": "",
"layer": 0,
"rotation": 0,
"rotateInY": false,
"x": 0,
"y": 0,
"z": 0,
"groupId": null
}
],
"grouper": 1,
"images": {
"side0": "",
"side1": "",
"top": "",
"side2": "",
"side3": ""
},
"centerOfGravity": {
"x": 0,
"y": 0,
"z": 0
},
"cornerWeight": null
}
],
"extra": "",
"plate": "",
"regions": [],
"images": {
"side": ""
},
"messages": {
"errors": [],
"warnings": [],
"infos": []
},
"items": 0
}
],
"link3d": "",
"message": "",
"edited": false
}
}
Criar Gancho
Método: POST
URL: {Base URL}api/v2/transports
Request
JSON
{
"supportedWeight": 0,
"tare": 0,
"type": "Box",
"containers": [
{
"width": 0,
"height": 0,
"length": 0,
"tare": 0,
"supportedWeight": 0
}
],
"id": "",
"description": ""
}
Fluxos
Integração Jetta Cargo
Acesse Integração > Integração Jetta Cargo
Esta tela exibe somente as integrações com a plataforma Jetta Cargo, ou seja, informações retornadas pela API e o status da exportação.
botão Exibir
O botão Exibir permite filtrar os registros apresentados no grid, conforme o status selecionado:
- Todos: exibe todos os registros, independentemente do status.
- Aguardando: exibe momento em que a integração foi apenas agendada.
- Concluído: exibe apenas os registros finalizados com sucesso.
- Erro: exibe apenas os registros que retornaram com falha.
botão Período
O botão Período permite filtrar os registros apresentados na tela conforme o período selecionado. As opções disponíveis são:
- 3 dias: exibe os registros gerados nos últimos 3 dias.
- 7 dias: exibe os registros gerados nos últimos 7 dias.
- 15 dias: exibe os registros gerados nos últimos 15 dias.
- 30 dias: exibe os registros gerados nos últimos 30 dias.
- Por Período: permite ao usuário informar uma data inicial e final para exibir apenas os registros dentro do intervalo especificado.
botão Detalhes
Exibirá as informações detalhadas dos produtos, das caixas, das quantidades e dimensões em que serão alocados. Caso o volume já tenha sido gerado na integração com a Jetta Cargo, também serão apresentadas as informações do volume.
S I M P L I F I C A N D O
Fluxo de Envio de Dados
- Conforme a configuração da onda, no momento previamente definido, é realizada a exportação dos dados de produtos e volumes (caixas) do WMS para a Jetta Cargo. Esse processo é devidamente registrado nas telas Integração Jetta Cargo e Integração de Arquivos.
- Após o processamento da exportação, os dados retornados pelo parceiro são recebidos pelo WMS e tratados como importação. Nesse momento, são registradas as informações de alocação dos produtos em cada caixa, conforme a otimização realizada pela Jetta Cargo. Todos os detalhes desse processamento podem ser consultados na tela Integração Jetta Cargo. Já a tela Integração de Arquivos registra tanto os arquivos de exportação (WMS x Jetta Cargo) quanto os arquivos de importação (Jetta Cargo x WMS).
- Os logs de comunicação entre os sistemas permanecem armazenados nas telas mencionadas. Além disso, na tela Integração de Arquivos, é possível realizar o download dos arquivos no formato JSON, após o processamento, conforme abaixo:
- Exportação: opção Baixar arquivo exportado
- Importação: opção Baixar arquivo importado
- Durante o processo de exportação, o Gestão de Armazenagem | WMS Senior:
- Obtém os produtos pertencentes à onda;
- Identifica exclusivamente as caixas de volume permitidas para o depositante/nota fiscal e que estejam integradas com a Jetta Cargo;
- Monta o JSON de envio contendo, para cada produto, as seguintes informações:
- Identificador (id);
- Nome;
- Código de barras;
- Dimensões (comprimento, largura e altura);
- Peso bruto;
- Regras de empilhamento;
- Quantidade efetivamente movimentada no momento da integração.
- Após a montagem do JSON, os dados são enviados ao endpoint de otimização da Jetta Cargo para processamento.
Importante: em cada momento configurado para integração, a quantidade enviada corresponde somente ao que foi efetivamente movimentado até aquele momento.
Exemplo: se um pedido possui 10 unidades e apenas 5 foram separadas, serão enviadas apenas essas 5 unidades para a Jetta Cargo.
Retorno da Jetta Cargo
Após o processamento da exportação, são gravados os detalhes da integração, incluindo o arquivo enviado para a Jetta Cargo e a importação do retorno da plataforma. Essas informações também ficam disponíveis na tela de Integração de Arquivos, permitindo o download dos arquivos gerados. Com isso a Jetta Cargo retorna um JSON contendo:
- Distribuição dos produtos em cada caixa.
- Volumes gerados
- Produtos não alocados (unallocatedItems)
Regras de tratamento:
- Se houver itens em unallocatedItems:
- Se, no retorno da Jetta Cargo, existirem itens em unallocatedItems (produtos que não obtiveram sucesso no cálculo), eles não serão considerados na sugestão de encaixe.
- Nessa situação, o processo seguirá o fluxo padrão do WMS atualmente utilizado para a definição dos volumes.
Sugestão de Caixa para Geração de Volumes
- A Jetta Cargo retorna ao WMS uma sugestão otimizada de caixas e alocação de produtos, com base nos cálculos de cubagem e nas regras definidas.
- Essa sugestão não é obrigatória. Cabe ao usuário, no fluxo de packing, decidir se seguirá a recomendação retornada pela Jetta Cargo ou se irá definir manualmente outras caixas, conforme a necessidade operacional.
- O WMS apenas disponibiliza a informação retornada pela integração, mantendo a autonomia do usuário na geração dos volumes.
|
Veja também: |
English
Español
