---
title: "DIAN Electronic Invoices"
method: POST
path: "/co/dian-muisca/electronic-invoices/v1"
tags: ["Colombia", "DIAN"]
---

# DIAN Electronic Invoices

`POST /co/dian-muisca/electronic-invoices/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/dian-muisca/electronic-invoices/v1`
- Auth: HTTP bearer

Read the electronic invoices issued to the connected DIAN account holder in one tax year (2023 onward): issuer, dates, invoiced and net amounts, deductible amount, payment method, invoice number and CUFE, with totals. Persons only: runs as your organization's own DIAN connection signed in on its own behalf.

Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`.

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `year` integer, required: Tax year (año gravable), from 2023 to the last year that has ended.
  - `connection_id` string: Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance.
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- DianMuiscaElectronicInvoicesResponse
  - `data` DianMuiscaElectronicInvoicesData, required
    - `year` number, required: Echoes the tax year.
    - `cutoff_date` string, nullable, required: The date DIAN's figures were cut, `yyyy-mm-dd`.
    - `taxpayer` object, required
      - `document_type` string, nullable, required: The account holder's document type, as DIAN prints it, e.g. "C. C.".
      - `document_number` string, nullable, required: The account holder's document number, as DIAN prints it.
      - `name` string, nullable, required: The account holder's name, as DIAN prints it.
    - `count` number, required: Number of invoices returned.
    - `totals` object, required: Sums over the invoices returned, in COP.
      - `invoiced_amount` number, required
      - `credit_notes_amount` number, required
      - `debit_notes_amount` number, required
      - `net_amount` number, required
      - `deductible_amount` number, required
    - `invoices` object[], required
      - `issuer_id` string, nullable, required: NIT or document of who issued the invoice.
      - `issuer_name` string, nullable, required: Name of who issued the invoice.
      - `issued_on` string, nullable, required: Issue date, `yyyy-mm-dd`.
      - `invoiced_amount` number, nullable, required: Amount invoiced, in COP.
      - `credit_notes_amount` number, nullable, required: Credit notes applied to the invoice, in COP.
      - `debit_notes_amount` number, nullable, required: Debit notes applied to the invoice, in COP.
      - `net_amount` number, nullable, required: The invoice after credit and debit notes, in COP.
      - `deductible_amount` number, nullable, required: The part DIAN considers eligible for the tax benefit, in COP.
      - `payment_method` string, nullable, required: Payment method as DIAN names it, e.g. "Efectivo" or "Electrónicos".
      - `invoice_number` string, nullable, required: The invoice number.
      - `cufe` string, nullable, required: The invoice's CUFE (código único de factura electrónica): the key.
    - `checked_at` string, required: When DIAN was read (ISO 8601).

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)