Histórico da Página
...
Realizar a integração das cargas OMS com o Monitoramento, funcionalidade pertencente ao Módulo de Execução do Cockpit Logístico Neolog.
03. SOLUÇÃO
Realizada a implementação que permitirá a integração de cargas faturadas com o Cockpit Logístico para o 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 à 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 com o Monitoramento será realizado através da rotina de Monitor de Cargas (OMSXCPL7), por meio da açã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 cargas com ou sem viagem geradas.
Envio da Carga para Monitoramento via Schedule
O envio da carga com o Monitoramento para monitoramento também poderá ser realizado via agendamento (schedule) do Protheus. Para tanto, a rotina agendada deverá ser a OMSXCPL7.
Estrutura do XML de Envio:O escopo desta integração permitirá o envio de cargas faturadas para o monitoramento no Cockpit Logístico Neolog.
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_QUANT | 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 | ||
...
Import HTML Content
Visão Geral
Conteúdo das Ferramentas