Referencia API

Endpoints, parámetros, esquemas y respuestas definidos por el contrato OpenAPI 3.1.

Fuente contractual: esta referencia se genera a partir de openapi/quantum-api-v1.yaml versión 1.0.0. Base de producción: https://nomina.quantumpos.com.co/api/ext/v1.

GETfe.read./companies/{company_id}/fe/docs

Listar documentos FE de producción#

Requiere scope fe.read. Reutiliza el listado FE productivo.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.
`page`	query	No
`per_page`	query	No
`tipo`	query	No
`estado`	query	No
`q`	query	No

Respuestas HTTP

HTTP	Descripción
`200`	Listado FE
`401`
`403`

GETfe.read./companies/{company_id}/fe/docs/{doc_id}

Obtener detalle de un documento FE#

Requiere scope fe.read.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.
`doc_id`	path	Sí

Respuestas HTTP

HTTP	Descripción
`200`	Documento encontrado
`401`
`403`
`404`

GETfe.read./companies/{company_id}/fe/terceros

Listar terceros FE#

Requiere scope fe.read.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.

Respuestas HTTP

HTTP	Descripción
`200`	Terceros
`401`
`403`

GETfe.read./companies/{company_id}/fe/payment-methods

Listar métodos de pago FE configurados#

Requiere scope fe.read. Los IDs son específicos de cada empresa y no deben hardcodearse entre compañías.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.

Respuestas HTTP

HTTP	Descripción
`200`	Catálogo de métodos de pago de la empresa
`401`
`403`

POSTfe.read./companies/{company_id}/dian/get-acquirer

Consultar adquirente#

Requiere scope fe.read.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.

Request body · GetAcquirerRequest

identification_type

string

identification_number

string

force_refresh

boolean

tipo_doc

string

Alias compatible

numero_doc

string

Alias compatible

Respuestas HTTP

HTTP	Descripción
`200`	Consulta exitosa
`400`
`401`
`403`
`502`	El servicio subyacente no produjo resultado satisfactorio

POSTfe.write./companies/{company_id}/fe/facturas

Crear, firmar y procesar una Factura Electrónica#

Requiere scope fe.write. El flujo externo reutiliza la creación FE productiva. Conserve draft_key ante reintentos. En FE, una tarifa exactamente 8 se trata como INC código 04 en la normalización actual.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.

Request body · FeCreateRequest

receptor *

FeReceiver

items *

array[FeItem]

subtotal

number

impuestos

number

total

number

es_contingencia

boolean

fecha_emision

string

payment

FePayment

aiu

object

withholdings

array[object]

currency

object

observaciones

string

attachment_tokens

array[string]

draft_key

string

Respuestas HTTP

HTTP	Descripción
`200`
`201`
`400`
`401`
`403`
`500`

POSTdse.write/companies/{company_id}/dse/documentos

Crear, firmar y transmitir un DSE#

Requiere scope dse.write e Idempotency-Key. La misma llave con el mismo payload no genera un segundo DSE. Si una transmisión devuelve pending=true, no cree otra llave: consulte el documento o repita únicamente con la misma llave y payload.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.
`Idempotency-Key`	header	Sí	Llave estable por operación DSE. Reutilizar exactamente la misma llave y payload ante retry.

Request body · DseCreateRequest

fecha_documento

string

fecha

string

Alias

hora

string

moneda

string

proveedor *

DseProvider

items *

array[DseItem]

forma_generacion

string

generation_mode

string

fecha_inicio_periodo

string

fecha_fin_periodo

string

forma_pago

string

payment_type

string

medio_pago_codigo

string

payment_means_code

string

fecha_vencimiento

string

fecha_vencimiento_contable

string

retenciones

array[DseRetention]

withholdings

array[DseRetention]

tipo_dian

string

Respuestas HTTP

HTTP	Descripción
`200`	Replay idempotente con documento existente
`201`	DSE nuevo procesado
`202`	Solicitud ya reservada
`400`
`401`
`403`
`409`	Idempotency-Key usada con payload diferente
`422`	Documento rechazado
`502`	Transporte/resultado DIAN incierto; normalmente pending=true
`500`

GETdse.read./companies/{company_id}/dse/documentos/{doc_id}

Consultar DSE por ID#

Requiere scope dse.read.

Parámetros

Parámetro	Ubicación	Obligatorio	Descripción
`company_id`	path	Sí	Empresa asociada al token. Debe coincidir con el token Bearer.
`doc_id`	path	Sí

Respuestas HTTP

HTTP	Descripción
`200`	Documento DSE
`401`
`403`
`404`