Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01. DADOS GERAIS

Linha de Produto:Datasul
Segmento:Agroindústria
Módulo:Venda, Compra e Armazenagem de Grãos
Função:

html.ggp.lotes - Gestão de Blocos

GG4091 - Integração Expedição Lotes x Agro Beneficiamento

GG1024 - Parâmetros Integração Grãos

Requisito/Story/Issue (informe o requisito relacionado) :DAGROOGD-9086


02. SITUAÇÃO/REQUISITO

Os lotes vinculados aos contratos de vendas necessitam ter suas características técnicas atualizadas, deste modo permitindo a gestão da sua comercialização. Ocorre que os Os processos que verificam alteram essas características podem acontecer na solução Totvs Beneficiamento. Portanto, surge solução TOTVS Agro Beneficiamento, logo, há a necessidade de ter a integração destes dados de forma automatizadaintegração destas informações.

03. SOLUÇÃO

Surgindo a necessidade de ter a atualização de dados entre as soluções de Originação de Grãos e Totvs Beneficiamento, foram Foram desenvolvidas APIs para a atualização de dados.

...

API que pode ser executada para atualizar características de determinado lote. Pode ser realizado de forma agrupado, deste modo permitindo informar vários lotes e várias características.

Com o uso da referida API, o Totvs TOTVS Agro Beneficiamento atualizará as características técnicas do lote.

API: /api/ggp/v1/loteCharacteristics/createAll/

Método: POST

Payload:  "itens" : "Array"  - Contém a lista de objetos a serem atualizados.

"cdComp" : "String" - Código da Característica Técnica a ser atualizada, conforme parametrização no GG1005B.

"desResult" : "String" - Resultado da Característica Técnica

"datAtualiz" : "String" - Data da atualização

"hraAtualiz": "String" - Hora da atualização

"codLote" : "String" - Lote a ser atualizado

"itCodigo" : "String" - Código do Produto a ser atualizado.

Exemplo:  {

"itens": [

{
"cdComp": "LEN",
"codUsuario": "super",
"datAtualiz": "2020-04-22T13:04:56.661Z",
"desResult": "1,00",
"hraAtualiz": "10:04:00",
"codLote": "0099099898990/2020",
"itCodigo": "algodao"
}

]

}


Atualizando as informações do Bloco no TOTVS Agro Beneficiamento.

Quando um lote é faturado via rotinas do Originação de Grãos, é possível atualizar as informações deste lote no sistema externo. Para isto, faz-se necessário realizar a configuração de integração no GG1024 - Parâmetros Integração Grãos, bem como executar o relatório GG4091 - Integração Expedição Lotes x Agro Beneficiamento.


GG1024 - Parâmetros Integração Grãos

As configurações de integração com o sistema de beneficiamento devem ser dispostas no registro 4 - TOTVS Agro Beneficiamento. Assim, os dados de autenticação devem ser informados para o usuário, bem como a URL de conexão.

A informação de URL Integração é o caminho do Web Service do produto TOTVS Agro Beneficiamento. Ainda, é possível informar um e-mail, para que seja o destinatário caso ocorra erros durante o processo de integração.


Image Added


Para o correto funcionamento, deve-se informar obrigatoriamente os dados para autenticação no TOTVS Agro Beneficiamento, assim preenchendo os dados do usuário de autenticação.


Image Added


As informações referentes ao Usuário, Senha, Url de Autenticação, Client ID e Client Secret poderá ser obtida com o produto TOTVS Agro Beneficiamento.


Image Added


GG4091 - Integração Expedição Lotes x Agro Beneficiamento

O relatório tem como finalidade realizar a integração dos lotes faturados com o TOTVS Agro Beneficiamento, atualizando os dados no Beneficiamento. Possíveis problemas encontrados também serão exibidos.

É possível filtrar os registros a serem listados, porém quando o relatório é executado em modo "Batch" é importante deixar o filtro abrangente, uma vez que ao realizar a integração será enviado todos os itens pendentes para o TOTVS Agro Beneficiamento . 


Image Added


Em Parâmetro terá três opções:

  • Integração e Relatório: busca os faturamentos que estão pendentes de integração, lista em relatório, e chama a integração para passar estas informações para o TOTVS AGRO Beneficiamento.
  • Integração: busca os faturamentos que estão pendentes de integração e executa a integração para passar estas informações para o TOTVS AGRO Beneficiamento. Em caso de execução Batch, esta seria a opção recomendada.
  • Relatório: busca os faturamentos que estão pendentes de integração, ou já Integrados, conforme parâmetros em tela e lista em relatório.


Image Added


Os modos de execução do relatório são:

  • On-line: execução no momento, pelo usuário que estiver acessando (GG4091).
  • Batch: execução automática em servidor. Pode ser programado por exemplo uma vez ao dia.


Image Added


Durante a execução da integração podem ocorrer problemas, deste modo na listagem é apresentada a relação de erros na execução.

Para solução desses erros pode ser necessário aplicar o certificado do ambiente TOTVS Agro Beneficiamento, assim ocorrendo o erro "Secure Socket SSL, código de erro -54: unable to get issuer certificate - 9318", deve-se realizar o procedimento descrito em https://centraldeatendimento.totvs.com/hc/pt-br/articles/360025880814-DS-TEC-Aplica%C3%A7%C3%A3o-de-certificados-no-Progress.



Templatedocumentos


HTML
<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;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

...