Saltearse al contenido
Factus API

Ver factura

Este endpoint devuelve una factura específica pasando el número de la factura como parámetro en la solicitud GET. Puede encontrar el número de la factura, debe ver la respuesta de la creación de la factura o en filtrar factura data.data.*.number.

Método: GET

Endpoint 

https://api-sandbox.factus.com.co/v2/bills/:number

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.

Variables de Ruta, Path Variables

Sección titulada «Variables de Ruta, Path Variables»
number string
Número de factura. Se recomienda guardar el numero de la factura una vez se haga la creación de la misma para poder hacer uso de este endpoint fácilmente.

Ejemplo de respuesta

Sección titulada «Ejemplo de respuesta»
{
  "status": "OK",
  "message": "Solicitud exitosa",
  "data": {
    "reference_code": "FACT-2026-0124",
    "number": "SETP990001103",
    "document_type": {
      "code": "01",
      "name": "Factura electrónica de Venta"
    },
    "operation_type": {
      "code": "10",
      "name": "Estándar"
    },
    "payment_form": {
      "code": "1",
      "name": "Pago de contado"
    },
    "payment_method": {
      "code": "10",
      "name": "Efectivo"
    },
    "order_reference": null,
    "billing_period": null,
    "send_email": false,
    "has_claim": false,
    "is_negotiable_instrument": false,
    "is_validated": true,
    "validated_at": "02-03-2026 11:12:48 AM",
    "errors": null,
    "observation": "Observacion de prueba",
    "payment_due_date": null,
    "created_at": "02-03-2026 11:12:47 AM",
    "numbering_range": {
      "prefix": "SETP",
      "from": 990000000,
      "to": 995000000,
      "resolution_number": "18760000001",
      "start_date": "19-01-2019",
      "end_date": "19-01-2030",
      "months": 132
    },
    "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": [
      {
        "scheme_id": null,
        "note": "",
        "mandate": null,
        "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"
      },
      {
        "scheme_id": null,
        "note": "",
        "mandate": null,
        "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"
    },
    "related_documents": [],
    "related_notes": {
      "credit_notes": [],
      "debit_notes": []
    },
    "cufe": "789b4ee4489b4d09f73913ebcabcc329ebb419a9f3a58a55354bd52427168a856c023e2d24ceafad1cc9ace9abf09e49",
    "links": {
      "qr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=789b4ee4489b4d09f73913ebcabcc329ebb419a9f3a58a55354bd52427168a856c023e2d24ceafad1cc9ace9abf09e49",
      "public_url": "http://app.test/documents/bills/1ea2d985975ee13ef1de0b9fe2915b5a5d9df6c9e004757f9ed2a9864b92d771"
    }
  }
}