Consultar el resultado de un cargue

El método ExtraerCargueRecepcion permite consultar el estado de los documentos cargados al módulo de recepción, tanto los de un cargue masivo (CargarDocumentoRecepcionMasivo) como los de un cargue individual (CargarDocumentoByCUFE).

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

Endpoint

Dato	Valor
Método HTTP	POST
Operación	ExtraerCargueRecepcion

Parámetros de entrada

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

Parámetro	Tipo	Obligatorio	Descripción
GuidEmpresa	string	Sí	GUID de la empresa registrada en Colfact.
IdArchivoExcel	int	Condicional	Identificador devuelto por CargarDocumentoRecepcionMasivo. Obligatorio para consultar un cargue masivo.
CUFE	string	Condicional	CUFE del documento. Obligatorio para consultar un cargue individual; en un cargue masivo permite filtrar un documento específico.

Ejemplo de solicitud

Cargue masivo (por IdArchivoExcel)

{
  "solicitud": {
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "CUFE": "",
    "IdArchivoExcel": 125
  }
}

Cargue individual (por CUFE)

{
  "solicitud": {
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "CUFE": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152"
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "ExtraerCargueRecepcionResult": {
    "Estado": "OK",
    "DetalleEstado": "<mensaje del resultado>",
    "FechaHoraSolicitud": "2025-01-15T10:35:00-05:00",
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "IdArchivoExcel": 125,
    "DocumentosRecibidos": [
      {
        "CodigoTransaccion": "<CUFE del documento>",
        "NumeroTransaccion": "FAC12345",
        "IdentEmisor": "900123456",
        "NombreEmisor": "Proveedor de ejemplo S.A.S.",
        "Iva": 23950,
        "Total": 150000,
        "Estado": "EXITO",
        "Observacion": "<detalle del procesamiento>",
        "FechaHoraEmision": "2025-01-10T14:30:00",
        "FechaHoraCreacion": "2025-01-15T10:31:00"
      }
    ]
  }
}

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.
FechaHoraSolicitud	datetime	Fecha y hora de la consulta.
GuidEmpresa	string	GUID de la empresa.
IdArchivoExcel	int	Identificador del archivo procesado.
DocumentosRecibidos	array	Documentos del cargue (ver tabla siguiente).

Documentos del cargue (DocumentosRecibidos)

Campo	Tipo	Descripción
CodigoTransaccion	string	Código de la transacción (CUFE) del documento.
NumeroTransaccion	string	Número del documento.
IdentEmisor	string	NIT del emisor.
NombreEmisor	string	Nombre del emisor.
Iva	decimal	Valor del IVA.
Total	decimal	Valor total del documento.
Estado	string	Estado del proceso (ver tabla siguiente).
Observacion	string	Mensaje o detalle del procesamiento.
FechaHoraEmision	datetime	Fecha de emisión del documento.
FechaHoraCreacion	datetime	Fecha de registro en el sistema.

Estados del cargue

Estado	Descripción
RECIB	Documento recibido.
PROCE	En proceso.
EXITO	Procesado correctamente.
ERROR	Falla en el procesamiento; revisa Observacion.

Consideraciones importantes

• Puede haber un tiempo de procesamiento antes de obtener el estado final; consulta periódicamente hasta obtener EXITO o ERROR.
• El campo Observacion contiene el detalle del resultado de cada documento.