Saltar al contenido principal

Cargar un documento recibido por CUFE

El método CargarDocumentoByCUFE permite registrar en el módulo de recepción una factura electrónica a partir de su CUFE, previamente registrado en la DIAN. Es útil para mitigar inconvenientes en el cargue de facturas que no llegaron por correo.

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

Endpoint

Dato	Valor
Método HTTP	`POST`
Operación	`CargarDocumentoByCUFE`

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.
`CUFE`	`string`	Sí	Código único de la factura electrónica.
`NumeroDocumento`	`string`	Sí	Número del documento (prefijo y consecutivo).

Ejemplo de solicitud

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

Estructura de la respuesta

Ejemplo de respuesta

{
  "CargarDocumentoByCUFEResult": {
    "Estado": "OK",
    "DetalleEstado": "<mensaje del resultado>",
    "FechaHoraSolicitud": "2025-01-15T10:30:00-05:00",
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "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 de la operación.
`GuidEmpresa`	string	Empresa que realizó el cargue.
`CUFE`	string	CUFE del documento.
`NumeroDocumento`	string	Número del documento procesado.

Consideraciones importantes

El CUFE debe existir previamente en la DIAN y el documento debe estar correctamente registrado.
Este método solo realiza el cargue inicial; no valida el estado final. Consulta el resultado con ExtraerCargueRecepcion enviando el mismo CUFE.

Lenguaje

C#
PHP
Python

POSThttps://micro.conexusit.com/corp/demo/api/Service.svc/CargarDocumentoByCUFE

using System.Net.Http;
using System.Text;

// Ambiente de pruebas.
var baseUrl = "https://micro.conexusit.com/corp/demo/api/Service.svc";
var url = $"{baseUrl}/CargarDocumentoByCUFE";

var json = @"{
  ""solicitud"": {
    ""GuidEmpresa"": ""<GUID de la empresa receptora>"",
    ""CUFE"": ""2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152"",
    ""NumeroDocumento"": ""FAC12345""
  }
}";

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, url);
request.Content = new StringContent(json, Encoding.UTF8, "application/json");

var response = await client.SendAsync(request);
var result = await response.Content.ReadAsStringAsync();

Console.WriteLine((int)response.StatusCode);
Console.WriteLine(result);

POSThttps://micro.conexusit.com/corp/demo/api/Service.svc/CargarDocumentoByCUFE

<?php
// Ambiente de pruebas.
$baseUrl = "https://micro.conexusit.com/corp/demo/api/Service.svc";
$url = "{$baseUrl}/CargarDocumentoByCUFE";

$payload = json_encode([
    "solicitud" => [
        "GuidEmpresa" => "<GUID de la empresa receptora>",
        "CUFE" => "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
        "NumeroDocumento" => "FAC12345"
    ]
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Accept: application/json",
    ],
    CURLOPT_TIMEOUT => 60,
]);

$response = curl_exec($ch);
if ($response === false) {
    die("Error cURL: " . curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status . PHP_EOL;
echo $response;

POSThttps://micro.conexusit.com/corp/demo/api/Service.svc/CargarDocumentoByCUFE

import requests

# Ambiente de pruebas.
base_url = "https://micro.conexusit.com/corp/demo/api/Service.svc"
url = f"{base_url}/CargarDocumentoByCUFE"

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

response = requests.post(
    url,
    json=payload,
    headers={"Accept": "application/json"},
    timeout=60,
)

print(response.status_code)
print(response.json())

Respuesta (ejemplo ilustrativo)

{
  "CargarDocumentoByCUFEResult": {
    "Estado": "OK",
    "DetalleEstado": "<mensaje del resultado>",
    "FechaHoraSolicitud": "2025-01-15T10:30:00-05:00",
    "GuidEmpresa": "<GUID de la empresa receptora>",
    "CUFE": "<CUFE del documento>",
    "NumeroDocumento": "FAC12345"
  }
}