Consultar documentos recibidos

El método ExtraerRecepcion permite consultar los documentos electrónicos recibidos por un receptor configurado en Colfact, con múltiples criterios de filtro: rango de fechas, proveedor, periodo, documento específico (CUFE/CUDE) y eventos asociados. Además, permite identificar el estado de cada documento dentro del proceso de recepción.

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

Endpoint

Dato	Valor
Método HTTP	POST
Operación	ExtraerRecepcion

Requisito previo

Para que el módulo funcione, las facturas deben redireccionarse al correo único de recepción de facturas recepcion@colfact.co. El sistema procesa los correos que llegan e incluye las facturas electrónicas para su procesamiento.

Parámetros de entrada

La solicitud se envía dentro de un objeto solicitud.

Parámetro	Tipo	Obligatorio	Descripción
guidEmpresa	string	Sí	Identificador único de la empresa receptora. Se asigna al configurar e implementar el cliente.
fechaInicio	string	No	Fecha inicial de la consulta, en formato yyyy-MM-dd. No puede ser posterior a fechaFin.
fechaFin	string	No	Fecha final de la consulta, en formato yyyy-MM-dd.
identProveedor	string	No	NIT del proveedor. Permite consultar los documentos recibidos de un mismo proveedor.
periodo	string	No	Periodo del documento, en formato yyyyMM.
codigoTransaccion	string	No	CUFE o CUDE de un documento específico.
codigoEvento	string	No	Código del evento por el cual filtrar. Ver Códigos de evento.
tipoRechazo	string	No	Tipo de rechazo por el cual filtrar. Ver Tipos de rechazo.
esRecepcion	boolean	No	Indica si se consultan los documentos que están en proceso de recepción.

Ejemplo de solicitud

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa receptora>",
    "fechaInicio": "2025-01-01",
    "fechaFin": "2025-01-31",
    "identProveedor": "",
    "periodo": "",
    "codigoTransaccion": "",
    "codigoEvento": "",
    "tipoRechazo": "",
    "esRecepcion": false
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "ExtraerRecepcionResult": {
    "Estado": "OK",
    "DetalleEstado": "Consulta exitosa",
    "fechaInicio": "2025-01-01",
    "fechaFin": "2025-01-31",
    "identProveedor": null,
    "documentos": [
      {
        "idSegmento": "202501",
        "tipoTransaccion": "FAC",
        "numeroTransaccion": "FAC12345",
        "codigoTransaccion": "<CUFE del documento>",
        "identProveedor": "900123456",
        "nombreProveedor": "Proveedor de ejemplo S.A.S.",
        "monto": 150000,
        "esRecibido": true,
        "eventos": "02;030;032;033"
      }
    ]
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
Estado	string	Resultado de la operación: OK o ERROR.
DetalleEstado	string	Mensaje descriptivo del resultado o del error presentado.
fechaInicio	string	Fecha inicial consultada.
fechaFin	string	Fecha final consultada.
identProveedor	string	NIT del proveedor consultado, si se envió.
documentos	array	Documentos recibidos. Ver DocumentRecepcionType.

El estado de recepción de cada documento se interpreta con los campos esRecibido y comentarioRecibido; ver Estado de recepción del documento.

Consideraciones importantes

• Los filtros opcionales que se envían vacíos no restringen la consulta.
• El campo eventos de cada documento contiene los códigos separados por punto y coma, por ejemplo "02;030;032;033".
• Casos de uso comunes: consultar facturas recibidas por rango de fechas, validar el estado de recepción, filtrar por proveedor y consultar los eventos de un documento.