factus-js iconfactus-js
Facturas

Ver factura

Obtener el detalle completo de una factura por su número de documento.

Firma del método

get(number: string, options?: RequestOptions): Promise<ViewBillResponse>

Endpoint Factus

GET /v2/bills/{number}

Fuente oficial: Ver factura

Parámetros

Prop

Type

Ejemplo

const response = await factus.bills.get("SETP990000203");
console.log(response.data);

Ejemplo de respuesta

{
  "status": "Created",
  "message": "Documento con el código de referencia fact0022025 registrado y validado con éxito",
  "data": {
    "company": {
      "url_logo": "http://api.test/storage/images/logos/2wkU627FUczVkr8U5P8yrYowQ44eYQG0Y9ymXhtP.png",
      "nit": "900825759",
      "dv": "7",
      "company": "HALLTEC S.A.S.",
      "name": "HALLTEC S.A.S.",
      "graphic_representation_name": "HALLTEC S.A.S.",
      "registration_code": "3FJ3253427",
      "economic_activity": "6311",
      "phone": "3165584659",
      "email": "[email protected]",
      "direction": "cra 10 # 9 - 04",
      "municipality": "San Gil"
    },
    "establishment": {
      "name": "SuperMarket",
      "address": "calle 10 # 3-13",
      "phone_number": "0987654321",
      "email": "[email protected]",
      "municipality_id": {
        "id": 996,
        "code": 68872,
        "name": "Villanueva",
        "department": {
          "id": 28,
          "code": "68",
          "name": "Santander"
        }
      }
    },
    "customer": {
      "identification": "123456789",
      "dv": null,
      "graphic_representation_name": "Alan Turing",
      "trade_name": "",
      "company": "",
      "names": "Alan Turing",
      "address": "calle 1 # 2-68",
      "email": "[email protected]",
      "phone": "1234567890",
      "legal_organization": {
        "id": 2,
        "code": "2",
        "name": "Persona Natural"
      },
      "tribute": {
        "id": 21,
        "code": "ZZ",
        "name": "No aplica"
      },
      "municipality": {
        "id": 980,
        "code": "68679",
        "name": "San Gil"
      }
    },
    "numbering_range": {
      "prefix": "SETP",
      "from": 990000000,
      "to": 995000000,
      "resolution_number": "18760000001",
      "start_date": "19-01-2019",
      "end_date": "19-01-2030",
      "months": 132
    },
    "billing_period": [],
    "bill": {
      "id": 820,
      "document": {
        "code": "01",
        "name": "Factura electrónica de Venta"
      },
      "operation_type": {
        "code": "10",
        "name": "Estándar"
      },
      "number": "SETP990000493",
      "reference_code": "fact0022025",
      "order_reference": null,
      "status": 1,
      "send_email": 0,
      "qr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=44e260a76e092e46fd5d8344a03146d5c8863ab68b18bde38a53318a33bf6805bac75f0bd71b0b75b3bd9c747a629470",
      "cufe": "44e260a76e092e46fd5d8344a03146d5c8863ab68b18bde38a53318a33bf6805bac75f0bd71b0b75b3bd9c747a629470",
      "validated": "09-01-2025 01:56:16 PM",
      "gross_value": "81232.50",
      "taxable_amount": "81232.50",
      "tax_amount": "8767.50",
      "discount_amount": "0.00",
      "surcharge_amount": "0.00",
      "total": "90000.00",
      "observation": null,
      "errors": [],
      "created_at": "09-01-2025 01:56:13 PM",
      "payment_due_date": null,
      "qr_image": "data:image/png;base64, [TRIMMED_BASE64_12712_CHARS]",
      "has_claim": 0,
      "is_negotiable_instrument": 0,
      "payment_form": {
        "code": "1",
        "name": "Pago de contado"
      },
      "payment_method": {
        "code": "10",
        "name": "Efectivo"
      }
    },
    "related_documents": [],
    "items": [
      {
        "scheme_id": null,
        "note": null,
        "code_reference": "12345",
        "name": "producto de prueba",
        "quantity": 1,
        "discount_rate": "20.00",
        "discount": "8403.36",
        "gross_value": "33613.45",
        "tax_rate": "19.00",
        "taxable_amount": "33613.45",
        "tax_amount": "6386.55",
        "price": "50000.00",
        "is_excluded": 0,
        "unit_measure": {
          "id": 70,
          "code": "94",
          "name": "unidad"
        },
        "standard_code": {
          "id": 1,
          "code": "999",
          "name": "Estándar de adopción del contribuyente"
        },
        "tribute": {
          "id": 1,
          "code": "01",
          "name": "IVA"
        },
        "total": 40000,
        "withholding_taxes": [
          {
            "tribute_code": "05",
            "name": "ReteIVA",
            "value": "957.98",
            "rates": [
              {
                "code": "05",
                "name": "ReteIVA",
                "rate": "15.00"
              }
            ]
          },
          {
            "tribute_code": "06",
            "name": "ReteRenta",
            "value": "2352.94",
            "rates": [
              {
                "code": "06",
                "name": "ReteRenta",
                "rate": "7.00"
              }
            ]
          }
        ],
        "mandate": null
      },
      {
        "scheme_id": null,
        "note": null,
        "code_reference": "54321",
        "name": "producto de prueba 2",
        "quantity": 1,
        "discount_rate": "0.00",
        "discount": "0.00",
        "gross_value": "47619.05",
        "tax_rate": "5.00",
        "taxable_amount": "47619.05",
        "tax_amount": "2380.95",
        "price": "50000.00",
        "is_excluded": 0,
        "unit_measure": {
          "id": 70,
          "code": "94",
          "name": "unidad"
        },
        "standard_code": {
          "id": 1,
          "code": "999",
          "name": "Estándar de adopción del contribuyente"
        },
        "tribute": {
          "id": 1,
          "code": "01",
          "name": "IVA"
        },
        "total": 50000,
        "withholding_taxes": [],
        "mandate": null
      }
    ],
    "allowance_charges": [],
    "withholding_taxes": [
      {
        "tribute_code": "05",
        "name": "ReteIVA",
        "value": "957.98"
      },
      {
        "tribute_code": "06",
        "name": "ReteRenta",
        "value": "2352.94"
      }
    ],
    "credit_notes": [],
    "debit_notes": []
  }
}

En esta página