01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Possibilitar a criação dos romaneios no Originação de Grãos, com base nos dados fornecidos pela pesagem da carga, via integração REST.

Retornar para o TOTVS Agro Pesagem os cadastros necessários para o correto funcionamento da integração.

03. SOLUÇÃO

Com o objetivo de prover os dados corretos ao TOTVS Agro Pesagem e permitir a geração dos romaneios de carga no Originação de Grãos, foi desenvolvido o serviço REST "TPesagService" que possibilita acesso aos métodos detalhados abaixo:

Composition Fields

API: /api/ggp/v1/TPesagService/v1/composition/fields

...

lote - Informação referente ao fardo da carga.

EntityHeader

API: /api/ggp/v1/TPesagService/v1/entityHeader

...

lote - Estrutura dos campos referente a tabela de lotes.

Data

API: /api/ggp/v1/TPesagService/v1/data/<entidade>

...

lote - Dados e estrutura referentes aos lotes/fardos já instruídos e aprovados no Originação de Grãos.

Unity

API: /api/ggp/v1/TPesagService/v1/unity

...

produto - Dados referentes aos produtos/itens cadastrados no Originação de Grãos.

Composition

API: /api/ggp/v1/TPesagService/v1/composition

...

Descritivo: O método irá registrar a pesagem recebida, bem como os dados adicionais da carga, gerando um Romaneio (GG2000) no Originação de Grãos. Os dados recebidos neste método precisam estar adequados com as informações retornadas nos métodos descritos anteriormente. Como retorno, o método informa o número do romaneio gerado e possíveis erros de negócio, caso ocorram.

Como Integrar

Como este serviço foi disponibilizado para consumo via padrão REST, basta que a aplicação de origem faça a requisição conforme desejado (GET ou POST).

...

Para mais detalhes sobre APIs REST, basta acessar o Guia de APIs Datasul.

Após Integrar

Após realizada a integração da pesagem com o Originação de Grãos, é possível fazer a consulta deste romaneio por intermédio da tela de Romaneios (GG2000) ou via Monitor de Romaneios (html.ggp.packingListsList), onde o romaneio poderá ser localizado utilizando-se do número retornado pelo método "Composition".

Também via tela de Romaneios (GG2000) será possível ajustar algum dado pendente do romaneio e fazer sua confirmação gerando a nota fiscal. Já via Monitor de Romaneios (html.ggp.packingListsList) é possível somente confirmar a nota fiscal.

Possíveis Falhas na Utilização dos Métodos

Abaixo segue uma lista de possíveis falhas, e soluções, que possam ocorrer na utilização dos métodos deste serviço.

...