Guia de Integração para o Sistema Viasoft x Forlog: Para método REST

Integração com tms e tms embarcador

Missão VIASOFT

Fornecer soluções completas, alinhadas e orientadas às melhores práticas de gestão empresarial, para que nossos clientes realizem mais

Visão VIASOFT

Ser a escolha mais inteligente para ações de evolução e inovação em gestão empresarial

Visão Geral

Solicita-se que seja implementado uma API no sistema da Viasoft para importar o cadastro de pedidos. Sugere-se que para isso seja utilizado serviço de um novo servidor REST. Essa rotina que será utilizada para realizar a integração entre o Agrotitan e o TMS da Forlog, onde documentos emitidos no portal TMS embarcador, serão enviados através de JSON para importação no AGRO. Todo pedido feito no sistema TMS embarcador e recebido pelo Agro sera tratado em um De para, para que seja integrado na configuração desejada. Os cadastros de pessoas e embalagens acompanhada de suas quantidades serão enviadas pelo Agro.

Objetivo

Tem por objetivo atualizar e agilizar processo de geração de pedidos com a solução para transportes do programa da Forlog. Buscando praticidade e interatividade com usuário nos processos do dia a dia.

Processo/ Instalação

Servidor TMS - Agro x Forlog - Instalação Downloads Servidor TMS - Agro x Forlog

Para utilizar o sistema, extraia os arquivos dessa pasta em qualquer local na sua máquina ou no cliente. Sugestão: Na pasta de plug-ins. Existem 2 modos de utilizar, Serviço ou VCL, ambos devem funcionar da mesma forma, o modo VCL não precisa instalar basta rodar o executável: ViasoftServidorForlogREST.exe Configuração Servidor

Os arquivos .conf & .conexões devem manter o nome do executável, sendo que para serviço & VCL são arquivos diferentes.

ViasoftServidorForlogRESTServico.conf ou ViasoftServidorForlogREST.conf Neste arquivo possui a configuração de “UrlBase”, este IP & Porta devem ser do servidor que está sendo executado. O mesmo valor será cadastrado no Agro. Importante: Utilize portas diferentes se for usar Serviço & VCL, caso use a mesma sempre pare um antes de usar o outro para não gerar conflito. O caminho do “DebugFile” deve existir para que seja feito o Log

ViasoftServidorForlogREST.conexoes ou ViasoftServidorForlogRESTServico.conexoes Mantenha uma conexão com exatamente o mesmo nome da sua conexão do

Open

Agro

Open

ViasoftServidorForlogRESTExtras.conf

Neste arquivo tem um De-Para das configurações de pedido do agro, VENDA_DIRTA = FORLOG 1 = Conf. de Pedido no Agro

Configuração AGRO

Caminho: Agro3c.exe > Configurações > Configuração > Empresas

Marque a opção Integra com Forlog = SIM, esse SIM ira permitir que as rotinas sejam integradas.

• Para configurar no agro, na tela de empresa basta informar o IP & Porta, o mesmo informado no arquivo.conf

• Na opção de “Rotinas Forlog“, mude a coluna “Método“ para REST nas rotinas disponíveis/desejadas.

• Cada rotina selecionada estará apta a ser realizado a integração da mesma.

• Importante: As opções são por Estabelecimento, replique para todos os desejados e salve logo após.

• Na opção URL - REST, informe o caminho do servidor disponibilizado pela Forlog

• A configuração é por estabelecimento, deve ser aplicada nos quais ira ser utilizado.

Para configuração ENVIAR TIPO DE CLIENTE

0 - Normal, vai enviar os cadastros da forma que está atualmente programado, sem restrição

1 - Prestador não envia como Cliente, quando o cadastro for prestador então não deve enviar ele como cliente/fornecedor.
2 - Não envia Prestador, quando o cadastro for prestador e essa opção for marcada não será enviado o cadastro do mesmo.

Operações para importação de CTe/CTRC

• Configuração de CTRC/CTE, deve ser informado qual configuração de CTe e ctrc que na integração ira ser lançadas, com o tipo de conta movimento.

Instalar & Atualizar o Serviço

Para instalar o serviço basta executar o .bat: “ViasoftServidorForlogRESTServico_install.bat“

O .bat possui uma única linha: 1ViasoftServidorForlogRESTServico.exe /install

Após instalado, ele deve aparecer na tela de serviços do Windows, onde você pode iniciar ou parar conforme necessidade:

Quando precisar atualizar:

• Pare o serviço;

• Troque o exe;

• Inicie novamente.

Oque devemos passar para Forlog ter acesso à integração (REST)

Dado que para ocorrer a integração entre sistemas Quando a Forlog solicitar acesso ao AGRO e seu serviço oque devemos passar a eles é IP: porta de acesso externo(local onde serviço está instalado), com nome do banco, usuário e senha cadastrados no Agro do grupo 1(administrador). Entao sugere se que seja criado um usuário chamado VIA_INTEGRACAO com a senha overhead, assim iremos ter um padrão referente a essa integração. A senha ao ser enviada deve ser criptografada.

Exemplo

• IP 123.123.12.123:123

• "Database-Name","value":"NOME_DO_BANCO","

• "AUser":"VIA_INTEGRACAO",

• "APassword": "6b472ddf248d1e24c8ca18d02dc73e90"
  (senha citada acima já criptografada, significa overhead)

Descrição do Processo e configurações internas

Para integração de Pedidos

Pedidos» Configuração

Na aba principal ativa a integração com Forlog, Por padrão ela vai ficar como Não, basta que usuário defina como SIM.

Ao acessar a pasta de serviços de integração.

Geralmente fica em…

C:\Viasoft\Client\PlugIns\ServerTMS vamos encontrar o arquivo de configuração de pedidos para realizar o depara de informação.

Chamado de ViasoftServidorForlogRESTServicoExtras.conf

Esse arquivo tera como finalidade definir a entrada dos pedidos, cadas numero informado corresponde a configuração do Agro, e o 0 (zero) pode ser usado para nao integrar tal operação.

EX:

[TIPOSPEDIDO]

VENDA_TRANSFERENCIAS=597

VENDA_PRAZO=450

VENDA_DATAFIXA=959

VENDA_ESPELHO=958

VENDA_DIRETA=0

VENDA_DIRETA_CE=100

VENDA_ENTREGA_FUTURA=110

VENDA_ENTREGA_FUTURA_CE=457

Para questão financeira do pedido

Forma de pagamento na configuração de pedido deve conter o flag Padrão marcado.

Para integração de Pessoas

Dado que no menu Configurações» Configuração» Empresa» Aba Integrações/Web Services, campo UTILIZA FORLOG estiver igual a SIM. Quando é necessário integrar os cadastros de Pessoas

Para integração de Produto

Para que ‘item’ seja integrado com Forlog no menu Estoque» Item» Grupo, no cadastro de grupo existe a opção de identificar produto como pertencente a integração do WMS/Forlog quando mesmo estiver informado com, SIM, então devera ser enviado.

• As embalagens dos itens hoje é só envia oque tem relacionamento com o produto, valida oque esta na tabela PEMBALAGENS tudo que está vinculado e manda.

Ficha financeira

Através de uma chamada da Forlog pelo método xxx, será possível consultar um CNPJ/cpf cadastrado no agro e apresentar a informação da ficha financeira do mesmo.

• Também precisa acessar cadastro de empresa na aba Empresa a no campo LIMITE DE Crédito deixar opção 1- Limite de crédito Off-line.

• Após esse processo reprocessar os limites

(Cadastros Gerais » Pessoa» Recálculo do Limite Crédito)

• Visualização da tela de ficha financeira
  Cadastros Gerais» Pessoa» Ficha Financeira

Envio de cadastros em massa EXPIMPAgro3C

exportação em massa dos cadastros, para enviar basta acessar Processos » Exportação Forlog » Exportação Forlog, selecionar o método usado com os filtros definidos.

Enviar Nota Pdf ou Xml para Forlog

Dado que na versão do lote 729 foi disponibilizado a função de gravar PDF em disco local ou em banco, com formato binário então é possível disponibilizar esse arquivo para Forlog através da configuração, Configurações» Configuração» Agro» Gravar PDF em(…)

Além dessa configuração deve ser validar a configuração Notas» Configurações» Configuração»10. NFe / NFCe estiver igual a “Sim”

E por fim para ser enviado para Forlog na aba 19 da configuração de nota deve estar marcado opção Integração com wms/tms= s-sim

Versão