Visão geral

Agora, no módulo bridge, temos como configurar o bot dos XMLs e integrações via SIEG e Questor. botxml1.png

Observações

  • O computador que vai usar o bot xml não pode estar em modo bridge
  • Período é definido para cada filial
    • Por exemplo, caso o período de uma filial for "a cada 30 dias", o bridge vai pular a sincronia dessa filial caso já tenha sincronizado recentemente.
    • Esse período é aplicado para cada integração daquela filial
  • Caso necessário, é possível alterar as URL's dos serviços do Questor e SIEG na primeira aba do bridge
  • O SIEG envia um xml por vez, enquanto o Questor pode enviar um lote de até 50 xmls de uma vez
  • A funcionalidade do modo Arquivo permanece a mesma usada no E-Trade
    • As configurações, porém, são separadas do E-Trade.
  • Enviamos os XMLs autorizados, cancelados, inutilizados e das notas de entrada pelas integrações
  • Para gerar log é só colocar -v no atalho do bridge
  • O computador com o bot XML deverá ter todos os certificados das filiais configuradas para a execução de comportamento a notas pendentes e verificação de pendências
  • O botão Forçar envio vai zerar a coluna Exportada do Movimento_NFe para o reenvio de todas as integrações configuradas
  • A coluna DadoIntegracao pode ter os seguintes valores conforme a tabela abaixo

  • Antes, estávamos usando o campo Exportada para a busca dos documentos
    • Esse campo armazenava um único valor inteiro onde, dependendo do valor, podia apresentar uma combinação de tipos de envio de um mesmo documento por integrações
    • Vamos remover esse campo do E-Trade :)
  • Agora. vamos utilizar um campo com valores compostos. Esse campo facilitará a leitura por técnicos e permitirá a expansão do bot xml para outras integrações
  • Exemplo: [{"TipoIntegracao":32,"TipoEnvio":0,"IdIntegracao":"DBAB3E770B7A4868A298D9CD860CADA2","IsConfirmado":false}]
    • TipoIntegracao: 32 - Domínio
    • TipoEnvio: 1 - Documento autorizado
    • IdIntegracao: DBAB3E770B7A4868A298D9CD860CADA2 - id de envio do documento
    • IsConfirmado: false - retorno de confirmação do documento enviado (utilizado apenas para o domínio. as outras integrações vão vir com padrão true mesmo que não tenhamos como saber se não foram)
  • Caso tenham mais de uma integração, vai retornar mais registros separados por vírgula.

Tipos de integração do bot xml (TipoIntegracao)

Integração Código
SIEG 4
Questor 8
Portal do contador 16
Domíno 32

Tipos de documento a ser enviado (TipoEnvio)

Tipo Código
Autorizado 1
Cancelado 2
Inutilizado 3

Questor

config_questor_bridge.png

Depois publicamos o vídeo sobre o recurso, identificamos que a configuração correta para utilização do QUESTOR é a apresentada acima. O que muda:

  1. Não precisa mais de informar a chave de api e e-mail.
  2. Antes tínhamos uma tabela para informar os CNPJ dos contadores que terão acesso aos XML, agora isso passará para um único registro.
  3. Precisará de "Solicitar acesso" ou seja o contador terá que liberar no software da Questor o seu envio de XML para a conta dele. Isso pode ser feito abaixo.
  4. Só depois que o Contador liberar o acesso que o Bridge conseguirá enviar os XML.

Para mais informações sobre o passo 3 veja esse texto da documentação do Questor:

O Escritório Contábil precisará acessar o módulo Gerenciador de Empresas em Utilitários > Controle Acesso API SYN.

Caso não esteja funcionando, solicite um print ao contador das duas solicitações autorizadas, deve vir como abaixo o layout 200 e 201 autorizados.

questor_autorizadas.jpg

Depois disso o contador pode ir baixar as notas no sistema. Oriente o contador a marcar a opção de Entrada e Saída

SIEG / Domínio

A SIEG é a integração oficial da Thomson Reuters - Domínio. Para ativar o SIEG no seu Domínio precisará de ativar a integração, aqui tem um manual de como o contador pode fazer isso no seu sistema. Todo caso recomendamos buscar o suporte da Thomson Reuters para mais informações e dúvidas.

Vídeo de como o contador pode gerar o serial da API para integrar no ERP

Portal do contador

É um portal da própria VR para o contador fazer o download dos XML de notas transmitidas pelo Bridge através do Bot de XML.

Esse portal tem algumas peculiaridade que falamos nesse vídeo: Como configurar o Portal do Contador:

  • Os arquivos são removidos 90 dias depois de feito o upload
  • Os arquivos de XML são armazenados no mês de referência configurado no Bridge
  • Os arquivos são armazenados na pasta do CNPJ do cliente, assim se o cliente mudar de CNPJ esses XML ficam presos no CNPJ antigo.
    • Para manter os CNPJ antigos precisa de guardar o cadastro antigo inalterado no BackOffice, se ele for modificado para o novo CNPJ o contador irá perder o acesso. Nesse caso deve ser feito um novo cadastro para o novo CNPJ ou baixar todos os dados do antigo antes de alterar.
  • O cadastro do contador deve ser realizado no BackOffice e atribuído no cadastro do cliente, solicite ajuda do time da VR para isso.
  • A senha do contador é cadastrada na ficha dele no BackOffice.

Domínio

Configuração

  • O contador vai enviar uma chave para inserirmos na config do bridge (na documentação isso aparece como integrationKey)
  • Inserir no campo Chave api contador e clicar no botão Verificar
  • Vai aparecer uma tela com os dados do contador e o cliente.
    • Clique em sim para buscar a chave da api que o cliente vai utilizar para envio de XMLs e busca de status de envio
  • Após a confirmação, o campo da Chave api do cliente vai ser preenchido.
  • Clicar no botão Aplicar para salvar as configurações
  • Salvar config do bridge

Fluxo de envio

  • O bot vai enviar os XMLs respeitando a configuração da filial do tipo de data do relatório
  • Os arquivos são enviados um a um, mas não confirmamos o envio nesta etapa
    • Não enviamos arquivos inutilizados para o domínio
  • Após o envio de um arquivo, guardamos o id dele na coluna DadoIntegracao na tabela movimento_nfe para consulta posterior
  • Após o envio de todos os arquivos, fazemos a confirmação de envio, um a um
  • Depois dessa confirmação, atualizamos o DadoIntegracao do movimento_nfe com os valores específicos

Vídeos sobre a tarefa

Daegrickcriado em 30 jul 2024 alterado em 01 nov 2024

Manual Outros Manual

1041 | 7