Antes de abrir um chamado, fale com a nossa assistente virtual. Ela esclarece suas dúvidas na hora e, se preciso, já abre o seu chamado automaticamente.
Este manual descreve o passo a passo para a configuração e utilização da integração entre o Sankhya e a plataforma Web Receita.
1. Instalação do Add-on
A instalação deve ser realizada diretamente no ambiente do cliente.
Acesse a tela ''Minhas Soluções'' (Comercial » Arquivo » Cadastros » Minhas Soluções).
Utilize as credenciais de acesso do cliente (Sankhya ID).
Em seguida, pesquise por ''Receita Agro''.
Localize o módulo e clique em ''Ver Detalhes'' e, posteriormente, em ''Instalar''.
O sistema solicitará a senha para liberação da customização (o código será enviado para o e-mail do usuário). Após a validação, o menu do módulo estará disponível para uso.
2. Configurações e Credenciais (Pré-requisitos)
Para que a integração funcione, o cliente deve possuir contrato ativo com a plataforma Web Receita.
Ambientes com mais de uma empresa
Os passos abaixo configuram uma única credencial para todo o ambiente. Para segregar as credenciais por empresa — cada empresa emitindo receituário com a própria credencial da Web Receita — ative antes a preferência REC_CONFPOREMP – Configurações por empresa Receituário e siga o artigo [Como configurar o Receituário Agro por empresa].
Nesse cenário, os cadastros de Agrônomo e de Produtor Rural passam a exigir vínculo com a credencial de cada empresa.
Acesse a tela ''Configurações Receita Agro'' (Receita Agro » Cadastros).
No campo ''Gateway'' selecione ''WebReceita''.
Insira o Client ID e o Client Secret fornecidos pela Web Receita.
Marque a opção ''Ativo'' e salve.
3. Sincronização de Dados (API)
O sistema importa, via API, as tabelas governamentais atualizadas. A sincronização pode ser feita de duas formas: manualmente, sob demanda em cada tela, ou de forma automática, mediante configuração de rotinas periódicas.
3.1 Sincronização Manual
A sincronização manual é executada diretamente na tela correspondente a cada cadastro, sempre que o usuário desejar atualizar as informações.
3.1.1 Alvos e Pragas
Acesse a tela ''Pragas'' (Receita Agro » Cadastros).
Clique no botão “Sincronizar Alvos”. O sistema realizará a importação automática, via API, de todos os alvos e culturas definidos pelo governo.
Acesse a tela ''Consulta Fitossanitária'' (Receita Agro » Cadastros » Consulta Fitossanitária).
Clique em ''Sincronizar Produtos''. Isso trará a lista de princípios ativos e nomes técnicos.
3.1.3 Culturas
Acesse a tela ''Culturas'' (Receita Agro » Cadastros » Culturas).
Clique em ''Sincronizar Culturas''.
3.2 Sincronização Automática
Para evitar a execução manual recorrente, o sistema permite programar rotinas que atualizam os dados automaticamente em intervalos definidos pelo usuário.
Acesse a tela "Configuração ReceitaAgro" (Receita Agro » Cadastros).
Selecione a empresa desejada
Clique no botão "Sincronização automática" na barra de ferramentas.
Na janela aberta, estão disponíveis três rotinas independentes:
Sinc. Produtores
Sinc. Alvos / Pragas
Sinc. Culturas
Para cada rotina que deseja automatizar, habilite o campo Ativo.
Informe o Tempo de atualização (minutos) — intervalo em que o sistema executará a busca das informações.
Clique em Salvar.
Observações:
As rotinas são configuradas de forma independente: é possível ativar apenas uma, duas ou todas as três.
O campo Última execução exibe a data e hora do último processamento de cada rotina, permitindo acompanhar se a automação está em funcionamento. Enquanto não houver a primeira execução, o campo apresentará "Nunca executado".
Com as rotinas ativas, não é necessário executar manualmente as sincronizações correspondentes descritas no item 3.1.
Para interromper a automação, basta desabilitar o campo Ativo da respectiva rotina e salvar.
4. Cadastros e Vínculos Estratégicos
4.1 Produtores (Parceiros)
Para que um parceiro seja reconhecido como produtor rural:
Acesse a tela ''Parceiros'' (Configurações » Cadastros » Parceiros), na aba ''Fiscal''.
Verifique se o campo ''Classificação de ICMS'' está selecionado como ''Produtor Rural''.
Acesse a tela ''Produtores'' (Receita Agro » Cadastros » Produtores) e clique em ''Importar Produtores'' para carregar os parceiros configurados no sistema.
Nota: com a preferência ''REC_CONFPOREMP'' ativa, vincule o produtor à credencial de cada empresa pela aba Produtor Rural por empresa.
Acesse a tela ''Agrônomos'' (Receita Agro » Cadastros » Agrônomos).
O cadastro de agrônomos pode ser realizado tanto no Sankhya quanto na plataforma Web Receita. Caso o cadastro seja feito no Sankhya, utilize a opção “Exportar Agrônomos” para enviá-los à Web Receita. Se o cadastro for realizado na plataforma, utilize a opção “Sincronizar Agrônomos” para importá-los ao Sankhya.
Nota: com a preferência ''REC_CONFPOREMP'' ativa, exporte o agrônomo para cada empresa pela aba Agrônomo por Empresa. O mesmo agrônomo recebe um Id Origem distinto em cada credencial.
O preenchimento do CREA é obrigatório para a emissão do receituário.
4.3 Vínculo de Produtos ERP
Este é o passo mais importante para o usuário final (geralmente o Engenheiro Agrônomo):
Acesse a tela ''Consulta Fitossanitária'' (Receita Agro » Cadastros » Consulta Fitossanitária).
Selecione o princípio ativo (Web Receita) e acesse a aba ''Vínculo Produto ERP''.
Vincule o código do produto comercial correspondente, previamente cadastrado no Sankhya.
Nota: O vínculo pode ser realizado no formato 1 para 1 ou 1 para muitos, conforme as marcas comerciais utilizadas.
5. Processo de Venda e Emissão
5.1 Configuração da TOP
Defina em qual momento o receituário será gerado: no Pedido ou na Nota.
Acesse a tela ''Tipos de Operação'', na aba ''ReceitaAgro''.
Marque a opção ''Emite Receiturário''.
IMPORTANTE: Geralmente, a configuração é realizada na TOP de Venda, para que a emissão ocorra de forma simultânea ao faturamento.
5.2 Layout do Portal de Vendas
Certifique-se de que o campo ''Cód. Agrônomo'' esteja visível no cabeçalho das notas/pedidos na tela ''Portal de Vendas'' (Comercial » Consulta » Portal de Vendas).
Essa configuração deve ser realizada na tela ''Configurador de Layout da Nota'' (Comercial » Configuração » Configurador de Layout da Nota).
5.3 Fluxo Operacional
No momento do faturamento, caso existam produtos vinculados à receita, o sistema exibirá um pop-up.
Nesse momento, o sistema irá sugerir o quantitativo de aplicação padrão (mínimo aceitável pelo governo).
O usuário poderá confirmar ou ajustar as informações de aplicação para cada item.
Ao salvar e confirmar a Nota Fiscal, o sistema gerará, de forma simultânea, as receitas correspondentes na plataforma integrada.
Em ambientes com configuração por empresa, o receituário é gerado na credencial da empresa informada na nota.
Comentários
0 comentário
Escreva seu comentário aqui
Por favor, entre para comentar.