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. E permitir a consulta de dados essenciais do Originação para o correto funcionamento do TOTVS Pesagem.

03. SOLUÇÃO

Com o objetivo de prover os dados corretos ao TOTVS 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 Acesso: prg/ggp/v1/TPesagService/v1/composition/fields

Descritivo: Este 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 ao 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 os seguintes campos:

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

desSafra - Informação referente a safra da carga;

codEmitente - Informação referente ao código do emitente da carga;

codInscricao - Informação referente ao código da inscrição do emitente;

cdnTranspdor - Informação referente ao código do transportador da carga;

numInstruc - Informação referente ao número da instrução de liberação;

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

EntityHeader

URL Acesso: prg/ggp/v1/TPesagService/v1/entityHeader

Descritivo: Este 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 retornadas referem-se as entidades:

deposito - Estrutura dos campos referente a tabela de depósito;

safra - Estrutura dos campos referente a tabela de safra;

emitente - Estrutura dos campos referente a tabela de emitente;

inscricao - Estrutura dos campos referente a tabela de inscrição;

transportador - Estrutura dos campos referente a tabela de transportador;

instrucao - Estrutura dos campos referente a tabela de instrução;

lote - Estrutura dos campos referente a tabela de lotes.

Data

URL Acesso: prg/ggp/v1/TPesagService/v1/data/<entidade>

Descritivo: Este 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.

Entidades possíveis de serem consultadas:

deposito - Dados e estrutura referentes aos depósitos cadastrados no EMS;

safra - Dados e estrutura referentes as safras cadastradas no Originação de Grãos;

emitente - Dados e estrutura referentes aos emitentes que possuem contratos com o Originação de Grãos;

inscricao - Dados e estrutura referentes as inscrições cadastradas no Originação de Grãos;

transportador - Dados e estrutura referentes aos transportadores cadastrados no EMS;

instrucao - Dados e estrutura referentes as instruções de embarque aprovadas no Originação de Grãos;

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

Unity

URL Acesso: prg/ggp/v1/TPesagService/v1/unity

Descritivo: Este 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 com os dados do Originação de Grãos.

Entidades retornadas:

estabelecimento - Dados referentes aos estabelecimentos cadastrados no EMS;

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

Composition

URL Acesso: prg/ggp/v1/TPesagService/v1/composition

Descritivo: Este 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.

Após Integração

Após realizada a integração da pesagem com o Originação de Grãos, é possível fazer a consulta deste por intermédio da tela de Romaneios (GG2000) ou via Monitor de Romaneios (Portinari), onde o romaneio poderá ser localizado utilizando-se o 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, e fazer a confirmação do romaneio 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 consulta.

Problema: dasda

Solução: dasdad

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