LCO728ZA - API de Conciliación de Saldos por Terceros

API para generar gráficos

Nombre físico: prgfin/lco/lco728za.py

Versión de integración: 001

Objetivo:

Realizar 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: tt_concilia_sdos_terceiros, tt_lanctos_ctbl_concil y tt_erros_api.
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 de entrada

Temp-table tt_concilia_sdos_terceiros: En la Temp-Table tt_concilia_sdos_terceiros, se definen las características generales y datos que se desarrollarán.

Descripción de los campos

TEMP-TABLE tt_concilia_sdos_terceiros
Atributo	Tipo	Formato	Valor inicial	Í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	Sí/No	No
ttv_log_dif_mov	Logical	Sí/No	No	X

Atributo	Descripción
tta_cod_finalid_econ	Finalidad
tta_cod_cenar_ctbl	Escenario contable
tta_cod_plano_cta_ctbl	Plan Cuentas
tta_cod_cta_ctbl	Cuenta contable
tta_des_tit_ctbl	Título Contable
ttv_val_sdo_ctbl_inic	Saldo Inicial
ttv_val_sdo_ctbl_fim	Saldo Final

Temp-table tt_lanctos_ctbl_concil: En la Temp-Table tt_lanctos_ctbl_concil, se definen las características generales y datos que se desarrollarán.

Descripción de los 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

Atributo	Descripción
tta_cod_cta_ctbl	Cuenta contable
tta_des_tit_ctbl	Título Contable
tta_val_lancto_ctbl	Valor Asiento
tta_ind_natur_lancto	Naturaleza Asiento
tta_dat_lancto_ctbl	Fecha Asiento
tta_num_lote_ctbl	Lote Contable
tta_num_lancto_ctbl	Asiento Contable
tta_num_seq_lancto_ctbl	Secuencia Asiento

Temp-table tt_retorna_sdo_ctbl: En la Temp-Table tt_retorna_sdo_ctbl, se definen las características generales y datos que se desarrollarán.

Descripción de los 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	Descripción
tta_num_seq	Num Sec
tta_cod_empresa	Empresa
tta_cod_finalid_econ	Finalidad
tta_cod_plano_cta_ctbl	Plan Cuentas
tta_cod_cta_ctbl	Cuenta contable
tta_cod_plano_ccusto	Plan Centros Costo
tta_cod_ccusto	Centro Costo
tta_cod_proj_financ	Proyecto
tta_cod_cenar_ctbl	Escenario contable
tta_cod_estab	Sucur.
tta_cod_unid_negoc	Un Neg
tta_dat_sdo_ctbl	Fecha Saldo Cont ble
tta_val_sdo_ctbl_db	Movto Débito
tta_val_sdo_ctbl_cr	Movto Crédito
tta_val_sdo_ctbl_fim	Saldo Contable Final
tta_val_apurac_restdo	Cálculo Resultado
tta_val_apurac_restdo_db	Cálculo Rest del DB
tta_val_apurac_restdo_cr	Cálculo Rest del CR
tta_val_apurac_restdo_acum	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	Cálculo Resultado
tta_val_apurac_restdo_sint_db	Cálc Restdo Sint DB
tta_val_apurac_restdo_sint_cr	Cálc Restdo Sint CR
tta_val_apurac_restdo_sint_acum	Cálc Result Sint
tta_val_movto_empenh	Movto Empeñado
tta_qtd_sdo_ctbl_db	Cantidad DB
tta_qtd_sdo_ctbl_cr	Cantidad CR
tta_qtd_sdo_ctbl_fim	Cantidad Final
ttv_val_movto_ctbl	Movimiento Contable
tta_qtd_movto_empenh	Cant Movto Empeñado

Ejecución

Sintaxis:

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 "Mayor o Igual y Menor o Igual" /*l_maior_igual_menor_igual*/ ,
                           				input "for each" /*l_for_each*/ ,
                           				output table tt_retorna_sdo_ctbl).

Si hubiera error en las validaciones anteriores, el error se devolverá por medio de la temp-table tt_erros_api.

Si los datos se aceptaran, la API devolverá las informaciones para generar la conciliación de saldos por terceros, compras cuando se active la procedure pi_busca_sdo_ctbl.

Ejemplo:

Haga clic aquí para visualizar...

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 plan de cuentas */
		run prgfin\lco\lco728za.r (input "GRIFFE1",       /* Plan de Cuentas */
                    	       	   input "Fiscal",        /* Escen rio Cont ble */
                        		   input "PESO COL",      /* Finalidad Economica */
		                           input v_cod_exercicio, /* Exerc¡cio */
		                           input v_num_periodo,   /* Periodo */
		                           input "IGN",           /* Sucur Inicial */
		                           input "IGV",           /* Sucur Final */
		                           input "008",           /* UN Inicial */
		                           input "VEN",           /* UN Final */
		                           input no,              /* Retorna Solamente No Conciliados */
		                           output table tt_concilia_sdos_terceiros,
		                           output table tt_lanctos_ctbl_concil,
DELETE PROCEDURE v_hdl_api.

Parámetros de salida

Si el retorno fuera NOK, todos los errores encontrados se devolverán en la tabla Temp-Table tt_erros_api:

La tt-erros es una tabla de retorno de datos diferente de los errores encontrados en el manejo de los datos de las tablas de entrada. La tt-erros retorna datos por medio de un registro que contiene el código del error y su descripción.

Obs.: Despué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	Descripción
ttv_num_erro	Número do erro. Secuencia dentro de la temp-table.
ttv_des_mensagem	Descripción del error.
ttv_des_ajuda	Descripción Ayuda.
ttv_row_id	Rowid.

Home

Línea Datasul

Páginas filhas

API para generar gráficos

CConsideraciones generales

Parámetros de entrada

Ejecución

Parámetros de salida