Saltearse al contenido
Factus API

12 - Transporte

Esta sección describe los campos que podría contener la factura.

Método: POST

Endpoint 

https://api-sandbox.factus.com.co/v2/bills/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 Factura Transporte
reference_code string
Código único que sirve para identificar cada factura de manera unívoca en el sistema y garantizar que no haya duplicados. Esto nos ayuda a prevenir que se genere más de una factura con la misma información.
created_time string opcional
Fecha y hora de creación del documento soporte en formato HH:mm:ss.
document string default:01 opcional
Código del tipo de documento. Tipos de documentos disponibles.
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.
operation_type string default:10 opcional
Código del tipo de operación. Si el tipo de operación no se agrega, por defecto el API agrega el código 10 (estándar). Tipos de operación disponibles.
currency object opcional
Objeto utilizado para mostrar los totales de la factura en una moneda extranjera dentro de su representación gráfica. Si se envía el campo currency, los campos internos son obligatorios.
currency.code string
Código internacional de la moneda extranjera que se desea mostrar en la factura. Debe ser una moneda distinta a la moneda local de emisión. Códigos de monedas disponibles.
currency.exchange_rate string
Tasa de cambio utilizada para convertir los montos de la moneda local a la moneda extranjera especificada.
send_email boolean default:true opcional
Indica si el sistema debe enviar el correo electrónico al cliente. Útil cuando el envío del correo se gestiona de forma externa o personalizada por el integrador. Por defecto, este campo tiene un valor de true, lo que implica que el correo electrónico será enviado al cliente. Si se establece en false, el correo no será enviado.
observation string opcional
Agrega una observación a la factura. No debe tener más de 250 caracteres.
prepayment_details array opcional
Este es un array de objetos para los detalles de anticipos. Se debe enviar un objeto por cada anticipo realizado.
prepayment_details.*.reference_code string
Código de referencia del anticipo.
prepayment_details.*.received_date string
Fecha en que se recibió el anticipo en formato YYYY-MM-DD.
prepayment_details.*.amount string
Monto del anticipo.
prepayment_details.*.note string opcional
Nota adicional sobre el anticipo. No debe exceder los 5000 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 la factura.
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 de la factura 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 de la factura, 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 la factura. 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.
billing_period object opcional
Este es un objeto que contendrá la información del periodo de facturación. Para utilizar en los servicios públicos, contratos de arrendamiento, matrículas en educación, etc. Si envías el campo billing_period los campos internos son obligatorios.
billing_period.start_date string
Fecha de inicio del periodo de facturación en formato YYYY-MM-DD.
billing_period.start_time string opcional
Hora de inicio del periodo de facturación en formato HH:mm:ss.
billing_period.end_date string
Fecha de fin del periodo de facturación en formato YYYY-MM-DD.
billing_period.end_time string opcional
Hora de fin del periodo de facturación en formato HH:mm:ss.
order_reference object opcional
Este es un objeto que contendrá la información que describe una orden de pedido. Si envías el campo order_reference los campos internos son obligatorios.
order_reference.reference_code string
Número del documento de la orden.
order_reference.issue_date string opcional
Fecha de emisión de la orden.
related_documents.* array opcional
Este es un array de objetos (documentos), debe haber un objeto por cada documento. Obligatorio cuando el campo document contenga el valor 03. Si envías el campo related_documents los campos internos son obligatorios.
related_documents.*.code string
Identificador del tipo de documento de referencia (corresponde a una codificación propia de la empresa).
related_documents.*.issue_date string
Fecha de emisión del documento referenciado en formato YYYY-MM-DD.
related_documents.*.number string
Prefijo y número del documento referenciado.
customer object
Este es un objeto que contendrá la información del cliente de la factura.
customer.identification_document_code string
Código que corresponda al tipo de identificación. Tipos de documentos disponibles.
customer.identification string
Número de identificación del cliente. Si el numero de identificación corresponde a un NIT no se debe enviar el dígito de verificación ni el guion que lo separa, el dígito de verificación tiene un campo exclusivo para él, aquí se debe enviar únicamente el numero de identificación.
customer.dv string opcional
Dígito de verificación correspondiente al NIT del cliente.
El dígito de verificación se envía únicamente para clientes que se identifican con NIT.
Si el cliente se identifica con NIT y no se envía el dígito de verificación, el API lo calculará automáticamente.
customer.legal_organization_code string
Código que corresponda al tipo de organización. Tipos de organizaciones disponibles.
customer.tribute_code string default:ZZ opcional
Código del tributo. Tipos de tributos disponibles.
customer.company string opcional
Razón social. Es obligatorio cuando el campo customer.legal_organization_code es 1 (persona jurídica).
customer.trade_name string opcional
Nombre comercial.
customer.names string opcional
Nombre del cliente. Es obligatorio cuando el campo customer.legal_organization_code es 2 (persona natural).
customer.address string opcional
Dirección del cliente.
customer.email string opcional
Correo electrónico del cliente.
customer.phone string opcional
Número de teléfono del cliente.
customer.country_code string opcional
Código del país del cliente. Países disponibles
customer.municipality_code string opcional
Código que corresponda al municipio donde vive el cliente. Se debe enviar el código del municipio únicamente si el municipio es de Colombia; si es extranjero, el valor del campo no aplica. Municipios disponibles.
items array
Este es un array de objetos (items) que corresponde a los productos o servicios de la factura, se debe enviar un objeto por cada producto o servicio.
items.*.scheme_id string
Este campo es requerido si el campo operation_type contiene el valor de 11 (mandatos) o 12 (transporte) o SS-Recaudo (Salud). Agregue el valor de 0 cuando sea ingreso propio y 1 para ingresos recibidos para terceros.
items.*.note string opcional
Añade información adicional del 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 opcional
Porcentaje del descuento del producto o servicio (máximo dos decimales).
Para aplicar descuentos use alguno de los dos campos, en porcentaje discount_rate o monto discount_amount, no es necesario enviar ambos campos para informar un descuento.
items.*.discount_amount string opcional
Monto del descuento del producto o servicio (máximo dos decimales).
Para aplicar descuentos use alguno de los dos campos, en porcentaje discount_rate o monto discount_amount, no es necesario enviar ambos campos para informar un descuento.
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.*.taxes array
Este es un array de objetos para los impuestos.
items.*.taxes.*.code string
Código del impuesto aplicado al producto o servicio. Códigos de impuestos disponibles.
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.
items.*.withholding_taxes array opcional
Este es un array de objetos (autorretenciones) para informar las retenciones que se aplican al producto o servicio. No son retenciones que otra persona o empresa te hace a ti, sino retenciones que tú mismo te aplicas como contribuyente. Por cada retención que te apliques a ti mismo, 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.*.additional_properties array opcional
Informa las operaciones del sector transporte de carga. Obligatorio cuando operation_type = 12.
items.*.additional_properties.*.code string
Código del tipo de operación de transporte de carga. 01 = consecutivo RNDC, 02 = consecutivo interno empresa, 03 = valor del flete.
items.*.additional_properties.*.value string
Valor de la característica que se quiere informar del ítem. Dependiendo del valor de items.*.additional_properties.*.code, este campo puede representar diferentes valores.
items.*.additional_properties.*.quantity string
Cantidad transportada. Obligatorio cuando items.*.additional_properties.*.code = 03 (Valor del flete).
items.*.additional_properties.*.unit_measure_code string
Unidad de medida de la cantidad transportada. Solo acepta: 414 = KGM (kilogramos) y 874 = GLL (galones). Obligatorio cuando items.*.additional_properties.*.code = 03.
allowance_charges array opcional
Este es un array de objetos que corresponden a los descuentos o recargos que se aplican a la factura; se debe enviar un objeto por cada descuento o recargo.
allowance_charges.*.concept_type string
Código del tipo de descuento o recargo. Para saber el código que corresponde, consulte la tabla. Códigos de conceptos disponibles.
allowance_charges.*.is_surcharge boolean
Indica si es un descuento o un recargo. El valor true corresponde a un recargo y false a un descuento.
allowance_charges.*.reason string
Razón por la cual se está haciendo el descuento o recargo.
allowance_charges.*.base_amount string
Base sobre la cual se calcula el descuento o recargo (máximo dos decimales).
allowance_charges.*.amount string
Valor del descuento o recargo aplicado (máximo dos decimales).

Ejemplo de Solicitud

Sección titulada «Ejemplo de Solicitud»
{
  "reference_code": "FACT-2026-0126",
  "document": "01",
  "numbering_range_id": 389,
  "operation_type": "12",
  "payment_details": [
    {
      "payment_form": "1",
      "payment_method_code": "10",
      "reference_code": "pago-001",
      "amount": "2000000"
    },
    {
      "payment_form": "1",
      "payment_method_code": "42",
      "reference_code": "pago-002",
      "amount": "400000"
    }
  ],
  "cash_rounding_amount": "0.00",
  "observation": "Observación de prueba",
  "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": [
    {
      "scheme_id": "1",
      "code_reference": "PROD-000A",
      "name": "Pantalones",
      "quantity": "10.00",
      "discount_rate": "0.00",
      "price": "200000.00",
      "unit_measure_code": "KGM",
      "standard_code": "999",
      "taxes": [
        {
          "code": "01",
          "rate": "19.00"
        }
      ],
      "additional_properties": [
        {
          "code": "01",
          "value": "13456"
        },
        {
          "code": "02",
          "value": "REM0001"
        },
        {
          "code": "03",
          "value": 250000,
          "quantity": 10,
          "unit_measure_code": "KGM"
        }
      ]
    },
    {
      "scheme_id": "0",
      "code_reference": "PROD-000B",
      "name": "flete",
      "quantity": "1.00",
      "discount_rate": "0.00",
      "price": "20000.00",
      "unit_measure_code": "94",
      "standard_code": "999",
      "taxes": [
        {
          "is_excluded": true
        }
      ]
    }
  ]
}

Respuesta

Sección titulada «Respuesta»
Descripción respuesta Factura Transporte
Campos Base
status string
Estado HTTP de la respuesta. Ejemplo: Created.
message string
Mensaje descriptivo del resultado de la operación. Ejemplo: Documento con el código de referencia 1e589e10-7a89-4e8e-b193-d2ee4d9dc1ad registrado y validado con éxito.
data object
Objeto principal que contiene toda la información del documento generado.
data Campos generales
data.reference_code string
Código de referencia único asignado a la factura. Corresponde al reference_code enviado en la solicitud.
data.number string
Número consecutivo de la factura asignado por el sistema según el rango de numeración activo. Ejemplo: SETP990002470.
data.order_reference string | null
Referencia a la orden de compra asociada. Retorna null si no aplica.
data.send_email boolean
Indica si el correo electrónico fue enviado al cliente al momento de la validación.
data.has_claim boolean
Indica si la factura tiene alguna reclamación registrada.
data.is_negotiable_instrument boolean
Indica si la factura es un título valor (instrumento negociable).
data.is_validated boolean
Indica si la factura fue validada exitosamente ante la DIAN. true: validada, false: pendiente de validación.
data.validated_at string | null
Fecha y hora en que la DIAN validó el documento. Formato: DD-MM-YYYY HH:mm:ss AM/PM. Retorna null si aún no está validada.
data.errors object
Objeto con las notificaciones o advertencias retornadas por la DIAN durante la validación. Las claves son los códigos de regla (ej. FAJ44b) y los valores son el mensaje descriptivo. Este campo puede estar vacío si no hay notificaciones.
data.observation string | null
Observación adicional incluida en la factura. Retorna null si no se especificó.
data.created_at string
Fecha y hora de creación del documento en el sistema. Formato: DD-MM-YYYY HH:mm:ss AM/PM.
data.cufe string
Código Único de Factura Electrónica (CUFE) generado por la DIAN. Es el identificador oficial y único del documento ante la DIAN.
data.document_type
data.document_type object
Objeto con la información del tipo de documento electrónico generado.
data.document_type.code string
Código del tipo de documento. Ejemplo: 01 para Factura electrónica de Venta.
data.document_type.name string
Nombre descriptivo del tipo de documento. Ejemplo: Factura electrónica de Venta.
data.operation_type
data.operation_type object
Objeto con el tipo de operación utilizado en la factura.
data.operation_type.code string
Código del tipo de operación. Para facturas de transporte el valor es 12.
data.operation_type.name string
Nombre descriptivo del tipo de operación. Para facturas de transporte: Transporte.
data.billing_period
data.billing_period object | null
Objeto con el período de facturación. Retorna null si no se especificó.
data.billing_period.start_date string
Fecha de inicio del período de facturación en formato DD-MM-YYYY.
data.billing_period.start_time string
Hora de inicio del período en formato HH:mm:ss.
data.billing_period.end_date string
Fecha de fin del período de facturación en formato DD-MM-YYYY.
data.billing_period.end_time string
Hora de fin del período en formato HH:mm:ss.
data.payment_details
data.payment_details array
Array de objetos con los detalles de cada medio de pago utilizado en la factura.
data.payment_details.*.payment_form object
Objeto con la forma de pago (contado o crédito).
data.payment_details.*.payment_form.code string
Código de la forma de pago. Ejemplo: 1 (Pago de contado).
data.payment_details.*.payment_form.name string
Nombre descriptivo de la forma de pago. Ejemplo: Pago de contado.
data.payment_details.*.payment_method object
Objeto con el método de pago utilizado.
data.payment_details.*.payment_method.code string
Código del método de pago. Ejemplo: 10 (Efectivo), 42 (Consignación).
data.payment_details.*.payment_method.name string
Nombre descriptivo del método de pago. Ejemplo: Efectivo.
data.payment_details.*.reference_code string | null
Código de referencia del pago. Retorna null si no aplica.
data.payment_details.*.amount string
Monto correspondiente a este medio de pago.
data.payment_details.*.due_date string | null
Fecha de vencimiento del pago en formato DD-MM-YYYY. Retorna null para pagos de contado.
data.numbering_range
data.numbering_range object
Objeto con la información del rango de numeración utilizado para generar el consecutivo de la factura.
data.numbering_range.prefix string
Prefijo del rango de numeración. Ejemplo: SETP.
data.numbering_range.from integer
Número inicial del rango de numeración autorizado.
data.numbering_range.to integer
Número final del rango de numeración autorizado.
data.numbering_range.resolution_number string
Número de resolución emitida por la DIAN para este rango.
data.numbering_range.start_date string
Fecha de inicio de vigencia del rango en formato DD-MM-YYYY.
data.numbering_range.end_date string
Fecha de fin de vigencia del rango en formato DD-MM-YYYY.
data.numbering_range.months integer
Duración total del rango de numeración en meses.
data.health
data.health null
Siempre retorna null en facturas de transporte. Este campo aplica únicamente para facturas del sector salud (tipo de operación SS-CUFE).
data.beneficiary
data.beneficiary object | null
Objeto con los datos del beneficiario. Retorna null si no aplica.
data.company
data.company object
Objeto con la información de la empresa emisora de la factura.
data.company.url_logo string
URL de la imagen del logotipo de la empresa.
data.company.nit string
NIT de la empresa emisora (sin dígito de verificación).
data.company.dv string
Dígito de verificación del NIT de la empresa.
data.company.economic_activity string
Código CIIU de la actividad económica principal de la empresa.
data.company.establishment object
Objeto con los datos del establecimiento comercial de la empresa.
data.company.establishment.name string
Nombre o razón social del establecimiento.
data.company.establishment.address string
Dirección física del establecimiento.
data.company.establishment.phone_number string
Número de teléfono del establecimiento.
data.company.establishment.email string
Correo electrónico del establecimiento.
data.company.establishment.municipality object
Objeto con el municipio donde está ubicado el establecimiento.
data.company.establishment.municipality.code string
Código DIVIPOLA del municipio.
data.company.establishment.municipality.name string
Nombre del municipio.
data.company.establishment.municipality.department object
Objeto con el departamento al que pertenece el municipio.
data.company.establishment.municipality.department.code string
Código DIVIPOLA del departamento.
data.company.establishment.municipality.department.name string
Nombre del departamento.
data.customer
data.customer object
Objeto con la información completa del cliente receptor de la factura.
data.customer.identification_document object
Objeto con el tipo de documento de identidad del cliente.
data.customer.identification_document.code string
Código del tipo de documento. Ejemplo: 31 (NIT).
data.customer.identification_document.name string
Nombre descriptivo del tipo de documento. Ejemplo: NIT.
data.customer.identification string
Número del documento de identidad del cliente.
data.customer.dv string | null
Dígito de verificación del documento. Retorna null para personas naturales con cédula.
data.customer.graphic_representation_name string
Nombre que aparece en la representación gráfica (PDF) de la factura.
data.customer.trade_name string | null
Nombre comercial del cliente. Retorna null si no aplica.
data.customer.company string | null
Razón social si el cliente es una empresa. Retorna null para personas naturales.
data.customer.names string | null
Nombre completo del cliente persona natural. Retorna null para personas jurídicas.
data.customer.address string
Dirección del cliente.
data.customer.email string
Correo electrónico del cliente al que se envía la factura.
data.customer.phone string
Número de teléfono del cliente.
data.customer.legal_organization object
Objeto con el tipo de organización legal del cliente.
data.customer.legal_organization.code string
Código de la organización legal. Ejemplo: 1 (Persona Jurídica).
data.customer.legal_organization.name string
Nombre de la organización legal. Ejemplo: Persona Jurídica.
data.customer.tribute object
Objeto con el tipo de tributo o responsabilidad fiscal del cliente.
data.customer.tribute.code string
Código del tributo. Ejemplo: ZZ (No aplica).
data.customer.tribute.name string
Nombre del tributo. Ejemplo: No aplica.
data.customer.municipality object
Objeto con el municipio del cliente.
data.customer.municipality.code string
Código DIVIPOLA del municipio del cliente.
data.customer.municipality.name string
Nombre del municipio del cliente.
data.customer.municipality.department object
Objeto con el departamento del municipio del cliente.
data.customer.municipality.department.code string
Código DIVIPOLA del departamento.
data.customer.municipality.department.name string
Nombre del departamento.
data.items
data.items array
Array de objetos con el detalle de cada ítem de la factura de transporte. Puede incluir remesas registradas en el RNDC y servicios adicionales.
data.items.*.scheme_id object
Objeto que identifica el tipo de ítem de transporte. Determina si el ítem corresponde a una remesa RNDC o a un servicio adicional.
data.items.*.scheme_id.code string
Código del esquema del ítem. Ejemplo: 0 (Servicio adicional), 1 (Remesa de transporte registrada en el RNDC).
data.items.*.scheme_id.name string
Nombre del esquema del ítem. Ejemplo: Remesa de transporte registrada en el RNDC.
data.items.*.collection_concept string | null
Concepto de recaudo asociado al ítem. Retorna null si no aplica.
data.items.*.note string
Nota o descripción adicional del ítem.
data.items.*.mandate null
Siempre retorna null en facturas de transporte. Este campo aplica para facturas de mandato.
data.items.*.additional_properties array
Array de propiedades adicionales específicas del servicio de transporte, asociadas a la remesa. Vacío para servicios adicionales (scheme_id.code = 0).
data.items.*.additional_properties.*.code string
Código identificador de la propiedad adicional. Valores posibles: 01 (Número de radicación RNDC), 02 (Consecutivo interno de la remesa), 03 (Valor del flete).
data.items.*.additional_properties.*.name string
Descripción de la propiedad adicional. Ejemplo: Número de Radicación de la Remesa entregado por el RNDC.
data.items.*.additional_properties.*.quantity number | null
Valor numérico de la propiedad, cuando aplica. Retorna null si no requiere cantidad.
data.items.*.additional_properties.*.unit_measure object | null
Objeto con la unidad de medida de la propiedad adicional. Retorna null si no aplica.
data.items.*.additional_properties.*.unit_measure.code string
Código de la unidad de medida. Ejemplo: KGM (kilogramo).
data.items.*.additional_properties.*.unit_measure.name string
Nombre de la unidad de medida. Ejemplo: kilogramo.
data.items.*.code_reference string
Código interno de referencia del producto o servicio.
data.items.*.name string
Nombre o descripción del producto o servicio. Ejemplo: Pantalones, flete.
data.items.*.quantity string
Cantidad del producto o servicio facturado.
data.items.*.unit_measure object
Objeto con la unidad de medida del producto.
data.items.*.unit_measure.code string
Código de la unidad de medida. Ejemplo: KGM (kilogramo), 94 (unidad).
data.items.*.unit_measure.name string
Nombre de la unidad de medida. Ejemplo: kilogramo.
data.items.*.standard_code object
Objeto con el estándar de codificación del producto.
data.items.*.standard_code.code string
Código del estándar. Ejemplo: 999 (Estándar de adopción del contribuyente).
data.items.*.standard_code.name string
Nombre del estándar de codificación.
data.items.*.discount_rate string
Porcentaje de descuento aplicado al ítem.
data.items.*.discount string
Valor absoluto del descuento aplicado al ítem.
data.items.*.gross_value string
Valor bruto del ítem antes de impuestos.
data.items.*.price string
Precio unitario del producto o servicio.
data.items.*.total string
Valor total del ítem (precio × cantidad - descuento + impuestos).
data.items.*.taxes array
Array de objetos con los impuestos (IVA, INC, etc.) aplicados al ítem.
data.items.*.taxes.*.tribute object
Objeto con el tipo de tributo del impuesto.
data.items.*.taxes.*.tribute.code string
Código del tributo. Ejemplo: 01 (IVA).
data.items.*.taxes.*.tribute.name string
Nombre del tributo. Ejemplo: IVA.
data.items.*.taxes.*.is_excluded boolean
Indica si el ítem está excluido de este impuesto. true: excluido (ej. servicios de flete), false: no excluido.
data.items.*.taxes.*.rates array
Array de objetos con las tarifas del impuesto aplicadas al ítem.
data.items.*.taxes.*.rates.*.taxable_amount string
Base gravable sobre la cual se calcula el impuesto.
data.items.*.taxes.*.rates.*.tax_amount string
Valor calculado del impuesto.
data.items.*.taxes.*.rates.*.rate string
Porcentaje de la tarifa del impuesto.
data.items.*.withholding_taxes array
Array de retenciones aplicadas al ítem. Vacío si no aplican retenciones.
data.prepayment_details
data.prepayment_details array
Array de objetos con los anticipos asociados a la factura. Vacío si no hay anticipos.
data.prepayment_details.*.reference_code string
Código de referencia del anticipo.
data.prepayment_details.*.received_date string
Fecha en que se recibió el anticipo en formato YYYY-MM-DD.
data.prepayment_details.*.amount string
Monto del anticipo registrado.
data.prepayment_details.*.note string
Nota o descripción adicional del anticipo.
data.allowance_charges
data.allowance_charges array
Array de cargos o descuentos a nivel de factura (no a nivel de ítem). Vacío si no aplican.
data.taxes
data.taxes array
Array de objetos con el resumen de impuestos a nivel de factura (totalizados por tipo de tributo). En facturas de transporte puede incluir entradas separadas para ítems excluidos y no excluidos del mismo tributo.
data.taxes.*.tribute object
Objeto con el tipo de tributo resumido.
data.taxes.*.tribute.code string
Código del tributo. Ejemplo: 01 (IVA).
data.taxes.*.tribute.name string
Nombre del tributo.
data.taxes.*.is_excluded boolean
Indica si este resumen de tributo corresponde a ítems excluidos (true) o gravados (false).
data.taxes.*.rates array
Array de objetos con las tarifas del tributo resumidas a nivel de factura.
data.taxes.*.rates.*.taxable_amount string
Base gravable total para esta tarifa de impuesto.
data.taxes.*.rates.*.tax_amount string
Valor total del impuesto para esta tarifa.
data.taxes.*.rates.*.rate string
Porcentaje de la tarifa del impuesto.
data.withholding_taxes
data.withholding_taxes array
Array de retenciones a nivel de factura. Vacío si no aplican retenciones globales.
data.totals
data.totals object
Objeto con los totales calculados de la factura.
data.totals.prepayment_amount string
Suma total de los anticipos registrados en la factura.
data.totals.gross_amount string
Valor bruto total de la factura antes de impuestos y descuentos.
data.totals.taxable_amount string
Base gravable total sobre la cual se calculan los impuestos (excluye ítems exentos).
data.totals.tax_amount string
Valor total de los impuestos calculados en la factura.
data.totals.surcharge_amount string
Valor total de cargos adicionales (recargos) aplicados a la factura.
data.totals.total string
Valor total a pagar de la factura (después de anticipos, impuestos y descuentos).
data.related_documents
data.related_documents array
Array de documentos relacionados con la factura (órdenes de compra, etc.). Vacío si no hay documentos relacionados.
data.related_notes
data.related_notes object
Objeto con las notas crédito y débito relacionadas con esta factura.
data.related_notes.credit_notes array
Array de notas crédito asociadas a esta factura. Vacío si no hay notas crédito.
data.related_notes.debit_notes array
Array de notas débito asociadas a esta factura. Vacío si no hay notas débito.
data.links
data.links object
Objeto con los enlaces generados para acceder al documento.
data.links.qr string
URL del código QR que apunta al portal de la DIAN para consultar el documento.
data.links.public_url string
URL pública para visualizar la representación gráfica del documento en el portal de Factus.