Histórico da Página

Button

Texto	Voltar
Link	https://tdn.totvs.com/pages/viewpage.action?pageId=929926296

API para

Geração de Gráficos

generar gráficos

Nombre físico

Nome Físico

: prgfin/lco/lco728za.pyVersão

Versión de

Integração

integración: 001

Objetivo:

Realizar a conciliação automática dos saldos contábeis distribuídos por terceiros com os saldos contábeis gerados sem essa distribuição para as mesmas contas.

Pré-requisitos:

Não se aplica.

la conciliación automática de los saldos contables distribuidos por terceros con los saldos contables generados sin esa distribución para las mismas cuentas.

Prerrequisitos:

No se aplica.

CConsideraciones generales

Se pasan como parámetros de input y output a la API, como Input son: Plan de Cuentas, Escenario Contable, Finalidad Económica, Ejercicio, Período, Rango de Sucursales, Rango de Unidades de Negocio y flag para indicar si debe retornar solamente los saldos no conciliados, como Output son

Considerações Gerais

São passados como parâmetros de input e output para a API, como Input são: Plano de Contas, Cenário Contábil, Finalidade Econômica, Exercício, Período, Faixa de Estabelecimentos, Faixa de Unidades de Negócio e flag para indicar se deve retornar somente os saldos não conciliados, como Output são: tt_concilia_sdos_terceiros, tt_lanctos_ctbl_concil e y tt_erros_api.
A exibição das informações da API é feita através da execução da La exhibición de la información de la API se realiza a través de la ejecución de la API prgfin/lco/lco728za.py.
.

Parâmetros

Parámetros de

Entrada

entrada

Temp-table tt_concilia_sdos_terceiros: Na En la Temp-Table tt_concilia_sdos_terceiros, são definidas as características gerais e dados a serem devolvidos.se definen las características generales y datos que se desarrollarán.

Descripción de los camposDescrição dos campos

TEMP-TABLE tt_concilia_sdos_terceiros
Atributo	Tipo	Formato	Valor Inicialinicial	Índice
tta_cod_finalid_econ	Character	x(10)		X
tta_cod_cenar_ctbl	Character	x(8)		X
tta_cod_plano_cta_ctbl	Character	x(8)		X
tta_cod_cta_ctbl	Character	x(20)		X
tta_des_tit_ctbl	Character	x(40)
ttv_val_sdo_terc_inic	Decimal	->>,>>>,>>>,>>9.99	0
ttv_val_mov_terc_db	Decimal	->>,>>>,>>>,>>9.99	0
ttv_val_mov_terc_cr	Decimal	->>,>>>,>>>,>>9.99	0
ttv_val_sdo_terc_fim	Decimal	->>,>>>,>>>,>>9.99	0
ttv_val_sdo_ctbl_inic	Decimal	->>>,>>>,>>>,>>>,>>9.99	0
ttv_val_mov_ctbl_db	Decimal	->>,>>>,>>>,>>9.99	0
ttv_val_mov_ctbl_cr	Decimal	->>,>>>,>>>,>>9.99	0
ttv_val_sdo_ctbl_fim	Decimal	->>,>>>,>>>,>>9.99	0
ttv_log_dif_sdo	Logical	SimSí/NãoNo	No
ttv_log_dif_mov	Logical	SimSí/NãoNo	No	X

Atributo	DescriçãoDescripción
tta_cod_finalid_econ	FinalidadeFinalidad
tta_cod_cenar_ctbl	Cenário ContábilEscenario contable
tta_cod_plano_cta_ctbl	Plano ContasPlan Cuentas
tta_cod_cta_ctbl	Conta ContábilCuenta contable
tta_des_tit_ctbl	Título ContábilContable
ttv_val_sdo_ctbl_inic	Saldo Inicial
ttv_val_sdo_ctbl_fim	Saldo Final

Temp-table tt_lanctos_ctbl_concil: Na En la Temp-Table tt_lanctos_ctbl_concil, são definidas as características gerais e dados a serem devolvidos.se definen las características generales y datos que se desarrollarán.

Descripción de los Descrição dos campos

TEMP-TABLE tt_lanctos_ctbl_concil
Atributo	Tipo	Formato	Valor Inicial	Índice
tta_cod_cta_ctbl	Character	x(20)
tta_des_tit_ctbl	Character	x(40)
tta_val_lancto_ctbl	Decimal	>>>,>>>,>>>,>>9.99	0
tta_ind_natur_lancto	Character	X(5)
tta_dat_lancto_ctbl	Date	99/99/9999	?
tta_num_lote_ctbl	Integer	>>>,>>>,>>9	1
tta_num_lancto_ctbl	Integer	>>,>>>,>>9	10
tta_num_seq_lancto_ctbl	Integer	>>>>9	0

Descrição

Atributo	Descripción
tta_cod_cta_ctbl	Conta Contábil Cuenta contable
tta_des_tit_ctbl	Título Contábil Contable
tta_val_lancto_ctbl	Valor Lançamento Asiento
tta_ind_natur_lancto	Natureza Lançamento Naturaleza Asiento
tta_dat_lancto_ctbl	Data Lançto Fecha Asiento
tta_num_lote_ctbl	Lote Contábil Contable
tta_num_lancto_ctbl	Lançamento Contábil Asiento Contable
tta_num_seq_lancto_ctbl	Sequência Lançto Secuencia Asiento

Temp-table tt_retorna_sdo_ctbl: Na En la Temp-Table tt_retorna_sdo_ctbl, são definidas as características gerais e dados a serem devolvidos.se definen las características generales y datos que se desarrollarán.

Descripción de los Descrição dos campos

TEMP-TABLE tt_retorna_sdo_ctbl
Atributo	Tipo	Formato	Valor Inicial	Índice
tta_num_seq	Integer	>>>,>>9	0	X
tta_cod_empresa	Character	x(3)		X
tta_cod_finalid_econ	Character	x(10)		X
tta_cod_plano_cta_ctbl	Character	x(8)		X
tta_cod_cta_ctbl	Character	x(20)		X
tta_cod_plano_ccusto	Character	x(8)		X
tta_cod_ccusto	Character	x(20)		X
tta_cod_proj_financ	Character	x(20)		X
tta_cod_cenar_ctbl	Character	x(8)		X
tta_cod_estab	Character	x(5)		X
tta_cod_unid_negoc	Character	x(3)		X
tta_dat_sdo_ctbl	Date	99/99/9999	?	X
tta_val_sdo_ctbl_db	Decimal	->>>,>>>,>>>,>>9.99	0
tta_val_sdo_ctbl_cr	Decimal	->>>,>>>,>>>,>>9.99	0
tta_val_sdo_ctbl_fim	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_db	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_cr	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_acum	Decimal	->>>>,>>>,>>>,>>9.99	0
tta_val_sdo_ctbl_db_sint	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_sdo_ctbl_cr_sint	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_sdo_ctbl_fim_sint	Decimal	->>>>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_sint	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_sint_db	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_sint_cr	Decimal	->>,>>>,>>>,>>9.99	0
tta_val_apurac_restdo_sint_acum	Decimal	->>>>,>>>,>>>,>>9.99	0
tta_val_movto_empenh	Decimal	->>,>>>,>>>,>>9.99	0
tta_qtd_sdo_ctbl_db	Decimal	>>>,>>>,>>9.99	0
tta_qtd_sdo_ctbl_cr	Decimal	>>>,>>>,>>9.99	0
tta_qtd_sdo_ctbl_fim	Decimal	->>>,>>>,>>9.99	0
ttv_val_movto_ctbl	Decimal	>>>,>>>,>>>,>>9.99	0
tta_qtd_movto_empenh	Decimal	->>>>,>>9.9999	0

Atributo	Descrição Descripción
tta_num_seq	Num Seq Sec
tta_cod_empresa	Empresa
tta_cod_finalid_econ	Finalidade Finalidad
tta_cod_plano_cta_ctbl	Plano Contas Plan Cuentas
tta_cod_cta_ctbl	Conta Contábil Cuenta contable
tta_cod_plano_ccusto	Plano Plan Centros Custo Costo
tta_cod_ccusto	Centro Custo Costo
tta_cod_proj_financ	Projeto Proyecto
tta_cod_cenar_ctbl	Cenário Contábil Escenario contable
tta_cod_estab	Estab Sucur.
tta_cod_unid_negoc	Un Neg
tta_dat_sdo_ctbl	Data Fecha Saldo Cont bil ble
tta_val_sdo_ctbl_db	Movto Débito
tta_val_sdo_ctbl_cr	Movto Crédito
tta_val_sdo_ctbl_fim	Saldo Contábil Contable Final
tta_val_apurac_restdo	Apuração Cálculo Resultado
tta_val_apurac_restdo_db	Apuração Restdo Cálculo Rest del DB
tta_val_apurac_restdo_cr	Apuração Restdo Cálculo Rest del CR
tta_val_apurac_restdo_acum	Apuracao Cálculo Final
tta_val_sdo_ctbl_db_sint	Movto Débito Sint
tta_val_sdo_ctbl_cr_sint	Movto Crédito Sint
tta_val_sdo_ctbl_fim_sint	Saldo Sintético
tta_val_apurac_restdo_sint	Apuracao Cálculo Resultado
tta_val_apurac_restdo_sint_db	Apur Cálc Restdo Sint DB
tta_val_apurac_restdo_sint_cr	Apur Cálc Restdo Sint CR
tta_val_apurac_restdo_sint_acum	Apur Cálc Result Sint
tta_val_movto_empenh	Movto Empenhado Empeñado
tta_qtd_sdo_ctbl_db	Quantidade Cantidad DB
tta_qtd_sdo_ctbl_cr	Quantidade Cantidad CR
tta_qtd_sdo_ctbl_fim	Quantidade Cantidad Final
ttv_val_movto_ctbl	Movimento Contábil Movimiento Contable
tta_qtd_movto_empenh	Qtde Cant Movto Empenhado Empeñado

Execução

Ejecución

SintaxeSintaxis:

Bloco de código

language	ruby

IF NOT VALID-HANDLE(v_hdl_api) THEN
    RUN prgfin/lco/lco728za.r PERSISTENT SET v_hdl_api.

/* Busca Saldo Inicial */
    run pi_busca_sdo_ctbl in v_hdl_api (input v_cod_empres_usuar,
                           				input p_cod_estab_ini,
                          				input p_cod_estab_fim,
                           				input p_cod_finalid_econ,
                           				input colext_cta_ctbl.cod_plano_cta_ctbl,
                           				input colext_cta_ctbl.cod_cta_ctbl,
                           				input colext_cta_ctbl.cod_cta_ctbl,
                           				input "",
                           				input "",
                           				input "ZZZZZZZZZZZ" /*l_zzzzzzzzzzz*/ ,
                           				input p_cod_un_inicial,
                           				input p_cod_un_final,
                           				input p_cod_cenar_ctbl,
                           				input "",
                          				input "ZZZZZZZZZZZZZZZZZZZZ" /*l_zzzzzzzzzzzzzzzzzzzz*/ ,
                           				input v_dat_sdo_inic,
                           				input v_dat_sdo_inic,
                           				input no,
                           				input "MaiorMayor ouo Igual ey Menor ouo Igual" /*l_maior_igual_menor_igual*/ ,
                           				input "for each" /*l_for_each*/ ,
                           				output table tt_retorna_sdo_ctbl).

Em caso de erro nas validações acima, o erro será retornado por meio da Si hubiera error en las validaciones anteriores, el error se devolverá por medio de la temp-table tt_erros_api.

Se os dados forem aceitos, a API devolverá as informações para geração da conciliação Si los datos se aceptaran, la API devolverá las informaciones para generar la conciliación de saldos por terceiros compras quando for chamada a terceros, compras cuando se active la procedure pi_busca_sdo_ctbl.

ExemploEjemplo:

Expandir

title	Clique aqui Haga clic aquí para visualizar...

Bloco de código

language	ruby

def var v_hdl_api as Handle format ">>>>>>9":U no-undo.

run prgfin\lco\lco728za.r persistent set v_hdl_api.

if  valid-handle(v_hdl_api)
then do:
     /* Busca planoplan de contascuentas */
		run prgfin\lco\lco728za.r (input "GRIFFE1",       /* PlanoPlan de ContasCuentas */
                    	       	   input "Fiscal",        /* Escen rio Cen rioCont Cont bilble */
                        		   input "PESO COL",      /* FinalidadeFinalidad Econ“micaEconomica */
		                           input v_cod_exercicio, /* Exerc¡cio */
		                           input v_num_periodo,   /* Per¡odoPeriodo */
		                           input "IGN",           /* EstabSucur Inicial */
		                           input "IGV",           /* EstabSucur Final */
		                           input "008",           /* UN Inicial */
		                           input "VEN",           /* UN Final */
		                           input no,              /* Retorna SomenteSolamente NÆoNo Conciliados */
		                           output table tt_concilia_sdos_terceiros,
		                           output table tt_lanctos_ctbl_concil,
DELETE PROCEDURE v_hdl_api.

Parâmetros

Parámetros de

Saída

salida

Si el retorno fuera No caso do retorno ser NOK, todos os erros encontrados serão retornados na tabela los errores encontrados se devolverán en la tabla Temp-Table tt_erros_api:

A La tt-erros é uma tabela es una tabla de retorno de dados referentes aos erros encontrados na manipulação dos dados das tabelas de datos diferente de los errores encontrados en el manejo de los datos de las tablas de entrada. A La tt-erros retorna dados datos por meio medio de um registro contendo o código do erro e a sua descriçãoun registro que contiene el código del error y su descripción.

Obs.: Depois da chamada feita à API é imprescindível tratar os erros retornados caso existamDespués de llamar a la API es imprescindible tratar los errores retornados si existieran.

TEMP-TABLE tt_erros_api
Atributo	Tipo	Formato	Valor Inicial
ttv_num_erro	Integer	>>>,>>9	0
ttv_des_mensagem	Character	x(50)
ttv_des_ajuda	Character	x(50)
ttv_row_id	Rowid	Rowid	?

Atributo	DescriçãoDescripción
ttv_num_erro	Número do erro. Sequencial Secuencia dentro da de la temp-table.
ttv_des_mensagem	Descrição do erroDescripción del error.
ttv_des_ajuda	Descrição ajudaDescripción Ayuda.
ttv_row_id	Rowid.

Documento Traduzido

Xxxxxx

Home

Línea Datasul

Páginas filhas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

API para

generar gráficos

CConsideraciones generales

Considerações Gerais

Parámetros de

entrada

Ejecución

Parámetros de

salida

Documento Traduzido