Saltearse al contenido
Factus API

Crear y Validar

Este endpoint permite crear una nota crédito y validarla.

Método: POST

Endpoint 

https://api-sandbox.factus.com.co/v2/credit-notes/validate

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Content-Type : application/json
Indica que los datos se envían en formato JSON.
Authorization Bearer token_de_acceso
Token de autenticación necesario para acceder al recurso. Ver Cómo generar token
Accept : application/json
Indica que la respuesta debe estar en formato JSON.
Nota: Reemplaza token_de_acceso con el token proporcionado tras autenticarte.

Ejemplo de Solicitud

Sección titulada «Ejemplo de Solicitud»

Aquí tienes un ejemplo de cómo debería quedar el cuerpo de la solicitud en formato JSON:

{
  "reference_code": "NOTA-2026-0015",
  "correction_concept_code": "2",
  "customization_id": "20",
  "bill_number": "SETP990001113",
  "numbering_range_id": 5,
  "observation": "descripción de prueba",
  "payment_details": [
    {
      "payment_form": "2",
      "payment_method_code": "10",
      "reference_code": "pago-001",
      "amount": "50000",
      "due_date": "2026-03-25"
    },
    {
      "payment_form": "1",
      "payment_method_code": "42",
      "reference_code": "pago-001",
      "amount": "83300"
    }
  ],
  "health": {
    "provider_code": "1920304050",
    "payment_method_code": "04",
    "coverage_code": "10",
    "contract_number": "CONT1230",
    "policy_number": ""
  },
  "customer": {
    "identification_document_code": "31",
    "identification": "123456789",
    "company": "Alan company name",
    "trade_name": "Alan trade name",
    "address": "calle 1 # 1-1",
    "email": "alan.company@email.com",
    "phone": "1234567890",
    "legal_organization_code": "1",
    "tribute_code": "ZZ",
    "municipality_code": "68679"
  },
  "items": [
    {
      "code_reference": "PROD-000A",
      "name": "Producto A",
      "quantity": "1.00",
      "discount_rate": "0.00",
      "price": "10000.00",
      "unit_measure_code": "94",
      "standard_code": "999",
      "taxes": [
        {
          "code": "01",
          "rate": "19.00"
        }
      ]
    },
    {
      "code_reference": "PROD-000B",
      "name": "Producto B",
      "quantity": "3.00",
      "discount_rate": "0.00",
      "price": "20000.00",
      "unit_measure_code": "94",
      "standard_code": "999",
      "taxes": [
        {
          "code": "01",
          "rate": "19.00"
        }
      ]
    }
  ]
}

Ejemplo de respuesta

Sección titulada «Ejemplo de respuesta»
{
  "status": "Created",
  "message": "Documento con el código de referencia NOTA-2026-0015 registrado y validado con éxito",
  "data": {
    "reference_code": "NOTA-2026-0015",
    "number": "NC208",
    "correction_concept": {
      "code": "2",
      "name": "Anulación de factura electrónica"
    },
    "customization_id": {
      "code": "20",
      "name": "Nota Crédito que referencia una factura electrónica."
    },
    "payment_method": {
      "code": "10",
      "name": "Efectivo"
    },
    "billing_period": null,
    "send_email": true,
    "is_validated": true,
    "validated_at": "06-03-2026 04:55:21 PM",
    "errors": [
      "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada"
    ],
    "observation": "descripcion de prueba",
    "created_at": "06-03-2026 04:55:19 PM",
    "company": {
      "url_logo": "http://api.test/storage/images/logos/oCuCijLV5YQY6AGZjxFCafdWaWEgIBFBl7aWa3ok.png",
      "nit": "900825759",
      "dv": "7",
      "economic_activity": "6311",
      "establishment": {
        "name": "HALLTEC S.A.S.",
        "address": "Calle 11 # 8 - 84",
        "phone_number": "3161331234",
        "email": "email@gmail.com",
        "municipality": {
          "code": "68679",
          "name": "San Gil",
          "department": {
            "code": "68",
            "name": "Santander"
          }
        }
      }
    },
    "customer": {
      "identification_document": {
        "code": "31",
        "name": "NIT"
      },
      "identification": "123456789",
      "dv": "6",
      "graphic_representation_name": "Alan trade name",
      "trade_name": "Alan trade name",
      "company": "Alan company name",
      "names": null,
      "address": "calle 1 # 1-1",
      "email": "alan.company@email.com",
      "phone": "1234567890",
      "legal_organization": {
        "code": "1",
        "name": "Persona Jurídica"
      },
      "tribute": {
        "code": "ZZ",
        "name": "No aplica"
      },
      "municipality": {
        "code": "68679",
        "name": "San Gil",
        "department": {
          "code": "68",
          "name": "Santander"
        }
      }
    },
    "items": [
      {
        "note": "",
        "additional_properties": [],
        "code_reference": "PROD-000A",
        "name": "Producto A",
        "quantity": "1.00",
        "unit_measure": {
          "code": "94",
          "name": "unidad"
        },
        "standard_code": {
          "code": "999",
          "name": "Estándar de adopción del contribuyente"
        },
        "discount_rate": "0.00",
        "discount": "0.00",
        "gross_value": "10000.00",
        "taxes": [
          {
            "tribute": {
              "code": "01",
              "name": "IVA"
            },
            "is_excluded": false,
            "rates": [
              {
                "taxable_amount": "10000.00",
                "tax_amount": "1900.00",
                "rate": "19.00"
              }
            ]
          }
        ],
        "withholding_taxes": [],
        "price": "10000.00",
        "total": "11900.00"
      },
      {
        "note": "",
        "additional_properties": [],
        "code_reference": "PROD-000B",
        "name": "Producto B",
        "quantity": "3.00",
        "unit_measure": {
          "code": "94",
          "name": "unidad"
        },
        "standard_code": {
          "code": "999",
          "name": "Estándar de adopción del contribuyente"
        },
        "discount_rate": "0.00",
        "discount": "0.00",
        "gross_value": "20000.00",
        "taxes": [
          {
            "tribute": {
              "code": "01",
              "name": "IVA"
            },
            "is_excluded": false,
            "rates": [
              {
                "taxable_amount": "60000.00",
                "tax_amount": "11400.00",
                "rate": "19.00"
              }
            ]
          }
        ],
        "withholding_taxes": [],
        "price": "20000.00",
        "total": "71400.00"
      }
    ],
    "allowance_charges": [],
    "taxes": [
      {
        "tribute": {
          "code": "01",
          "name": "IVA"
        },
        "is_excluded": false,
        "rates": [
          {
            "taxable_amount": "70000.00",
            "tax_amount": "13300.00",
            "rate": "19.00"
          }
        ]
      }
    ],
    "withholding_taxes": [],
    "totals": {
      "gross_value": "70000.00",
      "taxable_amount": "70000.00",
      "tax_amount": "13300.00",
      "discount_amount": "0.00",
      "surcharge_amount": "0.00",
      "total": "83300.00"
    },
    "cude": "e7f1ba98c08bf34bdf331fb678293db2bc1e2a46b9352545183ecea130a639ad8a321acfbdd62b37203959d6a877351b",
    "bill": {
      "reference_code": "REF240025n",
      "number": "SETP990001113",
      "cufe": "cfbab493d0ddaee2489c4904cbc36a04dc472830ec287d7b7a8f0863e7c759a5dd6a1be995b5809604c6858771189c21"
    },
    "links": {
      "qr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=e7f1ba98c08bf34bdf331fb678293db2bc1e2a46b9352545183ecea130a639ad8a321acfbdd62b37203959d6a877351b",
      "public_url": "http://app.test/documents/credit-notes/2614719dba685bdd5eba329494d623a0f209f49f3b3f1b5d33581a966305ce44"
    }
  }
}