01. DADOS GERAIS
Linha de Produto: | Microsiga Protheus |
---|---|
Segmento: | Supply Chain - Logística |
Módulo: | TOTVS Logística OMS |
Função: | OMSXCPL7 - Monitor de Cargas |
País: | Todos Países |
Requisito/Story/Issue (informe o requisito relacionado) : | DLOGWMSMSP-8078 DLOGWMSMSP-7275 (Épico) |
02. SITUAÇÃO/REQUISITO
Realizar a integração das cargas do OMS Protheus com o Monitoramento, funcionalidade pertencente ao Módulo de Execução do TOTVS Logística Cockpit.
03. SOLUÇÃO
Realizada a implementação que permitirá a integração de cargas faturadas com o TOTVS Logística Cockpit, para o seu monitoramento e rastreamento.
Não será obrigatória a existência de uma viagem (DK0) para que o monitoramento ocorra.
Pré-requisitos Para Integração da Carga
- MV_CPLMON, igual a 1-Sim;
- MV_WSMONI, preenchido com o WebService de Monitoramento;
- A carga deve possuir todos os seus pedidos faturados;
- Os clientes da carga devem possuir Endereço (A1_END ou A1_ENDENT), Município (A1_MUN ou A1_MUNE), Estado (A1_EST ou A1_ESTE) e País (A1_PAIS) preenchidos.
Envio da Carga Para Monitoramento
O envio da carga para o monitoramento será realizado pela rotina Monitor de Cargas (OMSXCPL7), por meio da opção Enviar Cargas p/ Monitoramento.
Os registros apresentados em tela serão filtrados conforme o pergunte da rotina, sendo possível, com base no período informado, selecionar as cargas com ou sem viagem geradas.
Envio da Carga Para Monitoramento Via Schedule
O envio da carga para o monitoramento também pode ser realizado via agendamento (Schedule) do Protheus.
Para isso, a rotina agendada deve ser a Monitor de Cargas (OMSXCPL7).
Estrutura do XML de Envio
Mensagem Integração de Monitorável | ||||
---|---|---|---|---|
Tag XML Agrupadora | Tag XML | Campo no Protheus | Campo no Cockpit Logístico | Observações |
driver | sourceId | Filial + DA4_COD | Motorista | |
driver | name | DA4_NOME | Motorista | |
driver | identifier | DA4_CGC ou DA4_MAT ou DA4_COD | Motorista | Utilizará a primeira informação não vazia. |
monitorables / monitorable | sourceId | Se tipo igual a TRIP, então: Filial + DAK_COD + DAK_SEQCAR Se tipo igual a INVOICE, então: F2_DOC + F2_SERIE | Se tipo igual a TRIP a nomenclatura utilizada no Cockpit será Viagem. Se tipo igual a TRIP a nomenclatura utilizada no Cockpit será Nota. | |
monitorables / monitorable | type | TRIP / INVOICE | A carga é enviada com o monitorável do tipo TRIP, já as notas fiscais são enviadas como monitoráveis do tipo INVOICE. | |
monitorables / monitorable | value | Se tipo igual a TRIP, então: DAK_VALOR Se tipo igual a INVOICE, então: F2_VALFAT | Valor | |
monitorables / monitorable | volume | Se tipo igual a TRIP, então: DAK_CAPVOL Quando tipo igual a INVOICE não é enviado o volume. | Volume | |
monitorables / monitorable | weight | Se tipo igual a TRIP, então: DAK_PESO Se tipo igual a INVOICE, então: F2_PLIQUI ou F2_PBRUTO | Peso | O peso varia conforme o parâmetro MV_PESOCAR, se igual à "L" envia o peso líquido, se MV_PESOCAR igual à "B" envia o peso bruto. |
monitorables / monitorable | temperatureType | DB0_TIPCAR | Envia carga como Congelada se todos os produtos existentes na carga possuam no tipo da carga (B1_TIPCAR) um modelo da carga cujo o tipo (DB0_TIPCAR) possua descrição igual à CONGELADA. Envia carga como Resfriada se todos os produtos existentes na carga possuam no tipo da carga (B1_TIPCAR) um modelo da carga cujo o tipo (DB0_TIPCAR) possua descrição igual à RESFRIADA. Envia a carga com o tipo de temperatura Default caso a carga não se encaixe nas duas regras acima. | |
monitorables / monitorable / vehicle | vehicle | DA3_COD | Veículo | |
monitorables / monitorable / vehicle | name | DA3_DESC | Veículo | |
monitorables / monitorable / truck | truck | DA3_PLACA | Caminhão | |
monitorables / monitorable / carrier | sourceId | A4_COD | Caminhão | |
monitorables / monitorable / carrier | name | A4_NOME | Transportadora | |
monitorables / monitorable/ carrier | description | DA4_NREDUZ | Transportadora | |
monitorables / monitorable / transitions / transition | name | A integração possuí 4 transições:
| Nome | As 4 transições apenas se aplicam para a transição do monitorável de tipo TRIP. Já para o monitorável do tipo INVOICE, apenas existirá a transição Chegada no Cliente. |
monitorables / monitorable / transitions / transition | sourceId | Sequencial de 3 dígitos gerado no momento de execução | Transição | |
monitorables / monitorable / transitions / transition | expectedTimestamp | Definida conforme o tipo da transição.
DK1_CHEGAD ou DAI_DTCHEG + DAI_CHEGAD
DK1_INIDES
DK1_FIMDES
DK1_TSAIDA ou DAI_DTSAID + DAI_HRSAID | Data Estimada | |
monitorables / monitorable / transitions / transition | limitTimestamp | Definida conforme o tipo da transição.
DK1_CHEGAD ou DAI_DTCHEG + DAI_CHEGAD
DK1_INIDES
DK1_FIMDES
DK1_TSAIDA ou DAI_DTSAID + DAI_HRSAID | Data Esperada | |
monitorables / monitorable / transitions / transition / location / locality | sourceId | Filial + A1_COD | Localidade | |
monitorables / monitorable / transitions / transition / location / locality | name | A1_NOME | Localidade | |
monitorables / monitorable / transitions / transition / location / locality | description | A1_NREDUZ | Localidade | |
monitorables / monitorable / transitions / transition / location / address | street | A1_ENDENT ou A1_END | Endereço | Prioriza o preenchimento com base no endereço de entrega, caso vazio utiliza o endereço do próprio cliente. |
monitorables / monitorable / transitions / transition / location / address | number | A1_ENDENT ou A1_END | Endereço | Prioriza o preenchimento com base no endereço de entrega, caso vazio utiliza o endereço do próprio cliente. |
monitorables / monitorable / transitions / transition / location / address | district | A1_BAIRROE ou A1_BAIRRO | Endereço | Prioriza o preenchimento com base no endereço de entrega, caso vazio utiliza o endereço do próprio cliente. |
monitorables / monitorable / transitions / transition / location / address | city | CC2_MUNE ou A1_MUNE / CC2_MUN ou A1_MUN | Endereço | Prioriza o preenchimento com base no endereço de entrega, caso vazio utiliza o endereço do próprio cliente. |
monitorables / monitorable / transitions / transition / location / address | state | A1_ESTE / A1_EST | Endereço | Prioriza o preenchimento com base no endereço de entrega, caso vazio utiliza o endereço do próprio cliente. |
monitorables / monitorable / transitions / transition / location / address | zipCode | A1_CEPE / A1_CEP | Endereço | Prioriza o preenchimento com base no endereço de entrega, caso vazio utiliza o endereço do próprio cliente. |
monitorables / monitorable / transitions / transition / location / address | country | A1_PAIS | Endereço | |
monitorables / monitorable / items / item | sourceId | F2_DOC + F2_SERIE + D2_ITEM | Item | |
monitorables / monitorable / items / item | quantity | D2_QUANT | Quantidade | |
monitorables / monitorable / items / item | value | D2_TOTAL | Valor | |
monitorables / monitorable / items / item | weight | D2_PESO | Peso | |
monitorables / monitorable / items / item | volume | D2_QUANT * (B5_COMPRLC * B5_LARGLC * B5_ALTURLC) | Volume | |
monitorables / monitorable / items / item / product | sourceId | B1_COD | Produto | |
monitorables / monitorable / items / item / product | name | B1_DESC | Produto | |
monitorables / monitorable / items / item / extensions / extension | key | Lote | Lote | |
monitorables / monitorable / items / item / extensions / extension | textValue | D2_LOTECTL | Lote | |
relationships / relationship | parentSourceId | Filial + DAK_COD + DAK_SEQCAR | ||
relationships / relationship / children | childSourceIds | F2_DOC + F2_SERIE |
Exemplo do XML de Aquisição de Monitoráveis
Exemplo de Utilização
OMSXCPL1
- Ative a integração do monitoramento da carga.
MATA410
- Inclua um Pedido de Venda.
OMSXCPL6
- Integre o Pedido de Venda com o Cockpit Logístico.
COCKPIT LOGÍSTICO
- Gere a viagem e libere.
OMSXCPL7
- Verifique se a carga foi gerada para a viagem.
- Neste ponto ainda não será possível integrar para o monitoramento.
MATA460B
- Fature a carga.
OMSXCPL7
- Integre a carga para o monitoramento.
COCKPIT LOGÍSTICO
- Clique em Monitoramento > Monitoráveis.
- Verifique se a carga foi recebida e se as transições estão corretas.
OMSXCPL1
- Ative a integração do monitoramento da carga.
MATA410
- Inclua um Pedido de Venda.
MATA460B
- Fature a carga.
OMSXCPL7
- Integre a carga para o monitoramento.
COCKPIT LOGÍSTICO
- Clique em Monitoramento > Monitoráveis.
- Verifique se a carga foi recebida e se as transições estão corretas.
04. DEMAIS INFORMAÇÕES
Tabelas Utilizadas
DAK - Carga
DAI - Itens da Carga
DK5 - Monitoramento Carga CPL
DK0 - Viagem
DK1 - Itens da Viagem
SF2 - Cabeçalho das NF de Saída
SD2 - Itens da Venda da NF
05. ASSUNTOS RELACIONADOS