API REST de Facturación Electrónica DIAN para Desarrolladores

// Node.js 18+ (Fetch nativo o Axios)
const API_KEY = process.env.JCFLOW_API_KEY || 'jcf_live_98a7f4bc32e18d09f7a1';

async function emitirFacturaDIAN() {
  const payload = {
    cliente: {
      numero_documento: '901234567',
      tipo_documento: 'NIT',
      razon_social: 'EMPRESA EJEMPLO S.A.S.',
      email: 'facturacion@ejemplo.com'
    },
    lineas: [
      {
        descripcion: 'Suscripción Software Cloud',
        cantidad: 1,
        precio_unitario: 150000,
        iva_porcentaje: 19
      }
    ]
  };

  const response = await fetch('https://api.jcflow.com.co/v1/api/documentos/factura', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
  });

  const data = await response.json();
  if (data.success) {
    console.log(`✅ Factura aprobada por la DIAN. CUFE: ${data.cufe}`);
    console.log(`📄 PDF: ${data.pdf_url}`);
  }
}

emitirFacturaDIAN();

<?php
// PHP 7.4 / 8.x con cURL o Guzzle
$apiKey = getenv('JCFLOW_API_KEY') ?: 'jcf_live_98a7f4bc32e18d09f7a1';

$payload = [
    'cliente' => [
        'numero_documento' => '901234567',
        'tipo_documento'   => 'NIT',
        'razon_social'     => 'EMPRESA EJEMPLO S.A.S.',
        'email'            => 'facturacion@ejemplo.com'
    ],
    'lineas' => [
        [
            'descripcion'     => 'Suscripción Software Cloud',
            'cantidad'        => 1,
            'precio_unitario' => 150000,
            'iva_porcentaje'  => 19
        ]
    ]
];

$ch = curl_init('https://api.jcflow.com.co/v1/api/documentos/factura');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo "Factura timbrada. CUFE: " . $result['cufe'];

# Python 3.10+ (pip install requests)
import os
import requests

API_KEY = os.getenv("JCFLOW_API_KEY", "jcf_live_98a7f4bc32e18d09f7a1")

payload = {
    "cliente": {
        "numero_documento": "901234567",
        "tipo_documento": "NIT",
        "razon_social": "EMPRESA EJEMPLO S.A.S.",
        "email": "facturacion@ejemplo.com"
    },
    "lineas": [
        {
            "descripcion": "Suscripción Software Cloud",
            "cantidad": 1,
            "precio_unitario": 150000,
            "iva_porcentaje": 19
        }
    ]
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post("https://api.jcflow.com.co/v1/api/documentos/factura", json=payload, headers=headers)
data = response.json()

print(f"Estado DIAN: {data.get('estado_dian')}")
print(f"CUFE: {data.get('cufe')}")
print(f"PDF: {data.get('pdf_url')}")

// .NET 8 / C# 12 con HttpClient
using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer jcf_live_98a7f4bc32e18d09f7a1");

var payload = new
{
    cliente = new
    {
        numero_documento = "901234567",
        tipo_documento = "NIT",
        razon_social = "EMPRESA EJEMPLO S.A.S.",
        email = "facturacion@ejemplo.com"
    },
    lineas = new[]
    {
        new
        {
            descripcion = "Suscripción Software Cloud",
            cantidad = 1,
            precio_unitario = 150000,
            iva_porcentaje = 19
        }
    }
};

var content = new StringContent(JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.jcflow.com.co/v1/api/documentos/factura", content);
var jsonResult = await response.Content.ReadAsStringAsync();

Console.WriteLine($"Respuesta DIAN: {jsonResult}");