Tiempo aproximado para lectura: 00:00:50 min
Dudas
Cual es el Objeto de negocio utilizado como fuente para el reporte de Certificado Retención IVA- rpWithholdingCertificate?
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 informaciones de:
- Empresa y sucursal.
- Proveedor/Receptor.
- Datos de emisión y período del certificado.
- Valores del movimiento, impuesto, título y base tributable.
- Clasificación y tipo de retención.
La API expone:
- GET /objectschema/*: devuelve el schema del objeto (metadatos).
- POST /data/*: devuelve los datos de la consulta.
Observaciones:
- Esta API utiliza el lookup de tipo de retención con la opción IVA.
- La rutina de negocio consumida permite devolver al IVA, ICA y Renta, y el filtro se aplica por medio de API según el tipo de retención informado.
Encabezado Detalle
| Campo | Descripción | Tipo |
|---|---|---|
| ttv | Empresa/Nombre enterprise | 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 | ID federal del proveedor | Character(8) |
| ttv_val_movto_ap | Valor movimiento AP | Decimal |
| ttv_val_imposto | Valor impuesto | Decimal |
| ttv_dat_expedic_certif | Fecha expedición certificado | Date |
| ttv_dat_emis_comprov | Fecha emisión comprobante | Date |
| ttv_cod_tit_co | Número título | Character(16) |
| ttv_cod_espec_docto_co | Clase de documento | Character(3) |
| ttv_cod_parc_co | Partida | Character(2) |
| ttv_val_movto_tot | Valor base total | Decimal |
| ttv_val_impto_tot_co | Valor impuesto total | Decimal |
| ttv_val_porc_tot | Porcentaje total | Decimal |
| ttv_val_porc_det | Porcentaje detalle | Decimal |
| ttv_cod_estab_co | Sucursal | Character(5) |
| ttv_nom_estab_co | Nombre sucursal | Character(40) |
| ttv_cod_impto_co | Impuesto | Character(5) |
| ttv_des_impto_co | Descripción impuesto | Character(40) |
| ttv_nom_fornec_co | Nombre proveedor/receptor | Character(40) |
| ttv_nom_cidad_fornec_co | Ciudad proveedor | Character(32) |
| ttv_cod_classif_impto_co | Clasificación impuesto | Character(5) |
| ttv_cod_classif_impto_det | Clasificación impuesto detalle | Character(5) |
| ttv_cdn_fornec_co | Código proveedor | Integer |
| ttv_des_classif_impto_co | Descripción clasificación impuesto | Character(40) |
| ttv_cb1_calc_dat_term_carenc | Campo calculado de carencia | Integer |
| ttv_cod_ser_docto | Serie documento | Character(5) |
| ttv_des_tit_ctbl | Título contable | Character(40) |
| ttv_val_tit_ap | Valor título AP | Decimal |
| ttv_val_imposto_ret | Valor impuesto retenido | Decimal |
| tta_val_rendto_tribut | Valor rendimiento tributable | Decimal |
| ttv_cod_tip_retenc | Tipo de retención | Character(20) |
| tta_val_aliq_impto_2 | Alícuota impuesto 2 | Decimal |
| ttv_val_agreg | Valor agregado | Decimal |
Parámetros
| Acción | Descripción |
|---|---|
| GET /objectschema/* | Devuelve el esquema (metadatos) del objeto de negocio para la configuración y el consumo de la consulta. |
| POST /data/* | Devuelve los datos de la consulta de Certificados de Retención de IVA, aplicando los filtros especificados. |
Parámetros de entrada utilizados en el POST:
- codEstab: sucursales (Character, multi valor).
- tipoRetencao: tipo de retención (Character), opcional y, cuando se informa, la API filtra por el valor.
- codFornecedor: proveedores (Character, multi valor).
- datEmisDoctoIni: fecha emisión inicial (Date).
- datEmisDoctoFim: fecha emisión final (Date).
- codPais: país (Character).
- codUnidFederac: unidad federativa (Character).
- codImposto: impuesto (Character).
- codClassifImpto: clasificación de impuesto (Character).
Reglas estándar cuando no se informan:
- 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 | Contiene los mensajes y errores generados durante el procesamiento. |
| tt-lookup-descriptor | Estructura auxiliar utilizada para las consultas de búsqueda (lookup). No corresponde a una tabla de datos de negocio devuelta en la respuesta del endpoint POST / Data. |
0 Comentarios