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

URL AcessoAPI: prg/api/ggp/v1/TPesagService/v1/composition/fields

Método: GET

Descritivo: Este O método irá retornar ao T-PESAG os campos adicionais, que serão disponibilizados na tela de pesagem, afim de prover todas as informações necessários necessárias ao módulo de Originação de Grãos do TOTVS Datasul referentes a pesagem e a carga. O método é responsável por retornar apenas os campos, sem a estrutura e relacionamentos das entidades.

No caso do Originação de Grãos, serão retornados São disponibilizados os seguintes campos:

codDepos - Informação referente ao código do depósito da carga;

...

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

EntityHeader

URL AcessoAPI: prg/api/ggp/v1/TPesagService/v1/entityHeader

Método: GET

Descritivo: Este O método irá retornar ao T-PESAG a estrutura de campos das entidades adicionais da pesagem. Com ele será possível modelar cada uma das entidade e seus relacionamentos.

As estrutura estruturas retornadas referem-se as entidades:

...

lote - Estrutura dos campos referente a tabela de lotes.

Data

URL AcessoAPI: prg/api/ggp/v1/TPesagService/v1/data/<entidade>

Método: GET

Descritivo: Este O método irá retornar ao T-PESAG a carga de dados das entidades adicionais da pesagem, bem como novamente a estrutura de campos da entidade consultada.

...

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

Unity

URL AcessoAPI: prg/api/ggp/v1/TPesagService/v1/unity

Método: GET

Descritivo: Este O método irá retornar ao T-PESAG a carga de dados das entidades nativas, ou seja, já existentes na pesagem. O objetivo é apenas alimentar os cadastrados cadastros com os dados do Originação de Grãos. Neste caso, serão retornados os dados referentes aos estabelecimentos.

Entidades retornadas:

estabelecimento - Dados referentes aos estabelecimentos cadastrados no EMS;.

Product

API: /api/ggp/v1/TPesagService/v1/product

Método: GET

Descritivo: O método irá retornar a carga de dados das entidades nativas, ou seja, já existentes na pesagem. O objetivo é apenas alimentar os cadastrados com os dados do Originação de Grãos. Neste caso, serão retornados os dados referentes aos produtos.

Entidades retornadas:

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

Composition

URL AcessoAPI: prg/api/ggp/v1/TPesagService/v1/composition

Método: POST

Descritivo: Este O método irá registrar a pesagem recebida do T-PESAG, 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 (Portinarihtml.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) ou via Monitor de Romaneios (Portinari)  será possível ajustar algum dado pendente do romaneio , e fazer sua confirmação gerando 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.

Problema: Serviço "TPesagService" indisponível para consulta.

Solução: Verificar se os serviços REST do TOTVS Datasul estão disponíveis para consumo.

Problema: Não está retornando dados na consulta "Data".

Solução: Verificar se o parâmetro da entidade está sendo passado corretamente, e se está na lista de entidades disponíveis para consultaJá via Monitor de Romaneios (html.ggp.packingListsList) é possível somente confirmar a nota fiscal.

<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>

...