FactusCreateCreditNote

Descripción

Genera una nota crédito electrónica validada por la DIAN de Colombia sobre una factura electrónica ya autorizada en Factus. Se puede usar para anular una factura completa (razón 2) o para registrar devoluciones parciales, descuentos o ajustes de precio.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales OAuth2 de Factus
bill_id	text	Si	ID interno de la factura original en Factus
reason_code	select	No	Razón de la nota crédito (default: 2=Anulación)
observation	text	No	Descripción o motivo
items	array	No	Ítems a devolver (solo razón 1 — devolución parcial)

Razones disponibles

Código	Descripción
1	Devolución parcial de bienes
2	Anulación de factura (default)
3	Descuento comercial global
4	Ajuste de precio
5	Otros

Salida

{
  "success": true,
  "note_id": "456",
  "note_number": "NC-001",
  "cufe": "def789...hash256",
  "bill_id": "123",
  "raw": { ... }
}

Ejemplo de Uso

Anular factura completa

{
  "credentials_id": "cred-factus-prod",
  "bill_id": "123",
  "reason_code": "2",
  "observation": "Factura emitida con error en datos del cliente"
}

Devolución parcial

{
  "credentials_id": "cred-factus-prod",
  "bill_id": "123",
  "reason_code": "1",
  "observation": "Devolución de 2 unidades defectuosas",
  "items": [
    {
      "code_reference": "PROD-001",
      "name": "Producto devuelto",
      "quantity": 2,
      "price": 50000,
      "tax_rate": "19.00",
      "unit_measure_id": 70,
      "standard_code_id": 1,
      "is_excluded": 0
    }
  ]
}

Notas

• Para la razón 2 (Anulación) no se necesita enviar items; Factus anula el total de la factura
• Para razón 1 (Devolución parcial), items debe incluir solo los productos/servicios a devolver
• El CUFE de la nota crédito es el identificador único ante la DIAN — debe guardarse

Nodos Relacionados

• FactusCreateInvoice - Emitir factura
• FactusGetInvoice - Consultar factura