1. Facturas electrónicas
Muisca - API de facturación electrónica
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Consultar resoluciones
    • Resoluciones
      GET
  • Versión 2.0
    • 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
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Documentos equivalentes
      • Consultar por ID
      • 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 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
      • 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
  • Organización
    • Actualizar logo de una organización
    • Agregar una organización hija
  • Schemas
    • Organización
      • AddCompany
      • AddUser
    • Response
    • Resolución Pos
    • Respuesta de consulta de documentos - Versión 3
    • 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
Portal DIAN
  1. Facturas electrónicas

Crear factura divisas

Probando
POST
https://api.muisca.io/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 'https://api.muisca.io/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",
    "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-11-06 03:28:33
Anterior
Crear factura sector salud
Siguiente
Consultar por ID
Built with