1. Facturas electrónicas
Muisca
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Consultar resoluciones
    • Resoluciones
      GET
  • Facturas electrónicas
    • Crear factura sector salud
      POST
    • Crear factura divisas
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
    • Crear factura electrónica
      POST
  • Documentos soporte
    • Crear documento soporte
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos equivalentes
    • Consultar por ID
      GET
    • Crear tiquete P.O.S
      POST
    • Crear tiquete de transporte terrestre
      POST
    • Crear tiquete de cine
      POST
    • Crear tiquete de cobro de peajes
      POST
    • Crear tiquete aereo
      POST
    • Crear boleta de ingreso a espectáculos públicos
      POST
    • Consultar por prefijo y consecutivo
      GET
  • Notas crédito
    • Crear nota crédito
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Notas débito
    • Crear nota débito
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Nota débito al documento equivalente
    • Crear nota débito al documento equivalente
    • 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 de ajuste al documento soporte
    • Consultar por ID
    • Consultar por prefijo y consecutivo
    • Crear nota de ajuste
  • Preguntas frecuentes
    • ¿Cómo funciona la contingencia Dian en Nitro?
    • ¿Cómo autenticarme en la API?
    • ¿Cómo pruebo antes de pasar a producción?
    • ¿Debo reenviar un documento rechazado?
    • ¿Cuál es la diferencia entre pruebas, habilitación y producción?
    • ¿Dónde obtengo la API Key?
    • ¿Qué ambientes existen?
    • ¿Qué formatos de documentos puedo enviar?
    • ¿Qué hago si la Dian rechaza un documento?
    • ¿Qué pasa cuando la Dian no responde?
    • ¿Qué significa un código de respuesta HTTP?
    • ¿Qué significa el estado DianNoDisponible?
  • 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
  • Schemas
    • Organización
      • AddCompany
      • AddUser
    • Response
    • Resolución Pos
    • FacturaRequestPOS
    • FacturaRequest
    • Productos
    • LineaProductoPeaje
    • NotasCred/Deb/Ajus
    • Sucursal
    • Supplier2
    • Dirección
    • Resolución
    • Cliente
    • Totales
    • Descuento
    • Cargos
    • Propinas
    • Transporte
    • TikectAereo
    • Cinema
    • EspectaculoPublico
    • SectorSalud
    • ComprayVentaDeDivisas
    • Retencioness
    • Impuestos
    • Mandante
  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
{
    "Id": "21158a97-2b72-4db6-8b75-4aeeefa016c6",
    "Cufe": "19dc6fbda4723595d089dcad098bfc3e25b9096c03ffe816d035ad8aa7b442f1db024a6702c4122f80b3db49c668ef88",
    "Sequence": "SETP994121930",
    "Qr": "NumFac:SETP994121930;FecFac:2026-07-01;HorFac:00:00:00-05:00;NitFac:830099008;DocAdq:1234567890;ValFac:150000.00;ValIva:28500.00;ValOtroIm:0.00;ValTolFac:178500.00;CUFE:19dc6fbda4723595d089dcad098bfc3e25b9096c03ffe816d035ad8aa7b442f1db024a6702c4122f80b3db49c668ef88;https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=19dc6fbda4723595d089dcad098bfc3e25b9096c03ffe816d035ad8aa7b442f1db024a6702c4122f80b3db49c668ef88",
    "Status": "Aprobada",
    "StatusReasons": [
        "Procesado Correctamente."
    ]
}
Modificado en 2026-08-29 16:34:33
Anterior
Crear factura sector salud
Siguiente
Consultar por ID
Built with