1. Lista de valores
API de Facturación Aliaddo NITRO
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Facturas electrónicas
    • Crear factura electrónica
      POST
    • Crear factura sector salud
      POST
    • Crear factura divisas
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos soporte
    • Crear documento soporte
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos equivalentes
    • Crear tiquete P.O.S
    • Crear tiquete de transporte terrestre
    • Crear tiquete de cine
    • Crear tiquete de cobro de peajes
    • Crear tiquete aereo
    • Crear boleta de ingreso a espectáculos públicos
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Notas crédito
    • Crear nota crédito
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Notas débito
    • Crear nota débito
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota de ajuste al documento soporte
    • Crear nota de ajuste
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota crédito al documento equivalente
    • Crear nota crédito al documento equivalente
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota débito al documento equivalente
    • Crear nota débito al documento equivalente
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota de ajuste al documento equivalente
    • Crear nota de ajuste al documento equivalente
  • Lista de valores
    • Actividades económicas
    • Ciudades
    • Códigos de monedas
    • Código estandar del producto
    • Condiciones de entrega (INCOTERMS)
    • Departamentos
    • Medios de pagos
    • Paises
    • Responsabilidades fiscales
    • Tipos de identificacion
    • Tipos de documentos electrónicos
    • Tipos de operación
    • Tipos de persona
    • Tipos de regimen
    • Tributos (Impuestos/Retenciones)
    • Unidades de cantidad
    • Responsable de impuestos
    • Códigos Postales de Colombia
  • Estructura de datos
    • Ancho del PDF
    • Descuentos y cargos
    • Direcciones del cliente
    • Documentos equivalentes
    • Extensiones de facturas
    • Factura electrónica de venta
    • Factura electrónica sector salud
    • Factura electrónica de venta y compra de divisas
    • Formatos permitidos PDF
    • ID set de pruebas DIAN
    • Modo contingencia
    • Modos de ambiente de facturación
    • Notas de ajuste débito y crédito al documento equivalente
    • Notas crédito y débito de factura electrónica de venta
  • Guía para importar archivos
    • Introducción
  • Schemas
    • Documentos electrónicos
      • FacturaElectronica
      • Divisas
      • DocumentoSoporteRequest
      • DocumentoEquivalenteRequest
      • BoletaEspectaculosRequest
    • Impuestos
    • Mandante
    • Retencioness
    • Resolución Pos
    • FacturaRequestPOS
    • FacturaRequest
    • Supplier
    • Dirección
    • Resolución
    • Cliente
    • Productos
    • LineaProductoPeaje
    • Totales
    • SectorSalud
    • Transporte
    • Sucursal
    • RequestResponse
    • Cinema
    • TikectAereo
    • EspectaculoPublico
    • ComprayVentaDeDivisas
    • Retenciones
    • Descuento
    • Propinas
    • Cargos
    • Supplier2
    • NotasCred/Deb/Ajus
  1. Lista de valores

Tipos de operación

Esta guía te ayuda a identificar qué valor debes enviar en typeOperation según el tipo de documento que estás generando.

1. Idea clave#

typeOperation no significa siempre lo mismo.
El valor permitido depende del code del documento.
Antes de elegir typeOperation, primero identifica qué documento vas a emitir.

2. Factura electrónica de venta#

Aplica para:
code: "01" Factura electrónica de venta
code: "02" Factura electrónica de venta - exportación

Valores permitidos#

typeOperationSignificado
10Estándar
11Mandatos

Ejemplos#

Factura estándar:
{
  "code": "01",
  "typeOperation": "10"
}
Factura de exportación estándar:
{
  "code": "02",
  "typeOperation": "10"
}

3. Factura electrónica de venta - sector salud#

Aplica para:
code: "01"
code: "02"
Además de typeOperation, este tipo de documento requiere el objeto healthSector.

Valores permitidos#

typeOperationSignificado
SS-CUFEOperación de salud con CUFE
SS-CUDEOperación de salud con CUDE
SS-POSOperación de salud asociada a POS
SS-SNumOperación de salud con SNum
SS-RecaudoOperación de recaudo
SS-ReporteOperación de reporte
SS-SinAporteOperación sin aporte

Ejemplo#

{
  "code": "01",
  "typeOperation": "SS-CUFE"
}

4. Factura electrónica de venta - compra y venta de divisas#

Aplica para:
code: "01"
code: "02"
Además de typeOperation, este tipo de documento requiere purchaseAndSaleCurrencies.

Valores permitidos#

typeOperationSignificado
15Compra de divisas
16Venta de divisas

Ejemplos#

Compra de divisas:
{
  "code": "01",
  "typeOperation": "15"
}
Venta de divisas:
{
  "code": "02",
  "typeOperation": "16"
}

5. Notas crédito y débito de factura electrónica#

5.1 Nota crédito#

Aplica para:
code: "91"
typeOperationSignificado
20Nota crédito que referencia una factura electrónica
22Nota crédito sin referencia a una factura electrónica
Ejemplo:
{
  "code": "91",
  "typeOperation": "20"
}

5.2 Nota débito#

Aplica para:
code: "92"
typeOperationSignificado
30Nota débito que referencia una factura electrónica
32Nota débito sin referencia a una factura electrónica
Ejemplo:
{
  "code": "92",
  "typeOperation": "30"
}

6. Documentos equivalentes electrónicos#

6.1 Documentos equivalentes con operación única#

Aplica para:
code: "20" Documento equivalente POS
code: "25" Boleta de ingreso a cine
code: "35" Tiquete de transporte terrestre
code: "40" Cobro de peajes
code: "50" Tiquete de transporte aéreo

Valor permitido#

typeOperationSignificado
10Operación estándar para estos documentos equivalentes

Ejemplo#

{
  "code": "20",
  "typeOperation": "10"
}

6.2 Boleta de ingreso a espectáculos públicos#

Aplica para:
code: "27"
typeOperationSignificado
271Estándar de espectáculos públicos de las artes escénicas
272Mandato de espectáculos públicos de las artes escénicas
273Estándar de otros espectáculos públicos
274Mandato de otros espectáculos públicos

Ejemplo#

{
  "code": "27",
  "typeOperation": "271"
}

7. Notas de ajuste de documento equivalente#

Aplica para:
code: "93" Nota de ajuste débito al documento equivalente
code: "94" Nota de ajuste crédito al documento equivalente
Aquí typeOperation no indica una modalidad. Indica el tipo de documento equivalente que estás afectando.

Valores permitidos#

typeOperationDocumento equivalente referenciado
20Documento equivalente POS
25Boleta de ingreso a cine
27Boleta de ingreso a espectáculos públicos
35Tiquete de transporte terrestre
40Cobro de peajes
50Tiquete de transporte aéreo

Ejemplo#

{
  "code": "94",
  "typeOperation": "25"
}

8. Modo contingencia#

8.1 Factura en contingencia#

Aplica para:
code: "03" Contingencia por parte del emisor
code: "04" Contingencia por parte de la DIAN
En este caso no se usa typeOperation.

Ejemplo#

{
  "code": "03"
}

8.2 Documento equivalente en contingencia#

Aplica para:
code: "07" Contingencia por parte del emisor
code: "08" Contingencia por parte de la DIAN
Aquí typeOperation indica qué documento equivalente estás emitiendo en contingencia.
typeOperationDocumento equivalente
20Documento equivalente POS
25Boleta de ingreso a cine
27Boleta de ingreso a espectáculos públicos
35Tiquete de transporte terrestre
40Cobro de peajes
50Tiquete de transporte aéreo

Ejemplo#

{
  "code": "07",
  "typeOperation": "20"
}

9. Resumen rápido#

Tipo de documentocodetypeOperation permitido
Factura electrónica de venta01, 0209, 10, 11, 12, 14
Factura sector salud01, 02SS-CUFE, SS-CUDE, SS-POS, SS-SNum, SS-Recaudo, SS-Reporte, SS-SinAporte
Factura de divisas01, 0215, 16
Nota crédito factura9120, 22
Nota débito factura9230, 32
Documento equivalente 20, 25, 35, 40, 5020, 25, 35, 40, 5010
Documento equivalente 2727271, 272, 273, 274
Nota ajuste documento equivalente93, 9420, 25, 27, 35, 40, 50
Factura en contingencia03, 04No aplica
Documento equivalente en contingencia07, 0820, 25, 27, 35, 40, 50

10. Errores comunes#

Elegir typeOperation sin revisar primero el code.
Reutilizar un typeOperation de factura en una nota o en un documento equivalente.
Enviar typeOperation: "10" para code: "27" cuando ese documento usa 271, 272, 273 o 274.
Enviar typeOperation: "93" o "94" en notas de ajuste, cuando esos valores corresponden a code.
Enviar typeOperation en factura de contingencia, 03 o 04, donde no aplica.
Modificado en 2026-04-10 14:54:31
Anterior
Tipos de documentos electrónicos
Siguiente
Tipos de persona
Built with