01. DADOS GERAIS
Produto: | TOTVS Moda |
---|---|
Segmento: | Varejo |
Módulo: | Financeiro - APIs Minhas Operações |
Função: | Painel Financeiro |
País: | Brasil |
Requisito/Story/Issue (informe o requisito relacionado) : |
02. SITUAÇÃO/REQUISITO
Desenvolver APIs para consulta de informações dos dashboards do financeiro para o produto "Minhas Operações".
03. SOLUÇÃO
Documentação Swagger da API: apitotvsmoda.bhan.com.br/api/totvsmoda/analytics/v2/swagger/index.html
Imagem 1 - Na imagem acima, temos o retorno da consulta da API referente ao endpoint "total-payable/search".
Imagem 2.1 - Na imagem acima, temos o filtro de duplicatas da semana (08/07/2023 - 14/07/2023).
Imagem 2.2 - Na imagem acima, temos o resultado da consulta no componente FCPFL009 listando os títulos em aberto conforme o filtro realizado no componente FCPFF001.
Imagem 3.1 - Na imagem acima, temos o filtro de duplicatas do mês (01/07/2023 - 31/07/2023).
Imagem 3.2 - Na imagem acima, temos o resultado da consulta no componente FCPFL009 listando os títulos em aberto conforme o filtro realizado no componente FCPFF001.
Imagem 4.1 - Na imagem acima, temos o filtro de duplicatas sem filtro de vencimento, ou seja, todas as duplicatas em aberto.
Imagem 4.2 - Na imagem acima, temos o resultado da consulta no componente FCPFL009 listando os títulos em aberto conforme o filtro realizado no componente FCPFF001.
Imagem 1 - Na imagem acima, temos o retorno da consulta da API referente ao endpoint "total-receivable/search".
Imagem 2.1 - Filtro utilizado para se buscar as faturas com vencimento na semana (08/07/2023 ~ 14/07/2023).
Imagem 2.2 - Demonstração do resultado da consulta das faturas no FCRFL046 que estão com valor em aberto, sendo utilizado o filtro anterior do FCRFF004.
Imagem 3.1 - Na imagem acima, temos o filtro para se buscar as faturas com vencimento no mês (01/07/2023 ~ 31/07/2023).
Imagem 3.2 - No FCRFL046 temos o resultado das faturas em aberto cujo vencimento se encontra no mês 07 de 2023 (01/07/2023 ~ 31/07/2023), sendo considerado o filtro do FISFF004 utilizado acima.
Imagem 4.1 - Filtro utilizado para se buscar todas as faturas em aberto na empresa 1, não tendo informado nenhum período de vencimento.
Imagem 4.2 - Conforme apresentado na imagem acima, temos o valor resultado do filtro FCRFF004 para se buscar o valor de todas as faturas em aberto da empresa 1.
Imagem 1 - Na imagem acima, temos o retorno da consulta da API referente ao endpoint "average-receipt-period/search", que é o valor do prazo média de recebimento, temos 4 fatura sendo 2 com prazo médio de 0 dias, 1 com prazo de 23 dias e outra com prazo de 5 dias, somando as 4 faturas e dividindo ira dar o prazo médio de 7 dias, Formula: (data de liquidação - data de emissão).
Imagem 2 - Acima vemos uma fatura com 0 dias de prazo de recebimento.
Imagem 3 - Acima vemos uma fatura com 5 dias de prazo de recebimento.
Imagem 4 - Acima vemos uma fatura com 23 dias de prazo de recebimento.
Imagem 5 - Acima vemos uma fatura com 0 dias de prazo de recebimento.
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "average-payment-period/search" para consulta de prazo médio de pagamento. Formula: (data de liquidação - data de chegada).
Imagem 2 - Demonstração das duplicatas encontradas ao acionar a consulta. Observa-se destacado data chegada e data de liquidação envolvidas no cálculo.
Primeira duplicata: data liquidação 13/07 - data chegada 03/07 = 10 dias
Segunda duplicata: data liquidação 03/07 - data chegada 03/07 = 0 dias
Terceira duplicata: data liquidação 03/07 - data chegada 03/07 = 0 dias
Soma-se os dias, 10+0+0, divide pela quantidade de duplicatas(3), resulta em 3(valor truncado).
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "account-balance/search" para consulta do saldo conciliado das contas do tipo "Banco".
Imagem 2 - Demonstração do componente FCCFL004 com destaque para o saldo conciliado do dia 04/07/2023 da primeira conta listada no retorno da Imagem 1.
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "overdue-cards/search" para consulta de cartões em atraso por operadora.
Imagem 2 - Demonstração do componente FCCFL046 com destaque para operadora em destaque na Imagem 1.
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "biweekly/search" para consulta do total dos valores a pagar e a receber referente ao período de quinze dias. Obs.: Type_field definirá o tipo sendo 1 valores a receber e 2 valores a pagar.
Imagem 2 - Filtro utilizado para se buscar as duplicatas em aberta com vencimento no período de 20/07/2023 à 04/08/2023.
Imagem 3 - Acima podemos ver as duplicatas que irão vencer dentro do período estipulado no filtro do FCPFF001.
Imagem 4 - Demonstração das configurações de filtro para se buscar as faturas em aberto, que possuem a data de vencimento entre os dias 20/07/2023 à 04/08/2023.
Imagem 5 - Conforme a imagem acima, podemos ver que foram trazidas 5 faturas que irão vencer conforme o período estipulado no filtro FCRFF004.
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "open-amount-document" para consulta do valor aberto por documento.
Imagem 2 - Neste exemplo usamos o componente FCRFL046 para demonstrar o valor em aberto do documento "Cheque".
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "amount-received-document" para consulta do valor recebido por documento.
Imagem 2 - Neste exemplo usamos o componente FCRFL046 para demonstrar o valor recebido do documento "Credev".
Imagem 1 - Demonstração da consulta do valor de clientes com maiores valores.
Imagem 2 - Demonstração do retorno da consulta da API referente ao endpoint "ranking-customer-biggers" para consulta do valor dos 5 maiores clientes.
Imagem 3 - Demonstração da consulta do valor de clientes com maior atraso.
Imagem 4 - Demonstração do retorno da consulta da API referente ao endpoint "ranking-customer-debtors" para consulta do valor recebido atrasado dos 5 maiores clientes.
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "ranking-supplier-biggers" para consulta do valor dos 5 maiores fornecedores.
Imagem 2 - Consulta no componente FCPFL028 referente ao mesmo período "Dt. chegada" da consulta realizada via API, considerando apenas duplicatas com o tipo de previsão "Real".
Imagem 3 - Demonstração do retorno da consulta da API referente ao endpoint "ranking-supplier-debtors" para consulta do valor dos 5 fornecedores mais devedores.
Imagem 4 - Consulta do componente FCPFL028 listando os 5 fornecedores mais devedores.
Imagem 1 - Demonstração do retorno da consulta da API referente ao endpoint "financial-income-statement" para consulta da DRF no regime de caixa, para exemplificar iremos pegar os valores de receita total de vendas.
Imagem 2 - Consulta no componente FCRFL046 referente ao mesmo período e no regime de caixa da consulta realizada via API.
Imagem 3 - Demonstração do retorno da consulta da API referente ao endpoint "financial-income-statement" para consulta da DRF no regime de competência, para exemplificar iremos pegar os valores de receita total de vendas.
Imagem 4 - Consulta no componente FCRFL046 referente ao mesmo período e no regime de competência da consulta realizada via API.
04. DEMAIS INFORMAÇÕES