Extraer documentos emitidos

El método ExtraerEmision permite consultar los documentos emitidos dentro de un rango de fechas, junto con la información de su estado y la respuesta obtenida por parte de la DIAN.

Esta operación facilita la identificación y el seguimiento de documentos electrónicos, especialmente cuando se requiere verificar su recepción en Colfact, consultar su estado o identificar posibles motivos de rechazo.

Con este método puedes:

• Consultar los documentos emitidos dentro de un rango de fechas.
• Identificar documentos que requieren revisión por posibles inconvenientes en su recepción o procesamiento.
• Consultar el estado de cada documento.
• Obtener la respuesta de la DIAN y el motivo de rechazo, cuando aplique.
• Filtrar los resultados por comprador, tipo de transacción, código de operación y estado.

POST https://micro.conexusit.com/corp/demo/api/Service.svc/ExtraerEmision

Endpoint

Dato	Valor
Método HTTP	POST
Operación	ExtraerEmision

Parámetros de entrada

El método recibe un objeto con los filtros de consulta: un rango de fechas obligatorio y filtros adicionales opcionales para delimitar los documentos que se desean consultar.

Parámetro	Tipo	Obligatorio	Descripción
guidEmpresa	string	Sí	GUID de la empresa emisora registrada en Colfact.
fechaInicio	string	Sí	Fecha inicial del rango de búsqueda, en formato yyyy-MM-dd.
fechaFin	string	Sí	Fecha final del rango de búsqueda, en formato yyyy-MM-dd.
identComprador	string	No	Número de identificación del comprador.
tipoTransaccion	string	No	Código del tipo de documento que se desea consultar (ver tabla siguiente).
codOperacion	string	No	Código de operación por el cual se desea filtrar la consulta.
estado	string	No	Estado del documento que se desea consultar.

Validación del rango de fechas

Los campos fechaInicio y fechaFin deben enviarse con el formato yyyy-MM-dd. Se recomienda verificar que la fecha inicial no sea posterior a la fecha final.

Tipos de transacción permitidos

El campo tipoTransaccion permite filtrar los resultados según el código del documento electrónico.

Código	Descripción
FAC	Factura electrónica
NCR	Nota crédito electrónica
NDB	Nota débito
NIE	Nómina electrónica
NIA	Nota de ajuste a nómina electrónica
DSP	Documento soporte
DSA	Documento soporte de ajuste
POS	Factura POS
POA	Nota de ajuste POS
TTD	Documento equivalente de transporte terrestre
SPD	Documento equivalente de servicios públicos domiciliarios
BCP	Documento equivalente de boleta de cobro de peajes
BEP	Documento equivalente de boleta de espectáculos públicos
BIC	Documento equivalente de boleta de ingreso a cine
JLN	Documento equivalente de boleta de juegos localizados o no localizados

Ejemplo de solicitud

El siguiente ejemplo muestra una consulta para una empresa y un rango de fechas específico, sin aplicar filtros opcionales.

{
  "guidEmpresa": "12345678-ABCD-1234-ABCD-123456789ABC",
  "fechaInicio": "2024-01-01",
  "fechaFin": "2024-01-31",
  "identComprador": "",
  "tipoTransaccion": "",
  "codOperacion": "",
  "estado": ""
}

Uso de filtros opcionales

Para consultar todos los documentos dentro del rango de fechas, los filtros opcionales pueden enviarse vacíos, según el comportamiento descrito para el servicio.

Si necesitas una consulta más específica, envía el valor correspondiente en los campos identComprador, tipoTransaccion, codOperacion o estado.

Estructura de la respuesta

El servicio devuelve un objeto con la información general de la consulta y una colección denominada documentos, que contiene los registros encontrados.

Información general

Campo	Descripción
Estado	Estado general de la consulta: EXITO, PROCE o ERROR.
DetalleEstado	Mensaje descriptivo del resultado de la consulta.
guidEmpresa	GUID de la empresa consultada.
fechaInicio	Fecha inicial utilizada en la consulta.
fechaFin	Fecha final utilizada en la consulta.
tipoTransaccion	Tipo de documento consultado o Todos, cuando no se aplica un filtro específico.
codOperacion	Código de operación consultado o Todos, cuando no se aplica un filtro específico.
identComprador	Identificación del comprador consultado o Todos, cuando no se aplica un filtro específico.
documentos	Colección de documentos que coinciden con los filtros enviados.

Resultado de documentos

Cada elemento de la colección documentos contiene información de identificación, fechas, datos del comprador, valores del documento y respuesta de la DIAN.

Campo	Descripción
idSegmento	Identificador del segmento correspondiente al año y mes del documento. Formato numérico yyyyMM.
tipoTransaccion	Código del tipo de documento.
numeroTransaccion	Número del documento electrónico.
fechaEmision	Fecha y hora de emisión. Formato de ejemplo: yyyy-MM-dd HH:mm.
fechaHoraIngreso	Fecha y hora de ingreso del documento a la plataforma.
codigoTransaccion	CUFE o CUDE del documento, según corresponda.
identComprador	Número de identificación del comprador.
nombreComprador	Nombre o razón social del comprador.
correoElectronicoComprador	Correo electrónico del comprador.
monto	Valor total del documento.
TotalImporteBruto	Valor total del importe bruto, según la estructura de respuesta del servicio.
TotalCargos	Valor total de los cargos.
TotalDescuentos	Valor total de los descuentos.
TotalBaseImponible	Valor total de la base imponible.
TotalAnticipos	Valor total de los anticipos aplicados.
vlrBrutoImpuesto	Valor bruto con impuestos, según la estructura de respuesta del servicio.
TotalIVA	Valor total del IVA.
esContado	Indica si el documento corresponde a una operación de contado (true) o de crédito (false).
estado	Estado individual del documento.
respuestaDIAN	Respuesta de la DIAN relacionada con el documento; puede incluir el motivo de rechazo cuando aplique.

Estados posibles de consulta

El campo Estado de la respuesta identifica el resultado general de la operación.

Estado	Descripción
EXITO	La consulta se ejecutó satisfactoriamente.
PROCE	La operación se encuentra en proceso.
ERROR	Se presentó un error durante la consulta.

Diferencia entre el estado de consulta y el estado del documento

El campo Estado de la respuesta representa el resultado general de la consulta. El campo estado de cada elemento de documentos representa el estado individual del documento.

Comportamiento de la respuesta

El campo DetalleEstado permite conocer el resultado general de la consulta.

Condición	DetalleEstado esperado
Se encontraron documentos que coinciden con los filtros.	Consulta exitosa
No se encontraron documentos para los filtros enviados.	No se encontraron documentos para los filtros enviados

Ejemplo de respuesta

El siguiente ejemplo representa una consulta exitosa que devuelve un documento con información de emisión, valores y una respuesta de rechazo de la DIAN.

{
  "Estado": "EXITO",
  "DetalleEstado": "Consulta exitosa",
  "guidEmpresa": "12345678-ABCD-1234-ABCD-123456789ABC",
  "fechaInicio": "2024-01-01",
  "fechaFin": "2024-01-31",
  "tipoTransaccion": "FAC",
  "codOperacion": "Todos",
  "identComprador": "Todos",
  "documentos": [
    {
      "idSegmento": 202401,
      "tipoTransaccion": "FAC",
      "numeroTransaccion": "SETT12345",
      "fechaEmision": "2024-01-10 14:30",
      "fechaHoraIngreso": "2024-01-10 14:32",
      "codigoTransaccion": "CUFE123456789",
      "identComprador": "1098765432",
      "nombreComprador": "JUAN PEREZ",
      "correoElectronicoComprador": "juan.perez@example.com",
      "monto": 150000,
      "TotalImporteBruto": 150000,
      "TotalCargos": 0,
      "TotalDescuentos": 0,
      "TotalBaseImponible": 126050,
      "TotalAnticipos": 0,
      "vlrBrutoImpuesto": 150000,
      "TotalIVA": 23950,
      "esContado": true,
      "estado": "ERROR",
      "respuestaDIAN": "Documento rechazado por inconsistencia en datos del adquiriente"
    }
  ]
}

Ejemplo ilustrativo

Los valores del ejemplo son demostrativos. La respuesta real depende de los filtros enviados, los documentos encontrados y la información registrada en la plataforma.

Consideraciones importantes

• Los campos guidEmpresa, fechaInicio y fechaFin son obligatorios para ejecutar la consulta.
• Los filtros opcionales permiten restringir los resultados por comprador, tipo de transacción, código de operación o estado.
• Cuando no se aplican filtros opcionales, el servicio puede devolver todos los documentos que coincidan con el rango de fechas, de acuerdo con el comportamiento descrito.
• El campo respuestaDIAN es útil para identificar motivos de rechazo y orientar el análisis de los documentos.
• El resultado de la consulta no debe confundirse con el estado individual de cada documento.
• Los documentos encontrados pueden utilizarse como insumo para actividades de auditoría, reprocesamiento y soporte técnico.