...
Linha de Produto: | PIMSConnector. |
Segmento: | Agroindústria. |
Módulo: | Mensagens integração. |
Função: | Integração de Apropriação Direta de Orçamento |
Situação/Requisito: | Realizar a integração das Despesas Orçamentos do Prophix para o PIMS Multicultivos |
Solução/Implementação: | Implementar novas rotinas utilizando utilizando recuperação de informações para integração via objeto de banco algumas rotinas para integrar os dados enviados do Prophix para o PIMS Multicultivos. |
Requisito: | DAGROINTEGRACAO-815/DAGROINTEGRACAO-909/DAGROINTEGRACAO-1340 |
Definição do Processo
A integração de Apropriação Direta do Orçamento, consiste na movimentação das despesas orçamentarias para os centro de custos de mão de obras.
...
O modelo de integração utilizado para comunicação do PIMS Multicultivos x Prophix, será via Objeto de Bancomensagem padronizada, utilizando o PIMSConnectorA integração via objeto de banco, utiliza tabelas intermediárias para trafegar as informações entre o PIMS Multicultivos com Prophix .O Owner onde será criado as tabelas intermediarias precisa de acesso de Leitura e Gravação. O Processo de Integração será realizada de forma assíncrona, através de agendamentos presentes no PIMSConnector e Prophix. Prophix
O Prophix após finalizar o processamento da apropriação irá preencher as informações da tabela BRG_APR_ORCAMENTO, respeitando a estrutura demonstrada abaixo.
...
38
...
Informações da Mensagem;
- Identificador: BudgetAppropriation:/ Apropriação de Custos
- Versão: 2.00
- Módulo <PIMS Multicultivos>: <Orçamento e Custos>
- Tipo de Envio: <Síncrona / Assincrona>
- Tipo de Evento: Upsert
Observação: O campo FG_STATUS determina a situação do registro presente na tabela. O PIMSConnector irá utilizar esse atributo para definir quando irá recuperar as informações para processamento.
Valores validos;
- 0 - Não Processado,
- 1 - Em Processamento,
- 2 - Processado,
- 3 - Erro,
- 4 - Finalizado,
- 5 - Aviso
O Prophix deverá incluir as informações na tabela com valor zero, pois somente com esse valor o PIMSConnector iniciará o processo de envio das informações para o PIMS.
O PIMSConnector após recuperar as informações disponíveis na BRG_APR_ORCAMENTO irá alterar o valor do campo FG_STATUS para um (1 - Em Processamento). O Prophix não poderá realizar alterações na tabela para os registros que estejam com valor 1.
Após o PIMSConnector finalizar o envio das informações ao PIMS MultiCultivos, será realizado a exclusão dos registros integrados da tabela BRG_APR_ORCAMENTO.
PIMSConnector
Empresa & Filial
Validar se a Empresa e Filial enviada pelo Prophix está cadastrada no PIMS, essa validação deverá ser realizada utilizando o método de recuperação da Unidade Administrativa já presente no PIMSConnector, caso não seja encontrado a Unidade Administrativa (PIMS) com os critérios informados pelo Prophix deverá registrar um aviso no Monitor de Integração do PIMSConnector e continuar o processo de integração.
Mensagem de Aviso : Não foi possível localizar a Unidade Administrativa com os critérios informados
Cenário
Validar se o Cenário enviado pelo Prophix está cadastrada no PIMS, essa validação é realizada através da consulta na tabela CENARIO. Caso não seja encontrado o Cenário (PIMS) com os critérios informados pelo Prophix deverá registrar um aviso no Monitor de Integração do PIMSConnector e continuar o processo de integração.
Mensagem de Aviso : Não foi possível localizar o Cenário com os critérios informados
Centro de Custos
Validar se o Centro de Custos enviado pelo Prophix está cadastrada no PIMS, essa validação é realizada através da consulta na tabela CCUSTO. Caso não seja encontrado o Centro de Custos (PIMS) com os critérios informados pelo Prophix deverá ser registrado um aviso no Monitor de Integração do PIMSConnector e continuar o processo de integração.
Mensagem de Aviso : Não foi possível localizar o Centro de Custo com os critérios informados
Conta Contábil
Validar se a Conta Contábil enviado pelo Prophix está cadastrada no PIMS, essa validação é realizada através da consulta na tabela CONTACUSTO_CTAB. Caso não seja encontrado a Conta Contábil (PIMS) com os critérios informados pelo Prophix deverá ser registrado um aviso no Monitor de Integração do PIMSConnector e continuar o processo de integração.
Mensagem de Aviso : Não foi possível localizar a Conta Contábil com os critérios informados
Ao finalizar as validações descritas acima a rotina de Integração deverá atualizar as informações da apropriação direta na tabela BRG_CSTG_APDIR do PIMS Multicultivos.
Estrutura da Tabela BRG_CSTG_APDIR :
Informação | Campo | Tipo de Dado | Obrigatório |
Código da Empresa | CD_EMPRESA | VARCHAR2(20 BYTE) | Sim |
Código da Filial | CD_FILIAL | VARCHAR2(20 BYTE) | Sim |
Código do Cenário | CD_CENARIO | NUMBER(38,0) | Sim |
Data de Movimento | DT_REFER | DATE | Sim |
Código do Centro de Custo | CD_CCUSTO | VARCHAR2(20 BYTE) | Sim |
Código da Conta Contábil | CD_CTA_CON | VARCHAR2(40 BYTE) | Sim |
Valor | QT_VALOR | NUMBER(14,4) | Sim |
O Primeiro processo para atualizar as informações é atualizar os registros da BRG, respeitando os seguintes critérios;
- CD_EMPRESA;
- CD_FILIAL;
- CD_CENARIO;
- DT_REFER;
- CD_CCUSTO;
- CD_CTA_CON.
Caso os registros não sejam localizados com o critério mencionados, deverá ser realizada o processo inclusão das informações enviadas pelo Prophix.
Ao finalizar a inclusão será excluído do registro presente na BRG_APR_ORCAMENTO do Owner de Integração.
Serão excluídos somente as linhas integradas com o PIMS, esse procedimento encerra o processo de integração de Apropriação do Orçamento entre Prophix x PIMS
Agendamento
Para habilitar o agendamento do serviço de apropriação direta de orçamento acessar a opção Agendamentos e selecionar a opção "GetBudgetAppropriation" (Serviço de Integração de Apropriação Direta de Orçamento) e definir intervalo para processamento.
Informações trafegados na Integração
- Empresa
- Filial
- Data de Referência
- Cenário
- Centro de Custos
- Conta Contábil
- Valor
- Tipo de Movimento
Tags trafegados na Integração
- InternalId
- CompanyId
- BranchId
- CompanyInternalId
- ReferenceDate
- ScenarioCode
- ScenarioInternalId
- CostCenterCode
- CostCenterInternalId
- AccountantAccountCode
- AccountantAcountInternalId
- MovementType
- Value
Classificação de Apropriação Direta de Orçamento
A mensagem BudgetAppropriation será utilizada para o processo de Apropriação de Orçamento e Planejamento do Orçamento, porém, para diferenciar os processos utilizaremos a TAG MovementType, onde teremos os seguintes valores:
- Apropriação de Orçamento
- Planejamento do Orçamento
Nessa Integração utilizaremos a opção 1 - Apropriação de Orçamento Obs: A instalação do PIMSConnector deve estar configurada com scopo habilitado para integração via objeto de banco "BRG(s)".