Linha Microsiga Protheus

Árvore de páginas


01. DADOS GERAIS

Linha de Produto:Protheus
Segmento:Backoffice
Módulo:SIGAAGR - Gestão de Agronegócio
Função:API´s de Integração com o T-Pesag
Requisito/Story/Issue (informe o requisito relacionado) :DAGROCCO-2399


02. SITUAÇÃO/REQUISITO

O T-Pesag realizará integração das pesagens com o Módulo SIGAAGR - Gestão de Agronegócio - Protheus.

Desta forma, foi necessário disponibilizar API´s para integrar informações entre T-Pesag e Protheus, de forma que seja possível gerar o Romaneio e Apontamento de Produção no Protheus a partir das pesagens coletadas pelo T-Pesag. 

03. SOLUÇÃO

Foram desenvolvidas API´s Públicas, específicas para a integração com o T-Pesag, cujas funções são:

  • Permitir que o T-Pesag tenha acesso à informações de Cadastros Básicos do Protheus, para que não seja necessário replicar informações a fim de realizar a pesagem dos produtos agrícolas na aplicação; e
  • Possibilitar o envio das pesagens coletadas pelo T-Pesag, para que seja possível gerar o Romaneio e Apontamento de Produção no Protheus. 
Obs.: As API´s foram desenvolvidas sem necessidade de autenticação.

No quadro abaixo segue o detalhamento de cada API:


APIDetalhes TécnicosDescritivo

Estrutura de Entidades

Endpoint:

.../rest/tpesagapi/api/agr/v1/entityHeader/

Essa API disponibiliza dados da estrutura da Entidade do T-Pesag.

Estruturas/Tabelas disponibilizadas:

NJ0 – Produtores

NJU – Safras

NNR – Locais de Estoque

Carga de Dados de Entidades

EndPoint:

 .../rest/tpesagapi/api/agr/v1/data/{codigo}

Essa API disponibiliza a carga de dados da Entidade do T-Pesag.

Carga das Tabelas:

NJ0 – Produtores

NJU – Safras

NNR – Locais de Estoque

Atributos

EndPoint:

.../rest/tpesagapi/api/agr/v1/composition/fields

Essa API informa alguns campos do Protheus como Entidade/Loja, Safra e Local, que deverão ser criados como Atributos no T-Pesag. 

Campos:

NJ0_CODENT - Código da Entidade

NJ0_LOJENT - Loja da Entidade

NJU_CODSAF - Código da Safra

NNR_CODIGO - Código do Local

Cadastro de Produtos

EndPoint:

.../rest/tpesagapi/api/agr/v1/product

Essa API disponibiliza as informações dos Produtos cadastrados no Protheus.

Tabela: 

SB1 - Produtos

Cadastro de Equipamentos (Veículos)

EndPoint:

.../rest/tpesagapi/api/agr/v1/equipments

Essa API disponibiliza as informações dos Veículos cadastrados no Protheus.

Tabela: 

DA3 - Veículos

Cadastro de Funcionários (Motoristas)

EndPoint:

.../rest/tpesagapi/api/agr/v1/employee

Essa API disponibiliza as informações dos Motoristas cadastrados no Protheus.

Tabela: 

DA4 - Motoristas

Cadastro de Tabelas de Classificação e  de Descontos

EndPoint:

.../rest/tpesagapi/api/agr/v1/discountRangesHE 

.../rest/tpesagapi/api/agr/v1/analysis

Essa API disponibiliza as informações das Tabelas de Classificação e de Descontos cadastradas no Protheus.

Pesagem

EndPoint:

/rest/tpesagapi/api/agr/v1/composition 

Essa API vai receber uma requisição (POST) com as informações das pesagens, analisar e acionar a API do OGA250 - Romaneio para realizar a pesagem e os apontamentos no Protheus.