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)
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 - Branch (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

{
    "items": [
        {
            "id":"T1D MG 01",
			"code":"D MG 01",
			"deleted":""
        },
        {
           "id":"T1D RJ 01",
			"code":"D RJ 01",
			"deleted":""
        },
        {
            "id":"T1M PR 01",
			"code":"M PR 01",
			"deleted":""
        },
        {
            "id":"T1M SP 01",
			"code":"M SP 01",
			"deleted":""
        }      
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

Bloco de código

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

"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

{
	"items": [
		{
            "id": "T1D MG 01000001",
			"branch":"D MG 01",
			"code":"000001",
			"deleted":""
        },
        {
         	"id": "T1D MG 01000003",
			"branch":"D MG 01",
			"code":"000003",
			"deleted":""
        },
        {
          	"id": "T1D MG 01000005",
			"branch":"D MG 01",
			"code":"000005",
			"deleted":""
        },
        {
            "id": "T1D RJ 02000001",
			"branchId":"D RJ 02",
			"code":"000001",
			"deleted":""
        },
	    {
            "id": "T1D RJ 02000005",
			"branch":"D RJ 02",
			"code":"000005",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

Bloco de código

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

"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

{
	"items": [
        {
            "id": "T1D MG 01595",
			"branch":"D MG 01",
			"code":"595",
			"sequential":"001",
			"deleted":""
        },
        {
           	"id": "T1D MG 01596",
			"branch":"D MG 01",
			"code":"596",
			"sequential":"001",
			"deleted":""
        },
        {
           	"id": "T1D MG 01598",
			"branch":"D MG 01",
			"code":"598",
			"sequential":"001",
			"deleted":""
        },
        {
            "id": "T1D RJ 02595",
			"branch":"D RJ 02",
			"code":"595",
			"sequential":"001",
			"deleted":""
        },
	    {
            "id": "T1D RJ 02597",
			"branch":"D RJ 02",
			"code":"597",
			"sequential":"001",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

Bloco de código

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

"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

{
	"items": [
        {
            "id": "T1D MG 01CC000001",
			"branch":"D MG 01",
			"code":"CC000001",
			"deleted":""
        },
        {
           	"id": "T1D MG 01CC000002",
			"branch":"D MG 01",
			"code":"CC000002",
			"deleted":""
        },
        {
           	"id": "T1D MG 01CC000005",
			"branch":"D MG 01",
			"code":"CC000005",
			"deleted":""
        },
        {
            "id": "T1D RJ 02CC000002",
			"branch":"D RJ 02",
			"code":"CC000002",
			"deleted":""
        },
	    {
            "id": "T1D RJ 02CC000003",
			"branch":"D RJ 02",
			"code":"CC000003",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

Bloco de código

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

"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

{
	"items": [
        {
            "id": "T1D MG 01CTD00001",
			"branch":"D MG 01",
			"code":"CTD00001",
			"deleted":""
        },
        {
           	"id": "T1D MG 01CTD00005",
			"branch":"D MG 01",
			"code":"CTD00005",
			"deleted":""
        },
        {
           	"id": "T1D MG 01CTD00008",
			"branchId":"D MG 01",
			"code":"CTD00008",
			"deleted":""
        },
        {
            "id": "T1|D RJ 02CTD00001",
			"branch":"D RJ 02",
			"code":"CTD00001",
			"deleted":""
        },
	    {
            "id": "T1D RJ 02CTD00002",
			"branch":"D RJ 02",
			"code":"CTD00002",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

Bloco de código

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

"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

{
	"items": [
        {
            "id": "T1D MG 01CTH00001",
			"branch":"D MG 01",
			"code":"CTH00001",
			"deleted":""
        },
        {
           	"id": "T1D MG 01CTH00005",
			"branch":"D MG 01",
			"code":"CTH00005",
			"deleted":""
        },
        {
            "id": "T1D MG 01CTH00008",
			"branch":"D MG 01",
			"code":"CTH00008",
			"deleted":""
        },
        {
            "id": "T1D RJ 02CTH00001",
			"branch":"D RJ 02",
			"code":"CTH00001",
			"deleted":""
        },
	    {
            "id": "T1D RJ 02CTH00002",
			"branch":"D RJ 02",
			"code":"CTH00002",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

API para informações de Moedas (SMO)

Bloco de código

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

"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

{
	"items": [
        {
            "id": "T1D MG 0101",
			"branch":"D MG 01",
			"code":"01",
			"deleted":""
        },
        {
           	"id": "T1D MG 0102",
			"branch":"D MG 01",
			"code":"02",
			"deleted":""
        },
        {
           	"id": "T1D MG 0103",
			"branch":"D MG 01",
			"code":"03",
			"deleted":""
        },
        {
            "id": "T1|D RJ 0201",
			"branch":"D RJ 02",
			"code":"01",
			"deleted":""
        },
	    {
            "id": "T1|D RJ 0202",
			"branch":"D RJ 02",
			"code":"02",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

"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

{
	"items": [
        {
            "id": "T1|D MG 01001000010000000001,
			"branch":"D MG 01",
			"code":"001",
			"number":"00001",
			"accountcodeacountantaccountcode":"0000000001",
			"deleted":""
        },
        {
           	"id": "T1D MG 01002000010000000001,
			"branch":"D MG 01",
			"code":"002",
			"number":"00001",
			"accountcodeacountantaccountcode":"0000000001",
			"deleted":""
        },
        {
           	"id": "T1|D MG 01001000020000000010,
			"branch":"D MG 01",
			"code":"001",
			"number":"00002",
			"accountcodeacountantaccountcode":"0000000010",
			"deleted":""
        },
        {
            "id": "T1D MG 01001000010000000005,
			"branch":"D RJ 02",
			"code":"001",
			"number":"00001",
			"accountcodeacountantaccountcode":"0000000005",
			"deleted":""
        },
	    {
            "id": "T1D MG 01001000030000000008,
			"branch":"D RJ 02",
			"code":"001",
			"number":"00003",
			"accountcodeacountantaccountcode":"0000000008",
			"deleted":""
        }  
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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

"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

{
	"items": [
        {
            "id": "T1 8850,
			"branch":"",
			"code":"8850",
			"deleted":""
        },
        {
           	"id": "T1 8800,
			"branch":"",
			"code":"8800",
			"deleted":""
        },
        {
           	"id": "T1 8860,
			"branch":"",
			"code":"8860",
			"deleted":""
        }
    ],
	"hasNext":true,
    "po_sync_date":"2021-02-09T21:00:38Z"
}

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 135

Nova versão 136

Chave