Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| - Como pré-requisito para utilização do processo de Nota Fiscal Eletrônica é necessário registrar algumas DLLS:
capicom.dll msxml5.dll Na pasta dos executáveis do SARA existe um .bat "Registrar_capicom_msxml5_msxml5r.bat", para realizar esta operação. Executar este arquivo como Administrador: - Deve ser realizada a instalação do Certificado Digital tipo A1. No momento da instalação deve ser marcado a opção (Marcar esta chave como exportável)
Image Added
Para que a integração possa ser ativada no sistema SARA, primeiramente deve possuir a solução do aplicativo Meu Checklist da TOTVS e um roteiro cadastrado no aplicativo que obedeça as seguintes regras: Os itens do roteiro do checklist deverão ser cadastrados com o padrão [código da parte do contêiner] - [descrição da parte do contêiner] (exemplo: 1 - LATERAL DIREITA). Os códigos de parte de contêiner deverão obrigatoriamente existir no sistema SARA;As opções do item de roteiro de checklist deverão ser cadastrados com o padrão [código da avaria de contêiner] - [descrição da avaria de contêiner] (exemplo: 2C - CORTADO). Os códigos da avaria deverão obrigatoriamente existir no sistema SARA. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| O sistema SARA só será capaz de se comunicar com o serviço do aplicativo Meu Checklist possuindo os dados para autenticação e acesso ao cliente. Desse modo, deverá ser configurado no arquivo formato "INI" do SARA, utilizado para identificar as configurações de acesso a base de dados. Os seguintes novos itens devem ser configurados conforme modelo sugerido abaixo: Bloco de código |
---|
language | text |
---|
theme | Eclipse |
---|
title | Modelo de configuração |
---|
| [MEU_CHECKLIST_CONFIG]
encrypted=0
clientid=identificação fornecida pelos responsáveis do aplicativo meu checklist
clientsecret=senha fornecida pelos responsáveis do aplicativo meu checklist
tenant=identificação fornecida pelos responsáveis do aplicativo meu checklist sem adicionar a instrução "tenant:"
username=usuario fornecido pelos responsáveis do aplicativo meu checklist
password=senha de usuário fornecido pelos responsáveis do aplicativo meu checklist |
A instrução encrypted com o valor 0 indica ao sistema SARA que os dados cadastrados não estão criptografados. Após a primeira utilização da integração no sistema SARA o valor será alterado automaticamente para 1 e todos os demais itens serão criptografados. Caso seja necessário alterar a configuração para autenticação, o valor deste parâmetro deverá ser retornado para 0 e todos os itens deverão ser alterados novamente, permitindo novo processo de criptografia na utilização do sistema SARA. Caso este item não seja tomado com atenção, a autenticação com o serviço do aplicativo meu checklist não ocorrerá. | Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| a prefeitura através do Web Service caso a parametrização estiver correta. - NFE_CIDADE - Parâmetro que indica qual o Lay-Out de NFS eletrônica para a respectiva Cidade (1-São Paulo / 3-Campinas).
- NUMERO_SERIE_CERTIFICADO_NFSE: Permite a parametrização do número de serie do certificado usado para envio da Nota Fiscal Eletrônica de serviço.
- NOME_CERTIFICADO_NFSE: Permite a parametrização do nome do certificado usado para envio da Nota Fiscal Eletrônica de serviço.
- PIN_CERTIFICADO_NFSE: Permite a parametrização do código PIN do certificado A3 usado para envio da Nota Fiscal Eletrônica de serviço.
- QTDE_RPS_POR_LOTE: QUANTIDADE DE RPS QUE PODE SER ENVIADO POR LOTE.
- DIRETORIO_INTERFACE_NFELETRONICA: DIRETORIO DE GRAVACAO DOS ARQUIVOS GERADOS PARA ENVIO DE NOTA FISCAL ELETRONICA
- CODIGO_ATIVIDADE_NFSE: CODIGO DA ATIVIDADE DO PRESTADOR DE SERVICO LIBERADO PELA PREFEITURA
Para a ativação da integração do aplicativo Meu Checklist, para vistoria de contêiner em pré-gate, deverão ser cadastrados os seguintes parâmetros no módulo sistema do SARA na tela de Parâmetros: - SL_MEUCHECKLIST_ATIVA_INTEGRACAO_PRE_GATE_CNT: define a ativação da integração com o aplicativo Meu Checklist para vistoria de contêiner em pré-gate. Valor S ativa a integração e valor N desativa. Valor padrão N;
- SL_MEUCHECKLIST_EXECUTOR_IS_CONFERENTE_TERMO: define se o conferente do termo de contêiner no SARA será o executor do checklist no aplicativo. Valor S define que o executor do checklist será o conferente no termo. Quando o valor for N o conferente será o mesmo do início da OS. Valor padrão N;
- SL_MEUCHECKLIST_ID_LOCALIDADE_PRE_GATE_CNT: define o código da localidade padrão para a execução do checklist de vistoria de contêiner no pré-gate. Valor padrão em branco, mas deverá obrigatoriamente ser configurado com um valor registrado no aplicativo Meu Checklist;
- SL_MEUCHECKLIST_ID_ROTEIRO_PRE_GATE_CNT: define o código do roteiro de vistoria em pré-gate que será utilizado para o envio da pendência ao aplicativo Meu Checklist. Valor padrão em branco, mas deverá obrigatoriamente ser configurado com um código de roteiro de vistoria de contêiner registrado no aplicativo.
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Os executores de checklist no aplicativo podem envolver executores que não pertencem ao grupo que realiza vistoria de contêiner no pré-gate. Por esse motivo, no SARA será necessário montar a lista de executores de checklist que farão parte do grupo que realiza a vistoria de contêiner no pré-gate. Para fazer isso, deverá ser acessado no SARA a tela de "De-para" disponível no menu Cadastro / De → Para no módulo Sistema e seguir os seguintes passos: - Obter a lista de executores com seus respectivos identificadores com os responsáveis pelo aplicativo Meu Checklist;
- Registrar um novo de-para para cada executor escolhido para pertencer ao grupo de executores de checklist de vistoria de contêiner em pré-gate;
- Cada novo registro deverá:
- ser selecionado no Nome do sistema o item descrito como "SL - Meu Checklist";
- escolher o Tipo de tabela como "Físico";
- apontar no campo Tabela SARA a tabela "TAB_USUARIOS";
- escolher o Tipo campo como "Físico";
- apontar no campo Campo SARA o campo "USU_ID";
- apontar no campo Valor SARA o código de identificação de usuário no SARA (exemplo: C05902953901). O código de identificação deverá ser um código existente de usuário no SARA;
- apontar no campo Valor sistema o código de identificação de executor no aplicativo meu checklist (exemplo: C23D7F1A-89B2-4838-85FF-EAC49057C433). O código de identificação informado deverá pertencer a lista de executores do aplicativo Meu Checklist; e, por fim;
- apontar no campo Descrição o nome do executor do checklist de vistoria de contêiner em pré-gate.
Sem a devida configuração da lista de executores, o SARA não será capaz de gerar uma pendência de checklist para um executor na vistoria de contêiner em pré-gate. A imagem abaixo ilustra o registro de um executor de checklist de vistoria de contêiner em pré-gate no SARA. Image Removed
| Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| Totvs custom tabs box |
---|
tabs | 1 - Pontos de Atenção, 2 - Portaria, 3 - Operacional, 4 - Coletor de Dados, 5 - Consulta |
---|
ids | proc1,proc2,proc3,proc4,proc5 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | proc1 |
---|
| Em situações em que o terminal encontrar-se sem conexão com a internet para acesso ao serviço do aplicativo do Meu Checklist, o sistema SARA pode identificar a ausência de conexão e solicitar a escolha do usuário se deseja prosseguir sem a integração com o aplicativo temporariamente. O SARA adotou esta abordagem para não travar a operação de entrada dos veículos no terminal e nem a barragem da execução das ordens de serviço em caso de problemas técnicos no terminal. Entretanto, ao permitir prosseguir sem a integração, por falta de conexão com a internet, causará a perda da integração até que a conexão com a internet e comunicação com o serviço do aplicativo Meu Checklist seja restabelecido. Por esse motivo, este item deve ser abordado com uma devida atenção na utilização no sistema. Na tela do CESV, caso escolha desativar a integração, a tela do executor do checklist não será mais solicitada. Se a conexão com a internet for restabelecida, feche a tela de registro do CESV e abra novamente para efetuar nova autenticação com o servidor do aplicativo e voltar a escolher o executor do checklist. A imagem abaixo ilustra uma situação no início de uma OS com o sistema sem conexão com a internet Image Removed
Mesmo sem a integração para a geração do termo de contêiner ter sido executado automático por falta de conexão com a internet, caso o checklist de vistoria de contêiner tenha ocorrido no aplicativo Meu Checklist, ao gerar o termo manualmente no SARA, e quando a conexão estiver restabelecida, o módulo consulta será capaz de recuperar as fotos tiradas no aplicativo para as partes do contêiner registradas com avaria, desde que as partes do contêiner registradas manualmente no termo do SARA sejam as mesmas registradas na vistoria de contêiner pelo checklist. Módulos que permitem desativar a integração temporariamente quando iniciado sem conexão com a internet - Portaria
- Operacional
- Coletor de Dados
Totvs custom tabs box items |
---|
| Fluxo Padrão No registro de CESV, ao gravar, o sistema irá identificar se possui contêiner na operação e, caso exista, irá exibir tela solicitando o executor para o checklist de vistoria de contêiner em pré-gate. Ao selecionar o executor e acionar OK, o sistema irá gerar uma pendência de checklist de vistoria de contêiner para o executor escolhido. Image Removed
Fluxo Alternativo No registro do CESV, se for necessário remover um contêiner já adicionado e integrado com o aplicativo Meu Checklist, o SARA fará uma verificação se a OS (ordem de serviço) do CESV já foi executado e o termo de contêiner já gerado. Caso não tenha termo de contêiner, ou termo cancelado, o sistema permitirá excluir o contêiner no CESV e irá cancelar o checklist de vistoria de contêiner no aplicativo Meu Checklist. Caso possua termo, irá exibir mensagem conforme imagem abaixo bloqueando a remoção do contêiner da OS. Image Removed
Se for necessário adicionar um novo contêiner ao CESV com contêiner já integrado, o sistema irá gerar a nova pendência de checklist. Entretanto, se a OS vinculada ao CESV já estiver iniciada, o sistema não gerará nova pendência de checklist para o contêiner adicionado, pois o SARA entende que o contêiner já encontra-se dentro da unidade e não está disponível no pré-gate para vistoria. A imagem abaixo ilustra uma situação em que um contêiner foi adicionado posteriormente ao CESV e início da OS. Image Removed
Totvs custom tabs box items |
---|
| Fluxo Padrão No início da OS, o SARA fará a verificação se todos os checklists dos contêineres relacionados à OS estão finalizados no serviço do aplicativo Meu Checklist. Caso estejam finalizados, o sistema automaticamente irá gerar o termo de contêiner com base nos dados coletados no aplicativo. O conferente do termo será associado automaticamente, mas, se o parâmetro SL_MEUCHECKLIST_EXECUTOR_IS_CONFERENTE_TERMO estiver configurado como S o conferente será o executor no aplicativo Meu Checklist, caso contrário, será o conferente apontado para a OS. O termo gerado após o início da OS poderá ser conferido já na tela de avarias da OS conforme ilustra imagem abaixo selecionando o conferente correspondente. Image Removed
Caso nenhuma avaria seja apontada para nenhuma parte do contêiner no aplicativo, nenhum termo será gerado. Fluxo Alternativo Se no início da OS o SARA identificar que algum contêiner relacionado a OS não está com o checklist finalizado no serviço do aplicativo Meu Checklist, o início da OS será bloqueado. Após todos os checklists relacionados serem concluídos e sincronizados com o serviço do aplicativo Meu Checklist, o SARA irá iniciar a OS normalmente e gerar os termos de contêiner automaticamente. A imagem abaixo ilustra um momento em que no início da OS o checklist ainda não está concluído e sincronizado com o serviço do aplicativo Meu Checklist. | A Nota Fiscal de Serviços Eletrônica (NFS-e) é o documento emitido e armazenado eletronicamente em sistema próprio da Prefeitura, com o objetivo de registrar as operações relativas à prestação de serviços. Para os contribuintes que emitem uma grande quantidade de notas, foi criado o Regime Especial de entrega em lote, no qual o contribuinte pode emitir Registros Provisórios de Serviços(RPS) através de seus próprios sistemas e estes em um determinado momento, serão convertidos em notas fiscais. Para converter estes RPS em NFS-e o sistema do contribuinte deve se conectar ao Web Service da prefeitura e enviar as informações de RPS gerados no formato XML, gerando um lote de entrega. O Recibo Provisório de Serviços (RPS) é um documento que deverá ser usado por emitentes da NFS-e no eventual impedimento da emissão “on-line” da Nota. Também poderá ser utilizado pelos prestadores sujeitos à emissão de grande quantidade de NFS-e (exemplo: estacionamentos). Nesse caso, o prestador emitirá o RPS para cada transação e providenciará sua conversão em NFS-e mediante o envio de lotes (processamento em lote). Existem duas metodologias de Web Services que as empresas terceirizadas das prefeituras podem adotar como forma de recebimento e tratamento das informações: - Modo Síncrono: No processamento síncrono, o retorno ocorre em tempo de execução, ou seja, ao enviar um RPS, você receberá na mesma conexão com o Web Service o resultado do processamento deste documento, que pode ser tanto autorizado, como uma rejeição por exemplo. Pode ocorrer da empresa estar configurada para processamento síncrono no InvoiCy, mas a prefeitura trabalhar apenas no método assíncrono. Nesse caso, quando o ERP enviar um RPS ao InvoiCy, vamos imediatamente enviá-lo para a prefeitura e retornar à você o resultado deste envio, que poderá ser “Em processamento”, caso ela trabalhe de forma assíncrona. Já se a prefeitura também trabalhar no método síncrono, seu ERP já receberá o resultado do processamento do RPS enviado, que poderá ser autorizado ou rejeitado. Ex. Prefeitura de São Paulo
- Modo Assíncrono: Já no processamento assíncrono, você receberá apenas uma confirmação de recebimento do documento e deverá efetuar uma consulta mais tarde para obter o resultado do processamento deste documento enviado. Neste caso, a prefeitura não valida o RPS na hora de seu recebimento, mas sim, a cada “X” minutos. O mesmo vale para a comunicação assíncrona entre seu ERP e o InvoiCy. Se a empresa assim estiver configurada, o ERP apenas receberá o status 105, acusando o recebimento do mesmo para posterior processamento. O InvoiCy então não enviará o RPS na hora para a prefeitura e manterá o documento em uma fila de processamento, que mais tarde, será enviado. Caberá ao ERP então, efetuar a consulta deste documento ou do lote enviado, para obter o status deste processamento quando ele ocorrer. Ex. Prefeitura de Campinas.
|
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Gerando uma Nota Fiscal no SARA: Image Added
Image Added
Realizando a integração com a Prefeitura: Na tela de Geração de Arquivo de NF-Eletrônica, existem duas opções de envio: - Pendentes: Marcando esta opção iram retornar todas as Notas Fiscais do SARA que estão pendentes para envio para a prefeitura
- Canceladas: Marcando esta opção iram retornar todas as Notas Fiscais já integradas com a prefeitura e que foram Canceladas no SARA.
Enviando Notas Fiscais "Pendentes":
Image Added
Image Added
Arquivo Gerado: Image Added
Arquivo de Retorno da Prefeitura: Image Added
- Na aba "Arquivos Gerados" é possível consultar os arquivos gerados e transmitidos para a prefeitura.
Image Added
- Na aba "Consultas NFSE" é possível visualizar as informações dos arquivos consultados na aba anterior. No Grid constam todas as Notas, RPS bem como os números das NFEs geradas pela Prefeitura.
Image Added
| proc4 | Fluxo Padrão Assim como no módulo Operacional, no Coletor de Dados, no início da OS o SARA fará verificação se todos os checklists dos contêineres relacionados à OS estão finalizados no serviço do aplicativo Meu Checklist. Caso estejam finalizados, o sistema automaticamente irá gerar o termo de contêiner com base nos dados coletados no aplicativo. O conferente do termo será associado automaticamente, mas, se o parâmetro SL_MEUCHECKLIST_EXECUTOR_IS_CONFERENTE_TERMO estiver configurado como S o conferente será o executor no aplicativo Meu Checklist, caso contrário, será o conferente apontado para a OS. O termo gerado após o início da OS poderá ser conferido já na tela de avarias da OS conforme ilustra imagem abaixo. Image Removed
Caso nenhuma avaria seja apontada para nenhuma parte do contêiner no aplicativo, nenhum termo será gerado. Fluxo Alternativo Idêntico ao módulo Operacional, no Coletor de Dados, se no início da OS o SARA identificar que algum contêiner relacionado a OS não está com o checklist finalizado no serviço do aplicativo Meu Checklist, o início da OS será bloqueado. Após todos os checklists relacionados serem concluídos e sincronizados com o serviço do aplicativo Meu Checklist, o SARA irá iniciar a OS normalmente e gerar os termos de contêiner automaticamente. A imagem abaixo ilustra um momento em que no início da OS o checklist ainda não está concluído e sincronizado com o serviço do aplicativo Meu Checklist. Image Removed
Totvs custom tabs box items |
---|
| Fluxo Padrão No módulo consulta, em consulta genérica por TFA/TFE e em consulta genérica por contêiner, será possível visualizar o termo integrado com o Meu Checklist e visualizar as fotos das partes dos contêineres tiradas durante o procedimento de vistoria do contêiner no pré-gate. Nessas duas consultas, na listagem das partes do contêiner estará disponível a coluna Fotos, e quando a parte do contêiner possuir foto tirada no aplicativo Meu Checklist, aparecerá na linha correspondente um botão Visualizar com a quantidade de fotos tiradas para aquela parte do contêiner. As imagens abaixo ilustram a tela de TFA/TFE e Consulta por Contêiner com as mudanças na visualização do termo com a coluna de fotos e os botões de visualizar. Image Removed Image Removed
Caso uma parte do contêiner não possuir fotos tiradas no aplicativo, esta parte não terá o botão Visualizar na coluna Fotos. Ao acionar com o mouse um botão para visualizar foto, o SARA abrirá uma tela de visualização das fotos consultando diretamente no servidor do aplicativo Meu Checklist. Essa tela permitirá salvar a imagem que está selecionada ou salvar todas as imagens listadas em um diretório de livre escolha do usuário. A imagem abaixo ilustra a tela de visualização de fotos de uma determinada parte de contêiner registrada no aplicativo. Image Removed
Fluxo Alternativo Se ao abrir uma das consultas mencionadas no fluxo padrão e a conexão com a internet não estiver disponível, o SARA exibirá mensagem informando problemas com a conexão e não apresentará a coluna Fotos para visualização, na listagem das partes do contêiner. A imagem abaixo ilustra uma situação em que a conexão com a internet não está disponível. Image Removed
|