Cargar documentos recibidos de forma masiva

El método CargarDocumentoRecepcionMasivo permite cargar de forma masiva las facturas electrónicas recibidas, a partir del archivo Excel que se descarga del portal de la DIAN, enviado en Base64.

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

Endpoint

Dato	Valor
Método HTTP	POST
Operación	CargarDocumentoRecepcionMasivo

Requisito previo

El método exige una contraseña en el encabezado password de la solicitud.

Contraseña de acceso

La contraseña no se publica en esta documentación. Solicítela a su asesor comercial y guárdela en un archivo de configuración o en una variable de entorno, nunca en el código fuente.

Parámetros de entrada

Encabezados

Encabezado	Tipo	Obligatorio	Descripción
password	string	Sí	Contraseña de seguridad para consumir el servicio. Solicítela a su asesor comercial.
Content-Type	string	Sí	Debe ser application/json.

Cuerpo de la solicitud

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

Parámetro	Tipo	Obligatorio	Descripción
GuidEmpresa	string	Sí	GUID de la empresa registrada en Colfact.
NombreArchivo	string	Sí	Nombre del archivo Excel exportado desde la DIAN.
Archivo	string	Sí	Archivo Excel descargado de la DIAN, codificado en Base64.

Ejemplo de solicitud

Encabezados

password: <contraseña suministrada por su asesor comercial>
Content-Type: application/json

Cuerpo (JSON)

{
  "solicitudMasiva": {
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "NombreArchivo": "reporte_dian.xlsx",
    "Archivo": "UEsDBBQAAAAIAA..."
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "CargarDocumentoRecepcionMasivoResult": {
    "Estado": "OK",
    "DetalleEstado": "<mensaje del resultado>",
    "FechaHoraSolicitud": "2025-01-15T10:30:00-05:00",
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "NombreArchivo": "reporte_dian.xlsx",
    "IdArchivoExcel": 125,
    "DocumentosRecibidos": [
      {
        "CUFE": "<CUFE del documento>",
        "NumeroDocumento": "FAC12345"
      }
    ]
  }
}

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 del procesamiento.
GuidEmpresa	string	GUID de la empresa.
NombreArchivo	string	Nombre del archivo procesado.
IdArchivoExcel	int	Identificador interno del archivo cargado. Se usa para consultar el resultado del cargue.
DocumentosRecibidos	array	Documentos encontrados en el archivo, con su CUFE y NumeroDocumento.

Consideraciones importantes

• Guarda el IdArchivoExcel de la respuesta: con él consultas el estado de cada documento en ExtraerCargueRecepcion.
• Flujo recomendado: cargar el archivo, obtener IdArchivoExcel, consultar ExtraerCargueRecepcion y validar el estado de cada documento.
• No comparta la contraseña ni la incluya en el código fuente ni en repositorios.