Árvore de páginas


CONTEÚDO

01. VISÃO GERAL

Esta rotina permite colher informações dos comprovantes de entrega dos CT-es, no momento do apontamento de ocorrência configurada como encerramento do processo de entrega, e enviá-las à SEFAZ utilizando o TSS (TOTVS Service SOA).

Ela é composta por um monitor de envio à SEFAZ, e uma tela na qual podem ser complementadas as informações que serão enviadas à SEFAZ, solicitar o cancelamento de um evento anterior de envio, ou ainda, monitorar os envios e recebimentos dos retornos da SEFAZ.

Sempre que for utilizada uma ocorrência do tipo Encerra processo, que esteja configurada como Comprovante de Entrega igual a Sim, durante o apontamento de ocorrências o Sistema armazenará os dados do CT-e e da Nota Fiscal, e o usuário deverá complementar com os dados do recebedor da mercadoria, seu documento de identificação e imagem do respectivo comprovante. Estas informações permanecem disponíveis para envio à SEFAZ.

Observar que a nova funcionalidade Comprovante de Entrega Eletrônico (TMSAE71) é diferente da rotina padrão Comprovante de Entrega (TMSA570) que trata-se de uma carta que pode ser impressa e enviada aos clientes, na qual são listados todos os canhotos de suas notas fiscais onde o objetivo é comprovar, através da assinatura do cliente, que a carga foi entregue na data determinada.

IMPORTANTE!

Para que a rotina de Comprovante de Entrega possa ser utilizada, o campo Comprov. Ent. (DT2_CMPENT) deve estar configurado como Sim no cadastro de Ocorrências, para envio dos eventos de comprovante de entrega.

02. PROCESSO DE UTILIZAÇÃO

  1.  No cadastro de tabela de  ocorrências, quando o tipo de ocorrência for igual encerra processo, o envio do evento ocorrerá automaticamente, sendo que a ação de transmissão ocorrerá somente para documentos do tipo CT-e.

  2.  Ocorrências anteriormente cadastradas na rotina tabela de  ocorrências, devem ser ajustadas no caso de necessidade de utilização neste processo (o campo Comprov. Ent. (DT2_CMPENT)).

  3.  Após o apontamento de ocorrência do tipo Encerra processo, no qual o campo comprovante de entrega deve estar configurado como Sim, o documento CT-e deverá ser monitorado.

Envio de Eventos Parciais

No processo de evento de comprovante de entrega não serão transmitidos eventos parciais. Desta forma, todas as Notas Fiscais contidas no documento CT-e receberão a mesma ação de envio ou cancelamento.

Motivo
A Nota Técnica 2019.001, Comprovante de Entrega Eletrônico - Versão 1.00 – Maio de 2019, informa que neste momento os eventos relacionados abaixo devem transitar dados relacionados aos documentos do tipo CT-e. Os eventos futuramente serão propagados nas notas fiscais eletrônicas relacionadas de forma automática.

  1.  Evento Comprovante de Entrega do CT-e
     Função: Evento para indicar a efetivação da entrega da carga pelo transportador.

  2.  Evento Cancelamento do Comprovante de Entrega do CT-e
     Função: Evento para indicar o cancelamento de um evento da entrega da carga pelo transportador nas ocasiões onde ocorrer erro na geração do evento de entrega.

Exemplo
Quando ocorre uma situação que pode gerar evento parcial?
Por que estes não são transmitidos a SEFAZ desta forma?

Citaremos abaixo um exemplo no qual pode ocorrer a situação de evento parcial, e nesta situação o usuário deve optar pelo apontamento de uma ocorrência do tipo encerra processo (01) ou uma ocorrência diferente, por exemplo do tipo Retorna Documento (04) :

  1.  Documento tipo CT-e emitido, onde há 7 NF-es a este vinculadas.
  2.  Ao realizar procedimento de entrega das NF-es mencionadas, ocorre:
    • A entrega com sucesso (normal) de 4 NF-es;
    • Retorno de documento de 3 NF-es;
  3.  Ao realizar o processo de apontamento de registro de ocorrências para o documento CT-e e caso decida-se realizar o apontamento de uma ocorrência de encerra processo, na tela de Ajuste Comprovante de Entrega, ocorrerá o envio de evento para todas as Notas Fiscais Eletrônicas que estão vinculadas.
  4.  Contudo, caso se decida realizar o apontamento de uma ocorrência do tipo Retorna Documento, não haverá ação de envio de eventos, ou seja, o processo padrão do módulo de Gestão de Transportes (SIGATMS) - Registro de Pendências deve ser seguido a partir daqui.
    Motivo: 
    Conforme destacamos anteriormente, os envios parciais serão tratados pelo órgão validador SEFAZ futuramente. Desta forma e em atendimento a Nota Técnica vigente publicada em Maio de  2019, os envios ocorrerão somente de forma total para as notas fiscais constantes nos documentos do tipo CT-e.

aNo Browse do Registro de Ocorrências 

Procedimento Para Utilização

  1.  No SIGATMS, clique em Atualizações > Ocorrências > Registro de Ocorrências.

  2.  Na tela Registro de Ocorrências, clique em Apontar.

  3.  Informe a ocorrência do tipo 01 - encerra processo.

  4.  Clique em Salvar.

  5.  Ao lançar a ocorrência será apresentada uma tela na qual deve ser definido se serão informados dados no momento do apontamento, opção Sim - tela Ajuste Comprovante de Entrega (TMSAE71B) ou opção Não para que seja dado continuidade ao processo padrão existente e posteriormente lançado os dados de comprovante de entrega na mesma rotina. Maiores informações detalhadas abaixo item 03. TELA DE PAINEL ACOMPANHAMENTO DE ENTREGAS, opção "a".
     Importante!
     Lembrando que a configuração da ocorrência do tipo de encerra processo deve estar configurada para envio de eventos no cadastro da rotina tabela de  ocorrências;

  6.  Na tela de Ajuste Comprovante de Entrega (TMSAE71B), informe os campos obrigatórios para a transmissão de evento do comprovante de entrega: Nome do recebedor da mercadoria, número do documento do recebedor da mercadoria e o local da imagem  (diretório completo mais o nome do arquivo com extensão) .

  7.  Clique em Confirmar.

  8.  A partir deste momento o documento estará apto para a transmissão de eventos do comprovante de entrega junto a SEFAZ.

  9.  Para dar continuidade ao processo acesse a rotina de Monitor Comprovante de Entrega (TMSAE71A), detalhada abaixo item 03. TELA DE PAINEL ACOMPANHAMENTO DE ENTREGAS, opção "b".

b.  Na Chamada de Menu de Ocorrências

Opções disponíveis em:

  1.  Atualizações > Ocorrências > Ajuste Comprovante de Entrega (TMSAE71B).
  2.  Atualizações > Ocorrências > Monitor Comprovante de Entrega (TMSAE71A).

c. No Browse da Abertura de Viagens

Procedimento Para Utilização

  1.   No SIGATMS, clique em Atualizações > Rodoviário Entrega - Viagem Modelo 2.
  2.   Na tela Viagem Modelo 2, posicione na viagem.
  3.  Clique em Outras Ações > Manutenção > Ocorrências.
  4.  Clique em Apontar;
  5.  Informe a ocorrência do tipo 01 - encerra processo.
  6.  Clique em Salvar.
  7.  Ao lançar a ocorrência será apresentada a tela na qual deve ser definido se  serão informados dados no momento do apontamento:
    1.  Sim - tela Ajuste Comprovante de Entrega (TMSAE71B).
    2.  Não - para que seja dado continuidade ao processo padrão existente e posteriormente lançado os dados de comprovante de entrega na mesma rotina.
       Informações detalhadas podem ser obtidas no item 03. TELA DE PAINEL ACOMPANHAMENTO DE ENTREGAS, opção "a".
      Importante!
      Lembrando que a configuração da ocorrência do tipo de encerra processo deve estar configurada para envio de eventos no cadastro da rotina tabela de  ocorrências;
  8.  Na tela de Ajuste Comprovante de Entrega (TMSAE71B) devem ser informados os campos obrigatórios para a transmissão de evento do comprovante de entrega: Nome do recebedor da mercadoria, número do documento do recebedor da mercadoria e o local da imagem  (diretório completo mais o nome do arquivo com extensão) .
  9.  Clique em Confirmar.
  10.  À partir deste momento o documento estará apto para a transmissão de eventos do comprovante de entrega junto a SEFAZ.
  11.  Para dar continuidade ao processo acesse a rotina de Monitor Comprovante de Entrega (TMSAE71A), detalhada abaixo no item 03. TELA DE PAINEL ACOMPANHAMENTO DE ENTREGAS, opção "b".

d. Após a Confirmação da Tela de Apontamento de Ocorrências

Após a confirmação da ocorrência na rotina de registro de ocorrências (TMSA360), conforme informamos acima nos itens 5. No Browse do Registro de Ocorrências e 7. No Browse da Abertura de Viagens será apresentada a tela de Ajuste Comprovante de Entrega (TMSAE71B).

Conforme detalhamento a seguir, no item 03. TELA DE PAINEL ACOMPANHAMENTO DE ENTREGAS.

03. TELA DE PAINEL ACOMPANHAMENTO DE ENTREGAS 

a. Ajuste Comprovante de Entrega

Após confirmar na tela de apontamento de ocorrências é apresentado um alerta para que sejam informados os dados para  comprovante de entrega - Tela de Ajuste Comprovante de Entrega.

Esta ação é opcional (imagem abaixo), para que sejam informados os dados no momento do apontamento ou para que seja dado continuidade ao processo padrão existente e, posteriormente, lançados os dados do comprovante de entrega na mesma rotina (Ajuste Comprovante de Entrega)Neste caso será herdada a ocorrência que foi apontada para o documento CT-e.


A tela de ajuste de comprovante de entrega terá novos campos para os dados do comprovante de entrega, sendo os relacionados abaixo dados passíveis de alteração: 

CampoDescrição
NomeReceberá dados (nome) de quem recebeu a mercadoria.
DocumentoReceberá dados (documento) de quem recebeu a mercadoria.
Imagem

Acesso à imagem (arquivo de foto) vinculado.
Para a inclusão da imagem deverão ser seguidos os seguintes passos:

  1.  Clique em Outras Ações > Selecionar Compr. Entrega.
  2.  Na tela de seleção de imagem, localize o diretório e a pasta onde a imagem está localizada.
  3.  Selecione a imagem.
  4.  Clique em Salvar.
  5.  No retorno à tela principal, clique duas vezes em <<IMAGEM>>.
  6.  A imagem selecionada será apresentada na tela Visualização da Imagem.

b. Monitor Comprovante de Entrega

A tela Monitor de Transmissão de Eventos Comprovante de Entrega, demonstra os documentos CT-e aptos ao processo de transmissão de Eventos Comprovante de Entrega.

ParâmetroDescrição
Remetente de:Código Inicial do Cliente Remetente
Loja de:Código Inicial da Loja Cliente Remetente
Remetente até:Código Final do Cliente Remetente
Loja até: Código Final da Loja Cliente Remetente
Data de:Data inicial para consulta dos dados , referente a data de entrega da mercadoria ou do apontamento de ocorrências.
Data até:Data final para consulta dos dados , referente a data de entrega da mercadoria ou do apontamento de ocorrências.
Status Evento 

Permite filtrar os documentos com base nos status dos eventos de comprovante de entregas sendo as opções:

0 - Todos;
1 - Aptos;
2 - Não aptos;


A tela Monitor Comprovante de Entrega está disposta em duas seções:

  • Documentos Transportados

Nesta seção serão apresentados os dados do CT-e: Nome do recebedor da mercadoria, número do documento (RG, CPF, CNH) do recebedor da mercadoria e campo para informar o local da imagem (caminho do diretório onde esta localizada a imagem, diretório completo mais o nome do arquivo com extensão) - relacionados ao evento de comprovante de entrega e demais  informações da DT6 - Documentos de Transporte.

Os documentos desta seção podem possuir dois status, conforme legenda da rotina:


  • Notas Fiscais x Documentos

Nesta seção serão apresentadas as Notas Fiscais vinculadas ao documento CT-e, informações de tipo de evento e status, conforme demonstra a legenda da rotina:


A Legenda do Monitor demonstra a indicação de transmissão e entrega (status), detalhadas abaixo:

Status / SituaçãoDescrição

Laranja - 
0 - Integração Meu-Checklist

Documentos que possuem integração com o aplicativo TOTVS Meu-Checklist.

Informações adicionais podem ser obtidas no documento: Integração Checklist x Ocorrência de Entrega Automática x Comprovante Entrega.

Vermelho -
1 - Não Apto

Documento já com apontamento de ocorrência, indicando Sim para Envio do Evento.

Documento pendente, pois faltam informações obrigatórias no layout e de todas as NF-es vinculadas a ele e com tal apontamento de ocorrência.

Verde -
2 - Apto

Documento com todas as informações obrigatórias indicadas e aguardando comunicação e entrega ao respectivo órgão.

Amarelo -
3 - Enviado

Transmissão ao respectivo órgão efetuada com sucesso e aguardando obter o retorno (transmissão assíncrona).

Importante!

Verifique as informações deste item na seção de Cancelamento, item 4. 

Azul -
4 - Autenticado

Sucesso no recebimento e retorno bem sucedido por parte do órgão responsável.

Importante!

Verifique as informações deste item na seção de Cancelamento, item 4. 

Preto -
5 - Rejeitado

Rejeição da entrega/recebimento do evento por parte do órgão responsável, sendo informado o motivo da rejeição pelo mesmo.


A rotina Monitor Comprovante de Entrega possui três opções:

  1.  Transmitir: permite transmitir o evento de comprovante de entrega para documentos aptos.
  2.  Cancelar: permite executar a solicitação de Cancelamento Manual do Evento; 
  3.  Refresh: permite consultar o TSS (TOTVS Service SOA), que solicita o status junto ao órgão validador SEFAZ, para saber se o registro está autenticado ou não.




Observações:

  • Para CT-es que estejam com o status Não Apto para Transmissão haverá acesso direto a tela de Ajuste Comprovante de Entrega , seguindo a mesma regra de apresentação e validações quando apresentada em tempo de Apontamento de Ocorrências.
  • O CT-e somente passará para Apto e Aguardando Transmissão quando todas as NF-es apresentarem todas as informações obrigatórias.

Procedimento Para Utilização

  1.  No SIGATMS, clique em Atualizações > Ocorrências > Monitor Comprovante de Entrega (TMSAE71A).

  2.  Na seção Documentos Transportado, selecione o documento CT-e.

  3.  Na seção Notas Fiscais x Documentos ocorrerá o posicionamento no último registro (última NF da lista apresentada).

  4.  Clique em Transmitir.

  5.  A transmissão/comunicação com o TSS (TOTVS Service SOA) será iniciada.

  6.  Posteriormente, as as Notas Fiscais listadas na seção Notas Fiscais x Documentos receberão o status de acordo com retorno do órgão validador SEFAZ e legendas da rotina.

IMPORTANTE!

Tamanho das Imagens:
  • Devido a necessidade de utilizar imagens para gerar o Hash do comprovante de entrega por meio da tag hashEntrega, é necessário tomar cuidado quanto ao tamanho das imagens que serão utilizadas, para evitar erros do tipo String Size Overflow (Estouro de tamanho da String).
  • Recomenda-se que as imagens tenham o tamanho menor que 1024 bytes, ou seja, menor que 1Mb. Caso seja necessário aumentar este limite deve-se entrar em contato com o Administrador do Sistema, para avaliar a necessidade e configurar o Appserver para considerar o tamanho da string de dados, ajustando conforme a necessidade.
  • Acesse o link MaxStringSize para visualizar a documentação que detalha como configurar o redimensionamento do tamanho da String de Dados.

04. CANCELAMENTO DO EVENTO

Antes do detalhamento do processo de cancelamento, é necessário informar:

  1.  Quando os documentos estiverem com o status Aguardando retorno da Transmissão ou Evento entregue com sucesso, o processo de Estorno da Ocorrência será impedido de ser executado, até que ocorra a solicitação de cancelamento e a devida autorização desse evento de cancelamento.  
  2.  A tela de Monitor será aberta para que o Operador acompanhe o processo de cancelamento, ou seja, para que este possa verificar os status da solicitação de cancelamento.   Esta tela ajudará o Operador neste acompanhamento.
  3.  Somente após a autorização do evento de cancelamento ocorrerá o estorno efetivo da Ocorrência.
  4.  O processo de cancelamento do envio de comprovante de entrega pode ocorrer de forma Automática ou Manual, conforme descrito a seguir:

a. Cancelamento Automático

O processo de cancelamento do envio de comprovante de entrega de forma automática ocorre quando é utilizado, na rotina de Registro de Ocorrências, o processo de estorno de ocorrências.

Processo de Utilização

  1.  No SIGATMS, clique em Atualizações > Ocorrências > Registro de Ocorrências (TMSA360).

  2.  Na tela Registro de Ocorrências, selecione/posicione um registro.

  3.  Clique em Outras Ações > Estornar.

  4.  Na tela apresentada, confirme os dados e altere o campo Estorna (DUA_ESTOCO) para Sim.

  5.  Clique em Confirmar.

  6.  Ao realizar este procedimento é gerado novo registro na tabela de Eventos do Comprovante de Entrega (DLY) para o documento do tipo cancelamento, sendo assim, o registro permanece pronto para nova utilização/transmissão.

  7.  Clique em Atualizações > Ocorrências > Monitor Comprovante de Entrega (TMSAE71A).

  8.  Na seção Documentos Transportados, selecione o documento CT-e.

  9.  Na seção Notas Fiscais x Documentos ocorrerá o posicionamento no último registro (última NF da lista apresentada).

  10.  Clique em Cancelar.

  11.  Será iniciado a transmissão/comunicação com o TSS (TOTVS Service SOA) para envio de evento de cancelamento.

  12.  Posteriormente, as Notas Fiscais da seção Notas Fiscais x Documentos receberão o status de acordo com retorno do órgão validador SEFAZ e legendas da rotina.

b. Cancelamento Manual

O processo de cancelamento do envio de comprovante de entrega de forma manual ocorre na própria rotina de Monitor de Comprovante de Entrega.

Processo de Utilização

  1.  Clique em Atualizações > Ocorrências > Monitor Comprovante de Entrega (TMSAE71A).

  2.  Na tela Monitor de Transmissão de Eventos Comprovante de Entrega, na seção Documentos Transportados, selecione/posicione um registro documento CT-e .

  3.  Na seção Notas Fiscais x Documentos ocorrerá o posicionamento no último registro (última NF da lista apresentada).

  4.  Clique em Cancelar.

  5.  Será iniciado a transmissão/comunicação com o TSS (TOTVS Service SOA) para envio de evento de cancelamento.

  6.  Posteriormente, as Notas Fiscais listadas na seção Notas Fiscais x Documentos  receberão o status de acordo com retorno do órgão validador SEFAZ e legendas da rotina.

IMPORTANTE!

  • Assim como no processo de evento de comprovante de entrega, não serão transmitidos eventos parciais no processo de cancelamento. Desta forma, todas as Notas Fiscais contidas no documento CT-e receberão a mesma ação de cancelamento.
  • Os envios parciais serão tratados pelo órgão validador SEFAZ, futuramente.

05. TABELAS UTILIZADAS

  • DLY - Eventos do Comprovante de Entrega
  • DM0 - Imagens Comprovante de Entrega
  • DT2 - Tabela de Ocorrências
  • DT6 - Documentos de Transporte
  • DUA - Registros de Ocorrências

06. ASSUNTOS RELACIONADOS