Tiempo aproximado para lectura: 00:00:40 min
Dudas
Cual es el Objeto de negocio utilizado como fuente para el reporte de Certificado de Retención sobre la Renta?
Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Datasul) - Cuentas por Pagar (APB) – A partir de Totvs12
Solución
Este objeto de negocio proporciona los datos de la consulta de Certificados de Retención (Colombia), consolidando información sobre:
Empresa y establecimiento.
Proveedor/receptor.
Datos de emisión y período del certificado.
Valores de movimiento, impuesto, título y base imponible.
Clasificación y tipo de retención.
La API expone:
GET /objectschema/*: devuelve el esquema del objeto (metadatos).
POST /data/*: devuelve los datos de la consulta.
Observación:
Esta API utiliza la búsqueda -lookup, del tipo de retención con la opción Renta
La rutina de negocio consumida permite obtener resultados para IVA, ICA y Renta, y la API aplica el filtro según el tipo de retención informado.
Cuando tipoRetencion = Renta, la API realiza una normalización interna a Renta antes de aplicar el filtro a los registros.
Encabezado del Detalle
| Campo | Descripción | Tipo de dato |
|---|---|---|
| ttv_nom_enterprise | Empresa / Nombre de la empresa | Character(40) |
| ttv_cod_id_feder | Identificación federal | Character(20) |
| ttv_dat_inic_period_2 | Fecha inicial del período | Date |
| ttv_dat_final_period_2 | Fecha final del período | Date |
| ttv_nom_endereco | Dirección | Character(40) |
| ttv_nom_ender | Dirección (descripción alternativa) | Character(40) |
| ttv_cod_id_feder_fornec | Identificación federal del proveedor | Character(8) |
| ttv_val_movto_ap | Valor del movimiento AP | Decimal |
| ttv_val_imposto | Valor del impuesto | Decimal |
| ttv_dat_expedic_certif | Fecha de expedición del certificado | Date |
| ttv_dat_emis_comprov | Fecha de emisión del comprobante | Date |
| ttv_cod_tit_co | Número de título | Character(16) |
| ttv_cod_espec_docto_co | Tipo de documento | Character(3) |
| ttv_cod_parc_co | Cuota | Character(2) |
| ttv_val_movto_tot | Valor total de la base | Decimal |
| ttv_val_impto_tot_co | Valor total del impuesto | Decimal |
| ttv_val_porc_tot | Porcentaje total | Decimal |
| ttv_val_porc_det | Porcentaje del detalle | Decimal |
| ttv_cod_estab_co | Código del establecimiento | Character(5) |
| ttv_nom_estab_co | Nombre del establecimiento | Character(40) |
| ttv_cod_impto_co | Código del impuesto | Character(5) |
| ttv_des_impto_co | Descripción del impuesto | Character(40) |
| ttv_nom_fornec_co | Nombre del proveedor/receptor | Character(40) |
| ttv_nom_cidad_fornec_co | Ciudad del proveedor | Character(32) |
| ttv_cod_classif_impto_co | Clasificación del impuesto | Character(5) |
| ttv_cod_classif_impto_det | Clasificación del impuesto (detalle) | Character(5) |
| ttv_cdn_fornec_co | Código del proveedor | Integer |
| ttv_des_classif_impto_co | Descripción de la clasificación del impuesto | Character(40) |
| ttv_cb1_calc_dat_term_carenc | Campo calculado del período de carencia | Integer |
| ttv_cod_ser_docto | Serie del documento | Character(5) |
| ttv_des_tit_ctbl | Título contable | Character(40) |
| ttv_val_tit_ap | Valor del título AP | Decimal |
| ttv_val_imposto_ret | Valor del impuesto retenido | Decimal |
| tta_val_rendto_tribut | Valor de la renta imponible | Decimal |
| ttv_cod_tip_retenc | Tipo de retención | Character(20) |
| tta_val_aliq_impto_2 | Alícuota del impuesto 2 | Decimal |
| ttv_val_agreg | Valor agregado | Decimal |
| Método / Endpoint | Descripción |
|---|---|
| GET /objectschema/* | Devuelve el esquema -metadatos del objeto de negocio para la construcción y el consumo de la consulta. |
| POST /data/* | Devuelve los datos de la consulta de Certificados de Retención de Renta, aplicando los filtros informados. |
Parámetros de entrada utilizados en el POST:
- codEstab: establecimientos -Character, multivalor.
- tipoRetencao: tipo de retención -Character, opcional. Cuando se informa, la API filtra por el valor indicado.
- codFornecedor: proveedores -Character, multivalor.
- datEmisDoctoIni: fecha de emisión inicial -Date.
- datEmisDoctoFim: fecha de emisión final -Date.
- codPais: país -Character.
- codUnidFederac: unidad federativa -Character.
- codImposto: impuesto -Character.
- codClassifImpto: clasificación del impuesto -Character.
Reglas predeterminadas cuando no se informan los parámetros:
- datEmisDoctoIni = TODAY.
- datEmisDoctoFim = TODAY.
Tablas utilizadas
| Tabla | Descripción |
|---|---|
| tt_rpt_tit_ap_certif_reten_col | Tabla temporal final devuelta por el objeto de negocio. |
| tt_erros_api | Mensajes/errores de procesamiento. |
| tt-lookup-descriptor | Estructura auxiliar para devolver el descriptor en los endpoints de búsqueda -lookup. No es una tabla de datos de negocio devuelta en el POST /data. |
0 Comentarios