INTEGRAÇÃO SIGATMS X PACK LOCATOR

Contexto de negócio (Introdução)

O objetivo desta integração é permitir a comunicação do dispositivo Pack Locator  com o modulo SIGATMS do Protheus, possibilitando assim conferência de volumes e o carregamento e descarregamento de veículos de uma forma mais integrada e síncrona com o processo físico, tornando os dados mais íntegros com o sistema.

As principais vantagens são :

• Ganho na produtividade e agilidade dos processos.
• Maior segurança e confiabilidade nos processos de  conferência de volumes, carregamento e descarregamento.
• Possibilidade de realizar a rastreabilidade dos volumes.

Sistemas Envolvidos

• Protheus / SIGATMS 

• • Entrada Dc.Cliente

• • Etiquetas

• • Viagens

• • Lotes de Entrada de Nf

• • Carregamento

• • Registro de Ocorrências

• • Apontamento de Operações
    
    
• Venture / PackLocator 

Integração

O objetivo desta melhoria é permitir que o usuário possa gerar e imprimir etiquetas para os volumes dos documentos do cliente, integrando os dados das etiquetas (Número das NF’s , serie NF, CNPJ, Número da Etiqueta e Qtde. volumes),com o sistema Pack Locator  para que posteriormente possa ser realizada a conferência das etiquetas através do coletor de dados utilizado pelo sistema da Pack Locator.

Integrar também os dados da viagem (Número Viagem, CTRC’s, Número das NF’s e Número das Etiquetas) com o sistema Pack Locator, para que através do coletor de dados o usuário possa fazer a conferência do carregamento e descarregamento, garantindo que todos os volumes da viagem foram conferidos.

Integrar as ocorrências, pendências e a identificação de produtos para conciliação de sobras e faltas.

A comunicação com os dispositivos  Pack Locator será realizada  através de Mensagem Única Protheus, uma tecnologia desenvolvida para melhorar o envio e recebimentos na camada de Web Services.

As informações trafegarão em uma via de mão dupla, onde cada uma das pontas enviará e receberá informações,.

Não haverá métodos de consulta direta em ambos os sistemas através de Web Services.

Escopo

Parâmetro:

• • MV_TMSETIQ: Habilita a funcionalidade de etiquetas na entrada do documento do cliente.
  • MV_INTVENT: Habilita a integração das etiquetas geradas com o  Pack Locator.

Observação: Se o parâmetro MV_INTVENT estiver habilitado, a funcionalidade de impressão estará ativa independente do parâmetro MV_TMSETIQ. Já que será obrigatório a impressão de etiquetas para a Integração com o  Pack Locator.

• • MV_TMSCOBR: Informa se a conferência das etiquetas é obrigatória antes do cálculo do frete. Se o parâmetro estiver habilitado, ao confirmar a digitação de todas as notas fiscais do lote o status do lote será (aguardando conferência) e só será possível efetuar o cálculo do frete deste lote se a conferência for realizada ou se a rotina Liberação do Lote for executada.
  • MV_TMSCDES: Informa se a conferência das etiquetas é obrigatória no descarregamento da viagem.
  • MV_TMSCDOC: Informa se a conferência de documentos é obrigatória do carregamento da viagem.
  • MV_TMSCETQ - Tipo da identificação do produto.

Exemplo de Aplicação:  

Comunicação através de mensagens únicas

Serão desenvolvidos mensagens únicas para que a integração ocorra entre o SIGATMS x  Pack Locator.

Geração de Etiquetas

Premissa: Parâmetro, MV_TMSETIQ = .T. ou parâmetro MV_INTVENT

 1.     Funcionalidade Pack Locator

O sistema  Pack Locator que é acessado via Coletor de Dados, receberá e armazenará as informações enviadas das Notas Fiscais e das Etiquetas.

Após a finalização da conferência, será enviado o resultado da ação para o Web Service do Protheus via mensagem única.

Em caso da conferência ocorrer com sucesso, ou seja, todas etiquetas da Nota Fiscal terem sido ‘bipadas’, será enviado para o Protheus o Status de Sucesso na Conferência da Nota Fiscal.

Em caso de insucesso na conferência, ou seja, um ou mais etiquetas não terem sido ‘bipadas’, será enviado para o Protheus o Status de Falha na Conferência da Nota Fiscal, assim como as etiquetas que não foram ‘bipadas’.

 2.       Inclusão

Na rotina TMSA050 (Entrada de Dc.Cliente), foi criado o campo Qtde.Etiquetas (DTC_QTDETI), este campo será gatilhado pelo campo Qtde. Volumes (DTC_QTDVOL), recebendo o mesmo conteúdo. Porém o usuário poderá alterar a quantidade de etiquetas que serão geradas.

Ao confirmar a entrada de documentos do cliente, o sistema validará se foi informado a quantidade de volumes e etiquetas para todos os documentos/produtos informados. Caso possua algum documento/produto sem volumes e etiquetas o sistema avisará ao usuário e perguntará se ele realmente desejar confirmar a gravação.

 3.       Alteração/Exclusão Entrada Dc.Cliente (TMSA050)

Importante: Não é permitido a alterar a chave do DTC quando estiver trabalhando com etiquetas, pois todo o vínculo será perdido.

Quando existir erro em um dos campos chaves do documento do cliente(DTC_NUMNFC, DTC_SERIE, DTC_CLIREM, DTC_LOJREM), o usuário poderá utilizar a opção de cópia alterando o novo registro e poderá excluir o anterior

Quando o usuário alterar a Entrada de dc.Cliente, mudando o valor do campo Qtde.Etiquetas (DTC_QTDETI), o sistema ira incluir ou excluir etiquetas conforme o valor digitado.

Exemplos:

                 Imaginando que o usuário havia lançado uma entrada de dc. Do cliente com 5 etiquetas.

1. 1. • Se o usuário alterar no TMSA050, o campo DTC_QTDETI para 2, 3 etiquetas das 5 geradas na DDR, serão apagadas, deixando assim as tabelas DDR e DDW com apenas duas etiquetas.
      • Se o usuário alterar no TMS050, o campo DTC_QTDETI para 0, todas as etiquetas geradas para aquele documento serão estornadas (DDR/DDW) o mesmo deve ocorrerá se o documento de entrada for excluído.
      • Caso o usuário altere no TMSA050, o campo DTC_QTDEDI para 8, será validado se a quantidade de etiquetas é menor ou igual a quantidade de volumes e em caso de positivo gravará 3 novos registros da DDR e DDW, consequentemente.

Para cada etiqueta será gerado um registro na tabela DDR (Etiquetas de Volumes) e na DDW(Movimento das Etiquetas), o número da etiqueta será sequencial.

O Pack Locator terá um controle do que já foi recebido/conferido, isto porque quando houver uma alteração no SIGATMS serão enviadas todas as etiquetas contidas na NF, mesmo que algumas etiquetas já estejam conferidas.

Ex: Foi gerada uma nota fiscal com 10 etiquetas e as 10 etiquetas foram enviadas para o Pack Locator. Se houver uma inclusão de 2(duas) etiquetas para a mesma nota fiscal, serão enviadas as 12 doze etiquetas para o  Pack Locator.

Caso o transportador altere a quantidade de etiquetas de 10 para 8 após o envio das etiquetas para o PACK LOCATOR, através do campo (DTC_QTDETI). Será chamada a rotina TMSA055 que enviará as 8 etiquetas ativas, assim o  Pack Locator deverá excluir as etiquetas que não foram enviadas.

        Caso seja realizada a Exclusão do documento do cliente (TMSA050), será chamada a rotina TMSA055 para excluir todas as etiquetas referentes ao documento do cliente. A rotina de Manutenção de Etiquetas (TMSA055), ao receber a exclusão do TMSA050, enviará para o  Pack Locator a mensagem (DocumentsxVolume) como "delete"  para todas as etiquetas do documento do cliente.

 4.       Cadastro de Etiquetas (TMSA055)

Além da geração automática das etiquetas, também existe o Cadastro de Etiquetas(TMSA055) para que o usuário possa incluir uma nova etiqueta.

Nesta tela o transportador poderá incluir uma nova etiqueta, com um número sequencial, amarrando assim a etiqueta com um documento do cliente já inserido no sistema através da tabela DTC, rotina TMSA050.

Além de incluir uma etiqueta e amarrar com o documento do cliente já cadastrado, o usuário poderá efetuar a impressão da etiqueta, através da opção Ações Relacionadas/Imprimir. 

Essa rotina exibirá todos as etiquetas da nota fiscal posicionada, permitindo que o usuário selecione quais as etiquetas serão impressas.

Ao incluir etiquetas para o documento do cliente será atualizado o campo DTC_QTDETI, referente ao documento do cliente que a etiqueta incluída pertence.

A etiqueta gerada deve ser enviada para o  Pack Locator e o status da etiqueta será (1=Aguard. Conf.NF). Vale ressaltar que serão enviadas todas as etiquetas contidas no documento do cliente, mesmo etiquetas que possivelmente já tenham sido enviadas para o  Pack Locator, através da mensagem (DocumentsxVolume), com isso o  Pack Locator fará o controle se a etiqueta já está contida na sua base de dados.

Em caso de exclusão parcial de etiquetas de uma nota fiscal será enviado a mensagem (DocumentsxVolume) com o evento "upsert".

O PACK LOCATOR analisará a mensagem (DocumentsxVolumes), e caso exista(m) etiqueta(s) na mensagem que não constam no  Pack Locator estas serão incluídas no  Pack Locator.

Caso existam etiquetas para a nota fiscal na base do  Pack Locator e não existir na mensagem (DocumentsxVolume) o  Pack Locator entenderá que as etiquetas foram excluídas do  SIGATMS.

Por fim, caso existam etiquetas na mensagem e no  Pack Locator, estas serão ignoradas pelo  Pack Locator. (Ficará a cargo do PACKLOCATOR definir se ignorará as etiquetas ou se fará alguma atualização, como data e hora do envio por exemplo.)

Se o parâmetro MV_TMSCOBR estiver habilitado, quando houver uma nova etiqueta inserida através da rotina TMSA055, o lote ao qual a nota fiscal pertence deverá ser atualizado com o status “Bloqueio Conf.Nf”, (DTP_STATUS = 6).

5.       Impressão de Etiquetas 

Independente da impressão das etiquetas será gerado a tabela DDR, com os dados das etiquetas e das notas ficais do cliente, a diferença será no campo DDR_FIMP, já que se a impressão for realizada o campo terá o conteúdo = 1 (Impresso), caso contrário seu conteúdo será = 0 (Não Impresso).

Será disponibilizada a impressão das etiquetas na da rotina TMSA050. Através do pergunte (SX1), para a impressão das etiquetas. Neste pergunte deverá constar as seguintes perguntas:

• • • Data de;
    • Data ate;
    • Remetente de;
    • Remetente ate;
    • Loja de;
    • Loja Até;
    • Etiqueta de;
    • Etiqueta ate;
    • NF de;
    • NF ate.

Após o preenchimento dos perguntes deverão ser apresentadas as etiquetas que obedecem o critério dos perguntes informados, através de um markbrowse para que o transportador marque as etiquetas serão impressas.

O usuário poderá escolher como será a sequência de impressão: POR PRODUTO, POR PRODUTO E CLIENTE OU POR NOTA FISCAL E CLIENTE.

A impressão da etiqueta também poderá ocorrer através da rotina Manutenção de Etiquetas (TMSA055), onde o transportador acessará as etiquetas da nota fiscal e poderá acessar a opção Ações Relacionadas/Imprimir, será perguntado quantas vias serão impressas.

 6.       Ordem de Impressão e Reimpressão.

A ordem de impressão das etiquetas é a informação exibida na etiqueta. Ex: 1/10, significa que esta etiqueta é a primeira que foi impressa num total de 10 etiquetas referentes aquela nota fiscal.

Não significa que é a ordem de geração da etiquetas, já que a etiqueta (A) pode ser gerada antes da (B), porém a etiqueta (B), pode ser impressa antes da (A).

O Transportador terá a opção de reimprimir determinadas etiquetas, respeitando a ordem de impressão.

 7.       Etiquetas em conferência pelo PACK LOCATOR

O Pack Locator enviará a mensagem (DocumentsxVolume) para o SIGATMS, informando que iniciou uma determinada operação. Ex: Conferência de Nota Fiscal x Volumes. Através desta notificação o status da etiqueta será alterado para 2 “Em Conferência”. Com isso o Protheus evitará que etiquetas que estão sendo conferidas sejam excluídas no Protheus. Para isso as etiquetas com status 2 “Em conferência”, não poderão ser excluídas, também não poderão ser geradas novas etiquetas para a mesma nota fiscal das etiquetas em conferência.

 8.       Exclusão de Etiquetas(TMSA050/TMSA055)

Somente poderão ser excluídas etiquetas que estejam com os seguintes status (1=’Aguardando Conf. Etiq’).

Quando houver a tentativa de exclusão da etiqueta através da rotina Manutenção de Etiquetas (TMSA055), será verificado o status desta etiqueta, caso a mesma esteja com o status “Em Conferência”, não será permitida a exclusão da mesma, já que o Pack Locator estará fazendo a conferência das etiquetas.

Caso as etiquetas estiverem com status igual a 3 (“Conf.NF”) ou 4 (“FALHA NF.”). A etiqueta só será excluída se a nota fiscal for excluída, porém neste caso a chamada será realizada pela rotina TMSA050, passando pelo TMSA055.

Observação: Mesmo a exclusão sendo realizada através do TMSA050, deveremos aproveitar o modelo gerado no TMSA055, para executarmos a IntegDef.

Caso a tentativa de exclusão seja realizada através da rotina Entrada Dc.Cliente (TMSA050), será verificado se existe etiqueta para este documento. Caso exista, serão utilizadas as mesmas regras do TMSA055.

 9.       Retorno do Pack Locator Sem Falhas

Após a conferência da nota fiscal x etiquetas o  Pack Locator enviará o retorno para o SIGATMS.

Se todas etiquetas forem conferidas com sucesso, no retorno do  Pack Locator (xml), constará a número da nota fiscal conferida, assim como série, CNPJ do remetente, filial de origem da nota fiscal e produto da nota fiscal.

O SIGATMS ao receber o XML sem falha, atualizará todas as etiquetas contidas na nota fiscal em questão para o status Conferido (DDR_STATUS = ‘3’). Posteriormente será atualizado automaticamente o status do lote ao qual pertence a nota fiscal conferida. Este lote ficará com o status “Em Aberto” (DTP_STATUS = 1) ou “Digitado” (DTP_STATUS = 2), a definição do status dependerá do lote se a quantidade de notas do lote for a mesma que a quantidade de notas fiscais informadas.

 10.    Retorno do Pack Locator Com Falhas

Se na conferência da nota fiscal x etiquetas houver alguma falha o  Pack Locator retornará no XML o número da(s) etiqueta(s) além das informações: número da nota fiscal conferida, série, CNPJ do remetente e a filial de origem da nota fiscal. Posteriormente será atualizado o status do lote ao qual pertence a nota fiscal conferida. Este lote ficará com o status o “Bloqueio p/ Falha”  (DTP_STATUS = ‘7’)  e será gerado um “Bloqueio p/ Falha” na rotina de Manutenção de Bloqueios(TMSA029).

 11.    Cadastro de Usuários

Os usuários que utilizaram o  Pack Locator deverão ser cadastrados no próprio  Pack Locator.

Em determinadas rotinas será enviado o nome do usuário para o SIGATMS, para que seja apresentado quando necessário.

 12.    Cadastro de Veículo (OMSA060) 

Os veículos serão enviados para o  Pack Locator, junto com a viagem na qual ele pertence. A validação para verificar se o veículo existe ou se possui viagem atrelada a ele será realizada pelo PACK LOCATOR. Já que o SIGATMS enviará os dados do veículo junto com cada viagem.

 13.    Cadastro de Filiais

O cadastro de filiais será enviado pelo Protheus através de uma mensagem única. Com isso o  Pack Locator receberá os dados das filiais cadastradas no SIGATMS.

 14.    Cálculo do Frete

• • MV_TMSCOBR == .T.

Com o  parâmetro MV_TMSCOBR habilitado, o cálculo do frete só será realizado se as conferências de todas as etiquetas dos documentos foram realizadas pelo coletor de dados.

Para consistir essa validação quando o lote for gerado seu status (DTP_STATUS) será = 6 (Bloqueio Conf.Nf), esse status será alterado se a conferência de todas etiquetas pertencentes as notas fiscais do lote estiverem com status (DDR_STATUS): 1(Conf.NF).

O novo status do lote será de acordo com a regra já existente no TMS, ou seja, Quantidade de Notas Digitadas igual a Quantidade de Notas do Lote, status do lote será: 2(digitado), caso contrário o status será: 1(Em Aberto).

• • MV_TMSCOBR == .F.

Com o parâmetro MV_TMSCOBR desabilitado, o status do lote continuará respeitando as regras existentes hoje no SIGATMS, ou seja, Quantidade de Notas Digitadas igual a Quantidade de Notas do Lote, status do lote será: 2(Digitado), caso contrário o status será: 1(Em Aberto).

 15.    Liberação  de Etiquetas

• • • Liberação de rotinas com falhas na conferência das etiquetas

Quando houver falha na conferência de etiquetas em um dos processos da integração, o processo será bloqueado devido a falha na conferência.

Porém existirá a possibilidade do transportador configurar a rotina Manutenção de Bloqueios(TMSA029) que trabalhará com bloqueio e liberação de registro. Caso a rotina que houve falha na conferência estiver configurada para gerar o bloqueio, o bloqueio será gerado na tabela DDU.

Após a liberação, o status da etiqueta será atualizado de acordo com a ação que gerou o bloqueio.

Exemplo:  

Ex: Bloqueio gerado pela ação Conferência de Etiquetas

Conferido, Carregado ou descarregado, dependendo da ação que gerou o bloqueio.

• • • Liberação de rotinas com etiquetas aguardando conferência

O transportador pode ter a necessidade de seguir um processo mesmo que a etiqueta não tenha sido conferida.

Ex: O transportador gerou etiquetas para uma determinada nota fiscal e devido a algum problema no coletor não conseguirá efetuar a conferência.

Para  resolver a situação acima, se o transportador desligar um dos parâmetros (MV_INTVENT = .F. ou MV_TMSCOBR = .F.) ele poderá dar andamento ao processo efetuando o cálculo do frete.

Já para os processos de carregamento e descarregamento a contingência será realizada no  Pack Locator que por sua vez deverá enviar a mensagem (LoadingAndUnloading), informando que o carregamento ou o descarregamento foi realizado como contingência.

 16.    Conferência do Carregamento via Coletor

• • • SIGATMS → Pack Locator

Como as etiquetas são enviadas para o  Pack Locator no momento da entrada do documento do cliente, na geração das etiquetas, ao incluirmos os documentos na viagem e confirma-la, enviaremos: O número da viagem, veículos, conhecimentos de transporte, notas fiscais e as filiais onde serão descarregadas cada etiqueta informada na viagem.

Sendo assim será possível que através do coletor de dados o usuário possa fazer a conferência do carregamento.

Neste momento a tabela DTA terá o campo DTA_STATUS atualizado para “0”, Aguard.Carreg. Consequentemente as etiquetas envolvidas na viagem terão seus status atualizados para “Aguardando Envio Carreg.” (DDR_STATUS = “5”). E este status será atualizado para “Aguardando Conferencia Carregamento” (DDR_STATUS = “6”) quando a mensagem única (LoadingAndUnloading) fizer o envio para o  Pack Locator.

Na tabela DDW será gerado um novo registro com o movimento da etiqueta atualizando os campos: DDW_FILORI, DDW_VIAGEM, DDW_FILDOC, DDW_DOC, DDW_SERIE.

• • • Pack Locator  → SIGATMS

A diferença no funcionamento da aplicação do  Pack Locator será que o usuário informará o número da viagem ou número do veículo para conferência e posteriormente informará todas as etiquetas conferidas no carregamento.

No momento que o usuário bipar a primeira etiqueta, o sistema identifica de qual nota é este volume e informará a quantidade de volumes a serem carregados, ao termino do processo, o sistema informará que os volumes foram carregados com sucesso.

Ao final da conferência de todos os documentos sequenciados na viagem, o usuário terá a mensagem de Viagem Carregada com Sucesso, neste momento, O  Pack Locator  retornará a mensagem (“LoadingAndUnloading”) para o SIGATMS informando que o carregamento foi realizado com sucesso.

O SIGATMS atualizará a tabela DTA, campo DTA_STATUS para “1” (Carregado).

Quando na conferência faltar alguma etiqueta, será informado ao usuário que faltam etiquetas e quais são as etiquetas faltantes.

E posteriormente será perguntado se ele desejar confirmar a conferência.

Caso o usuário confirme, será enviado o retorno para o SIGATMS via mensagem (LoadingAndUnloading), com o status que a conferência não foi realizada com sucesso. Com este retorno o SIGATMS, bloqueará a viagem.

Consequentemente na tabela DTA, campo DTA_STATUS será atualizado para “3” – Falha Carreg., logo o carregamento da viagem existente hoje no Protheus não será realizado, obrigando assim que a conferência via coletor (Pack Locator) seja realizada com todos os volumes ou que o carregamento seja liberado pela rotina de liberação.

As etiquetas que tiverem falhas serão atualizadas com o status “Falha Carregamento”, (DDR_STATUS = ‘8’)               

Importante:       

• • • • • Na conferência do carregamento/descarregamento o sistema deverá permitir que o usuário possa escolher se o filtro será realizado por veículo ou por viagem no  Pack Locator.

• • • • • Quando a integração com o  Pack Locator estiver habilitada (MV_INTVENT == .T.) e a conferência do carregamento foi obrigatório (MV_TMSCDOC == .T.), todos os carregamentos de viagens serão realizados automaticamente e efetivados após o retorno do Pack Locator.

 17.   Caso seja apontadas ocorrências no  Pack Locator, estas ocorrências serão enviadas para o SIGATMS através da mensagem “PointingOcurrences”. Mais detalhes desta mensagem em - 27. Ocorrências.

 18.    Exclusão do documento da viagem

• • Quando houver exclusão do documento em uma viagem, o sistema buscara todas as etiquetas da viagem e para cada etiqueta encontrada:
  • O sistema encontrar o último movimento da etiqueta, antes do vínculo da viagem na etiqueta. Na tabela DDW (Movimentação da Etiqueta).
  • Após encontrar o último movimento sem a viagem, incluirá um novo registro idêntico a este na tabela DDW.
  • A tabela DDR (Etiquetas) será atualizada com o mesmo status deste novo registro gerado na DDW.

Exemplo

• • Onde seguindo esse exemplo, seria inserido um novo registro na tabela DDW com Status igual a “3=Conferido NF”

 19.    Inclusão de viagens

• • Viagem Normal

Para a Viagem do tipo NORMAL, ao efetuar a confirmação da Viagem (Inclusão ou Alteração) o sistema efetua o Carregamento Automático daqueles documentos ainda não carregados e efetua seu envio ao Pack Locator.

• • Viagem Planejada

Quando se tratar de uma Viagem Planejada, serão vinculados somente os documentos a Viagem em questão ( DUD ) e não será executado o CARREGAMENTO AUTOMÁTICO, mesmo quando o Operador indicar Carregamento Automático através do parâmetro externo existente no ato da inclusão da Viagem. Também não será feito envio das informações ao  Pack Locator.

Somente no momento da confirmação da viagem, o SIGATMS:

• • • Executará o processo de Carregamento Automático dos Documentos;
    • Enviará os Documentos ao Pack Locator, solicitando seu carregamento.

• • Viagem de Redespacho

A viagem de redespacho deve ter o comportamento no carregamento idêntico a viagem do tipo normal.

Ou seja, todos os documentos incluídos na viagem de redespacho serão carregados automaticamente e efetua o envio para o Pack Locator.

• • Viagem de Socorro – Inclusão

A viagem de socorro é inserida para que ocorra a transferência de documentos que estavam contidos em uma outra viagem.

Os documentos são inseridos á viagem de socorro através do apontamento de ocorrência do tipo Transferência de Viagem, transferindo os documentos da viagem original para a Viagem de Socorro.

Ao realizar o apontamento de ocorrência do tipo Transferência de Viagem

• • • O sistema criara um registro na tabela de Carregamento (DTA) com o Status idêntico ao da Viagem Original.
    • Será incluído um registro na tabela  Movimento de Etiqueta (DDW), vinculado a viagem de Socorro.

Como não existe carregamento para a viagem de socorro, não haverá integração com o  Pack Locator.

• • Viagem de Socorro - Estorno

No estorno da ocorrência de Transferência de Viagem, o registro na tabela de Carregamento (DTA)  da nova viagem será estornado e a viagem inicial terá o status da tabela de Carregamento (DTA) será  atualizado para Carregado.

O registro da tabela  Movimento de Etiqueta (DDW) será apagado.

 20.    Estorno do Carregamento

Ao confirmar o estorno do carregamento no SIGATMS, será verificado se o carregamento pode ser estornado.

Para efetuar essa validação, será necessário verificar se o carregamento já foi realizado pelo  Pack Locator (DTA_STATUS = 2 “Carregado” ), em caso de positivo será solicitado o descarregamento junto ao  Pack Locator, já em caso de negativo será informado ao transportador que não será possível estornar o carregamento.

A posição do carregamento, (DTA_STATUS) ficará Aguardando Descarregamento.

No  Pack Locator, será possível informar o número da viagem e efetuar a conferência.

No momento que o usuário bipar a primeira etiqueta, o sistema identificará de qual nota e conhecimento de frete é este volume e informará a quantidade de volumes que devem ser descarregados referente a esta nota.

Se a conferência for realizada com o sucesso será enviado ao Protheus através da mensagem (LoadingAndUnloading) o status de descarregamento realizado com sucesso.

O campo Status de cada etiqueta descarregada será atualizado para “B” (Descarregado) e o campo Pos. Carreg.(DTA_STATUS) ficará “vazio”.

Por fim o estorno do carregamento do documento no SIGATMS. só será concretizado se todos as etiquetas contidas no documento forem descarregadas.

Para realizar o Carregamento novamente e realizar a atualização das etiquetas e atualização do registro na DTA, será necessário acessar a viagem como alteração e fazer a confirmação da mesma. Após a confirmação da viagem o status da etiqueta será atualizado para “Aguard.Envio Carreg.” (DDR_STATUS = 5), já  ao campo Pos. Carreg. da tabela de Carregamento (DTA) será atualizado para Aguardando Carregamento (DTA_STATUS = ‘1’).

Após o envio para o Pack Locator Venture através da mensagem (LoadingAndUnloading)  a etiqueta será atualizada para DDR_STATUS = ‘6’, “Aguardando Conferência Carregamento”.

 21.    Estorno do Carregamento – Falha

Se houver falha no descarregamento realizado pelo  Pack Locator o retorno da mensagem (LoadingAndUnloading), deverá informar as etiquetas que não foram descarregadas.

O SIGATMS atualizará as etiquetas com falhas com o status de “Falha Estorno de Carregamento” (DDR_STATUS = “D”) e bloqueará a viagem.

 22.    Exclusão dos registros de etiqueta 

Pensando na performance da funcionalidade, deverá ser desenvolvida uma rotina que permitirá ao usuário excluir registros da tabela de etiquetas, respeitando a integridade do módulo. Filtrando por data, CNPJ, status, etc.

Com isso o volume da tabela de etiquetas será menor.

Porém só serão excluídas etiquetas que estejam com o status de Entregue ou Não Entregue.

  23.    Descarregamento de Viagens de Transferência

Se o parâmetro MV_TMSCDES estiver habilitado, ao efetuar a chegada de viagem na filial de descarga no SIGATMS, será atualizado o status da tabela de Carregamento(DTA), campo DTA_STATUS para “3 – Aguardando Descarreg.”

As etiquetas dos documentos da viagem serão atualizadas para “Aguard.Envio Descarreg.” (DDR_STATUS = “5”), posteriormente será chamada a IntegDef da rotina TMSINTCOL), a mesma passará as informações da viagem, documentos e etiquetas para a  Pack Locator através da mensagem única (LoadingAndUnloading), na sequência atualizará o status da etiqueta para "Aguardando Conferência Descarregamento" (DDR_STATUS = “A”).

O  Pack Locator por sua vez, verificará se o volume informado está disponível para descarregamento de transferência e se o mesmo deve ser descarregado na filial onde o descarregamento está sendo executado.

Caso alguma das validações seja falsa o usuário será avisado e caso confirme o descarregamento do volume, será avisado ao usuário e o mesmo poderá efetuar o apontamento da ocorrência Sobra.

Após todo o descarregamento efetuado, o usuário finaliza o processo e o sistema  Pack Locatorverifica se todos os volumes foram descarregados corretamente.

Caso alguma irregularidade seja encontrada, as mesmas serão exibidas na tela do sistema  Pack Locator.

Ao finalizar a conferência o  Pack Locator fará chamada da mensagem única (LoadingAndUnloading), informando as etiquetas em caso de falha, além de preencher a tag TypeOfOperation com o conteúdo igual a “D”.

No  Pack Locator será possível visualizar as pendências existentes no descarregamento (Notas e Volumes faltantes).

O SIGATMS ao receber o retorno da mensagem única (LoadingAndUnloading), fará a chamada da função TMSConfEtq (TMSINTCOL.PRW), em caso de retorno com sucesso, a função fará a atualização do status do DTA, DTA_STATUS = “5 - Descarregado".

Já a tabela DUD (Movimento da Viagem), terá o status do registro atualizado para Encerrado (DUD_STATUS = ‘4’) e automaticamente será gerado um novo movimento da viagem para o documento, porém este não terá a informação da viagem para que possa ser incluído em uma viagem de entrega.

Por fim será efetuado a confirmação do apontamento da operação de descarregamento. Utilizando data e hora passada pelo  Pack Locator através da mensagem única. Caso o  Pack Locator não informe a data e hora do descarregamento, o SIGATMS utilizará a data e hora atual para geração da operação de descarregamento.

Importante lembrar, que para cada atualização de status da tabela DDR, deverá ser criado um novo registro para a tabela DDW, já que na DDW teremos o histórico de movimentação das etiquetas.

Observação:

Em caso de falha a mesma será informada ao SIGATMS, e no TMS novamente será gerado um bloqueio de viagem.

 24.    Estorno do descarregamento de viagem de transferência.

Quando for realizada o estorno da operação de descarregamento no SIGATMS, será enviado a mensagem (LoadingAndUnloading) para o  Pack Locator, informando a necessidade de um “Carregamento”. Com isso o status das etiquetas ficarão com o status de “Aguardando Envio Carreg”(DDR_STATUS = ‘5’), após o envio , o status da etiqueta ficará como “Aguardando Conferência Carregamento” (DDR_STATUS = ‘6’).

Já  o status da tabela de carregamento (DTA) será “Aguard.Carreg” (DTA_STATUS = ‘1’).

Após a conferência do carregamento do  Pack Locator, será seguido o mesmo processo de carregamento já descrito anteriormente.

 25.    Chegada de viagem eventual

No SIGATMS existe a possibilidade do transportador realizar chegas eventuais.

Ex: Viagem que estava programada para chegar na filial de São Paulo (SPO) e chegou na filial de Santos(SAN).

Para atender este processo junto à conferência de descarregamento, as orientações abaixo deverão ser seguidas.:

Considerando que a filial SPO estava prevista para a chegada da viagem:

1. 1. • Quando for realizado o apontamento da chegada de viagem na filial SAN que não está prevista. Será criado uma nova operação de chegada da viagem para a filial SAN.
      • Este apontamento ficará fechado após a informação e confirmação da data e hora da realização.

O apontamento de chegada de viagem da filial (SPO), continuará com em aberto e até este momento não será enviado nenhuma mensagem para o Pack Locator.

1. 1. • Para aqueles documentos em que o Operador desejar efetuar seu DESCARREGAMENTO via Coletor / Pack Locator, o mesmo deverá apontar a ocorrência do tipo CHEGADA EVENTUAL (“13 – Chegada Eventual”), de acordo com o padrão atual do SIGATMS.
      • Após apontar a ocorrência de chegada eventual, o SIGATMS será enviado a mensagem “PointingOccurrences”, assim como a mensagem “LoadingAndUnloading” para que seja realizado o descarregamento das etiquetas contidas nos documentos informados.
      • Com o envio da mensagem “LoadingAndLoanding”  as etiquetas terão seus status atualizados, primeiramente para “Aguardando Envio Descarregamento” (DDR_STATUS = ‘9’)e logo após enviar a ,mensagem ao Pack Locator, ficará como “Aguardando Conferência Descarregamento” (DDR_STATUS = ‘A’).

O  Pack Locator após receber as informações deverá apontar a ocorrência para os documentos informados, além de atualizar as etiquetas destes documentos para que fiquem disponíveis para um descarregamento.

O  Pack Locator ao apontar o descarregamento dos documentos de chegada eventual, enviará as informações para o SIGATMS através da mensagem “LoadingAndUnloading”.

O TMS ao receber a mensagem seguirá o mesmo processo de descarregamento (item 22.Descarregamento da Viagem de Transferência). 

Todo esse processo será executado somente quando se tratar de Chegada de Viagem Eventual e ambos os parâmetros a seguir estiverem habilitados:

• • • “MV_INTVENT” – Habilita a integração das etiquetas geradas com o  Pack Locator
    • “MV_TMSCDES” – Informa a obrigatoriedade ( .T. ) da conferência das etiquetas no descarregamento da viagem.

 26.   Estorno da chegada Eventual

1. No SIGATMS a ocorrência de chegada eventual poderá ser estornada. Quando isto for realizado, será validado se as etiquetas referentes aos documentos já foram descarregadas.
   Em caso se negativo, não será possível estornar a ocorrência de chegada eventual.
   Em caso de positivo, as etiquetas serão atualizadas para “Aguard.Envio Carregamento”, (DDR_STATUS = ‘5’) e posteriormente para “Aguardando Conferencia de Carregamento”., (DDR_STATUS = ‘6’) A tabela DTA
   (Carregamento), será atualizada para “Aguardando Carregamento” (DTA_STATUS = ‘1’)
   
   
2. Novamente serão enviadas as mensagem de "PointingOccurrences", assim como a mensagem “LoadingAndUnloading”. Desta vez será solicitado o carregamento dos documentos na viagem.

  27.   Chegada da Viagem de Entrega

Se tratando de uma viagem de entrega, o usuário poderá informar os volumes que não foram entregues.

Logo após o apontamento da chegada da viagem, o  Pack Locator permitirá que sejam informados os volumes contidos na viagem. E caso algum deste volume não seja entregue, o transportador poderá bipá-lo e ao finalizar a conferência do retorno da viagem de entrega, o  Pack Locator enviará via Web Service ao SIGATMS todos os volumes que retornaram.

O Protheus por sua vez, atualizará o status dos volumes permitindo que o volume seja utilizado posteriormente em uma nova viagem.

Caso existir, será possível visualizar as pendências no descarregamento (Notas e Volumes faltantes).

Ao finalizar a conferencia do retorno da viagem de entrega, o  Pack Locator deverá validar se foram informados todos os volumes das notas fiscais. Ou seja, se for informado 1 volume(etiqueta), de uma nota fiscal que possui 2 volumes(etiquetas), o  Pack Locator deverá avisar ao usuário a necessidade de um documento de devolução, além de questionar se o processo será seguido ou cancelado. Caso o usuário opte por seguir o processo será enviado o XML ao SIGATMS.

Retorno Total da Nota Fiscal

Se todas etiquetas de uma nota fiscal forem conferidas no retorno da viagem de entrega, o SIGATMS, atualizará o status de todas as etiquetas recebidas para DDR_STATUS == “F” (‘Não Entregue”) , para histórico da etiqueta, e posteriormente para “Conf.NF” (DDR_STATUS == “3” ) para que a nota possa ser incluída em um novo documento.

Entrega parcial da nota fiscal

Podem existir alguns produtos da nota fiscal foram entregues outros não. Neste caso será necessária a digitação de uma nota fiscal de devolução. Sendo assim as etiquetas que retornaram devem ser atualizadas para o status “Não Entregue” (DDR_STATUS == “F”) e as demais etiquetas que não retornaram deverão ser atualizadas para o status “Entregue” (DDR_STATUS == “E”).

Devido a necessidade de uma nota fiscal de devolução para a entrega parcial, as etiquetas que retornaram ficarão com o status de “Entregue”.

Para seguir o processo o transportador deverá incluir manualmente através da rotina Entrada Dc. Cliente (TMSA050), uma nota fiscal de devolução e gerando novas etiquetas para os produtos que retornaram.

 28.   Ocorrências

Será realizada a integração das ocorrências apontadas no SIGATMS através da rotina Registro de Ocorrências (TMSA360), utilizando a mensagem PointingOccurrences.

Serão enviadas todas as ocorrências apontadas para o SIGATMS com as informações: Informações da viagem, documentos da viagem, data e hora da ocorrência, código da ocorrência, motivo da ocorrência, qtde.de volumes, peso real, etc.

As ocorrências não necessariamente precisam estar vinculadas a uma viagem para serem enviadas ao  Pack Locator, caso necessário o  Pack Locator poderá filtrar os documentos da ocorrência, para encontrar as etiquetas e fazer a atualização se achar necessário.

O  Pack Locator também poderá enviar a mesma mensagem ao SIGATMS, o SIGATMS ao receber a mensagem de “PointOcurrences” fará a gravação da ocorrência através da rotina automática do Registro de Ocorrências (TMSA360) de forma automática.

Também serão integrados o cadastro de ocorrência do SIGATMS (TMSA020), através da mensagem Ocurrence. Para que o transportador possa utilizar as mesmas ocorrências no  Pack Locator.

 29.   Pendências

As ocorrências que geram pendências DT2_TIPOCO = ‘6’ (Gera Pendência), gerarão a mensagem de ’PointPendings’.  Enviando as pendências ao  Pack Locator, a mensagem “PointPending” enviará a filial onde a pendência foi apontada, número da pendência, data, hora, tipo da pendencia, descrição, além das informações do documento, viagem, ocorrência, etc.

 30.   Tipo identificação do produto

No SIGATMS é possível efetuar o cadastro de tipo de identificação do produto, para que nos apontamentos de ocorrência de sobras e faltas dos produtos possam ser identificados.

Existe um cadastro de Tipo Identificação do Produto (TMSA016), neste cadastro podemos incluir qual o tipo da identificação a ser utilizada no momento da identificação do produto. Exemplo: Podemos incluir o tipo 01 = CNPJ (Para informar o CNPJ do Remetente da Mercadoria), 02 = Etiqueta (Numero da etiqueta do Volume), entre outros.

Para integrar este cadastro será utilizada a mensagem ”ProductIdentifier”, será enviado na mensagem: o tipo, descrição, código da Picture, detalhe da Picture e filtro de pesquisa (que indica se o tipo de identificação de produto deve existir no filtro de pesquisa dos itens para conciliação de sobras e faltas).

 31.   Identificação do produto

A identificação do produto em si será enviada na mensagem de ocorrência PointingOccurrences. Com isso será enviado no mesmo momento do envio das ocorrências apontada.

Macro Processos:

Pré-requisitos instalação/implantação/utilização

• A configuração básica do TMS seja efetuada.
• A etapa de Procedimentos de Configuração, descrita neste boletim, seja efetuada.
• A configuração do PackLocator e seus respectivos processos sejam efetuados.
• Possua a aplicação do Update TMS11R184 do requisito PCREQ-151, para a funcionalidade de Bloqueio/ Liberação.

Instalação/Atualização

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo. Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si. As informações mínimas necessárias para teste tópico são:

• Procedimentos que devem ser observados quando um dos produtos for atualizado.
• Configuração necessária que deve ser realizada em arquivos de configuração ou programas de parâmetros etc.
• Arquivos diversos que devem ser mantidos em determinados locais para o funcionamento da integração, exemplo: xml, xsd.
• Atualizações necessárias em banco de dados ou instruções para que elas sejam feitas.
• Processos, módulos ou programas que precisam ser instalados ou atualizados. Deve ser definida a versão mínima necessária dos programas envolvidos.
• Ferramentas, servidores ou serviços que precisam ser disponibilizados e configurados, o que pode gerar necessidade de novo hardware ou aumento de capacidade. Exemplo: serviço de WebService.
• Instruções para habilitar a comunicação da ferramenta EAI entre as partes, quais rotas devem ser definidas ou como as transações devem ser habilitadas.

Observação: evite o uso de Prints de telas, facilitando, assim, o trabalho de tradução e versionamento deste documento.

Datasul

Insira aqui as informações pertinentes a Datasul.

Logix

Insira aqui as informações pertinentes ao Logix.

Protheus

Insira aqui as informações pertinentes ao Protheus.

Protheus

1.  Deve ser configurado os seguintes Parâmetros:

Pack Locator

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts 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 RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Transações/Entidades/Mensagens únicas

Apresente quais as transações/entidades que são trocadas e quem envia a informação para quem. Pode (e recomenda-se) ter um diagrama, uma tabela ou afins que apresente este fluxo.

Relacione quais são as mensagem únicas (TOTVSMessage) utilizadas e qual o seu relacionamento com as entidades já existentes do ERPs envolvidos.

Exemplos:

Fluxo das Informações

Para cada fluxo de informação descreva, se necessário, alterações de comportamento que o respectivo produto irá sofrer. Por exemplo: quando o Logix recebe o PEDIDO de OUTRO ERP, este pedido não poderá ser alterado no Logix.

Liste quais as entidades integradas e como é o mapeamento entre as diferentes estruturas. Por exemplo: Classe no sistema A vira categoria no sistema B, o campo X é refletido no campo Y etc.

Liste quais transações/operações a integração fará com as entidades relacionadas. Exemplo: Insert de PEDIDO, Insert, update de ITEM, buscar saldo em estoque do ITEM no dia X ou buscar dados do FUNCIONÁRIO.

Cadastros

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

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Entidade>

Identificador da Mensagem: <mensagem>

Versão: <versão>

Módulo <marca 1>: <BackOffice – Gestão xxxxxxx>

Módulo <marca 2>: <SIGAXXX>

Tipo de Envio: <Assíncrona/Síncrona>

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

A seguir descrever as variações, particularidades da mensagem e processos (integração) de acordo com cada marca

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita.

Processos

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

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Processo>

Tipo de Fluxo: Protheus -> RM

Mensagem: Request_1_000

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.

Acrescentar um diagrama do processo.

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

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita. 

Limitações / Restrições Gerais

Descreva limitações e restrições para cada fluxo descrito no tópico anterior. Exemplo:

• ERP1 envia ITEM cadastrado para o ERP2

ERP1 somente enviará o ITEM se este estiver em uma das famílias cadastradas no parâmetro FAMILIA_INTEGRACAO.

Se o tipo de valorização do estoque for FIFO.

• ERP2 envia PEDIDO cadastrado para o ERP1

O pedido recebido no ERP1 vindo do ERP2 estará bloqueado para alteração.

Como fazer (opcional)

Descreva os passos que viabilizem a integração.

Exemplo:

Os passos para viabilizar a integração são:

• No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.
• No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.
• No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
• No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
• No Protheus consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
• No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
• No Protheus verificar se foi efetuado corretamente o relacionamento entre os dois documentos.
• No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.
• No Protheus efetuar o faturamento do pedido de venda recebido.
• No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).
• No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.
• No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido está disponível no programa WMS6411 (Movimentos a Faturar).

Situações comuns (opcional)

Descreva situações problemáticas comuns que podem ocorrer durante o funcionamento da integração e como solucioná-los. Neste ponto também é importante dar instruções de como reconhecer e investigar problemas que podem vir a ocorrer durante a integração. Se houver, apresente tabelas de códigos e descrições de erros que a integração poderá apresentar.

Este tópico possivelmente será alimentado com as experiências durante o desenvolvimento da integração e poderá ser realimentado durante o uso da integração no cliente.

Exemplo 1:

Tratamento de erros de integração (Produto A)

Tratamento de erros de integração (Produto B)

Exemplo 2:

Quando uma mensagem é enviada do Logix para o Protheus, podem ocorrer situações em que o WebService não estará totalmente funcional. Nestes casos uma mensagem de erro genérica irá aparecer na tela:

Exemplo:

Erro ao enviar a mensagem de Cidade via Integração

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

Para resolver este problema, verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService. 

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

• Identificar o funcionamento da integração;
• Identificar a ocorrências de problemas;
• Coletar evidências do mau funcionamento relatado pelo cliente;
• Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos