DAGROOGD-9086 DT Integração Originação de Grãos e Beneficiamento

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

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

03. SOLUÇÃO

Foram desenvolvidas APIs para a atualização de dados.

Atualização de Característica Técnica

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

Com o uso da referida API, o 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.