Create Invoice

curl -X POST https://api.yourapp.com/api/v1/invoices \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_code": "INV-2024-001",
    "payment_method_code": "10",
    "payment_form": "1",
    "customer": {
      "identification_document_id": 6,
      "identification": "900123456",
      "dv": "7",
      "company": "Acme Corporation S.A.S.",
      "email": "[email protected]",
      "address": "Calle 123 #45-67",
      "phone": "3001234567",
      "municipality_id": 11001,
      "legal_organization_id": 1,
      "tribute_id": 1
    },
    "items": [
      {
        "code_reference": "PROD-001",
        "name": "Software License",
        "quantity": 1,
        "price": 1000000.00,
        "discount_rate": 0.00,
        "tax_rate": 19.00,
        "unit_measure_id": 70,
        "standard_code_id": 999,
        "is_excluded": 0,
        "tribute_id": 1
      }
    ]
  }'

{
  "message": "Factura creada exitosamente",
  "data": {
    "number": "FACT-12345",
    "prefix": "FACT",
    "cufe": "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
    "qr_url": "https://factus.com/qr/abc123def456",
    "status": "success",
    "message": "Invoice created successfully"
  }
}

POST

api

invoices

curl -X POST https://api.yourapp.com/api/v1/invoices \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_code": "INV-2024-001",
    "payment_method_code": "10",
    "payment_form": "1",
    "customer": {
      "identification_document_id": 6,
      "identification": "900123456",
      "dv": "7",
      "company": "Acme Corporation S.A.S.",
      "email": "[email protected]",
      "address": "Calle 123 #45-67",
      "phone": "3001234567",
      "municipality_id": 11001,
      "legal_organization_id": 1,
      "tribute_id": 1
    },
    "items": [
      {
        "code_reference": "PROD-001",
        "name": "Software License",
        "quantity": 1,
        "price": 1000000.00,
        "discount_rate": 0.00,
        "tax_rate": 19.00,
        "unit_measure_id": 70,
        "standard_code_id": 999,
        "is_excluded": 0,
        "tribute_id": 1
      }
    ]
  }'

{
  "message": "Factura creada exitosamente",
  "data": {
    "number": "FACT-12345",
    "prefix": "FACT",
    "cufe": "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
    "qr_url": "https://factus.com/qr/abc123def456",
    "status": "success",
    "message": "Invoice created successfully"
  }
}

Headers

Authorization

string

required

Bearer token for authentication: Bearer <local_jwt>

X-Factus-Token

string

required

Factus access token obtained from authentication

Request Body

numbering_range_id

integer

Numbering range ID for the invoice

document

string

default:"01"

Document type code. Default: “01” (Sales Invoice)

reference_code

string

required

Unique reference code for the invoice

observation

string

Additional observations or notes (max 250 characters)

payment_method_code

string

default:"10"

Payment method code. Default: “10” (cash)

payment_form

string

default:"1"

Payment form: “1” for immediate payment, “2” for credit

payment_due_date

string

Payment due date (required if payment_form is “2”). Format: YYYY-MM-DD

operation_type

string

Type of operation for the invoice

send_email

boolean

Whether to send email notification automatically

customer

object

required

Customer information

Show Customer properties

identification_document_id

integer

required

Document type ID (e.g., 6 for NIT)

identification

string

required

Customer identification number

string

Verification digit (required for NIT)

company

string

Company name (for legal entities)

trade_name

string

Trade name

names

string

Full name (required for natural persons)

address

string

Customer address

string

Customer email address

phone

string

Customer phone number

municipality_id

integer

Municipality ID

legal_organization_id

integer

required

Legal organization type ID

tribute_id

integer

required

Tribute/tax regime ID

items

array

required

List of invoice items

Show Item properties

code_reference

string

required

Product/service code reference

name

string

required

Product/service name

quantity

integer

required

Quantity (must be greater than 0)

price

number

required

Unit price (must be greater than 0, max 2 decimal places)

discount_rate

number

default:"0.00"

Discount rate (0-100, max 2 decimal places)

tax_rate

number

required

Tax rate (max 2 decimal places)

unit_measure_id

integer

required

Unit of measure ID

standard_code_id

integer

required

Standard code ID

is_excluded

integer

required

Tax exclusion flag: 0 (not excluded) or 1 (excluded)

tribute_id

integer

required

Tribute/tax ID for this item

scheme_id

string

Scheme identifier

note

string

Additional notes for the item

withholding_taxes

array

List of withholding taxes

Show Withholding tax properties

code

string

required

Tax code

withholding_tax_rate

number

required

Withholding tax rate

mandate

object

Mandate information

Show Mandate properties

identification_document_id

integer

required

Document type ID

identification

string

required

Identification number

order_reference

object

Order reference information

Show Order reference properties

reference_code

string

required

Order reference code

issue_date

string

Order issue date (YYYY-MM-DD)

List of related documents

Show Related document properties

billing_period

object

Billing period information

Show Billing period properties

start_date

string

required

Period start date (YYYY-MM-DD)

start_time

string

Period start time

end_date

string

required

Period end date (YYYY-MM-DD)

end_time

string

required

Period end time

establishment

object

Establishment information

Show Establishment properties

name

string

required

Establishment name

address

string

required

Establishment address

phone_number

string

required

Phone number

string

required

Email address

municipality_id

integer

required

Municipality ID

allowance_charges

array

List of allowances and charges

Show Allowance/charge properties

concept_type

string

required

Concept type code

is_surcharge

boolean

required

True for surcharge, false for discount

reason

string

required

Reason for allowance/charge

base_amount

number

required

Base amount

amount

number

required

Allowance/charge amount

Response

message

string

Success message

data

object

Invoice creation response data

Show Data properties

number

string

Generated invoice number

prefix

string

Invoice prefix

cufe

string

CUFE (Unique Electronic Invoice Code)

qr_url

string

QR code URL for the invoice

status

string

Invoice status

message

string

Additional status message

curl -X POST https://api.yourapp.com/api/v1/invoices \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_code": "INV-2024-001",
    "payment_method_code": "10",
    "payment_form": "1",
    "customer": {
      "identification_document_id": 6,
      "identification": "900123456",
      "dv": "7",
      "company": "Acme Corporation S.A.S.",
      "email": "[email protected]",
      "address": "Calle 123 #45-67",
      "phone": "3001234567",
      "municipality_id": 11001,
      "legal_organization_id": 1,
      "tribute_id": 1
    },
    "items": [
      {
        "code_reference": "PROD-001",
        "name": "Software License",
        "quantity": 1,
        "price": 1000000.00,
        "discount_rate": 0.00,
        "tax_rate": 19.00,
        "unit_measure_id": 70,
        "standard_code_id": 999,
        "is_excluded": 0,
        "tribute_id": 1
      }
    ]
  }'

{
  "message": "Factura creada exitosamente",
  "data": {
    "number": "FACT-12345",
    "prefix": "FACT",
    "cufe": "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
    "qr_url": "https://factus.com/qr/abc123def456",
    "status": "success",
    "message": "Invoice created successfully"
  }
}

Refresh Factus Token Get Invoice

⌘I

Build docs developers (and LLMs) love

Get started for free Talk to us

Authentication

Invoices

Lookups

Headers

Request Body

Response

Build docs developers (and LLMs) love

Authentication

Invoices

Lookups

​Headers

​Request Body

​Response

Build docs developers (and LLMs) love

Headers

Request Body

Response