1. Facturas electrónicas
APIs Rest de Aliaddo
  • API Nitro (Facturacón Masiva)
    • 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
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • 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 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 soporte
      • Crear nota de ajuste
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • 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
  • API ERP Cloud
    • Autenticación
    • Respuestas API
    • Límite de request
    • VENTAS
      • Facturas
        • Crear factura de venta
        • Consultar facturas
        • Consultar una factura
        • Editar factura de venta
        • Pagar factura
        • Anular una factura
      • Cotizaciones
        • Crear cotización
        • Consultar cotizaciones
        • Consultar una cotización
        • Editar cotización
        • Anular cotización
      • Ordenes de Venta
        • Crear orden de venta
        • Consultar ordenes de venta
        • Consultar una orden de venta
        • Editar orden de venta
        • Anular orden de venta
      • Remisiones
        • Crear remisión
        • Consultar remisiones
        • Consultar una remisión
        • Editar remisión
        • Anular remisión
    • COMPRAS
      • Facturas de compra
        • Consultar una factura
        • Editar factura
        • Anular una factura
        • Consultar facturas
        • Pagar factura de compra
        • Crear factura
    • Contactos
      • Consultar los contactos
      • Crear contacto
      • Eliminar un contacto
      • Consultar un contacto
      • Editar contacto
    • Productos
      • Consultar un producto
      • Eliminar un producto
      • Editar un producto
      • Crear un producto
      • Consultar los productos
      • Consultar categorías
      • Consultar unidades de medidas
      • Consultar listas de precios
      • Consultar stock
    • Bodegas
      • Consultar bodegas
    • Contabilidad
      • Consultar tipos de comprobantes
      • Crear asiento contable
      • Consultar asientos contables
      • Anular asiento contable
      • Consultar cuentas contables
      • Consultar un asiento contable
      • Consultar cuentas contables por código
      • Consultar tipos de comprobantes por código
    • Centros de costo
      • Consultar centros de costos
    • Impuestos
      • Consultar un impuesto
      • Consultar los impuestos
      • Editar impuesto
      • Crear impuesto
      • Eliminar un impuesto
    • Retenciones
      • Consultar las retenciones
      • Crear retención
      • Eliminar una retención
      • Editar retención
    • Sucursales
      • Consultar sucursales
    • Vendedores
      • Lista de vendedores
    • Usuarios
      • Consultar usuarios
    • CRM
      • Deals
        • Crear negocio
        • Consultar negocios
        • Editar negocio
        • Eliminar un negocio
      • Leads
        • Consultar Leads
        • Crear lead
        • Consultar etapas del ciclo de vida
        • Editar lead
        • Eliminar lead
      • Territorios
        • Consultar territorios
      • Pipelines
        • Consultar procesos
        • Consultar etapas de un proceso
      • Fuentes
        • Consultar fuentes
      • Activities
        • Crear actividad
        • Consultar actividades
        • Consultar actividades
        • Editar actividad
        • Eliminar actividad
      • Consultar propietarios
  • APIs Heredadas (Legacy)
    • API FE de primera generación
      • Introducción
      • Cuotas y Límites
      • Primeros Pasos
        • Consideraciones Importantes
        • Manual Operativo de la Plataforma
        • Generar X-API-KEY
        • Librerías
        • Formatos PDF
        • Diccionario de Datos
          • Sobre el Diccionario de Datos
          • Factura
          • Nota Crédito
          • Nota Débito
          • Documento Soporte
          • Nota de Ajuste
          • Listas de Códigos
            • Sobre las Listas de Códigos
            • Códigos de Factura
            • Códigos de Nota Crédito
            • Códigos de Nota Débito
            • Códigos de Actividades Económicas
            • Códigos de Ciudad
            • Códigos de Forma de Pago
            • Códigos de Moneda
            • Códigos de País
            • Códigos de Región
            • Códigos de Unidades de Medida
            • Códigos de Responsabilidad Fiscal
      • Errores y Rechazos
        • Errores Comunes
        • Códigos de Rechazo y Advertencia de la DIAN
          • Códigos de Rechazo y Advertencia de la DIAN
          • Rechazos de Factura
          • Rechazos de Nota Crédito
          • Rechazos de Nota Débito
      • Modo Pruebas
        • Enviar Factura a Pruebas
        • Enviar Nota Crédito a Pruebas
        • Enviar Nota Débito a Pruebas
        • Enviar Documento Soporte a Pruebas
        • Enviar Nota de Ajuste a Pruebas
      • Modo Habilitacion
        • Enviar Factura para Habilitación
        • Enviar Nota Crédito para Habilitación
        • Enviar Nota Débito para Habilitación
      • produccion
        • Documento sin título
        • Documento sin título
        • Documento sin título
        • Documento sin título
        • Documento sin título
      • archivo-plano.csv
        • Importar archivo plano
        • Consideraciones sobre el archivo plano
        • estructura-del-archivo-plano
          • Factura
          • Nota crédito
          • Nota débito
          • Estructura del archivo plano
    • API Nómina de primera generación
      • Table of contents
      • Cuotas y límites
      • Introducción
      • primeros-pasos
        • Documento sin título
        • estructura-de-los-datos
          • Documento sin título
          • Documento sin título
          • Documento sin título
          • Estructura de los datos
          • listas-de-codigos
            • Códigos de ciudad
            • Códigos de moneda
            • Códigos de municipio
            • Códigos de país
            • Códigos de departamento
            • Documento de identificación
            • Medios de pago
            • Periodo de Nómina
            • Listas de códigos
            • Subtipo de Trabajador
            • Tipo de contrato
            • Tipo de Hora Extra o Recargo: Porcentaje
            • Tipo de Incapacidad
            • Tipo de trabajador
      • modo-produccion
        • reemplazar-nomina
          • Enviar reemplazo de nómina para producción
          • Reemplazar Nómina
        • enviar-nomina
          • Enviar documento para producción
          • Enviar Nómina
        • eliminar-nomina
          • Eliminación de nómina para producción
          • Eliminar Nómina
      • modo-habilitacion
        • untitled-1
          • Enviar reemplazo de nómina en habilitación
          • Reemplazar Nómina
        • enviar-nomina
          • Enviar documento para habilitación
          • Enviar Nómina
        • eliminar-nomina
          • Eliminación de nómina en habilitación
          • Eliminar Nómina
      • modo-pruebas
        • untitled
          • Enviar documento para pruebas
          • Enviar Nómina
        • reemplazar-nomina
          • Enviar reemplazo de nómina para pruebas
          • Reemplazar Nómina
        • eliminar-nomina
          • Eliminación de nómina para pruebas
          • Eliminar Nómina
  • Schemas
    • Documentos electrónicos
      • FacturaElectronica
      • Divisas
      • DocumentoSoporteRequest
      • DocumentoEquivalenteRequest
      • BoletaEspectaculosRequest
    • Schemas ERP Cloud API
    • ISV Legacy
      • Factura Electrónica
      • Sucursal
      • Resolución
      • Cliente
      • Detalle
      • Descuentos
      • Cargos
      • Impuestos
      • Retenciones
      • Mandante
      • Total
      • Campos Personalizados
      • Nota Crédito
      • Nota Débito
      • Documento Soporte
      • Nota de Ajuste
      • Proveedor
    • 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. Facturas electrónicas

Crear factura divisas

Probando
POST
/v2/documents/invoices
Genera una factura electrónica para operaciones de compra/venta de divisas. Permite registrar transacciones en moneda extranjera con tasa de cambio, según normativa de la DIAN para agencias de cambio autorizadas.
Ver guía

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Success
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/v2/documents/invoices' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "code": "01",
  "typeOperation": "15",
  "mode": "Test",
  "format": "Estandar",
  "size": "Estandar",
  "testSetId": "0e3d0669-03ed-4f70-a237-c9541d22c5a1",
  "prefix": "SETP",
  "consecutive": 1,
  "orderReference": "ORD-2025-001",
  "currencyCode": "COP",
  "currencyRate": 0,
  "issuedAt": "2026-03-10",
  "dueAt": "2026-03-10",
  "periodStartDate": "2026-03-10",
  "periodEndDate": "2026-03-10",
  "deliveryAt": "2026-03-10",
  "deliveryTerms": "Entrega en puerta",
  "terms": "Términos y condiciones comerciales",
  "termDay": 30,
  "paymentMeanCode": "10",
  "sellerName": "Juan Vendedor",
  "branch": {
    "name": "Sucursal Principal",
    "address": "Calle Ficticia 123, Edificio Empresarial",
    "regionCode": "11",
    "regionName": "Departamento Ejemplo",
    "cityCode": "11001",
    "cityName": "Ciudad Ejemplo",
    "phone": "1234567890"
  },
  "resolution": {
    "key": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
    "prefix": "SETP",
    "number": 18760000001,
    "rangeInitial": 990000000,
    "rangeFinal": 995000000,
    "validFrom": "2019-01-19",
    "validUntil": "2030-01-19"
  },
  "customer": {
    "companyName": "Mi empresa S.A",
    "personType": "2",
    "regimeType": "49",
    "firstName": "Nombres del cliente",
    "lastName": "Apellidos del cliente",
    "identification": "1234567890",
    "digitCheck": "2",
    "identificationTypeCode": "13",
    "email": "clienteemail@gmail.com",
    "phone": "1234567890",
    "responsibleFor": "ZZ",
    "responsibilities": "R-99-PN",
    "BillingAddress": {
      "address": "Tu dirección 01 #02-03",
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001",
      "postalCode": "110011",
      "neighborhood": "Chapinero",
      "phone": "1234567890",
      "contactName": "Nombre Contacto"
    },
    "ShippingAddress": {
      "address": "Tu dirección 01 #02-03",
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001",
      "postalCode": "110011",
      "neighborhood": "Chapinero",
      "phone": "1234567890",
      "contactName": "Nombre Contacto"
    }
  },
  "lines": [
    {
      "code": "PROD001",
      "name": "Producto número 1",
      "modelName": "Modelo Prueba",
      "description": "Descrpción del producto número 1",
      "brandName": "Marca1",
      "itemCodeSupplier": "Supplier123",
      "unitMeasurementCode": "94",
      "unitMeasurementName": "Unidad",
      "price": 10000,
      "quantity": 5,
      "discountAmount": 5000,
      "chargeAmount": 5000,
      "standardType": "001",
      "standardCode": "10101501",
      "discounts": [
        {
          "name": "Descuento por volumen",
          "type": "P",
          "rate": 10,
          "amount": 1000
        }
      ],
      "charges": [
        {
          "name": "Costo de envío",
          "type": "F",
          "rate": 1000,
          "amount": 1000
        }
      ],
      "taxes": [
        {
          "name": "IVA",
          "code": "01",
          "type": "P",
          "rate": 19,
          "amount": 1900,
          "base": 10000
        }
      ],
      "withholdings": [
        {
          "name": "ReteIVA",
          "code": "05",
          "type": "P",
          "rate": 15,
          "amount": 285,
          "base": 1900
        }
      ]
    }
  ],
  "totals": {
    "amount": 50000,
    "prepaymentAmount": 0,
    "taxesAmount": 9500,
    "withholdingAmount": 1425,
    "discountsAmount": 0,
    "chargesAmount": 0
  },
  "notes": [
    "Nota importante 1",
    "Nota importante 2"
  ],
  "remark": "Comentarios adicionales",
  "purchaseAndSaleCurrencies": {
    "code": "01"
  }
}'
Respuesta Ejemplo de Respuesta
{}
Modificado en 2026-06-03 14:44:29
Anterior
Crear factura sector salud
Siguiente
Consultar por ID
Built with