| Painel |
|---|
| borderColor | solid |
|---|
| title | (i) TOTVS Acompanha custos |
|---|
| Painel com Dashboard para gerenciar e alertar distorções nas transações de estoque, permitindo análise e gerando notificações sobre itens críticos e distorções de custo, para que seja validado se os consumos e apontamentos de produção estão com valores adequados.
Realizando também um checklist das tarefas de fechamento. |
| Painel |
|---|
| borderStyle | solid |
|---|
| title | Recursos disponíveis |
|---|
| | Expandir |
|---|
|  A funcionalidade do Onboarding tem o propósito de auxiliar o usuário no seu primeiro acesso, sendo exibido ao iniciar a aplicação em seu primeiro acesso, ou selecionando a opção de ajuda no canto superior direito, ao lado do ícone de perfil.
| Expandir |
|---|
| title | Informações técnicas |
|---|
| Front End- Para a criação da feature, utilizamos componentes do framework PO-UI para facilitar e agilizar o desenvolvimento, sendo:
<po-modal> - https://po-ui.io/documentation/po-modal <po-checkbox> - https://po-ui.io/documentation/po-checkbox <po-button> - https://po-ui.io/documentation/po-button Back End- Foi desenvolvido uma classe REST de controle para entrada e saída de dados através da linguagem TLPP, sendo responsável por gerações e gravações de registros nas tabelas de perfil de usuário do Framework.
- Estruturação API:
- Especificações de Serviços
| Expandir |
|---|
| title | GET /api/v1/acUser/:userId |
|---|
| Retorna o status do perfil do usuário informado: | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": true,
"userId": 000000,
"userName": "Administrador"
} |
Descrição de Campos: - showModal: boolean – Define se será apresentado o Onboarding
- userId: string – Retorno o código do usuário consultado
- userName: string – Retorna nome do usuário consultado
|
| Expandir |
|---|
| title | POST /api/v1/acUser/:userId |
|---|
| Permite cadastrar um novo registro de perfil de usuário com as definições passadas pelo body da requisição. | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": false,
} |
O seu retorno esperado será: | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": false,
"userId": "000000",
"userName": "Administrador"
} |
Descrição de Campos: - showModal: boolean – Define se será apresentado o Onboarding
- userId: string – Retorno o código do usuário consultado
- userName: string – Retorna nome do usuário consultado
|
| Expandir |
|---|
| title | PUT /api/v1/acUser/:userID |
|---|
| Permite alterar o status da configuração de perfil do usuário através da informações passadas pelo body da requisição. | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": true,
} |
| Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": true,
"userId": "000000",
"userName": "Administrador"
} |
Descrição de Campos: - showModal: boolean – Define se será apresentado o Onboarding
- userId: string – Retorno o código do usuário consultado
- userName: string – Retorna nome do usuário consultado
|
| Expandir |
|---|
| title | GET api/acConfigProf/v1/profile/restore |
|---|
| Permite alterar o status da configuração de perfil do usuário através da informações passadas pelo body da requisição. | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": true,
} |
| Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"showModal": true,
"userId": "000000",
"userName": "Administrador"
} |
Descrição de Campos: - showModal: boolean – Define se será apresentado o Onboarding
- userId: string – Retorno o código do usuário consultado
- userName: string – Retorna nome do usuário consultado
|
|
|
| Expandir |
|---|
| title | Acompanhamento dos Custos |
|---|
|
|
| Expandir |
|---|
| title | Fechamento de estoque |
|---|
| | Expandir |
|---|
| title | Configuração de parâmetros |
|---|
|  Image ModifiedAtravés do menu de fechamento é possível acessar o botão configurar parâmetros, essa uma funcionalidade foi disponibilizada para salvar as configurações previas de recalculo de custo médio e fechando para virada de saldo, essa configuração é considera para cara filial, dessa forma caso o cliente realize o processamento em mais de uma filial será possível tratar as particularidades de processamento. - Acessando a primeira vez o sistema vai capturar as ultimas configurações do arquivo SX1(Pergunte) retornado em tela somente para validação, com uma ressalva dos parâmetros do tipo string (caracter) pois esses devem ser informado na primeira utilização ou serão considerados com o seu conteúdo em branco.
- Utilização:
Ao realizar a configuração o sistema vai gravar em seu perfil com a filial que realizou a configuração para processamento.  Image Modified
Tendo necessidade de alterar a configuração de processamento, basta acessar a rotina o sistema vai resgatar as informação do perfil depois de alterar clicar em salvar novamente.  Image Modified
E possível restaurar configurações padrões mediante ao SX1(cadastro de pergunte Protheus).  Image Modified
| Expandir |
|---|
| title | Parâmetros do configurador |
|---|
|  Image Modified
|
| Expandir |
|---|
| title | Informações técnicas |
|---|
| Front End- Para a criação da feature, utilizamos componentes do framework PO-UI para facilitar e agilizar o desenvolvimento, sendo:
<po-modal> - https://po-ui.io/documentation/po-modal <po-checkbox> - https://po-ui.io/documentation/po-checkbox <po-button> - https://po-ui.io/documentation/po-button <po-select> - https://po-ui.io/documentation/po-select <po-checkbox> - https://po-ui.io/documentation/po-checkbox <po-widget> - https://po-ui.io/documentation/po-widget Back End- Foi desenvolvido uma classe REST de controle para entrada e saída de dados através da linguagem TLPP, sendo responsável por gerações e gravações de registros nas tabelas de perfil de usuário do Framework
- Estrutura da API:
- Image Modified
- Especificações de Serviços
| Expandir |
|---|
| title | GET api/acConfigProf/v1/profile/:userId |
|---|
| Retorna o SX1 (Pergunte do MATA330 e MATA280 ) ou perfil salvo do usuário na filial corrente. | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"closing": {
"mta280": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": ""
},
{
"parameter": "mv_par04",
"value": true
}
]
},
"recalculation": {
"mta330": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": false
},
{
"parameter": "mv_par04",
"value": true
},
{
"parameter": "mv_par05",
"value": 0
},
{
"parameter": "mv_par06",
"value": 1
},
{
"parameter": "mv_par07",
"value": ""
},
{
"parameter": "mv_par08",
"value": ""
},
{
"parameter": "mv_par09",
"value": false
},
{
"parameter": "mv_par10",
"value": 3
},
{
"parameter": "mv_par11",
"value": false
},
{
"parameter": "mv_par12",
"value": ""
},
{
"parameter": "mv_par13",
"value": true
},
{
"parameter": "mv_par14",
"value": 2
},
{
"parameter": "mv_par15",
"value": true
},
{
"parameter": "mv_par16",
"value": 2
},
{
"parameter": "mv_par17",
"value": 1
},
{
"parameter": "mv_par18",
"value": 1
},
{
"parameter": "mv_par19",
"value": true
},
{
"parameter": "mv_par20",
"value": 2
},
{
"parameter": "mv_par21",
"value": false
}
]
}
} |
Descrição de Campos: - closing: string – Separador com informações dos perguntes da rotina MATA280 (Virada dos saldos)
- parameter: string MV_PAR relacionado a rotina MATA280 vidara dos saldos
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
- recalculation: string – Retorno o código do usuário consultado.
- parameter: string MV_PAR relacionado a rotina MATA330 recalculo do custos medio
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
|
| Expandir |
|---|
| title | POST /api/acConfigProf/v1/profile/:userId |
|---|
| Permite cadastrar uma configuração de parâmetros de usuário com as definições passadas pelo body da requisição. | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"closing": {
"mta280": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": ""
},
{
"parameter": "mv_par04",
"value": true
}
]
},
"recalculation": {
"mta330": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": false
},
{
"parameter": "mv_par04",
"value": true
},
{
"parameter": "mv_par05",
"value": 0
},
{
"parameter": "mv_par06",
"value": 1
},
{
"parameter": "mv_par07",
"value": ""
},
{
"parameter": "mv_par08",
"value": "ZZZZZZZ"
},
{
"parameter": "mv_par09",
"value": false
},
{
"parameter": "mv_par10",
"value": 3
},
{
"parameter": "mv_par11",
"value": false
},
{
"parameter": "mv_par12",
"value": ""
},
{
"parameter": "mv_par13",
"value": true
},
{
"parameter": "mv_par14",
"value": 2
},
{
"parameter": "mv_par15",
"value": true
},
{
"parameter": "mv_par16",
"value": 2
},
{
"parameter": "mv_par17",
"value": 1
},
{
"parameter": "mv_par18",
"value": 1
},
{
"parameter": "mv_par19",
"value": true
},
{
"parameter": "mv_par20",
"value": 2
},
{
"parameter": "mv_par21",
"value": false
}
]
}
} |
O seu retorno esperado será: | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| Permite cadastrar uma configuração de parâmetros de usuário com as definições passadas pelo body da requisição.
{
"closing": {
"mta280": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": ""
},
{
"parameter": "mv_par04",
"value": true
}
]
},
"recalculation": {
"mta330": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": false
},
{
"parameter": "mv_par04",
"value": true
},
{
"parameter": "mv_par05",
"value": 0
},
{
"parameter": "mv_par06",
"value": 1
},
{
"parameter": "mv_par07",
"value": ""
},
{
"parameter": "mv_par08",
"value": "ZZZZZZZ"
},
{
"parameter": "mv_par09",
"value": false
},
{
"parameter": "mv_par10",
"value": 3
},
{
"parameter": "mv_par11",
"value": false
},
{
"parameter": "mv_par12",
"value": ""
},
{
"parameter": "mv_par13",
"value": true
},
{
"parameter": "mv_par14",
"value": 2
},
{
"parameter": "mv_par15",
"value": true
},
{
"parameter": "mv_par16",
"value": 2
},
{
"parameter": "mv_par17",
"value": 1
},
{
"parameter": "mv_par18",
"value": 1
},
{
"parameter": "mv_par19",
"value": true
},
{
"parameter": "mv_par20",
"value": 2
},
{
"parameter": "mv_par21",
"value": false
}
]
}
} |
Descrição de Campos: - closing: string – Separador com informações dos perguntes da rotina MATA280 (Virada dos saldos)
- parameter: string MV_PAR relacionado a rotina MATA280 vidara dos saldos
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
- recalculation: string – Retorno o código do usuário consultado.
- parameter: string MV_PAR relacionado a rotina MATA330 recalculo do custos medio
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
|
| Expandir |
|---|
| title | PUT /api/acConfigProf/v1/profile/:userID |
|---|
| Permite alterar a configuração de parâmetros do usuário através da informações passadas pelo body da requisição. | Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"closing": {
"mta280": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": ""
},
{
"parameter": "mv_par04",
"value": true
}
]
},
"recalculation": {
"mta330": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": false
},
{
"parameter": "mv_par04",
"value": true
},
{
"parameter": "mv_par05",
"value": 0
},
{
"parameter": "mv_par06",
"value": 1
},
{
"parameter": "mv_par07",
"value": ""
},
{
"parameter": "mv_par08",
"value": ""
},
{
"parameter": "mv_par09",
"value": false
},
{
"parameter": "mv_par10",
"value": 3
},
{
"parameter": "mv_par11",
"value": false
},
{
"parameter": "mv_par12",
"value": ""
},
{
"parameter": "mv_par13",
"value": true
},
{
"parameter": "mv_par14",
"value": 2
},
{
"parameter": "mv_par15",
"value": true
},
{
"parameter": "mv_par16",
"value": 2
},
{
"parameter": "mv_par17",
"value": 1
},
{
"parameter": "mv_par18",
"value": 1
},
{
"parameter": "mv_par19",
"value": true
},
{
"parameter": "mv_par20",
"value": 2
},
{
"parameter": "mv_par21",
"value": false
}
]
}
} |
| Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"closing": {
"mta280": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": ""
},
{
"parameter": "mv_par04",
"value": true
}
]
},
"recalculation": {
"mta330": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": false
},
{
"parameter": "mv_par04",
"value": true
},
{
"parameter": "mv_par05",
"value": 0
},
{
"parameter": "mv_par06",
"value": 1
},
{
"parameter": "mv_par07",
"value": ""
},
{
"parameter": "mv_par08",
"value": ""
},
{
"parameter": "mv_par09",
"value": false
},
{
"parameter": "mv_par10",
"value": 3
},
{
"parameter": "mv_par11",
"value": false
},
{
"parameter": "mv_par12",
"value": ""
},
{
"parameter": "mv_par13",
"value": true
},
{
"parameter": "mv_par14",
"value": 2
},
{
"parameter": "mv_par15",
"value": true
},
{
"parameter": "mv_par16",
"value": 2
},
{
"parameter": "mv_par17",
"value": 1
},
{
"parameter": "mv_par18",
"value": 1
},
{
"parameter": "mv_par19",
"value": true
},
{
"parameter": "mv_par20",
"value": 2
},
{
"parameter": "mv_par21",
"value": false
}
]
}
} |
Descrição de Campos: - closing: string – Separador com informações dos perguntes da rotina MATA280 (Virada dos saldos)
- parameter: string MV_PAR relacionado a rotina MATA280 vidara dos saldos
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
- recalculation: string – Retorno o código do usuário consultado.
- parameter: string MV_PAR relacionado a rotina MATA330 recalculo do custos medio
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
|
| Expandir |
|---|
| title | GET api/acConfigProf/v1/profile/restore |
|---|
| Permite resturar o perfil para configurações padrão do protheus Não necessita de envio o retorno será conforma abaixo porem com as informações do arquivo SX1 - perguntes do MATA280 e MATA330
| Bloco de código |
|---|
| language | js |
|---|
| theme | Confluence |
|---|
| {
"closing": {
"mta280": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": ""
},
{
"parameter": "mv_par04",
"value": true
}
]
},
"recalculation": {
"mta330": [
{
"parameter": "mv_par01",
"value": ""
},
{
"parameter": "mv_par02",
"value": false
},
{
"parameter": "mv_par03",
"value": false
},
{
"parameter": "mv_par04",
"value": true
},
{
"parameter": "mv_par05",
"value": 0
},
{
"parameter": "mv_par06",
"value": 1
},
{
"parameter": "mv_par07",
"value": ""
},
{
"parameter": "mv_par08",
"value": ""
},
{
"parameter": "mv_par09",
"value": false
},
{
"parameter": "mv_par10",
"value": 3
},
{
"parameter": "mv_par11",
"value": false
},
{
"parameter": "mv_par12",
"value": ""
},
{
"parameter": "mv_par13",
"value": true
},
{
"parameter": "mv_par14",
"value": 2
},
{
"parameter": "mv_par15",
"value": true
},
{
"parameter": "mv_par16",
"value": 2
},
{
"parameter": "mv_par17",
"value": 1
},
{
"parameter": "mv_par18",
"value": 1
},
{
"parameter": "mv_par19",
"value": true
},
{
"parameter": "mv_par20",
"value": 2
},
{
"parameter": "mv_par21",
"value": false
}
]
}
} |
Descrição de Campos: - closing: string – Separador com informações dos perguntes da rotina MATA280 (Virada dos saldos)
- parameter: string MV_PAR relacionado a rotina MATA280 vidara dos saldos
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
- recalculation: string – Retorno o código do usuário consultado.
- parameter: string MV_PAR relacionado a rotina MATA330 recalculo do custos medio
- value boolean - para os parâmetros do tipo sim ou não, string para os tipos texto e números para os combos
|
|
|
| Expandir |
|---|
|  Image Modified
Novo Fechamento, recurso que permite iniciar a jornada de fechamento |
nessa basta definir o tipo de contabilização e clicar em novo fechamento.
|
| Expandir |
|---|
| title | Histórico de Fechamentos |
|---|
|  Image Added
Na abertura da funcionalidade de Fechamentos, será exibido uma estrutura com os últimos fechamentos realizados em forma de lista ao qual seguirá em duas configurações: Não havendo fechamento realizado através da jornada da nova funcionalidade, será apenas exibido o último fechamento de estoque realizado pela rotina de Virada de Saldos (MATA280), analisando a tabela Saldos Iniciais (SB9). Com a estrutura devidamente implementada, o sistema terá a tabela Logs de Fechamento (D3X). Realizando a jornada de fechamento, o sistema gerará logs detalhados de todo o processo de fechamento, que abrangem: - Recálculo do Custo Médio
- Virada de Saldo
- Saldo Atual para Final
| Expandir |
|---|
| title | Informações Técnicas |
|---|
| Seguem informações técnicas de Front-End e Back-End: |
|
| Acompanhamento dos Custos | Componentes principais utilizados para a construção da feature: |
|
|
| Alerta do Sistema | Fechamento de estoque | GET api/aclist/v1/listclosing |
|---|
| Permite listar o histórico de fechamentos realizados:
|
|
|
|
|
|
| Painel |
|---|
| borderStyle | solid |
|---|
| title | Arquitetura |
|---|
|
|
|
