Saltearse al contenido
Factus API

Crear y validar

Método: POST

Endpoint 

https://api-sandbox.factus.com.co/v2/support-documents/validate

Encabezados de la Solicitud

Incluye 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.

Ver aquí la descripción de los campos.
Parámetros Documento Soporte
reference_code string
Código único que sirve para identificar cada documento soporte de manera unívoca en el sistema y garantizar que no haya duplicados. Esto nos ayuda a prevenir que se genere más de un documento soporte con la misma información.
numbering_range_id integer opcional
ID del rango de numeración. Es obligatorio solo si tienes múltiples rangos activos. Si se omite, el sistema utilizará el único rango disponible por defecto. Rangos de numeración para documento soporte , filtar por filter[document] = 24 para obtener solo los rangos de numeración para documentos soporte.
created_time string opcional
Fecha y hora de creación del documento soporte en formato HH:mm:ss.
observation string opcional
Agrega una observación del documento soporte. No debe tener más de 250 caracteres.
payment_details array
Este es un array de objetos para los medios de pago. Se debe enviar un objeto por cada medio de pago utilizado para pagar el documento soporte.
payment_details.*.payment_form string
Código de la forma de pago. Formas de pago disponibles
payment_details.*.payment_method_code string
Código del método de pago. Métodos de pago disponibles.
payment_details.*.reference_code string opcional
Código de referencia del pago.
payment_details.*.amount string
Monto pagado por ese medio y método de pago.
payment_details.*.due_date string opcional
Fecha de vencimiento del documento soporte, en formato YYYY-MM-DD. Requerido solo cuando la forma de pago (payment_form) contiene el valor de 2 (pago a crédito).
cash_rounding_amount string opcional
Ajuste opcional que reconcilia la diferencia entre la suma de los montos en ⁠payment_details y el total del documento soporte, causada por las limitaciones de denominación de la moneda local. Acepta valores negativos (redondeo hacia abajo) o positivos (redondeo hacia arriba). El valor máximo permitido es ±500.00.
establishment object opcional
Este es un objeto que contendrá la información sobre el establecimiento. Úsalo cuando manejes más de un establecimiento y necesites que los datos correspondientes se reflejen en el documento soporte. Si envías el campo establishment los campos internos son obligatorios.
establishment.name string
Nombre del establecimiento.
establishment.address string
Dirección del establecimiento.
establishment.phone_number string
Número telefónico del establecimiento.
establishment.email string
Correo electrónico del establecimiento.
establishment.municipality_code string
Código que corresponda al municipio donde se encuentra el establecimiento. Municipios disponibles.
provider object
Este es un objeto que contendrá la información del proveedor del documento soporte.
provider.identification_document_code string
Código que corresponde al tipo de identificación. Tipos de documentos de identidad disponibles
provider.identification string
Número de identificación del proveedor.
provider.dv string opcional
Dígito de verificación del proveedor. Requerido ya que el proveedor debe identificarse con NIT, sin embargo, si no se envía el API lo calcula automáticamente.
provider.trade_name string opcional
Nombre comercial del proveedor.
provider.names string
Nombre del proveedor.
provider.address string
Dirección del proveedor.
provider.country_code string
Código del país del proveedor. Países disponibles
provider.municipality_code string
Código del municipio del proveedor. Municipios disponibles
provider.email string opcional
Dirección del correo electrónico del proveedor.
provider.phone string opcional
Número de teléfono del proveedor.
items array
Este es un array de objetos (items) que corresponde a los productos o servicios del documento soporte, se debe enviar un objeto por cada producto o servicio.
items.*.code_reference string
Código de referencia del producto o servicio.
items.*.name string
Nombre del producto o servicio.
items.*.quantity string
Cantidad del producto o servicio (máximo dos decimales).
items.*.discount_rate string
Porcentaje del descuento del producto o servicio (máximo dos decimales).
items.*.price string
Precio por unidad del producto o servicio sin impuestos incluidos ni descuentos, valor neto (máximo dos decimales).
items.*.unit_measure_code string
Código que corresponda a la unidad de medida del item. Unidades de medida disponibles
items.*.standard_code string
Código que corresponde al estándar que se adopta para los productos o servicios. Códigos de estándar disponibles.
items.*.withholding_taxes array opcional
Este es un array de objetos para informar las retenciones que se aplican al producto o servicio. Por cada retención que apliques al proveedor, debes enviar un objeto.
items.*.withholding_taxes.*.code string
Código de la retención aplicada al producto o servicio. Códigos retenciones disponibles.
items.*.withholding_taxes.*.rate string
Porcentaje de la retención aplicada al producto o servicio (máximo dos decimales).
items.*.taxes array
Este es un array de objetos para los impuestos.
items.*.taxes.*.code string
Código del impuesto aplicado al producto o servicio, para documento soporte debe ser 01 correspondiente al impuesto sobre la ventas - IVA.
items.*.taxes.*.rate string
Porcentaje del impuesto aplicado al producto o servicio (máximo dos decimales).
items.*.taxes.*.is_excluded boolean opcional
Indica si el ítem está excluido de impuestos. Valor: true o false.

Ejemplo de Solicitud

Sección titulada «Ejemplo de Solicitud»
{
  "reference_code": "DS-2026-v2-0001",
  "created_time": "15:30:00",
  "observation": "",
  "payment_details": [
    {
      "payment_form": "1",
      "payment_method_code": "42",
      "reference_code": "pago-002",
      "amount": "40000"
    },
    {
      "payment_form": "2",
      "payment_method_code": "10",
      "reference_code": "pago-003",
      "amount": "40000",
      "due_date": "2026-05-25"
    }
  ],
  "cash_rounding_amount": "0.00",
  "establishment": {
    "name": "nombre establecimiento",
    "address": "direccion del establecimiento",
    "phone_number": "1234567890",
    "email": "establecieminto@tuempresa.com",
    "municipality_code": "91263"
  },
  "provider": {
    "identification_document_code": "31",
    "identification": "2343543",
    "dv": "7",
    "names": "Pepito Perez",
    "address": "calle 4",
    "country_code": "CO",
    "municipality_code": "68679",
    "legal_organization_code": "1"
  },
  "items": [
    {
      "code_reference": "12345",
      "name": "producto de prueba",
      "quantity": "2.00",
      "discount_rate": "20.00",
      "price": "50000.00",
      "unit_measure_code": "94",
      "standard_code": "999",
      "withholding_taxes": [
        {
          "code": "06",
          "rate": "3.50"
        }
      ],
      "taxes": [
        {
          "code": "01",
          "rate": "19.00"
        }
      ]
    }
  ]
}