FactusCreateInvoice

Descripción

Crea y valida una factura electrónica ante la DIAN de Colombia a través de la API de Factus. El nodo devuelve el CUFE (Código Único de Factura Electrónica) y el código QR requeridos por la normativa colombiana.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales OAuth2 de Factus
numbering_range_id	number	Si	ID del rango de numeración DIAN configurado en Factus
payment_method_code	select	No	Método de pago: 10=Efectivo, 42=Consignación (default: 10)
reference_code	text	No	Código de referencia interno (pedido, orden de compra)
observation	text	No	Notas o descripción de la factura
customer	object	Si	Objeto JSON con datos del cliente
items	array	Si	Array JSON con los ítems de la factura

Credenciales

Requiere una credencial de tipo factus con:

• Client ID: ID OAuth2 de la aplicación en el panel de Factus
• Client Secret: Secret OAuth2 de la aplicación
• Entorno: sandbox (pruebas) o production (DIAN real)

Estructura del cliente

{
  "identification": "900123456",
  "dv": "7",
  "company": "Empresa Cliente S.A.S.",
  "trade_name": "Empresa Cliente",
  "names": "Juan Pérez",
  "address": "Calle 1 # 2-3, Bogotá",
  "email": "cliente@empresa.com",
  "phone": "3001234567",
  "legal_organization_id": "1",
  "tribute_id": "21",
  "identification_document_id": "31",
  "municipality_id": "149"
}

Valores comunes:

• legal_organization_id: 1=Persona Jurídica, 2=Persona Natural
• tribute_id: 21=Responsable IVA, 22=No responsable IVA
• identification_document_id: 31=NIT, 13=Cédula
• municipality_id: Código interno de Factus (149=Bogotá)

Estructura de ítems

[
  {
    "code_reference": "SERV-001",
    "name": "Servicio de desarrollo de software",
    "quantity": 1,
    "discount_rate": 0,
    "price": 1000000,
    "tax_rate": "19.00",
    "unit_measure_id": 70,
    "standard_code_id": 1,
    "is_excluded": 0
  }
]

Salida

{
  "success": true,
  "bill_id": "123",
  "bill_number": "FE-001",
  "cufe": "abc123...hash256",
  "qr_code": "https://...",
  "status": "Aceptado",
  "raw": { ... }
}

Ejemplo de Uso

{
  "credentials_id": "cred-factus-prod",
  "numbering_range_id": "1",
  "payment_method_code": "42",
  "reference_code": "PO-2025-001",
  "observation": "Desarrollo de módulo de facturación",
  "customer": {
    "identification": "900123456",
    "dv": "7",
    "company": "Cliente S.A.S.",
    "email": "admin@cliente.com",
    "legal_organization_id": "1",
    "tribute_id": "21",
    "identification_document_id": "31",
    "municipality_id": "149"
  },
  "items": [
    {
      "name": "Consultoría técnica",
      "quantity": 8,
      "price": 200000,
      "tax_rate": "19.00",
      "unit_measure_id": 70,
      "standard_code_id": 1,
      "is_excluded": 0
    }
  ]
}

Notas

• El numbering_range_id corresponde a la resolución DIAN habilitada en el panel de Factus
• La autenticación usa OAuth2 client_credentials; el token se renueva automáticamente
• El CUFE es el identificador único de la factura ante la DIAN — debe guardarse para futuras consultas
• Si la DIAN rechaza la factura, Factus devuelve error 422 con los motivos

Nodos Relacionados

• FactusGetInvoice - Consultar una factura emitida
• FactusCreateCreditNote - Crear nota crédito