Árvore de páginas

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

(Obrigatório)

Informações Gerais 

Especificação

Produto

Datasul

Módulo

Vendas, Compras e Armazenagem de Grãos

Segmento Executor

Originação de Grãos

Projeto1

Integração Romaneio Produção com PIMS - Linha Datasul

IRM1

PCREQ-8569 

Requisito1

PCREQ-8712

Subtarefa1

PDR_AGR_ORI004-47

Chamado2

 

Release de Entrega Planejada

12.1.11

Réplica

Não se aplica.

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

(Obrigatório)

Objetivo

O presente requisito tem como objetivo viabilizar a integração das pesagens dos romaneios e a ordem de colheita, assim integrando o Módulo de Originação de Grãos e a solução PIMS. Deste modo, a integração será feita através da tecnologia EAI, de modo síncrono, onde será enviado para a solução PIMS os pesos das ordens de colheita. 

(Obrigatório)

Definição da Regra de Negócio

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

GG1005 - Parâmetros Grãos 

Alteração

Cadastros

 

GG2077 - Pendência Integração

Criação

Tarefas

 

GGAPI126 - API Integração Ordem de Produção

Criação

Não se aplica.

 

GetHarvestOrderAdapter - Adapter para o XSD GetHarvestOrder_1_000CriaçãoNão se aplica. 
GetHarvestOrderFactory - Geração do XML para o XSD GetHarvestOrder_1_000CriaçãoNão se aplica. 
WeighingRawMaterialsAdapter - Adapter para o XSD WeighingRawMaterials_1_000CriaçãoNão se aplica. 
WeighingRawMaterialsFactory - Geração do XML para o XSD WeighingRawMaterials_1_000CriaçãoNão se aplica. 
ChannelPIMS - Conexão com o Web Service PIMSCriaçãoNão se aplica. 
GG2000-z06 - Zoom das Listagens de Ordem de ColheitaCriaçãoNão se aplica. 
GG2000 - Romaneios AlteraçãoTarefas 
GGAPI126 - Api Entrada ProduçãoAlteraçãoNão se aplica. 

GG1005 - Parâmetros Grãos 

O referido programa vai ser alterado para a inclusão dos campos "Integração PIMS Romaneio de Produção" e "Url WS PIMS". Tais campos, estarão disponíveis na após clicar no novo botão "Integrações", onde será aberto uma janela para informar os dados correspondentes. Deste modo, os respectivos campos deverão estar informados para que o serviço de integração com o PIMS esteja ativo.

GG2077 - Pendências Integrações 

O programa de pendencia de integração tem como objetivo o reenvio de XMLs que apresentaram problemas ao integrar com o Web Service, tendo as seguintes características:

  • Permite o reenvio do XML que apresentou erro
  • Permite consultar todas integrações realizadas
  • Permite testar a conexão com o Web Service

GGAPI126 - API Integração Ordem de Produção

A referida API tem como objetivo reunir as funções que serão usadas para tratar os dados retornados dos adapters que farão a integração, tendo as seguintes funcionalidades:

  • Rotina para tratamento dos dados obtidos através do adapter GetHarvestOrder, obtendo a listagem das ordens de colheita.
  • Rotina para validar a ordem de colheita, realizando a verificação através do adapter GetHarvestOrder.
  • Rotina para enviar para o PIMS a pesagem da ordem de colheita informada, deste modo usando o adapter WeighingRawMaterials.
  • Rotina para cancelar o envio efeutado para o PIMS, utilizando o adapter WeighingRawMaterials na opção delete.
  • Rotina para cadastrar as integrações realizadas na tabela "gg-penden-integra".

GetHarvestOrderAdapter - Adapter para o XSD GetHarvestOrder_1_000

O adapter é uma classe que realiza a busca dos dados da Ordem de Colheita, tendo como características:

  • Ser desenvolvido com base no XSD GetHarvestOrder_1_000.
  • Utilização dos programas do EAI para tratamento dos dados.
  • Utilização do programa GetHarvestOrderFactory para criação do XML.

GetHarvestOrderFactory - Geração do XML para o XSD GetHarvestOrder_1_000

A classe GetHarvestOrderFactory  tem como objetivo criar o XML de requisição da listagem das ordens de colheita, tendo as características:

  • Ser desenvolvido com base no XSD GetHarvestOrder_1_000.
  • Utilização dos programas do EAI para tratamento dos dados.

Os dados incluídos no XML serão:

Parâmetros para requisição dos dados

Tag

Descrição

Tipo de dado

Obrigatório

CompanyId

Código da Empresa

CHAR(20)

Sim

BranchId

Código da Filial

CHAR(20)

Sim

WeighingDate

Data da Pesagem

DATE

Sim

HarvestOrderCode

Número da Ordem e Colheita

CHAR(10)

Não

ItemCode

Código do Produto

CHAR(20)

Não

Informações Enviadas

Tag

Descrição

Tipo de dado

Obrigatório

HarvestOrderCode

Número da Ordem de Colheita

CHAR(10)

Não

HarvestOrderDate

Data da Ordem de Colheita

DATE

Não

StartHarvestForecast

Previsão de Início de Colheita

DATE

Não

ClosingHarvestForecast

Previsão de Encerramento da Colheita

DATE

Não

VarietyCode

Código da Variedade

INT(10)

Não

VarietyDescription

Descrição da Variedade

CHAR(30)

Não

ItemCode

Código do Produto Matéria Prima

INT(38)

Não

HarvestSystemCode

Código do Sistema de Colheita

INT(10)

Não

HarvestSystemDescription

Descrição do Sistema de Colheita

CHAR(30)

Não

FarmCode

Código da [Fazenda]

CHAR (6)

Não

FarmDescription

Descrição da [Fazenda]

CHAR (50)

Não

SectorCode

Código do [Setor]

CHAR (6)

Não

SectorDescription

Descrição do [Setor]

CHAR (50)

Não

PartOfLandCode

Código do [Talhão]

CHAR (6)

Não

OccupationCode

Código da Ocupação do [Talhão]

INT(10)

Não

OccupationDescription

Descrição da Ocupação

CHAR (30)

Não

HarvestedArea

Área do [Talhão] a ser colhida

DECIMAL(7,2)

Não

HarvestEstimate

Estimativa (kg) de colheita para o [Talhão]

DECIMAL(10,4)

Não

WeighingRawMaterialsAdapter - Adapter para o XSD WeighingRawMaterials_1_000

O adapter é uma classe que realiza a o envio e cancelamento das pesagens da Ordem de Colheita, tendo como características:

  • Ser desenvolvido com base no XSD WeighingRawMaterials_1_000.
  • Utilização dos programas do EAI para tratamento dos dados.
  • Utilização do programa WeighingRawMaterialsFactory para criação do XML.
  • Rotina para Inserir e Deletar pesagem de Ordem de Colheita.

WeighingRawMaterialsFactory - Geração do XML para o XSD WeighingRawMaterials_1_000

A classe WeighingRawMaterialsFactory tem como objetivo criar o XML de envio de pesagens da ordem de colheita, tendo as características:

  • Ser desenvolvido com base no XSD WeighingRawMaterials_1_000.
  • Utilização dos programas do EAI para tratamento dos dados.

Os dados incluídos no XML serão:

Informações Recebidas

Tag-Campo

Descrição

Tipo de dado

Obrigatório

InternalId

InternalId de Integração

INT(38)

Não

CompanyId

Código da Empresa ERP

CHAR(20)

Sim

BranchId

Código da Filial ERP

CHAR(20)

Sim

MovementDate

Data do Movimento

DATE

Sim

EntryDate

Data e Hora da 1.ª Pesagem

DATE

Sim

ExitDate

Data e Hora da 2.ª Pesagem

DATE

Sim

WeightNumber

Número do documento utilizado na viagem.

INT(38)

Não

HarvestOrderCodePIMS

Número da Ordem de Colheita no PIMSMulticultivos

CHAR(10)

Não

HarvestOrderCode

Número da Ordem de Colheita Externa

CHAR(20)

Não

OccupationCode

Código da Ocupação no PIMSMulticultivos

INT(38)

Não

HarvestCode

Código da Safra no PIMSMulticultivos

INT(38)

Não

ProductionPeriodCode

Código do Período de Produção no PIMSMulticultivos

INT(38)

Não

FarmCode

Código da [Fazenda] no PIMSMulticultivos

CHAR(6)

Não

SectorCode

Código do [Setor] no PIMSMulticultivos

CHAR(6)

Não

PartOfLandCode

Código do [Talhão] no PIMSMulticultivos

CHAR(6)

Não

WarehouseCode

Código da Unidade Receptora no ERP

CHAR(20)

Não

TeamCode

Código da Equipe no PIMSMulticultivos

INT(38)

Não

EquipmentCode

Código do Equipamento no PIMSMulticultivos

CHAR(20)

Não

DriverCode

Código do Motorista no ERP

CHAR(20)

Não

HarvesterCode

Código da Colhedora no PIMSMulticultivos

CHAR(20)

Não

OperatorCode

Código do Operador no ERP

CHAR(20)

Não

InvoiceNumber

Número da Nota Fiscal

CHAR(10)

Não

InvoiceSerie

Número da Série

CHAR(5)

Não

InvoiceType

Tipo da Nota Fiscal (R - Remessa, V - Venda)

CHAR(1)

Não

GrossWeight

Peso da 1.ª Pesagem

INT(6)

Sim

TaraWeight

Peso da 2.ª Pesagem

INT(6)

Sim

ImpurityTotal

Quantidade total de impureza em Kg

DECIMAL(10,2)

Não

HarvestOrderDate

Data de Ordem de Colheita

DATE

Não

HarvestSystemCode

Código do Sistema de Colheita no PIMSMulticultivos

INT(38)

Não

AreaHarvestOrder

Área da Ordem de Colheita

DECIMAL(7,2)

Não

EstimatedWeight

Kg/Ha Estimados

DECIMAL(10,4)

Não

PackNumber

Número do Fardão

INT(12)

Não

WeighingBulletinNumber

Número do boletim da Pesagem Externa (Romaneio)

CHAR(20)

Sim

ChannelPIMS - Conexão com o Web Service PIMS

A referida classe tem como objetivo obter os dados de conexão que foram cadastrados no GG1005, para utilizarem as mesmas a fim de efetuar a conexão com o Web Service.

  • Disponibiliza os dados obtidos para uso nos adapters GetHarvestOrderAdapter e WeighingRawMaterialsAdapter

GG2000-z06 - Zoom das Listagens de Ordem de Colheita

O respectivo programa exerce-rá função de zoom para o campo ordem de colheita no GG2000:

  • Lista as Ordens de colheita conforme resultado obtido da integração.
  • Criar barra de progresso para avisar que os dados estão sendo buscados via WS.
  • Informar se não for possível buscar os dados via WS.

GG2000 - Romaneios 

O programa de romaneios deverá ser modificado para que esteja aderente as novas funcionalidades do romaneio por produção:

  • O programa gg2000-v01.w deverá ser modificado para habilitar o zoom  no campo ordem de colheita.
  • A habilitação só deverá acontecer se for romaneio por produção e a parametrização do campo  Integração PIMS Romaneio de Produção do gg1005 estiver ativa.
  • Antes de confirmar um romaneio de produção, se informado a ordem de colheita e ativa a integração, validar a ordem de colheita. Retornando inválida, parar o processo; Retornando erro na integração, permitir a inclusão, porém apresentar mensagem.
  • Ao finalizar a entrada por produção deverá ser acionado o envio de dados para o PIMS
  • Ao cancelar um romaneio por produção que tenha sido integrado com o PIMS, deve ser enviado uma solicitação de exclusão para o PIMS
  • Dando erro no processo, tanto na inclusão quanto no cancelamento, não deve ser impeditivo para a finalização do processo, porém deverá ser apresentada uma mensagem de erro.

GGAPI064 - API Entrada Produção

O respectivo programa será alterado com a finalidade de permitir, após o processo de movimentação de estoque o envio de dados do romaneio de produção para o PIMS. Deste modo, o programa GGAPI064 deverá executar as funções do programa GGAPI126 para enviar os dados para o PIMS. 

(Opcional)

Estrutura de Menu

 

Procedimentos

Procedimento

 GG2077

Descrição

Pendência Integração

Módulo

 GGP

Programa base

 GG2027

Nome Menu

Pendência Integração

Interface

GUI

Registro padrão

Sim

Visualiza Menu

Sim

Release de Liberação

 12.1.11

 

Programas

Programa

GG2077 

Descrição

Pendência Integração

Nome Externo

 ggp/gg2077.r

Nome Menu/Programa

Pendência Integração

Nome Verbalizado[1]

Pendência Integração

Procedimento

 GG2077

Template

Cadastro Simples

Tipo[2]

Manutenção

Interface

GUI

Categoria[3]

 Não se Aplica

Executa via RPC

Não

Registro padrão

Sim

Outro Produto

Não

Visualiza Menu

Sim

Query on-line

Sim

Log Exec.

Não

Rotina (EMS)

Não se Aplica

Sub-Rotina (EMS)

Não se Aplica

Localização dentro da Sub Rotina (EMS)

Não se Aplica

Compact[4]

Não se Aplica

Home[5]

Não se Aplica

Posição do Portlet[6]

Não se Aplica

Informar os papeis com os quais o programa deve ser vinculado

Não se Aplica

 



[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.