Histórico da Página
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 | Aquisição Produtos Rurais |
Segmento Executor |
| ||
Projeto1 | MANMAT01 | IRM1 | MANMAT01-105 |
Requisito1 | MANMAT01-2780 | Subtarefa1 |
|
Chamado2 |
| ||
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
<Nesta etapa informar o objetivo da especificação do requisito, ou seja, o que a funcionalidade deve fazer. Exemplo: Permitir que o usuário defina o percentual mínimo em espécie (dinheiro), a referência mínima para calculo dos débitos do aluno e o período de validade do parâmetro de negociação>.
Recalcular o valor unitário a ser usado na emissão da nota fiscal do produtor para que reflita o valor negociado, considerando o incentivo à produção leiteira e os impostos retidos.
(Obrigatório)
Definição da Regra de Negócio
<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.
<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.
Na aquisição de leite do produtor rural é comum os laticínios negociarem um preço final já incluindo o incentivo à produção de leite (quando houver) e a retenção de impostos. Para que o preço final pago ao produtor siga esta diretriz é necessário recalcular o preço da NF retirando o efeito do incentivo e do imposto retido (SENAR). Isso será feito calculando um ajuste a ser aplicado ao unitário da nota fiscal. Em um exemplo em que o valor unitário negociado seja R$ 1,20 o recálculo ficaria assim:
Valor antes do recálculo:
Inclusão de ajuste adequando o unitário da NF:
Detalhes do cálculo:
Para que o valor do incentivo a ser incluído na nota seja calculado conforme a diretriz de desconsiderar o próprio incentivo e imposto retido, as regras precisarão ser ajustadas:
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
[ACAA040 – Parâmetros]aq0315 | [Alteração] | [Atualizações Logística -> AcadêmicoAquisição Produtos Rurais -> Tesouraria]Tarefas | - |
[ACAA050 – Negociação Financeira]cd0024 | [EnvolvidaAlteração] | [Atualizações Cadastros Geriais -> AcadêmicoCadastros Gerais -> Tesouraria]Manutenção | - |
[ACAA060 – Cadastro de Pedidos]aq0501 | [CriaçãoAlteração][Atualizações -> Acadêmico-> Cadastros] | Apuração Valores Período | - |
Exemplo de Aplicação:
- Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
- Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades como a referência mínima para calcular o débito total do aluno.
- Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
- O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.
Tabelas Utilizadas
- SE2 – Cadastro de Contas a Pagar
- FI9 – Controle de Emissão de DARF>.
| aq0311 | [Alteração] | Geração Notas Produtor | - |
Opcional
Protótipo de Tela
<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.
Protótipo 01
Apresentados junto ao fluxo de processo.
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Opcional
Dicionário de Dados
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação> |
(Opcional)
Grupo de Perguntas
<Informações utilizadas na linha Protheus>.
Nome: FINSRF2
X1_ORDEM | 01 |
X1_PERGUNT | Emissão De |
X1_TIPO | D |
X1_TAMANHO | 8 |
X1_GSC | G |
X1_VAR01 | MV_PAR01 |
X1_DEF01 | Comum |
X1_CNT01 | '01/01/08' |
X1_HELP | Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório |
(Opcional)
Consulta Padrão
<Informações utilizadas na linha Protheus>
Consulta: AMB
Descrição | Configurações de Planejamento |
Tipo | Consulta Padrão |
Tabela | “AMB” |
Índice | “Código” |
Campo | “Código”; ”Descrição” |
Retorno | AMB->AMB_CODIGO |
1 - Externalização das Regras para Recálculo do Bônus
Incluir novas variáveis na API de consulta de tipos de operações e variáveis
- Incluir na include cdapi0034a.i5 as novas variáveis necessárias ao recálculo do bônus fixo:
Lista de variáveis a incluir:
novo-total = Valor intermediário utilizado no cálculo do ajuste
val-ajuste = Valor unitário que ajusta o bônus fixo
nat-oper-comp-1 = Natureza NF complementar - Item SEM crédito
nat-oper-comp-2 = Natureza NF complementar - Item COM crédito
val-imp-retido = Valor projetado para o imposto retido
Lista de variáveis retornadas pela cdapi034:
novo-total = Valor intermediário utilizado no cálculo do ajuste
val-ajuste = Valor unitário que ajusta o bônus fixo
nat-oper-comp-1 = Natureza NF complementar - Item SEM crédito
nat-oper-comp-2 = Natureza NF complementar - Item COM crédito
val-imp-retido = Valor projetado para o imposto retido
2 - Apuração Valores Período
- Incluir uma chamada ao interpretador de regras (cdapi034) passando código da empresa, código do estabelecimento, o tipo de operação "AQR-NF-Produtor" e o seguinte conjunto de variáveis:
optante = indica se o produtor é optante do programa de incentivo (produt-rural.optante)
item = código do item (fechto-produt-period.it-codigo)
vol-acum-ano = volume entregue acumulado no ano (quant-fornec-produt.qtd-fornec)
vol-mes = volume entregue no mês (fechto-produt-period.qtd-period)
vol-ano-mes = volume acumulado do ano mais o volume do mês (quant-fornec-produt.qtd-fornec + fechto-produt-period.qtd-period)
preco-final-inf = preço final informado (fechto-produt-period.val-preco-final-inf)
- Salvar os valores de ajuste retornados pela cdapi034 nos campos livres, da seguinte forma:
fechto-produt-period.val-livre-1 = val-ajuste
Se o interpretador de regras não retornar valor, gravar zero
3 - aq0315 - Confirmação Preço Final
Incluir nova coluna "Ajuste" na tela do aq0315 para mostrar o valor do ajuste (fechto-produt-period.val-livre-1). Este valor deverá ser recalculado cada vez que o usuário alterar o "Preço Final" chamando o interpretador de regras para a linha alterada
Chamada ao Interpretador de Regras
- Executar a cdapi034 (interpretador de regras) quando o campo Preço Final for alterado passando código da empresa, código do estabelecimento, o tipo de operação "AQR-NF-Produtor" e o seguinte conjunto de variáveis:
optante = indica se o produtor é optante do programa de incentivo (produt-rural.optante)
item = código do item (fechto-produt-period.it-codigo)
vol-acum-ano = volume entregue acumulado no ano (quant-fornec-produt.qtd-fornec)
vol-mes = volume entregue no mês (fechto-produt-period.qtd-period)
vol-ano-mes = volume acumulado do ano mais o volume do mês (quant-fornec-produt.qtd-fornec + fechto-produt-period.qtd-period)
preco-final-inf = preço final informado (fechto-produt-period.val-preco-final-inf)
Lista de variáveis retornadas pela cdapi034:
val-ajuste = Valor unitário que ajusta o bônus fixo
- Se a cdapi034 não retornar valores, a coluna "Ajuste" deve ficar com zero.
4 - Fechamento Período Aquis Rural
- Retirar do programa aq0320 a parte que é responsável por criar movimentos de evento financeiro. Esta geração será concentrada no programa de Geração de Notas Produtor (aq0311) para que seja realizada o mais tarde possível no processo, quando a chance de que eles precisem ser recriados é menor.
5 - Emissão de Notas Produtor
Para que a nota fiscal seja gerada com um valor que desconsidere o incentivo e o imposto retido, será necessário aplicar o ajuste (fechto-produt-period.val-livre-1) ao preço unitário confirmado. Na montagem do preco-total da item-doc-est, somar o ajuste ao preço final:
Se tem incentivo (NF-Credito = Sim)
item-doc-est.preco-total = fechto-produt-period.qtd-period * (fechto-produt-period.val-preco-final-inf + fechto-produt-period.val-livre-1)
Se tem incentivo parcial (NF-Credito = Parcial)
item-doc-est.preco-total = qtde-1 * (fechto-produt-period.val-preco-final-inf + fechto-produt-period.val-livre-1) e
item-doc-est.preco-total = qtde-2 * (fechto-produt-period.val-preco-final-inf + fechto-produt-period.val-livre-1)
Se não tem incentivo (NF-Credito = Não)
item-doc-est.preco-total = fechto-produt-period.qtd-period * (fechto-produt-period.val-preco-final-inf + fechto-produt-period.val-livre-1)
- Incluir no programa de Geração de Notas Produtor (aq0311) a geração de movimentos de evento financeiro retiradas do programa de Fechamento de Período (tópico 4 acima)
6 - Eliminação de Notas Produtor
- Incluir no programa de Eliminação de NF Produtor Rural a eliminação dos eventos financeiros criados durante a geração das notas que estão sendo eliminadas.
- Para isso, fazer uma chamada ao método "pi_eliminar_movto_event_financ_chave_sem_num_seq" do programa apb061za.p
Opcional
Não se aplica.
(Opcional)
Não se aplica.
(Opcional)
Não se aplica.
(Opcional)
Estrutura de Menu
Não se aplica.
Cadastro de Papéis
Não se aplica.
(Opcional)
Estrutura de Menu
<Informações utilizadas na linha Datasul>.
Procedimentos
Procedimento |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Módulo |
|
|
|
Programa base |
|
|
|
Nome Menu | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Registro padrão | Sim | Sim | Sim |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Release de Liberação |
|
|
|
Programas
Programa |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Nome Externo |
|
|
|
Nome Menu/Programa | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Nome Verbalizado[1] | (Max 254 posições) | (Max 254 posições) | (Max 254 posições) |
Procedimento |
|
|
|
Template | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) |
Tipo[2] | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Categoria[3] |
|
|
|
Executa via RPC | Sim/Não | Sim/Não | Sim/Não |
Registro padrão | Sim | Sim | Sim |
Outro Produto | Não | Não | Não |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Query on-line | Sim/Não | Sim/Não | Sim/Não |
Log Exec. | Sim/Não | Sim/Não | Sim/Não |
Rotina (EMS) |
|
|
|
Sub-Rotina (EMS) |
|
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
|
Compact[4] | Sim/Não | Sim/Não | Sim/Não |
Home[5] | Sim/Não | Sim/Não | Sim/Não |
Posição do Portlet[6] | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
|
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
Código Papel | (máx 3 posições) |
Descrição em Português* |
|
Descrição em Inglês* |
|
[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
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
|---|
Import HTML Content
Visão Geral
Conteúdo das Ferramentas