Timer Caramuru

(Diferença entre revisões)
Ir para: navegação, pesquisa
(Parâmetro Empresa)
 
(46 edições intermediárias de 2 usuários não apresentadas)
Linha 1: Linha 1:
 +
==Apresentação==
 +
'''Olá '''
  
 +
O Objetivos deste wiki, é explicar como funciona o processo de integração e geração de viagem a partir da Caramuru dentro dos sistemas da Intersite
 +
 +
 +
===Processos Melhoria===
 +
 +
Projeto: Disponibilização Espelho do CT-e via XML
 +
Este projeto teve inicio em Janeiro de 2016.
 +
 +
Objetivo do Processo GRC: Garantir que as informações manifestada no CT-e, não tenha inconformidades fiscais, diminuir o retrabalho e agilizar o pagamento de frete.
 +
 +
 +
[http://websaf.intersite.com.br/wiki/images/6/62/Apresenta%C3%A7%C3%A3oGRC.pdf Leia o projeto na integra]
 +
 +
Jucelina@caramuru.com
 +
64-3404-0394
 +
64-9-9207-2250
 +
 +
==Diagrama do Funcionamento==
  
 
[[Arquivo:Ciclo caramuru.png]]
 
[[Arquivo:Ciclo caramuru.png]]
 +
 +
*1) Todo processo começa quando a Transportadora, envia o veiculo para carregar em determinas unidades da Caramuru, e lá e feito os tramites administrativos internos deles
 +
 +
 +
*2) Feito o carregamento, veiculo embarcado, nota fiscal eletrônica emitida e autorizada, então é disparado um e-mail com um '''XML''' para o email indicado no ato do cadastro da transportadora na Caramuru
 +
 +
 +
*3) O  [http://www.intersite.com.br/#section-produtos Sistema SITESAT ] então em determinado prazo de tempo, abre esse mesmo email, e verifica se chegou algum email enviado da Caramuru ou algum '''Controle''' como é chamado o xml.
 +
 +
 +
*4) O [http://www.intersite.com.br/#section-produtos Sistema SITESAT ] faz os devidos tratamentos, e cruzamento de informações com um [[Pedido]] padrão e então gera uma viagem no SAT.
 +
 +
 +
*5) Com a viagem '''pré montada''' dentro do SAT é hora de aplicar sobre essa viagem o [[Pedido]] que realmente irá conter todos os dados corretos ex: Frete motorista do lote, rotas, impostos, margens e outras informações de '''controle exclusivo de cada Transportadora'''
 +
 +
==Como é o modelo desse Controle enviado ?==
 +
 +
 +
O Modelo do XML enviado não pode ser lido diretamente pelo SAT, já que se trata de varias informações que necessitam de tratamento e não seguem um padrão preestabelecido oficialmente, diferentemente de uma NFe.
  
  
 
[[Arquivo:Cararm.PNG]]
 
[[Arquivo:Cararm.PNG]]
  
 +
==Requisito para uso==
 +
 +
Como o SAT nao tem um modulo de recepção e gestão de email, então é necessário a instalação do [http://www.intersite.com.br/#section-produtos Sistema SITESAT ],
 +
 +
para isso é necessário que o servidor tenha configuração básica de hardware razoável, (nesse caso entre em contato com a equipe de servidores) servidor@intersite.com.br
 +
 +
'''Não há custo adicional para instalação da função TimerCaramuru'''
 +
 +
==Como Configurar o uso==
 +
 +
Primeiramente é necessário criar um [http://websaf.intersite.com.br/wiki/index.php/Viagens-Pedidos Pedidos] padrão com os dados básicos para a Caramuru, isso porque o XML de controle enviado pode faltar informações básicas para criar a viagem
 +
 +
===Pedido Padrão===
 +
 +
Exemplo abaixo dos dados básicos para compor um Pedido
  
==Como Configurar==
 
  
  
 
[[Arquivo:Pedidopadrao.png]]
 
[[Arquivo:Pedidopadrao.png]]
  
[[Arquivo:COMOCONFIGURAR.png]]
 
  
[[Arquivo:COMOCONFIGURAR2.png]]
+
Com este pedido criado, então pode-se começar a configuração dos dados de integração
 +
 
 +
===Parâmetro Empresa===
 +
 
 +
 
 +
Em '''configurações -> Parâmetro Empresa''' aba '''6.SiteSAT''' deve ser informado no parâmetro
 +
 
 +
EmailXMLTimerCaramuru | Email que deve ser lido pelo Timer Caramuru para checar se existem XMLs a serem processados.
 +
 
 +
 
 +
ListaEmailTimerCaramuru | E-mail que será avisado pelo Timer Caramuru que XML controle foram processados
 +
 
 +
 +
CodPedidoCaramuru | Código do Pedido para usar dados padrões quando nãi vier informação completa no XML do Timer Caramuru
 +
 
 +
Existem os parametros:
 +
 
 +
CodTipoOcorrenciaCaramuru,
 +
CodPedidoCaramuru,
 +
CodGerRiscoCaramuru,
 +
EmailXMLTimerCaramuru,
 +
ListaEmailTimerCaramuru,
 +
TaxaSeguroTimerCaramuru,
 +
PropNaoTranspVeicPropTimerCaramuru,
 +
ImpViagSemNFTimerCaramuru,
 +
NaoProgramaPedCaramuru,
 +
OpEnvioEmailTimerCaramuru,
 +
UsaDtVencPedagioTimerCaramuru,
 +
UsaPedCadastradoCaramuru,
 +
UsaPPTsEfetivoTimerCaramuru,
 +
UsaFilUEPedidoPadraoCaramuru,
 +
VerOrigDestPedTimerCaramuru,
 +
VerOrigDestConhecTimerCaramuru,
 +
 
 +
Campos CFGs:
 +
 
 +
timerCaramuru - usaAdiantamentoEmpresa (String usaAdiantamentoEmpresa = GeralSis.getValorCampo("timerCaramuru", "usaAdiantamentoEmpresa", 7, em))
 +
timerCaramuru - usaFreteCombinado (String usaFreteCombinado = GeralSis.getValorCampo("timerCaramuru", "usaFreteCombinado", 7, em))
 +
 
 +
 
 +
 
 +
[[Arquivo:COMOCONFIGURAR.png|1024px]]
 +
 
 +
===Parâmetro Normal===
 +
 
 +
Em '''Configurações -> Parâmetro''' deve ser configurado os dados do Servidor IMAP que sera comunicado pelo sitesat para receber os dados , cada empresa tem suas configurações.
 +
 
 +
 
 +
OBS: Se não for cadastrado o CoderRiscoCaramuru (tabelas - auxiliares - gerenciadoras de risco) então a configuração não é feita em (tabelas - auxiliares - empresas) e sim nos parametros IMAP que fica em: (configurações - parametros - exportação/importação)
 +
 
 +
 
 +
 
 +
[[Arquivo:COMOCONFIGURAR2.png|1024px]]
 +
 
 +
==COMO FUNCIONA NO DIA A DIA==
 +
 
 +
 
 +
Depois de todas as configurações realizadas corretamente, a cada X minutos o sistema fará uma varredura no e-mail, e caso encontre um xml da caramuru, fará a interpretação básica dos dados, gerará a viagem e '''enviará um e-mail''' para avisar que existe uma viagem '''Processada''' com o numero interno.
 +
 
 +
 
 +
 
 +
[[Arquivo:RETORNOSITESAT.png|1024px]]
 +
 
 +
 
 +
Então o sistema SAT, em '''Viagens / Viagens''', pesquise pelo '''Numero Interno'''
 +
 
 +
É gerada a Viagem conforme imagem e seguindo a seguinte logica atualmente :
 +
 
 +
 
 +
====Caso 1 ====
 +
 
 +
Se remetente for terceiro (não for Caramuru)
 +
 
 +
...então
 +
 
 +
..........no xml vem o '''P.P.T CHEIO''' (e informado no campo P.P.T Empresa)
 +
 
 +
..............vem '''Pedágio por Eixo''' ( informado no campo P.P.T Pedágio e  ''deve ser multiplicado com QTDE Eixo do Veiculo para obter o Valor do Pedágio'')
 +
 
 +
====Caso 2 ====
 +
 
 +
Se remetente for Caramuru e transportador enviou veículo da frota própria
 +
 +
...então
 +
 
 +
..........no xml vem o '''FRETE EMPRESA CHEIO''' (informado no campo ''Valor Fret'')
 +
 
 +
...........se a tag no xml <CNPJFORNPEDAGIO/>
 +
 +
............então na aba '''8.CTE''', é informado o Fornecedor pedágio
 +
 
 +
..................informar o Disp. do Pedágio = TAG
 +
 
 +
..................informar o Resp. pelo Pedágio = Tomador de Serviço - 5
 +
 
 +
 
 +
====Caso 3====
 +
 
 +
se remetente for caramuru e veiculo transportador não for frota própria
 +
 
 +
...então
 +
 +
..........no xml vem o '''FRETE EMPRESA CHEIO''' (Informado no campo ''Valor FRETE'')
 +
 
 +
..................vem o '''Pedágio VEM CHEIO''' (informado direto no campo ''Valor PEDÁGIO'')
 +
 
 +
 
 +
 
 +
Feito as verificações acima, então e necessário aplicar o Pedido para complementar os outros dados da viagem
 +
 
 +
 
 +
[[Arquivo:Viagemgerada.png|1024px]]
 +
 
 +
 
 +
Veja o controle no xml do CTE
 +
 
 +
[[Arquivo:Xmlcteaut.png]]
 +
 
 +
==IMPORTANTE==
 +
 
 +
'''ESTES DOIS CAMPO SÃO OBRIGATÓRIOS'''
 +
 
 +
'''Pd.Cli.Frete:''' Dever ser obrigatoriamente  o mesmo numero do xml controle enviado
 +
 
 +
'''Load:''' deverá esta escrito obrigatoriamente ''CARAMURU''
 +
 
 +
 
 +
'''EM CASO DE CTE AUTORIZADO SEM ESTES CAMPOS, IMEDIATAMENTE É REJEITADO O XML PELO SISTEMA INTERNO DA CARAMURU'''
 +
 
 +
 
 +
*Altere os dados necessários da viagem ou então vincule um pedido na mesma para validar os dados
 +
 
 +
*Pode ser necessário criar Regras de Calculo no DACTE para obter a forma correta de uso
 +
 
 +
* para atender o novo layout que foi solicitado em 06/02/2019 é necessário  que no pedido, deve se alterar:
 +
 
 +
'''Pedágio Emb.Frete.Emp:''' desmarcada
 +
 
 +
'''Base Icms direto:''' desmarcada
 +
 
 +
'''REGRAS CTE:'''  -> COMPONENTE DA PRESTAÇÃO
 +
 
 +
...........FRETE VALOR (Frete Fiscal menos Pedágio)
 +
 
 +
...........Valor Pedágio (Valor Pedágio)
 +
 
 +
 
 +
[[Arquivo:Regrasdactecaramuru.png]]
 +
 
  
==requisitos==
+
---

Edição atual tal como 14h52min de 29 de novembro de 2023

Tabela de conteúdo

[editar] Apresentação

Olá

O Objetivos deste wiki, é explicar como funciona o processo de integração e geração de viagem a partir da Caramuru dentro dos sistemas da Intersite


[editar] Processos Melhoria

Projeto: Disponibilização Espelho do CT-e via XML Este projeto teve inicio em Janeiro de 2016.

Objetivo do Processo GRC: Garantir que as informações manifestada no CT-e, não tenha inconformidades fiscais, diminuir o retrabalho e agilizar o pagamento de frete.


Leia o projeto na integra

Jucelina@caramuru.com 64-3404-0394 64-9-9207-2250

[editar] Diagrama do Funcionamento

Ciclo caramuru.png

  • 1) Todo processo começa quando a Transportadora, envia o veiculo para carregar em determinas unidades da Caramuru, e lá e feito os tramites administrativos internos deles


  • 2) Feito o carregamento, veiculo embarcado, nota fiscal eletrônica emitida e autorizada, então é disparado um e-mail com um XML para o email indicado no ato do cadastro da transportadora na Caramuru


  • 3) O Sistema SITESAT então em determinado prazo de tempo, abre esse mesmo email, e verifica se chegou algum email enviado da Caramuru ou algum Controle como é chamado o xml.


  • 4) O Sistema SITESAT faz os devidos tratamentos, e cruzamento de informações com um Pedido padrão e então gera uma viagem no SAT.


  • 5) Com a viagem pré montada dentro do SAT é hora de aplicar sobre essa viagem o Pedido que realmente irá conter todos os dados corretos ex: Frete motorista do lote, rotas, impostos, margens e outras informações de controle exclusivo de cada Transportadora

[editar] Como é o modelo desse Controle enviado ?

O Modelo do XML enviado não pode ser lido diretamente pelo SAT, já que se trata de varias informações que necessitam de tratamento e não seguem um padrão preestabelecido oficialmente, diferentemente de uma NFe.


Cararm.PNG

[editar] Requisito para uso

Como o SAT nao tem um modulo de recepção e gestão de email, então é necessário a instalação do Sistema SITESAT ,

para isso é necessário que o servidor tenha configuração básica de hardware razoável, (nesse caso entre em contato com a equipe de servidores) servidor@intersite.com.br

Não há custo adicional para instalação da função TimerCaramuru

[editar] Como Configurar o uso

Primeiramente é necessário criar um Pedidos padrão com os dados básicos para a Caramuru, isso porque o XML de controle enviado pode faltar informações básicas para criar a viagem

[editar] Pedido Padrão

Exemplo abaixo dos dados básicos para compor um Pedido


Pedidopadrao.png


Com este pedido criado, então pode-se começar a configuração dos dados de integração

[editar] Parâmetro Empresa

Em configurações -> Parâmetro Empresa aba 6.SiteSAT deve ser informado no parâmetro

EmailXMLTimerCaramuru | Email que deve ser lido pelo Timer Caramuru para checar se existem XMLs a serem processados.


ListaEmailTimerCaramuru | E-mail que será avisado pelo Timer Caramuru que XML controle foram processados


CodPedidoCaramuru | Código do Pedido para usar dados padrões quando nãi vier informação completa no XML do Timer Caramuru

Existem os parametros:

CodTipoOcorrenciaCaramuru, CodPedidoCaramuru, CodGerRiscoCaramuru, EmailXMLTimerCaramuru, ListaEmailTimerCaramuru, TaxaSeguroTimerCaramuru, PropNaoTranspVeicPropTimerCaramuru, ImpViagSemNFTimerCaramuru, NaoProgramaPedCaramuru, OpEnvioEmailTimerCaramuru, UsaDtVencPedagioTimerCaramuru, UsaPedCadastradoCaramuru, UsaPPTsEfetivoTimerCaramuru, UsaFilUEPedidoPadraoCaramuru, VerOrigDestPedTimerCaramuru, VerOrigDestConhecTimerCaramuru,

Campos CFGs:

timerCaramuru - usaAdiantamentoEmpresa (String usaAdiantamentoEmpresa = GeralSis.getValorCampo("timerCaramuru", "usaAdiantamentoEmpresa", 7, em)) timerCaramuru - usaFreteCombinado (String usaFreteCombinado = GeralSis.getValorCampo("timerCaramuru", "usaFreteCombinado", 7, em))


COMOCONFIGURAR.png

[editar] Parâmetro Normal

Em Configurações -> Parâmetro deve ser configurado os dados do Servidor IMAP que sera comunicado pelo sitesat para receber os dados , cada empresa tem suas configurações.


OBS: Se não for cadastrado o CoderRiscoCaramuru (tabelas - auxiliares - gerenciadoras de risco) então a configuração não é feita em (tabelas - auxiliares - empresas) e sim nos parametros IMAP que fica em: (configurações - parametros - exportação/importação)


COMOCONFIGURAR2.png

[editar] COMO FUNCIONA NO DIA A DIA

Depois de todas as configurações realizadas corretamente, a cada X minutos o sistema fará uma varredura no e-mail, e caso encontre um xml da caramuru, fará a interpretação básica dos dados, gerará a viagem e enviará um e-mail para avisar que existe uma viagem Processada com o numero interno.


RETORNOSITESAT.png


Então o sistema SAT, em Viagens / Viagens, pesquise pelo Numero Interno

É gerada a Viagem conforme imagem e seguindo a seguinte logica atualmente :


[editar] Caso 1

Se remetente for terceiro (não for Caramuru)

...então

..........no xml vem o P.P.T CHEIO (e informado no campo P.P.T Empresa)

..............vem Pedágio por Eixo ( informado no campo P.P.T Pedágio e deve ser multiplicado com QTDE Eixo do Veiculo para obter o Valor do Pedágio)

[editar] Caso 2

Se remetente for Caramuru e transportador enviou veículo da frota própria

...então

..........no xml vem o FRETE EMPRESA CHEIO (informado no campo Valor Fret)

...........se a tag no xml <CNPJFORNPEDAGIO/>

............então na aba 8.CTE, é informado o Fornecedor pedágio

..................informar o Disp. do Pedágio = TAG

..................informar o Resp. pelo Pedágio = Tomador de Serviço - 5


[editar] Caso 3

se remetente for caramuru e veiculo transportador não for frota própria

...então

..........no xml vem o FRETE EMPRESA CHEIO (Informado no campo Valor FRETE)

..................vem o Pedágio VEM CHEIO (informado direto no campo Valor PEDÁGIO)


Feito as verificações acima, então e necessário aplicar o Pedido para complementar os outros dados da viagem


Viagemgerada.png


Veja o controle no xml do CTE

Xmlcteaut.png

[editar] IMPORTANTE

ESTES DOIS CAMPO SÃO OBRIGATÓRIOS

Pd.Cli.Frete: Dever ser obrigatoriamente  o mesmo numero do xml controle enviado 
Load: deverá esta escrito obrigatoriamente CARAMURU


EM CASO DE CTE AUTORIZADO SEM ESTES CAMPOS, IMEDIATAMENTE É REJEITADO O XML PELO SISTEMA INTERNO DA CARAMURU


  • Altere os dados necessários da viagem ou então vincule um pedido na mesma para validar os dados
  • Pode ser necessário criar Regras de Calculo no DACTE para obter a forma correta de uso
  • para atender o novo layout que foi solicitado em 06/02/2019 é necessário que no pedido, deve se alterar:

Pedágio Emb.Frete.Emp: desmarcada

Base Icms direto: desmarcada

REGRAS CTE: -> COMPONENTE DA PRESTAÇÃO

...........FRETE VALOR (Frete Fiscal menos Pedágio)

...........Valor Pedágio (Valor Pedágio)


Regrasdactecaramuru.png


---

Ferramentas pessoais
Espaços nominais

Variantes
Ações
WebSaf
SAT Tabelas
SAT Auxiliares
SAT Cadastros
SAT Viagens
Painéis
SAT Financeiro
SAT Relatórios
Exportação - Importação
SAT Manuais/Processo
CTe
Layouts
Integrações
FAQ-Perguntas Frequentes
Apps InterSite
Diagramas
Configurações
Política de Privacidade
Ferramentas