Histórico da Página

...

Totvs custom tabs box

tabs	Implementação,Imagens
ids	filtros_implementacao,filtros_imagens

Totvs custom tabs box items

default	yes
referencia	filtros_implementacao

Front-End:

Os campos do filtro serão construídos com o componente DynamicForm do PO UI. Ao carregar a tela, será necessário chamar uma API que recupera os filtros já salvos pelo usuário. Caso o endpoint retorne vazio, significa que o usuário ainda não salvou nenhum filtro.

Por questão de performance, os endpoints dos selects/multiselects vão ser chamados somente quando clicados nos inputs.

Os campos serão por seleção, ou seja, o usuário poderá selecionar todos os itens ou um item específico. Os inputs serão construídos com o módulo MultiSelect do PO UI. (#001)

Abaixo todos os filtros que vão estar disponíveis para configuração:

Filial (multiselect)
Data (de/até) (date)
Conta contábil (multiselect)
Moeda (select)
Conciliar por (select) (dependendo do filtro, abrirá um novo campo para o usuário colocar o número do processo ou extrato bancário) (#003), (#028)
Lançamento Padrão (multiselect) (#006)
Filtra entidade (select boolean)
Centro de custo (multiselect)
Item contábil (multiselect)
Clvl (multiselect)
Registros conciliados (select boolean) (#004)
Lote (#002)
Valor mínimo (#019)
Valor máximo (#019)

Teremos um filtro de valor mínimo e valor máximo para que o sistema desconsidere a divergência de valores (caso haja) nos itens conciliados automaticamente. (#019)

Como citado acima, após salvar o formulário, o front fará uma requisição para o back-end enviando os dados que o usuário selecionou nos filtros. Quando o usuário acessar novamente, os filtros estarão salvos. (#007)

Cada campo terá um parâmetro onde será possível adicionar um texto de ajuda para aquele campo específico. O local de exibição da ajuda na tela ainda não está definido. (#008)

Como o PO UI não tem a função de ordenar colunas arrastando e soltando como existe no Protheus, só é possível alterar a ordem das colunas por meio do gerenciador de colunas que existe nas tabelas do PO UI. (#023)

Back-End:

Será necessário uma API para salvar os filtros do usuário e uma outra API para recuperar o filtro já salvo.

Para que o filtro que o usuário realizou reflita nos grids, o front vai chamar as APIs que trazem as informações dos grids passando os valores dos filtros como query strings, assim a API vai saber o que filtrar na hora de trazer o resultado.

Os filtros deverão possuir help para facilitar entendimento do usuário.

Serão necessárias disponibilidade das APIs abaixo:

API para informações de Filiais (SM0)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
    "Branch": [
        {
            "BranchId":"D MG 01"
        },
        {
           "BranchId":"D RJ 01"
        },
        {
            "BranchId":"M PR 01"
        },
        {
            "BranchId":"M SP 01"
        }      
    ]
}

API para informações do Plano de Contas Contábeis (CT1)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
	{ "BranchId": "D MG 01"},
	{ "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"AccountantAccounts": [
		{
            "InternalId": "T1|D MG 01|000001",
			"BranchId":"D MG 01",
			"Code":"000001"
        },
        {
         	"InternalId": "T1|D MG 01|000003",
			"BranchId":"D MG 01",
			"Code":"000003"
        },
        {
          	"InternalId": "T1|D MG 01|000005",
			"BranchId":"D MG 01",
			"Code":"000005"
        },
        {
            "InternalId": "T1|D RJ 02|000001",
			"BranchId":"D RJ 02",
			"Code":"000001"
        },
	    {
            "InternalId": "T1|D RJ 02|000005",
			"BranchId":"D RJ 02",
			"Code":"000005"
        }  
    ]
}

API para informações de Lançamento Padrão (CT5)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"StandardReleases": [
        {
            "InternalId": "T1|D MG 01|595",
			"BranchId":"D MG 01",
			"Code":"595"
        },
        {
           	"InternalId": "T1|D MG 01|596",
			"BranchId":"D MG 01",
			"Code":"596"
        },
        {
           	"InternalId": "T1|D MG 01|598",
			"BranchId":"D MG 01",
			"Code":"598"
        },
        {
            "InternalId": "T1|D RJ 02|595",
			"BranchId":"D RJ 02",
			"Code":"595"
        },
	    {
            "InternalId": "T1|D RJ 02|597",
			"BranchId":"D RJ 02",
			"Code":"597"
        }  
    ]
}

API para informações de Centro de Custo (CTT)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"CostCenters": [
        {
            "InternalId": "T1|D MG 01|CC000001",
			"BranchId":"D MG 01",
			"Code":"CC000001"
        },
        {
           	"InternalId": "T1|D MG 01|CC000002",
			"BranchId":"D MG 01",
			"Code":"CC000002"
        },
        {
           	"InternalId": "T1|D MG 01|CC000005",
			"BranchId":"D MG 01",
			"Code":"CC000005"
        },
        {
            "InternalId": "T1|D RJ 02|CC000002",
			"BranchId":"D RJ 02",
			"Code":"CC000002"
        },
	    {
            "InternalId": "T1|D RJ 02|CC000003",
			"BranchId":"D RJ 02",
			"Code":"CC000003"
        }  
    ]
}

API para informações de Itens Contábeis (CTD)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"AccountingItems": [
        {
            "InternalId": "T1|D MG 01|CTD00001",
			"BranchId":"D MG 01",
			"Code":"CTD00001"
        },
        {
           	"InternalId": "T1|D MG 01|CTD00005",
			"BranchId":"D MG 01",
			"Code":"CTD00005"
        },
        {
           	"InternalId": "T1|D MG 01|CTD00008",
			"BranchId":"D MG 01",
			"Code":"CTD00008"
        },
        {
            "InternalId": "T1|D RJ 02|CTD00001",
			"BranchId":"D RJ 02",
			"Code":"CTD00001"
        },
	    {
            "InternalId": "T1|D RJ 02|CTD00002",
			"BranchId":"D RJ 02",
			"Code":"CTD00002"
        }  
    ]
}

API para informações de Classe de Valor (CTH)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"ValueClasses": [
        {
            "InternalId": "T1|D MG 01|CTH00001",
			"BranchId":"D MG 01",
			"Code":"CTH00001"
        },
        {
           	"InternalId": "T1|D MG 01|CTH00005",
			"BranchId":"D MG 01",
			"Code":"CTH00005"
        },
        {
            "InternalId": "T1|D MG 01|CTH00008",
			"BranchId":"D MG 01",
			"Code":"CTH00008"
        },
        {
            "InternalId": "T1|D RJ 02|CTH00001",
			"BranchId":"D RJ 02",
			"Code":"CTH00001"
        },
	    {
            "InternalId": "T1|D RJ 02|CTH00002",
			"BranchId":"D RJ 02",
			"Code":"CTH00002"
        }  
    ]
}

API para informações de Moedas (SMO)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"Currencies": [
        {
            "InternalId": "T1|D MG 01|01",
			"BranchId":"D MG 01",
			"Code":"01"
        },
        {
           	"InternalId": "T1|D MG 01|02",
			"BranchId":"D MG 01",
			"Code":"02"
        },
        {
           	"InternalId": "T1|D MG 01|03",
			"BranchId":"D MG 01",
			"Code":"03"
        },
        {
            "InternalId": "T1|D RJ 02|01",
			"BranchId":"D RJ 02",
			"Code":"01"
        },
	    {
            "InternalId": "T1|D RJ 02|02",
			"BranchId":"D RJ 02",
			"Code":"02"
        }  
    ]
}

API para informações bancárias (SA6) com a opção Get (#014)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"Banks": [
        {
            "InternalId": "T1|D MG 01|001|00001|0000000001,
			"BranchId":"D MG 01",
			"Code":"001",
			"Number":"00001",
			"AccountCode":"0000000001"
        },
        {
           	"InternalId": "T1|D MG 01|002|00001|0000000001,
			"BranchId":"D MG 01",
			"Code":"002",
			"Number":"00001",
			"AccountCode":"0000000001"
        },
        {
           	"InternalId": "T1|D MG 01|001|00002|0000000010,
			"BranchId":"D MG 01",
			"Code":"001",
			"Number":"00002",
			"AccountCode":"0000000010"
        },
        {
            "InternalId": "T1|D MG 01|001|00001|0000000005,
			"BranchId":"D RJ 02",
			"Code":"001",
			"Number":"00001",
			"AccountCode":"0000000005"
        },
	    {
            "InternalId": "T1|D MG 01|001|00003|0000000008,
			"BranchId":"D RJ 02",
			"Code":"001",
			"Number":"00003",
			"AccountCode":"0000000008"
        }  
    ]
}

API para informações de Lotes Contábeis (SX5, tabela 09)

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Request
linenumbers	true
collapse	true

[
"InternalId": "T1",
"CompanyId": "T1",
"Branchs": [
    { "BranchId": "D MG 01"},
    { "BranchId": "D RJ 02"}
]

Bloco de código

language	coldfusion
theme	DJango
firstline	1
title	Json Response
linenumbers	true
collapse	true

{
	"Batches": [
        {
            "InternalId": "T1||8850,
			"BranchId":"",
			"Code":"8850"
        },
        {
           	"InternalId": "T1||8800,
			"BranchId":"",
			"Code":"8800"
        },
        {
           	"InternalId": "T1||8860,
			"BranchId":"",
			"Code":"8860"
        }
    ]
}

Informações

title	Atenção

As APIs que forem disponibilizadas para clientes deverão ser desenvolvidas e documentadas conforme padrão de Api Totvs

Totvs custom tabs box items

default	no
referencia	filtros_imagens

...

Árvore de páginas

Versões comparadas

Versão antiga 118

Nova versão 119

Chave