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 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 M2M.
Principais parâmetros:
Parâmetro | Descrição | Conteúdo padrão | Conteúdo exigido para esta rotina |
| MV_AGRO200 | URL utilizada para realizar a autenticação | ||
MV_AGRO201 | E-mail para realizar a autenticação | ||
| MV_AGRO202 | Senha para realizar a autenticação | ||
| MV_AGRO203 | URL para solicitar a cotação Atual | ||
| MV_AGRO204 | URL para solicitar a cotação Futura |
Pré-requisitos:
Necessário configurar os parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203 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. Cada moeda existente no Protheus, terá seu respectivo código externo na API REST do parceiro M2M.
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 conferencia a cotação da moeda poderá ser verificada na rotina Moedas(MATA090).
Necessário configurar os parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203 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.
No cadastro do índice de mercado deve ser informado no campo "Cod Futuro" o código externos correspondente ao índice que deverá ser requisitado ao parceiro M2M, para que o mesmo disponibilize as respectivas cotações. Cada Índice existente no Protheus, poderá ter seu respectivo código externo na API REST do parceiro M2M.
Na imagem abaixo é apresentado um exemplo do cadastro de um índice de mercado com campo "Cod Futuro" preenchido.
Os cadastros de Índices com campo Bolsa de referencia, são criados automaticamente pela integração da rotina Bolsa de Referencia(OGA720), que será visto em outro tópico 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 referencia, na opção "Atualizar Cotação" a integração irá atualizar todos os índices da bolsa de referencia.
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)
Necessário configurar os parâmetros MV_AGRO200, MV_AGRO201, MV_AGRO202.
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 referencia 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 grid de Índices de commodity no campo "Cod Futuro" deverá ser informado o codigo externo correspondente ao índice da bolsa para que o mesmo disponibilize as respectivas cotações. Cada Bolsa e respectivo Índice existente no Protheus, poderá ter seu respectivo código externo na API REST do parceiro M2M.
Cada bolsa poderá ter um ou mais índices de commodity 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 referencia, 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 conferencia 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).
Utilizando o Schedule Protheus, pode ser criado um agendamento para execução da rotina OGX300, informando a recorrência desejada (diária, semanal, mensal, anual ou sempre ativo). A recorrência fica a critério da necessidade de cada cliente.
A rotina OGX300
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):
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
<!-- 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>
|