Integração Farmbox

Descrição

Índice

Especificações dos dados integrados

A integração com o Farmbox tem etapas de importação e exportação, sendo os cadastros destacados abaixo:

• Fazendas: esse cadastro pode ser realizado através de ambos os sistemas. Caso for cadastrado pelo Farmbox, é necessário cadastrar no Lavoura e realizar o “De Para“ do código dos cadastros;

• Culturas: cadastro realizado apenas pelo sistema da Viasoft. É necessário realizar o “De Para“ do código dos cadastros;

• Variedade: para esse cadastro é necessário apenas ativar a integração e realizar o “De Para“;

• Equipamentos: cadastro realizado apenas pelo sistema da Viasoft. É necessário realizar o “De Para“ do código dos cadastros;

• Safras: esse cadastro pode ser realizado através de ambos os sistemas. Caso for cadastrado pelo Farmbox, é necessário cadastrar no Lavoura e realizar o “De Para“ do código dos cadastros;

• Talhões: esse cadastro pode ser realizado através de ambos os sistemas. Caso for cadastrado pelo Farmbox, é necessário cadastrar no Lavoura e realizar o “De Para“ do código dos cadastros;

• Croqui do talhão: esse cadastro pode ser realizado através de ambos os sistemas. Caso for cadastrado pelo Farmbox, é necessário cadastrar no Lavoura e realizar o “De Para“ do código dos cadastros;

• Armazenamento: esse cadastro pode ser realizado através de ambos os sistemas. Caso for cadastrado pelo Farmbox, é necessário cadastrar no Lavoura e realizar o “De Para“ do código dos cadastros;

• Usuários: cadastro realizado apenas pelo sistema da Viasoft. É necessário realizar o “De Para“ do código dos cadastros;

• Grupo de Itens: para esse cadastro é necessário apenas ativar a integração e realizar o “De Para“

• Itens: esse cadastro pode ser realizado através de ambos os sistemas. Caso for cadastrado pelo Farmbox, é necessário cadastrar no Lavoura e realizar o “De Para“ do código dos cadastros;

• Inventário: enviado conforme a movimentação dos itens que estão parametrizados que integram com o Farmbox. O saldo e o custo enviado nessas situações é conforme o parametrizados nas configurações da integração;

• Apontamentos: importado todos os apontamentos finalizados no sistema do Farmbox. A importação pode ocorrer de maneira manual ou através da parametrização de um Agendador de Tarefas do XE. Atualmente não edita um apontamento já importado, caso tenha alterações, o sistema exclui o antigo e importa novamente;

Configurações Gerais

Inicialmente para ativar a integração é necessário no cadastro da empresa (Agro3C » Configurações » Configuração » Empresas), na aba “Integrações/Web Service“ definir como “sim“ no campo “Integra com o Farmbox?“, conforme demonstra a imagem abaixo:

Open

Por conseguinte é necessário acessar o módulo ExpImpAgro e acessar as Configurações do Farmbox (Processos » Exportação/Importação Farmbox » Configuração Farmbox). Nessa rotina se faz necessário informar os seguintes campos:

• URL integração: adicionar a URL de produção da integração que é disponibilizado pelo Farmbox;

• Token de acesso: informar o token de autenticação que é disponibilizado pelo Farmbox;

Feito isso, se faz necessário preencher os seguintes campos para exportar corretamente o inventário e importar os apontamentos:

• Saldo a ser exportado: neste campo o usuário deve vincular o código do saldo dos produtos que deseja exportar para o sistema do Farmbox;

• Custo a ser exportado: neste campo o usuário deve vincular o código do custo a ser exportado para o Farmbox;

• Config. de apontamento planejado: através desse campo é preciso adicionar a configuração de apontamento do Lavoura que deverá importar os apontamentos de planejamento do Farmbox;

• Config. de apontamento realizado: neste campo é necessário atrelar a configuração de apontamento do Lavoura para importar os apontamentos executados através do Farmbox;

• Cód. de atividade do apontamento: neste campo é necessário vincular o código da atividade que será gravado na importação dos apontamentos oriundos do Farmbox;

A imagem abaixo demonstra um modelo da parametrização a ser realizada:

Open

Relacionamento entre os cadastros

Após ativar a integração é necessário realizar o relacionamento entre os cadastros dos sistemas, ou seja, informar no sistema da Viasoft quais os códigos correspondentes dos mesmos cadastros no Farmbox.

Esse relacionamento deve ser realizado nas seguintes rotinas:

• Grupo de Itens;

• Itens;

• Fazendas;

• Talhões;

• Culturas;

• Variedades;

• Equipamentos;

• Locais de Estoque;

• Usuários;

• Safras;

A imagem abaixo demonstra um modelo do campo que é disponibilizado nessas rotinas para realizar o relacionamento:

Agendador de Tarefas

Para que os apontamentos sejam importados de maneira automática é necessário parametrizar através do módulo Agro a execução do Agendador de Tarefas do módulo ViasoftServerAgroXE. Para isso, é necessário na rotina de Agendador de Tarefas (Agro3C » Configurações » Configuração » Agendador de Tarefas) criar uma nova opção selecionando a rotina “039 - Importar Apontamentos - Farmbox“. Feito isso, é preciso definir os dias da semana, hora e minutos para a execução do mesmo.

A imagem abaixo demonstra um modelo da parametrização a ser realizada:

Exportação/Importação Manual

Através do módulo ExpImpAgro é disponibilizado a possibilidade de importar e exportar (ExpImpAgro3C » Processos » Exportação/Importação Farmbox) manualmente os registros não integrados entre os sistemas, permitindo assim o envio de registros retroativos.

A imagem abaixo demonstra um modelo das rotinas disponibilizadas:

Central de Comunicação

Com o objetivo de facilitar o usuário a identificar as possíveis não conformidades entre as integrações, é disponibilizado a rotina de Central de Comunicação (ExpImpAgro3C » Processos » Exportação/Importação Farmbox » Central de Comunicação) que apresenta os logs de todos os registros, permitindo filtro filtrar por data, operação e status.

A imagem abaixo demonstra um modelo da rotina mencionada:

Versão