Histórico da Página
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.
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.
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.
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 .
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.
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.
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> |
...