Descargar un documento recibido

El método ExtraerDocumentoRecepcion permite descargar el XML y el PDF (en Base64, si está disponible) de un documento electrónico recibido, identificado por su CUFE o CUDE, junto con la información detallada del documento.

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

Endpoint

Dato	Valor
Método HTTP	POST
Operación	ExtraerDocumentoRecepcion

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.
codigoTransaccion	string	Sí	CUFE o CUDE del documento.
periodo	string	Sí	Año y mes de emisión del documento, en formato yyyyMM (por ejemplo, 202501). Debe coincidir con la fecha de emisión del documento.

Ejemplo de solicitud

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa receptora>",
    "codigoTransaccion": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
    "periodo": "202501"
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "ExtraerDocumentoRecepcionResult": {
    "Estado": "OK",
    "DetalleEstado": "Consulta exitosa",
    "guidEmpresa": "<GUID de la empresa receptora>",
    "codigoTransaccion": "<CUFE del documento>",
    "periodo": "202501",
    "XML": "<XML del documento>",
    "PDF": "<PDF en Base64>",
    "documentos": [
      {
        "idSegmento": 202501,
        "tipoTransaccion": "FAC",
        "numeroTransaccion": "FAC12345",
        "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.
guidEmpresa	string	Identificador de la empresa receptora.
codigoTransaccion	string	CUFE o CUDE del documento.
periodo	string	Periodo del documento.
XML	string	Contenido XML del documento.
PDF	string	PDF del documento en Base64. Puede venir vacío.
documentos	array	Información detallada del documento. Ver DocumentRecepcionType.

Consideraciones importantes

• El XML siempre se devuelve si el documento existe.
• El campo PDF va vacío si el correo recibido no contenía el PDF.
• El periodo debe coincidir con la fecha de emisión del documento.
• Útil para descarga de soportes, auditoría documental e integración con sistemas contables.