Factura Electrónica (FE)

POST /api/v1/service/invoice

Genera una Factura Electrónica de Venta según el Anexo Técnico DIAN v1.9.

Request

POST /api/v1/service/invoice

Identificación

Seller (Vendedor / Emisor)

Buyer (Adquirente)

Lines (Líneas)

TaxTotals (Totales de Impuestos)

MonetaryTotal (Totales Monetarios)

PaymentMeans (Medio de Pago)

Control (Resolución)

Software

Environment

Ejemplo

curl -X POST https://emision.smartapp.com.co/api/v1/service/invoice \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prefix": "SETP",
    "number": 100,
    "issue_date": "2026-05-01",
    "issue_time": "10:30:00-05:00",
    "notes": ["Pago a 30 días"],
    "seller": {
      "nit": "901917345",
      "dv": "0",
      "name": "Smart Mensajería SAS",
      "address": {
        "department_code": "11",
        "city_code": "11001",
        "address_line": "Calle 123 #45-67",
        "postal_zone": "110111"
      }
    },
    "buyer": {
      "nit": "900123456",
      "dv": "1",
      "name": "Cliente SAS",
      "address": {
        "department_code": "11",
        "city_code": "11001",
        "address_line": "Cra 45 #67-89"
      }
    },
    "lines": [
      {
        "id": "1",
        "description": "Servicio de mensajería",
        "quantity": 1,
        "unit_price": 100000,
        "line_extension_amount": 100000,
        "tax_total": {
          "tax_amount": 19000,
          "tax_subtotals": [
            {"tax_amount": 19000, "taxable_amount": 100000, "tax_percent": 19,
             "tax_scheme_id": "01", "tax_scheme_name": "IVA"}
          ]
        }
      }
    ],
    "tax_totals": [
      {
        "tax_amount": 19000,
        "tax_subtotals": [
          {"tax_amount": 19000, "taxable_amount": 100000, "tax_percent": 19,
           "tax_scheme_id": "01", "tax_scheme_name": "IVA"}
        ]
      }
    ],
    "monetary_total": {
      "line_extension_amount": 100000,
      "tax_exclusive_amount": 100000,
      "tax_inclusive_amount": 119000,
      "payable_amount": 119000
    },
    "payment_means": {"payment_means_code": "10"},
    "control": {
      "invoice_authorization": "18760000001",
      "start_date": "2019-01-19",
      "end_date": "2030-01-19",
      "prefix": "SETP",
      "from_number": 1,
      "to_number": 1000000
    },
    "software_id": "ccf08616-3061-4c25-9d68-e76f23235a1b",
    "software_pin": "13934"
  }'

Python

import requests
 
resp = requests.post(
    "https://emision.smartapp.com.co/api/v1/service/invoice",
    headers={"Authorization": "Bearer sk_..."},
    json={
        "prefix": "SETP",
        "number": 100,
        "issue_date": "2026-05-01",
        "issue_time": "10:30:00-05:00",
        "seller": {
            "nit": "901917345",
            "dv": "0",
            "name": "Smart Mensajería SAS",
            "address": {"department_code": "11", "city_code": "11001", "address_line": "Calle 123 #45-67"},
        },
        "buyer": {
            "nit": "900123456",
            "dv": "1",
            "name": "Cliente SAS",
            "address": {"department_code": "11", "city_code": "11001", "address_line": "Cra 45 #67-89"},
        },
        "lines": [{
            "id": "1", "description": "Servicio de mensajería",
            "quantity": 1, "unit_price": 100000, "line_extension_amount": 100000,
            "tax_total": {"tax_amount": 19000, "tax_subtotals": [
                {"tax_amount": 19000, "taxable_amount": 100000, "tax_percent": 19,
                 "tax_scheme_id": "01", "tax_scheme_name": "IVA"}]},
        }],
        "tax_totals": [{"tax_amount": 19000, "tax_subtotals": [
            {"tax_amount": 19000, "taxable_amount": 100000, "tax_percent": 19,
             "tax_scheme_id": "01", "tax_scheme_name": "IVA"}]}],
        "monetary_total": {
            "line_extension_amount": 100000, "tax_exclusive_amount": 100000,
            "tax_inclusive_amount": 119000, "payable_amount": 119000},
        "payment_means": {"payment_means_code": "10"},
        "control": {"invoice_authorization": "18760000001",
                     "start_date": "2019-01-19", "end_date": "2030-01-19",
                     "prefix": "SETP", "from_number": 1, "to_number": 1000000},
        "software_id": "ccf08616-3061-4c25-9d68-e76f23235a1b",
        "software_pin": "13934",
    }
)
print(resp.json())

Node.js

const resp = await fetch("https://emision.smartapp.com.co/api/v1/service/invoice", {
  method: "POST",
  headers: { "Authorization": "Bearer sk_...", "Content-Type": "application/json" },
  body: JSON.stringify({
    prefix: "SETP",
    number: 100,
    issue_date: "2026-05-01",
    issue_time: "10:30:00-05:00",
    seller: {
      nit: "901917345", dv: "0", name: "Smart Mensajería SAS",
      address: { department_code: "11", city_code: "11001", address_line: "Calle 123 #45-67" },
    },
    buyer: {
      nit: "900123456", dv: "1", name: "Cliente SAS",
      address: { department_code: "11", city_code: "11001", address_line: "Cra 45 #67-89" },
    },
    lines: [{
      id: "1", description: "Servicio de mensajería",
      quantity: 1, unit_price: 100000, line_extension_amount: 100000,
      tax_total: { tax_amount: 19000, tax_subtotals: [
        { tax_amount: 19000, taxable_amount: 100000, tax_percent: 19,
          tax_scheme_id: "01", tax_scheme_name: "IVA" }] },
    }],
    tax_totals: [{ tax_amount: 19000, tax_subtotals: [
      { tax_amount: 19000, taxable_amount: 100000, tax_percent: 19,
        tax_scheme_id: "01", tax_scheme_name: "IVA" }] }],
    monetary_total: { line_extension_amount: 100000, tax_exclusive_amount: 100000,
                      tax_inclusive_amount: 119000, payable_amount: 119000 },
    payment_means: { payment_means_code: "10" },
    control: { invoice_authorization: "18760000001",
               start_date: "2019-01-19", end_date: "2030-01-19",
               prefix: "SETP", from_number: 1, to_number: 1000000 },
    software_id: "ccf08616-3061-4c25-9d68-e76f23235a1b",
    software_pin: "13934",
  })
});
console.log(await resp.json());