¶ Como Realizar a Integração SYN?
¶ ERP Gestão Empresarial e ERP Questor Negócio
Histórico de Revisões
| Data | Versão | Descrição | Autor |
| 25/01/2022 | 1.0 | Versão Inicial | Alexandre Royer |
| 26/01/2022 | 1.1 | Revisão | Robson Tibolla |
Este manual de implantação da Integração Fiscal/Contábil SYN apresenta as orientações necessárias para configuração, implantação e utilização da integração entre os produtos Questor por meio da API SYN.
O SYN é uma solução desenvolvida para viabilizar a integração entre os ERP’s Questor e o Questor Gestão Contábil, permitindo o envio estruturado de informações fiscais e contábeis de forma automatizada e segura.
Com o SYN, as empresas passam a disponibilizar dados diretamente à contabilidade, eliminando a necessidade de geração e envio manual de arquivos como SPED, XML e outros documentos fiscais.
A comunicação do SYN é realizada via protocolo HTTPS, utilizando dados no formato JSON (String JSON). A integração não exige configurações personalizadas complexas, pois os ERP’s Questor já são nativamente homologados e integrados à solução. Para ativação, basta realizar o vínculo com o escritório de contabilidade por meio do CNPJ, não sendo necessária a geração de tokens, instalações adicionais ou criação de infraestrutura específica.
¶ Implantação – Gestão Empresarial
Para iniciar a implantação da integração fiscal/contábil por meio da API SYN, é necessário seguir os passos abaixo na sequência indicada. O correto cumprimento dessas etapas garante o funcionamento adequado da comunicação entre o ERP e o Questor Gestão Contábil.
¶ Vínculo do Escritório de Contabilidade
O primeiro passo consiste no vínculo do escritório de contabilidade no Gestão Empresarial.
O escritório deve estar previamente cadastrado no sistema como Fornecedor, com o respectivo CNPJ corretamente informado. Caso ainda não exista o cadastro, ele deverá ser criado antes de prosseguir com a configuração da integração.
Após concluir o cadastro da entidade, é necessário realizar o vínculo com a filial correspondente. Para isso, acesse: Gerenciador de Empresa > Cadastro de Filiais.
Na tela de cadastro da filial, localize o quadro “Configuração Integração Questor” e selecione o fornecedor cadastrado (escritório contábil) para efetivar o vínculo.
Esse relacionamento é indispensável para habilitar a comunicação entre a empresa e o escritório contábil por meio da API SYN.
¶ Integração Fiscal/Contábil
Após realizar o vínculo do escritório de contabilidade no cadastro da filial do ERP Gestão Empresarial, a integração fiscal e contábil via API SYN já pode ser utilizada.
Para acessar a rotina, utilize o caminho: Arquivos > Integração Contábil/Fiscal SYN.
Nesta tela, é possível definir os filtros que determinam quais informações serão enviadas para a integração.
Filtros disponíveis
- Empresa: Permite selecionar a empresa que será considerada na integração. O campo é carregado automaticamente com a empresa logada.
- Filial: Permite selecionar a filial para integração. Também é preenchido automaticamente conforme a filial ativa.
- Data de Emissão: Define o intervalo de datas dos lançamentos fiscais e/ou contábeis que serão integrados.
- Série de Nota Fiscal: Possibilita filtrar documentos por série.
- Número de Documento: Permite integrar documentos específicos por número.
- Origens: Permite selecionar as origens dos lançamentos fiscais que deverão compor a integração.
¶ Integração Fiscal
A integração fiscal contempla o envio de documentos fiscais, tais como:
- Notas de entrada;
- Notas de saída;
- Conhecimentos de transporte;
- Cupons fiscais;
- NFC-e.
Não são necessárias configurações adicionais para a integração fiscal. É necessário apenas que existam lançamentos registrados no sistema, de acordo com os filtros informados na tela.
O envio é realizado de forma agrupada por data — ou seja, todos os documentos de um mesmo dia são transmitidos juntos em um único arquivo no formato JSON.
¶ Disposição Geral da Tela de Integração
A rotina de integração via API SYN está disponível para todos os clientes do ERP Gestão Empresarial no caminho: Arquivos > Integração Fiscal/Contábil SYN.
Nessa tela estão concentrados os filtros, parâmetros e comandos necessários para execução das integrações fiscal e contábil.
¶ Integração Contábil
A integração contábil contempla o envio dos lançamentos contábeis gerados pelas diversas origens do sistema.
Assim como na integração fiscal, não são exigidas configurações adicionais, sendo necessário apenas que existam lançamentos dentro dos filtros definidos.
O envio também ocorre de forma agrupada por dia, gerando um único arquivo JSON para cada data integrada.
⚠️ Importante: Antes de integrar os lançamentos contábeis, é necessário realizar a integração prévia do plano de contas e dos cadastros de clientes e fornecedores, garantindo que as contas contábeis relacionadas já existam no Gestão Contábil para correto relacionamento das informações.
¶ Importação no Gestão Contábil
Por padrão, os documentos fiscais e lançamentos contábeis enviados via SYN não são inseridos automaticamente na base do escritório contábil.
Após o envio pelo ERP Gestão Empresarial, os dados ficam armazenados na API SYN e devem ser importados por meio da rotina específica de importação de lançamentos SYN no sistema Gestão Contábil.
Quando a integração é concluída com sucesso, o ERP apresenta uma mensagem de confirmação indicando a integração da data processada. A partir desse momento, os dados já estão disponíveis para importação no Gestão Contábil.
Caso ocorram inconsistências durante a importação no Gestão Contábil, recomenda-se verificar:
- Parâmetros da rotina de importação;
- Configurações de integração;
- Estrutura dos cadastros relacionados;
- Se houver mensagem de erro no log ou alerta no canto superior direito da tela ao finalizar a integração no ERP Gestão Empresarial, é necessário conferir:
- Vínculo do escritório de contabilidade;
- Cadastros envolvidos;
- Lançamentos integrados e possíveis inconsistências de dados.
¶ Vínculo do Escritório de Contabilidade e Configuração do Ambiente no Questor Negócio
Para habilitar a integração via API SYN no Questor Negócio, é necessário realizar o vínculo do escritório de contabilidade e definir corretamente o ambiente de comunicação.
O vínculo é feito diretamente no cadastro do estabelecimento. Acesse: Configurações > Padrão Sistema > Estabelecimento > Configuração Comunicação Externa.
Na tela, localize o quadro “Configuração SYN” e preencha os campos conforme abaixo:
- CNPJ Contabilidade Padrão: Informe o CNPJ do escritório de contabilidade responsável por receber os lançamentos fiscais e contábeis integrados. Esse dado é essencial para direcionar corretamente as informações enviadas pela API SYN.
- Ambiente: Selecione o ambiente de operação da integração:
- Homologação: Utilize para testes e validações de integração.
- Produção: Uilize o ambiente real, quando a integração já estiver validada e liberada para uso oficial pela contabilidade.
Após o preenchimento, salve as configurações para que o ambiente fique apto a realizar a comunicação com o sistema contábil.
¶ Integração Fiscal/Contábil
Após realizar o vínculo do escritório de contabilidade nas configurações do estabelecimento do Questor Negócio, a integração via API SYN já pode ser utilizada.
Para acessar a rotina, utilize o caminho: Contabilidade > Integração Contábil/Fiscal > Integração API SYN.
Nesta funcionalidade são definidos os parâmetros e o tipo de informação que será enviada para o sistema contábil.
¶ Filtros disponíveis
- Tipo de Registro: permite selecionar o tipo de lançamento que será integrado (plano de contas, fiscal, contábil, recebimentos, entre outros).
- Estabelecimento: define qual estabelecimento realizará a integração.
⚠️ Atenção: Na primeira integração, deve ser enviado o registro “001 – Plano de Contas ERP”, garantindo que a estrutura de contas esteja previamente disponível no sistema contábil.
Observação: Para agilizar o vínculo das contas, recomenda-se que o plano de contas já tenha sido importado da contabilidade com as contas contábeis devidamente associadas nos campos específicos. Isso reduz ajustes posteriores no escritório contábil.
¶ 2.1 Integração Fiscal
A integração fiscal é realizada ao selecionar o Tipo de Registro 201 – Saídas. Nessa opção, é enviado o movimento de NFS-e faturadas, permitindo que o setor fiscal receba automaticamente os lançamentos correspondentes.
¶ 2.1.1 Integração Fiscal – Recebimentos de Duplicatas
Para integrar os recebimentos vinculados às notas enviadas, deve-se selecionar o Tipo de Registro 203 – Recebimentos de Duplicata.
Serão enviados os registros de duplicatas recebidas relacionadas às NFS-e previamente integradas pelo Registro 201.
¶ 2.2 Integração Contábil
A integração contábil é realizada ao selecionar o Tipo de Registro 100 – Lançamentos Contábeis. Nessa modalidade, são enviados os lançamentos contábeis gerados pelo sistema, incluindo:
- Provisionamentos de Contas a Pagar e Contas a Receber;
- Lançamentos efetivos de pagamentos e recebimentos;
- Adiantamentos a clientes;
- Adiantamentos a fornecedores;
- Movimentos diários;
- Registros com contas de débito e crédito.
¶ 2.3 Importação – Gestão Contábil
Por padrão, os documentos fiscais e lançamentos contábeis enviados via SYN não são inseridos automaticamente na base do escritório contábil.
Após o envio pelo Questor Negócio, os dados permanecem armazenados na API SYN e devem ser importados por meio da rotina específica de importação de lançamentos SYN no sistema Gestão Contábil.
Quando a integração é concluída com sucesso, o ERP apresenta uma mensagem de confirmação. A partir desse momento, os lançamentos já estão disponíveis para importação no Gestão Contábil.
Caso ocorram inconsistências durante a importação de arquivos disponíveis no SYN, recomenda-se verificar os parâmetros de importação configurados no Gestão Contábil e os cadastros relacionados.
