ÍNDICE


01. VISÃO GERAL

O módulo de Gestão de Agronegócio possui a opção de integração via API REST com parceiro externo M2M para buscar e atualizar a cotação de moedas(atual e futura), índices de mercado e índices de commodity, de forma que possam ser realizadas as negociações de venda e compra e geração de relatórios gerenciais com valores atualizados.

A integração funciona através de requisições HTTP, buscando as informações do serviço API REST para interagir com seus recursos. A integração funciona de duas formas: por demanda ou agendamento automático (schedule).

Todo acesso é feito através de autenticação (HTTP Basic) de um usuário existente no servidor da API REST do parceiro externo M2M.  A autenticação é temporária e a integração requisita uma nova a cada interação com a API REST.

02. CONFIGURAÇÃO/PARÂMETROS DA ROTINA

Principais parâmetros:

Parâmetro

Descrição

Conteúdo padrão

Conteúdo exigido para esta rotina
MV_AGRO200URL utilizada para realizar a autenticação

MV_AGRO201

E-mail para realizar a autenticação



MV_AGRO202Senha para realizar a autenticação

MV_AGRO203URL para solicitar a cotação Atual 

MV_AGRO204URL para solicitar a cotação Futura


Pré-requisitos:


OGA410 - Cadastro de Componentes e Preço

No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Cadastros Básicos→ Moeda Protheus x Externo.

Na imagem abaixo é apresentado um exemplo do cadastro de moeda.

Para a integração e atualização da cotação atual da moeda(do dia) é necessário preencher o campo "Cod Atual" com o código que o parceiro externo M2M disponibiliza.

Para a integração e atualização da cotação futura da moeda é necessário preencher o campo "Cod Futuro" com o código que o parceiro externo M2M disponibiliza.


OGA490 - Configuração de Componentes

No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Precificação → Configuração de Componentes.

Para o componente de resultado é obrigatório definir a fórmula de cálculo, ou seja, como o valor final será gerado.


03. EXEMPLO DE UTILIZAÇÃO

Para incluir um contrato de venda fixo em moeda estrangeira:

Na imagem a seguir é exibido um exemplo de fixação de preço. Quando o contrato de venda é fixo, a fixação será sempre de preço. Portanto, não é permitido fixar apenas o componente.

Sendo moeda estrangeira, a fixação é na moeda do contrato.


Para incluir um contrato de venda a fixar em moeda estrangeira:


Para consultar os títulos financeiros gerados:


Para consultar os valores financeiros, de faturamento e fixados:


Para gerar um relatório com os dados financeiro (faturamento e fixação):


04. PREVISÕES FINANCEIRAS

Ao utilizar a funcionalidade de Gerar Previsão Financeira do Contrato de Venda são gerados títulos de previsão no módulo do financeiro (SIGAFIN) e sua gestão deve ocorrer no Painel Financeiro. Neste programa é possível vincular as previsões com os recebimentos (RA) e permitir que os títulos de NF relacionados sejam baixados automaticamente.

Quando vincular uma previsão financeira com um recebimento e esta previsão já tenha títulos de NF vinculados, os mesmos são baixados automaticamente. Caso tenha saldo a faturar e saldo de recebimento do que foi vinculado, os próximos faturamentos são liquidados automaticamente ao confirmar o romaneio.

Valores Financeiros e de Faturamento do Contrato de Venda

05. CONTEÚDOS RELACIONADOS


<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>