---
clave: "cce_guias:guia_manual:1404"
titulo: "Sigec: Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO"
corporacion: "Guías y Manuales CCE"
tipo: "Guía / Manual"
fecha: "2024-09-04"
radicado: ""
numero: "Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO"
ponente: ""
url_canonica: "https://adjudicalo.com.co/documento/cce_guias:guia_manual:1404"
---

# Sigec: Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO

- **Título oficial / radicado:** Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO
- **Corporación:** Guías y Manuales CCE
- **Tipo:** Guía / Manual
- **Fecha:** 2024-09-04
- **Número:** Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO
- **URL canónica en Adjudika:** https://adjudicalo.com.co/documento/cce_guias:guia_manual:1404
- **PDF oficial:** https://www.colombiacompra.gov.co/wp-content/uploads/2024/09/Acuerdo_de_Servicios_de_Interoperabilidad_sigec_ws-acto-documento_03-07-2024.xlsx
- **Fuente oficial:** https://www.colombiacompra.gov.co/archivos/manual/acuerdo-de-servicios-de-interoperabilidad-sigec-ws-acto-documento

## Puntos clave

- Guías y Manuales CCE
- SIGEC
- Manuales y Guías

## Extracto

DESCRIPCIÓN Servicio REST para el consumo por medio de la plataforma X-ROAD o por el Gateway de SIGEC, el cual permitirá la carga de los datos asociados al Acto/Documento de las estampillas. Ej: CCE-147-2023. actDocumentCode texto X Para Acto/Documento: 2 Plataforma Nombre de la plataforma del SECOP al que pertenece el Acto/Documento, que puede ser: 3 Valor del Acto/Documento Valor en pesos del Acto/Documento. generatorFactValue número X 1. 4 Fecha de inicio Acto/Documento Fecha de inicio del Acto/Documento generatorFactStartDate fecha X 1.

## Descriptores temáticos

Guías y Manuales CCE, SIGEC, Manuales y Guías

## Decisiones relacionadas

- [Guías y Manuales CCE — Sigec: 3 Pago Plantilla SIGEC](https://adjudicalo.com.co/documento/cce_guias:guia_manual:24100.md)
- [Guías y Manuales CCE — Sigec: 1 Actodocumento_Plantilla_SIGEC](https://adjudicalo.com.co/documento/cce_guias:guia_manual:24099.md)
- [Guías y Manuales CCE — Sigec: 2 Liquidacion Plantilla SIGEC](https://adjudicalo.com.co/documento/cce_guias:guia_manual:24095.md)
- [Guías y Manuales CCE — Sigec: 1 Actodocumento_Plantilla_SIGEC](https://adjudicalo.com.co/documento/cce_guias:guia_manual:24093.md)

## Texto del documento

Título: Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO
Corporación: Colombia Compra Eficiente
Descriptores: Guías y Manuales CCE, SIGEC, Manuales y Guías

Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO

SERVICIOS DE REPORTE DE ACTO-DOCUMENTO
DESCRIPCIÓN Servicio REST para el consumo por medio de la plataforma X-ROAD o por el Gateway de SIGEC, el cual permitirá la carga de los datos asociados al Acto/Documento de las estampillas. 
URL X-ROAD http://{IP_SERVIDOR_XROAD}/r1/CO-PRE/GOB/CCE-8033/ESTAMPILLA/WS-ACTO-DOCUMENTO/registrar
URL GATEWAY SIGEC https://preprosigec.colombiacompra.gov.co/gateway/stamp/v1/stamp/interoperabilityActoDocumento/registrar
MÉTODO POST
SERVICIOS DE REPORTE DE ACTO-DOCUMENTO
DESCRIPCIÓN Servicio REST para el consumo por medio de la plataforma X-ROAD o por el Gateway de SIGEC, el cual permitirá la carga de los datos asociados al Acto/Documento de las estampillas. 
URL X-ROAD http://{IP_SERVIDOR_XROAD}/r1/CO/GOB/CCE-8033/ESTAMPILLA/WS-ACTO-DOCUMENTO/registrar
URL GATEWAY SIGEC https://sigec.colombiacompra.gov.co/gateway/stamp/v1/stamp/interoperabilityActoDocumento/registrar
MÉTODO POST
ID NOMBRE DATO DESCRIPCIÓN NOMBRE TIPO Acto/Documento VALIDACIÓN MENSAJE OBSERVACIONES
0 Token Valor del token suministrado a la entidad para el proceso de autenticación en el sistema.  Authorization texto X 1. Parámetro obligatorio y único.
2. Tipo: Texto.
3. Este parámetro va en el header del Request. Si no es correcto: 
- Devuelve el mensaje “Error. Token inválido” 1. Si la información que se reporta corresponde a:
-	Entidad Territorial: El token enviado deberá corresponder con el que se generó para el registro de la entidad territorial.
-	Entidad Descentralizada: El token enviado deberá corresponder con el que se generó para el registro de la entidad descentralizada que depende de la entidad territorial solicitante. Si las entidades descentralizadas que dependen de la territorial solicitante son varias, para cada una de ellas debe existir su respectivo token para el reporte particular de su información.

2. Estos tokens son gestionados por el usuario Administrador Articulador, siempre será el mismo mientras no sea generado nuevamente y es suministrado a la Entidad por medio del procedimiento definido para tal fin.
1 Código Acto/Documento Código del Acto/Documento con que fue creado en la entidad que está cargando la información. Ej: CCE-147-2023. actDocumentCode texto X Para Acto/Documento:
1. Parámetro obligatorio.
2. Tipo: Texto.
3.Se valida que el actDocumentCode no se encuentre creado para el numero de indentificacion del sujeto pasivo taxpayerDocumentNumber. 1.Para Acto/Documento:
Si no es exitoso:
- Devuelve el mensaje: “Error. El valor del parámetro actDocumentCode es obligatorio”
-"Error. el valor del parametro actDocumentCode ya existe para el taxpayerDocumentNumber" Debe corresponder con el código del contrato/orden de compra en SECOP (SECOP I, SECOP II o TVEC).
tipo de operacion  Numero que indica el tipo de operación que desea realizar (0 – creación, 1 – adición): 
- 0 Creación 
- 1 Adición: Proceso para modificar el valor(generatorFactValue) y fecha de fin(generatorFactEndDate) del acto/documento indicado por el actDocumentCode y la identificación del sujeto pasivo. type numero X 1. Parámetro obligatorio.
2. Tipo: Número
3. El  valor debe ser 0 o 1
4. Si se selecciona la opcion 0 la combinancion de los  campos actDocument y  CodetaxpayerDocumentNumber no debe existir para la entidad territorial y centralizada.
5. Si se selecciona la opcion 1 la combinancion de los  campos actDocument y  CodetaxpayerDocumentNumber debe existir para la entidad territorial y centralizada. 1: Error. El valor del parametro type es obligatorio y debe estar dentro de los codigos validos
2. Error. El valor del parametro type es obligatorio y debe estar dentro de los codigos validos
3: Error. El valor del parametro type es obligatorio y debe estar dentro de los codigos validos
4. Error. el valor del parametro actDocumentCode ya existe para el taxpayerDocumentNumber para esta entidad
5. Error. El Acto documento no existe en el sistema para la entidad para realizar el cambio se debe crear primero El valor debe ser 0 para creación, o 1 para modificacion
2 Plataforma Nombre de la plataforma del SECOP al que pertenece el Acto/Documento, que puede ser: 
-	SECOP I 
-	SECOP II
-	TVEC
-NO PUBLICA platform número X 1. Parámetro Obligatorio.
2. Tipo: Número
3. Debe estar dentro de los valores {1,2,3,4}:
- SECOP I : 1
- SECOP II : 2
- TVEC : 3
- NO PUBLICA: 4 Si no es exitoso:
- Devuelve el mensaje: “Error. El valor del parámetro platform es obligatorio y debe estar dentro de los códigos válidos.”
3 Valor del Acto/Documento Valor en pesos del Acto/Documento.  generatorFactValue número X 1. Parámetro obligatorio.
2. Tipo: Número
3. Numérico y con máximo dos dígitos decimales. Si no es exitoso:
- Devuelve el mensaje: “Error. El valor del parámetro generatorFactValue es obligatorio y debe ser un número con dos decimales máximo” Modificable si el tipo de operación (type) es 1(uno) para la operación de adición.
4 Fecha de inicio Acto/Documento Fecha de inicio del Acto/Documento generatorFactStartDate fecha X 1. Parámetro obligatorio.
2. Tipo: Fecha
3. Formato fecha (yyyy-MM-dd HH:mm:ss) Si no es exitoso:
- Devuelve el mensaje: “Error. El valor del parámetro generatorFactStartDate es obligatorio y debe tener el formato (yyyy-MM-dd HH:mm:ss)”
5 Fecha de fin Acto/Documento Fecha final del Acto/Documento. generatorFactEndDate fecha X 1. Parámetro obligatorio.
2. Tipo: Fecha
3. Formato fecha (yyyy-MM-dd HH:mm:ss) Si no es exitoso:
- Devuelve el mensaje: “Error. El valor del parámetro generatorFactEndDate es obligatorio y debe tener el formato (yyyy-MM-dd HH:mm:ss)” Modificable si el tipo de operación (type) es 1(uno) para la operación de adición.
6 Acto /Documento Tipo del código del Acto/Documento. Debe estar dentro de los valores {"AD1,"AD8"}:
- Contratos: “AD4”
- Orden de compra: “AD8” parametricActDocumentCodeType texto X 1.	Parámetro obligatorio.
2.	Tipo: Texto.
3.	Debe estar dentro de los valores {"AD4","AD8"}:
-	Contratos: “AD4”
-	Orden de Compra: “AD8” Si no es exitoso:
- Devuelve el mensaje: “Error. El parámetro parametricActDocumentCodeType es obligatorio y debe estar dentro de los códigos válidos”
8 Tipo de Identificación del Sujeto Pasivo Tipo de identificación del contratista, que puede ser:
- Registro Civil.
- Tarjeta de identidad.
- Cédula de Ciudadanía.
- Tarjeta de Extranjería.
- Cédula de Extranjería.
- NIT.
- Pasaporte.
- Documento de Identificación Extranjero.
- PEP.
- NIT de otro país.
- NUIP. payerDocumentParametricTypeCode texto X 1.	Parámetro obligatorio.
2.	Tipo: Texto.
3.	Debe estar dentro de los valores {"RC", "TI", "CC", "TE", "CE", "NIT", "PAS", "DIE", "PEP", ”NITE", NUIP"}:
-	Registro Civil :"RC"
-	Tarjeta de identidad : "TI"
-	Cédula de Ciudadanía :"CC"
-	Tarjeta de Extranjería : "TE"
-	Cédula de Extranjería : "CE"
-	NIT : "NIT"
-	Pasaporte : "PAS"
-	Documento de Identificación Extranjero :"DIE"
-	PEP : "PEP"
-	NIT de otro país :“NITE"
-	NUIP :“NUIP" Si no es exitoso:
- Devuelve el mensaje: “Error. El parámetro payerDocumentParametricTypeCode es obligatorio y debe estar dentro de los códigos válidos”

9 Número de Identificación de sujeto pasivo Número de identificación del contratista. taxpayerDocumentNumber texto X 1.	Parámetro obligatorio.
2.	Tipo: Texto. Si no es exitoso:
- Devuelve el mensaje: “Error. El parámetro taxpayerDocumentNumber es obligatorio.
10 Nombres y apellidos de Sujeto pasivo o Razón Social Nombres y apellidos o Razón social del contratista taxpayerName texto X 1.	Parámetro obligatorio.
2.	Tipo: Texto. Si no es exitoso:
- Devuelve el mensaje: “Error. El parámetro taxpayerName es obligatorio.”
N/A
RESPUESTAS DEL SISTEMA
EVENTO HTTPSTATUS MENSAJE
ERROR EN LA VALIDACIÓN DEL TOKEN 401 Error. Token inválido
ERROR EN LA VALIDACION DEL CODIGO DEL ACTO/DOCUMENTO DURANTE EL REGISTRO DEL ACTO/DOCUMENTO 400 Error. El valor del parámetro actDocumentCode es obligatorio y único.
ERROR EN LA VALIDACIÓN DEL CÓDIGO DEL ACTO/DOCUMENTO DURANTE EL REGISTRO DE LA LIQUIDACIÓN 400 Error. El valor del parámetro actDocumentCode es obligatorio y debe existir en el sistema.
ERROR EN LA VALIDACIÓN DE LA PLATAFORMA 400 Error. El valor del parámetro platform es obligatorio y debe estar dentro de los códigos válidos.
ERROR EN LA VALIDACIÓN DEL VALOR DEL ACTO/DOCUMENTO 400 Error. El valor del parámetro generatorFactValue es obligatorio y debe ser un número con dos decimales máximo
ERROR EN LA VALIDACIÓN DE LA FECHA DE INICIO DEL ACTO/DOCUMENTO 400 Error. El valor del parámetro generatorFactStartDate es obligatorio y debe tener el formato (yyyy-MM-dd HH:mm:ss)
ERROR EN LA VALIDACIÓN DE LA FECHA DE FIN DEL ACTO/DOCUMENTO 400 Error. El valor del parámetro generatorFactEndDate es obligatorio y debe tener el formato (yyyy-MM-dd HH:mm:ss)
ERROR EN LA VALIDACIÓN DEL ACTO/DOCUMENTO 400 Error. El parámetro parametricActDocumentCodeType es obligatorio y debe estar dentro de los códigos válidos
ERROR EN LA VALIDACIÓN DEL TRÁMITE 400 Error. El parámetro parametricprocedureCode es obligatorio y debe estar dentro de los códigos válidos
ERROR EN LA VALIDACIÓN DEL TIPO DE IDENTIFICACIÓN DEL SUJETO PASIVO 400 Error. El parámetro payerDocumentParametricTypeCode es obligatorio y debe estar dentro de los códigos válidos
ERROR EN LA VALIDACIÓN NÚMERO DE IDENTIFICACIÓN DEL SUJETO PASIVO 400 Error. El parámetro taxpayerDocumentNumber es obligatorio
ERROR EN LA VALIDACION DE LOS NOMBRES Y APELLIDOS DEL SUJETO PASIVO O RAZÓN SOCIAL  400 Error. El parámetro taxpayerName es obligatorio.
ERROR EN LA VALIDACIÓN DEL IDENTIFICADOR DE LIQUIDACIÓN DURANTE EL REGISTRO DE UNA LIQUIDACIÓN 400 Error. El valor del parámetro liquidatedValueId es obligatorio
ERROR EN LA VALIDACIÓN DEL IDENTIFICADOR DE LIQUIDACIÓN DURANTE EL REGISTRO DE UN PAGO 400 Error. El valor del parámetro liquidatedValueId es obligatorio, debe estar creado en el sistema y no debe estar anulado
ERROR EN LA VALIDACIÓN DEL CÓDIGO DE ESTAMPILLA 400 Error. El valor del parámetro stampNumber es obligatorio y debe existir en el sistema
ERROR EN LA VALIDACIÓN DEL VALOR LIQUIDADO 400 Error. El valor del parámetro liquidatedValue es obligatorio y debe ser un número con dos decimales máximo
ERROR EN LA VALIDACIÓN DEL IDENTIFICADOR DE PAGO 400 Error. El valor del parámetro payedValueId es obligatorio.
ERROR EN LA VALIDACIÓN DEL VALOR PAGADO 400 Error. El valor del parámetro valuePayed es obligatorio y debe ser un número con dos decimales máximo
ERROR EN LA VALIDACIÓN DE LA FECHA DE PAGO 400 Error. El valor del parámetro paymentDate es obligatorio y debe tener el formato (yyyy-MM-dd)
ERROR DE LA VALIDACIÓN DEL TIPO DE ACCIÓN DURANTE EL REGISTRO DE LA LIQUIDACIÓN 400 Error. El valor del parámetro type es obligatorio y debe estar dentro de los códigos válidos
ERROR SI EL REGISTRO YA SE ENCUENTRA CARGADO DURANTE EL REGISTRO DE UNA LIQUIDACIÓN 400 Error. El valor del parámetro liquidatedValueId para el registro de liquidación debe ser único.
ERROR SI EL REGISTRO NO SE ENCUENTRA CARGADO DURANTE LA ANULACIÓN DE UNA LIQUIDACIÓN 400 Error. El valor del parámetro liquidatedValueId para la anulación de liquidación debe existir en el sistema.
ERROR SI EL REGISTRO TIENE ASOCIADOS PAGOS SIN ANULAR DURANTE LA ANULACIÓN DE UNA LIQUIDACIÓN 400 Error. El valor del parámetro liquidatedValueId para la anulación de liquidación no debe tener pagos asociados sin anular.
ERROR SI EL REGISTRO QUE SE PIENSA ANULAR NO ES IGUAL AL REGISTRADO DURANTE LA ANULACIÓN DE UNA LIQUIDACIÓN 400 Error. El registro de anulación con el parámetro liquidatedValueId suministrado no es idéntico al registrado en el sistema.
ERROR SI EL REGISTRO YA CUENTA CON UNA ANULACIÓN DURANTE LA ANULACIÓN DE UNA LIQUIDACIÓN 400 Error. Ya existe la anulación para esta liquidación
ERROR DE LA VALIDACIÓN DEL TIPO DE ACCIÓN DURANTE EL REGISTRO DE UN PAGO 400 Error. El valor del parámetro type es obligatorio y dentro de los códigos válidos.
ERROR SI EL REGISTRO YA SE ENCUENTRA CARGADO DURANTE EL REGISTRO DE UN PAGO 400 Error. El valor del parámetro payedValueId para el registro de pago debe ser único.
ERROR SI EL REGISTRO NO SE ENCUENTRA CARGADO DURANTE LA ANULACIÓN DE UN PAGO 400 Error. El valor del parámetro payedValueId para la anulación de pago debe existir en el sistema.
ERROR SI EL REGISTRO QUE SE PIENSA ANULAR NO ES IGUAL AL REGISTRADO DURANTE LA ANULACIÓN DE UN PAGO 400 Error. El registro de anulación con el parámetro payedValueId suministrado no es idéntico al registrado en el sistema.
ERROR SI EL REGISTRO YA CUENTA CON UNA ANULACIÓN DURANTE LA ANULACIÓN DE UN PAGO 400 Error. Ya existe la anulación para este pago
CARGA DE INFORMACIÓN ALMACENADA DURANTE EL REGISTRO DE UN ACTO/DOCUMENTO 200 Carga del hecho generador almacenada
CARGA DE INFORMACIÓN ALMACENADA DURANTE EL REGISTRO DE UNA LIQUIDACIÓN 200 Carga de la liquidación almacenada
CARGA DE INFORMACIÓN ALMACENADA DURANTE EL REGISTRO DE UN PAGO 200 Carga del pago almacenada

## Cómo citar esta fuente

Guías y Manuales CCE. Guía / Manual Acuerdo de Servicios de Interoperabilidad Sigec WS ACTO DOCUMENTO. 2024-09-04. Consultado en Adjudika (https://adjudicalo.com.co/documento/cce_guias:guia_manual:1404).
