Histórico da Página
ÍNDICE
Índice exclude Í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 o parceiro externo M2M para buscar e atualizar a cotação de moedas(atual e futura), índices de mercado e índices de commoditycommodities de Bolsa de Referência, 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 (scheduleSchedule).Todo acesso é feito através de autenticação (HTTP Basic) de um usuário existente no servidor da API REST do
Os dados necessários para integração deverão ser solicitados junto ao parceiro M2M.
02. CONFIGURAÇÃO/PARÂMETROS DA ROTINA
Principais parâmetros:
Parâmetro | Descrição | Conteúdo padrão |
| MV_AGRO200 | URL |
| : Utilizada para realizar a autenticação de integração com a M2M. | |
E-mail para realizar |
a autenticação para a geração do Token e integração M2M. | |
| MV_AGRO202 |
| Password para realizar a |
| autenticação para a geração do Token e integração M2M. | |
| MV_AGRO203 | URL: Utilização do Token para solicitar a |
| cotação Atual - Passada | ||
| MV_AGRO204 | URL: Utilização do Token para solicitar a cotação Atual - Futura |
Pré-requisitos:
- Parâmetros MVParâmetros MV_AGRO200, MV MV_AGRO201,MV_AGRO202 , MV MV_AGRO203 e MV e MV_AGRO204 configurados configurados.
- Possuir nas rotinas os campos de integração devidamente configurados.
03. INTEGRAÇÃO COTAÇÃO DE MOEDAS VIA ROTINA MOEDAS PROTHEUS X EXTERNO(OGA011)
Necessário configurar os
...
parâmetros MV_AGRO200,
...
...
...
e MV_AGRO204.
No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Cadastros Básicos→ Moeda Protheus x Externo.
Exclusivamente para Moedas, nesse programa devem ser informados os códigos externos correspondente a moeda que deverá ser requisitado ao parceiro M2M, para que o mesmo disponibilize as respectivas cotações.
...
Na imagem abaixo é apresentado um exemplo do cadastro da Moeda Protheus x Externo.
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 externo que o parceiro 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 externo que o parceiro M2M disponibiliza.
Para realizar a integração por demanda da cotação da moeda, acessar no menu em Outras Ações → Atualizar Cotação.
Para
...
conferência, a cotação da moeda poderá ser verificada na rotina Moedas (MATA090).
04. INTEGRAÇÃO COTAÇÃO DE ÍNDICES VIA ROTINA ÍNDICES DE MERCADO(OGA080)
Necessário configurar os
...
parâmetros MV_AGRO200,
...
...
...
e MV_AGRO204.
No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Precificação → Índices de Mercado
Neste programa há duas formas de integração de índice.
1. Cadastro de Índice com campo código futuro preenchido
No cadastro do índice de mercado, deve ser informado no campo "Cod Futuro" o código
...
externo correspondente ao índice que deverá ser requisitado
...
ao parceiro M2M, para que o mesmo disponibilize as respectivas cotações.
...
Na imagem abaixo é apresentado um exemplo do cadastro de um índice de mercado com campo "Cod Futuro" preenchido.
2. Cadastro de Índice com Bolsa de
...
Referência.
Os cadastros de Índices com campo "Cod Bolsa
...
" preenchido, são criados automaticamente pela integração da rotina Bolsa de
...
Referência (OGA720), que será visto
...
no tópico 05 mais abaixo.
Para realizar a integração por demanda dos índice de mercado, acessar no menu em Outras Ações → Atualizar Cotação.
Caso o índice selecionado seja com bolsa de
...
referência, na opção "Atualizar Cotação" a integração irá atualizar todos os índices da bolsa de
...
referência.
Para conferencia a cotação do índice poderá ser verificada na rotina Cotação de Índice(OGA090).
Integração cotação de Índices via rotina Bolsa de Referencia(OGA720)
...
05. INTEGRAÇÃO COTAÇÃO DE ÍNDICES VIA ROTINA BOLSA DE
...
REFERÊNCIA(OGA720)
Necessário configurar os
...
parâmetros MV_AGRO200,
...
No módulo de Gestão de Agronegócio, acesse no menu Atualizações → Comercialização → Precificação → Bolsa de Referência
No cadastro de bolsa de
...
referência deve ser informado no campo "URL Integra" a URL de integração correspondente a bolsa de mercado(CBOT, BMF, ESALQ, etc) que deverá ser requisitado ao parceiro M2M, e na
...
tabela de Índices de
...
commodities no campo "Cod Futuro" deverá ser informado o
...
código externo correspondente ao índice da bolsa para que o mesmo disponibilize as respectivas cotações.
...
Cada bolsa poderá ter um ou mais índices de
...
commodities cadastrado. Na imagem abaixo é apresentado dois exemplos do cadastro de
...
Bolsa de
...
Referência.
Para realizar a integração por demanda dos índice da
...
Bolsa de
...
Referência, acessar no menu em Outras Ações → Atualizar Índices Bolsa.
Ao realizar a integração, o sistema verifica se os índices retornados pela API REST estão cadastrados, caso não, será incluído o índice no sistema, assim como sua cotação será incluída ou atualizada.
Para
...
conferência poderá ser verificado na rotina de Índices de
...
Mercado (OGA080) os índices incluído, estes estarão com o campo "Cod Bolsa" preenchido. E a cotação poderá ser verificada na rotina Cotação de Índice (OGA090).
...
06. INTEGRAÇÃO VIA AGENDAMENTO
...
AUTOMÁTICO(SCHEDULE)
Utilizando o Schedule Protheus, pode ser criado um agendamento para execução da rotina OGX300
...
, que realiza a integração com o API REST do parceiro M2M para atualização das moedas e índices de mercado, possibilitando informar a recorrência desejada (diária, semanal, mensal, anual ou sempre ativo)
...
a critério da necessidade de cada cliente.
...
Para correta integração via Schedule, é necessário configurar os parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203 e MV_AGRO204 e nas rotinas de cadastro já mencionados nos tópicos acima, realizar o preenchimentos dos campos para a integração.
Na imagem abaixo é apresentado um exemplo de cadastro no Schedule para a rotina OGX300 de integração.
07. CONTEÚDOS RELACIONADOS
A rotina OGX300
03. EXEMPLO DE UTILIZAÇÃO
Para incluir um contrato de venda fixo em moeda estrangeira:
- Parâmetros MV_AGRA001, MV_AGRO002 e MV_AGRO040 habilitados. Os parâmetros devem ser alterados no módulo Configurador;
- Em Gestão de Agronegócio (SIGAAGR) acesse Atualizações > Comercialização > Negociação > Contrato de Venda > Contrato de Venda;
- Clique em Incluir;
- Informe os campos obrigatórios:
- Na pasta Principal: (Entidade, Safra, Produto, TES);
- Na pasta Previsão de Entrega (Quantidade, Filial de Origem);
- Na pasta Financeiro (Ref. Contrato, Tipo Valor, Quantidade/Percentual).
- Na pasta Dados Negócio / Financeiro o campo Tipo Fix. para "1 - Fixo".
- Para caracterizar o contrato de venda como moeda estrangeira informe os dados abaixo:
- Na pasta Principal o campo Tipo de Mercado deve ser 1 - Interno;
- Na pasta Dados Negócio / Financeiro o campo Moeda deve ser diferente de 1.
- Após informar os dados, clique em Confirmar;
- Para realizar a fixação de preço acesse Outras Ações → Fixação de Preço;
- Informe os valores nos componentes e clique em Confirmar. Observar que o preço de venda que foi fixado está na moeda do contrato (imagem abaixo);
- Acesse Outras Ações → Gerar Previsão Financeira para gerar os valores financeiros;
- Acesse Outras Ações → Confirmar para efetivar o contrato de venda.
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:
- Parâmetros MV_AGRA001, MV_AGRO002 e MV_AGRO040 habilitados. Os parâmetros devem ser alterados no módulo Configurador;
- Em Gestão de Agronegócio (SIGAAGR) acesse Atualizações > Comercialização > Negociação > Contrato de Venda > Contrato de Venda;
- Clique em Incluir;
- Informe os campos obrigatórios:
- Na pasta Principal: (Entidade, Safra, Produto, TES);
- Na pasta Previsão de Entrega (Quantidade, Filial de Origem, Data Limite de Fixação, Mês Bolsa, Idx. Negócio);
- Na pasta Financeiro (Ref. Contrato, Tipo Valor, Quantidade/Percentual).
- Na pasta Dados Negócio / Financeiro o campo Tipo Fix. para "2 - A Fixar".
- Para caracterizar o contrato de venda como moeda estrangeira informe os dados abaixo:
- Na pasta Principal o campo Tipo de Mercado deve ser 1 - Interno;
- Na pasta Dados Negócio / Financeiro o campo Moeda deve ser diferente de 1.
- Após informar os dados, clique em Confirmar;
- Para realizar a fixação de componente acesse acesse Outras Ações → Fixação de Preço;
- Informe os valores nos componentes e clique em Confirmar. Em contratos a fixar somente é possível fixar os componentes. Para fechar o valor, a fixação de preço deve ocorrer pelo Painel de Fixações;
- Acesse Outras Ações → Gerar Previsão Financeira para gerar os valores financeiros. Nesse momento, como não há fixação de preço os valores são calculados em base ao índice informado;
- Acesse Outras Ações → Confirmar para efetivar o contrato de venda.
Para consultar os títulos financeiros gerados:
- Em Gestão de Agronegócio (SIGAAGR) acesse Atualizações > Comercialização > Negociação > Contrato de Venda > Contrato de Venda;
- Posicione no contrato de venda que deseja consultar;
- Clique em Visualizar;
- Clique na pasta Financeiro;
- Na parte inferior são apresentadas as previsões financeiras que foram geradas (data de vencimento e valor).
- NOTA: Para realizar a gestão dos títulos utilize o Painel Financeiro;
Para consultar os valores financeiros, de faturamento e fixados:
- Em Gestão de Agronegócio (SIGAAGR) acesse Atualizações > Comercialização > Negociação > Contrato de Venda > Contrato de Venda;
- Posicione no contrato de venda que deseja consultar;
- Clique em Visualizar;
- Clique na pasta Previsão de Entrega;
- Na tabela superior da pasta Previsão de Entrega selecione a cadência que deseja consultar os valores;
- Na tabela inferior da pasta Previsão de Entrega são exibidas regras fiscais. Para cada regra fiscal é possível ter acessos aos valores do contrato nos campos Vlr. Tot. Fin, Vlr. Tot. Fat e Vlr. Tot. Fix.
- NOTA: Na nova comercialização existe o conceito de regra fiscal que é similar a um pedido. Uma previsão de entrega pode ter uma ou mais regras fiscais.
Para gerar um relatório com os dados financeiro (faturamento e fixação):
- Em Gestão de Agronegócio (SIGAAGR) acesse Atualizações > Comercialização > Negociação > Contrato de Venda > Contrato de Venda;
- Posicione no contrato de venda que deseja gerar o relatório;
- Clique em Outras Ações → Mais Ações → Extrato Contrato;
- Clique em Imprimir.
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
- Contrato de venda;
- Painel de Fixações;
- Painel Financeiro;
- Registro de Negócio Opcional.
| HTML |
|---|
<!-- 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>
|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas