Referencia de respuestas

Esta página reúne las estructuras y los códigos que comparten varios métodos de la API. Cada método enlaza aquí en lugar de repetir las mismas tablas.

Respuesta (ResponseType)

Los métodos de trazabilidad (GetTransaccion y sus variantes) devuelven una respuesta de tipo ResponseType, que contiene información sobre el resultado de la operación, la identificación del documento, su procesamiento y la trazabilidad de las acciones ejecutadas en Colfact.

Campo	Descripción
CodQR	Texto con la información asociada al código QR del documento.
Base64QR	Imagen del código QR codificada en Base64, cuando está disponible.
CodResp	Código que identifica el resultado de la operación. Ver Códigos de respuesta.
CodigoTransaccion	Código único de identificación del documento electrónico. Corresponde al CUFE o CUDE, según el tipo de documento y cuando esté disponible.
NumeroTransaccion	Número del documento enviado, de acuerdo con la resolución o configuración aplicable.
DetalleRespuesta	Observaciones relacionadas con el resultado de la operación y el procesamiento del documento.
Detalles	Información detallada de la respuesta recibida de la DIAN, cuando está disponible.
IdTransaccion	Identificador interno de la transacción en Colfact.
PDFBase64	Representación gráfica del documento en formato PDF, codificada en Base64, cuando está disponible.
Proceso	Lista de eventos asociados a la trazabilidad del documento. Ver ProcesoType.
Suscripciones	Información de las suscripciones asociadas al emisor. Ver SuscripcionType.
EmailEstado	Información sobre los envíos de correo electrónico asociados al documento. Ver EmailEstadoType.
TipoTransaccion	Código que identifica el tipo de transacción o el contexto de la respuesta. Ver Tipos de transacción.
XML	XML del documento electrónico generado y enviado a la DIAN, cuando está disponible.
FechaValidacion	Fecha y hora de recepción de la respuesta de validación de la DIAN por parte de Colfact.

Códigos de respuesta (CodResp)

El campo CodResp identifica el resultado de la operación reportado por el servicio.

Código	Descripción
OK	El documento fue recibido satisfactoriamente por el servicio.
ERR	Se presentó un inconveniente relacionado con la estructura, los datos o el procesamiento del documento.
PROCE	El documento aún no cuenta con una respuesta de la DIAN.

Tipos de transacción (TipoTransaccion)

Código	Descripción
RECIB	Solicitud o documento recibido.
FAC	Factura electrónica.
NCR	Nota crédito electrónica.
NDB	Nota débito electrónica.
ERROR	Se presentó un error durante la operación o la consulta de la trazabilidad.

Consideraciones sobre la respuesta

• La disponibilidad de los campos depende del método invocado, del estado del documento y de la etapa en la que se encuentre el procesamiento.
• CodResp y TipoTransaccion representan información diferente: el primero identifica el resultado de la operación y el segundo el tipo de transacción o contexto de la respuesta.
• PDFBase64, Base64QR, XML y otros campos pueden no estar disponibles en todas las consultas.
• En caso de rechazo de la DIAN, el campo PDFBase64 puede estar vacío.

Trazabilidad del documento (ProcesoType)

El campo Proceso contiene los eventos registrados durante el procesamiento del documento. Cada elemento permite identificar la etapa ejecutada, el mensaje asociado y la fecha y hora de la acción.

Campo	Descripción	Observaciones
Order	Orden en que se registró o ejecutó el evento.	Permite identificar la secuencia de los eventos.
Proceso	Código de la etapa del procesamiento.	Ver Códigos de proceso.
Mensaje	Mensaje descriptivo asociado al evento.	Contiene la información registrada para la acción correspondiente.
FechaHoraAccion	Fecha y hora asociadas al evento.	Permite consultar cuándo ocurrió cada evento.

Códigos de proceso

Código	Descripción
RECIB	Recepción inicial del documento.
FIRMA	Firma del XML.
ENAUT	Envío del documento a la autoridad correspondiente.
VEAUT	Verificación ante la autoridad.
DOCUM	Generación de documentos asociados al procesamiento.

Estado de los correos electrónicos (EmailEstadoType)

El campo EmailEstado contiene información relacionada con los envíos de correo electrónico asociados al documento. Permite consultar datos de identificación del mensaje, destinatarios y eventos reportados por el proveedor de correo.

Campo	Descripción
MessageId	Identificador único del mensaje asignado por el proveedor de correo electrónico.
idTransaccion	Identificador de la transacción asociada al documento en Colfact.
Recipient	Dirección de correo electrónico del destinatario.
Action	Acción o estado asociado al envío del correo electrónico, según los valores definidos por el proveedor.
SmtpStatus	Estado de la operación de envío según la información SMTP reportada.
BounceCategory	Categoría asociada al rechazo o devolución del correo electrónico, cuando se presenta.
Provider	Proveedor o servicio de correo electrónico utilizado.
Dkim	Información relacionada con la validación de DKIM (DomainKeys Identified Mail), cuando está disponible.
SendIp	Dirección IP de origen reportada por el proveedor.
ReceivedAt	Fecha y hora de recepción del evento por parte del proveedor.
IngestedAt	Fecha y hora en que el evento fue incorporado al sistema de seguimiento.

Consideraciones

• La información disponible depende de los eventos reportados por el proveedor de correo electrónico.
• Un estado de envío exitoso no necesariamente significa que el destinatario haya leído el mensaje.
• Los valores de Action, SmtpStatus, BounceCategory y Dkim deben interpretarse de acuerdo con el contrato y la documentación del proveedor utilizado.

Suscripciones (SuscripcionType)

Contiene información sobre las suscripciones asociadas al emisor, incluyendo su vigencia, consumo, disponibilidad y estado actual.

Campo	Descripción
IssuerId	Identificador del emisor asociado a la suscripción.
TotalQuantity	Cantidad total de documentos permitidos por la suscripción.
ConsumedQuantity	Cantidad de documentos consumidos o contabilizados.
RemainingQuantity	Cantidad de documentos disponibles para consumo.
StartDate	Fecha de inicio de vigencia de la suscripción.
EndDate	Fecha de finalización de la vigencia de la suscripción.
Status	Estado actual de la suscripción, según los valores definidos por el servicio.
DocumentPackage	Información del paquete de documentos asociado a la suscripción. Ver DocumentPackageType.

Paquetes de documentos (DocumentPackageType)

Contiene información del paquete de documentos asociado al sistema integrado y al socio de negocio, incluyendo las cantidades permitidas, consumidas y disponibles.

Campo	Descripción
IntegratedSystemId	Identificador del sistema integrado asociado al paquete.
BusinessPartnerId	Identificador del socio de negocio relacionado con el paquete.
TotalQuantity	Cantidad total de documentos permitidos en el paquete.
ConsumedQuantity	Cantidad de documentos consumidos del paquete.
RemainingQuantity	Cantidad de documentos disponibles en el paquete.
StartDate	Fecha de inicio de vigencia del paquete.
EndDate	Fecha de finalización de la vigencia del paquete.
Status	Estado actual del paquete, según los valores definidos por el servicio.
DocumentPackageLimit	Límites de consumo del paquete. Ver DocumentPackageLimitType.
Subscription	Suscripción relacionada con el paquete (solo en ViewDocumentPackage). Ver SuscripcionType.

Límites del paquete (DocumentPackageLimitType)

Contiene información sobre los límites de consumo establecidos para el paquete de documentos, por tipo de servicio.

Campo	Descripción
TotalQuantity	Cantidad total permitida para el límite configurado.
ConsumedQuantity	Cantidad consumida del límite.
RemainingQuantity	Cantidad disponible para consumo dentro del límite.
ServiceTypeCode	Código del tipo de servicio al que corresponde el límite. Ver Códigos de tipo de servicio.
StartDate	Fecha de inicio de vigencia del límite.
EndDate	Fecha de finalización de la vigencia del límite.
Status	Estado actual del límite, según las reglas definidas por el servicio.

Códigos de tipo de servicio (ServiceTypeCode)

Código	Descripción
FE	Facturación electrónica.
DS	Documento soporte.
NE	Nómina electrónica.
RC	Recepción.
JL	Boleta de juegos localizados y no localizados.
BC	Boleta de cobro de peajes.
BE	Boleta de ingreso de espectáculos públicos.
TD	Boleta de transporte terrestre de pasajeros.
BI	Boleta de ingreso a cine.
SP	Boleta de servicios públicos.
PS	Boleta de facturación POS.
CD	Consulta de documentos.

Consideraciones sobre suscripciones y paquetes

• TotalQuantity representa el cupo total configurado.
• ConsumedQuantity indica el consumo registrado.
• RemainingQuantity corresponde al saldo disponible.
• StartDate y EndDate identifican el período de vigencia configurado.
• Los valores de Status deben interpretarse según las reglas definidas por el servicio.
• La información de suscripciones, paquetes y límites puede variar según la configuración asociada al emisor y al sistema integrado.