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 sector salud

Probando
POST
/v2/documents/invoices
Crea una factura electrónica especializada para el Sector salud. Incluye campos específicos como códigos de servicios médicos, planes de cobertura, copagos y datos del prestador de servicios de salud.
Ver guía

Solicitud

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

Ejemplos

Respuestas

🟢200OK
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": "SS-CUDE",
    "mode": "Test",
    "format": "Estandar",
    "testSetId": "550e8400-e29b-41d4-a716-446655440001",
    "prefix": "SETP",
    "consecutive": 994110417,
    "orderReference": "53279097",
    "currencyCode": "COP",
    "currencyRate": 0,
    "issuedAt": "2026-02-10",
    "dueAt": "2026-02-10",
    "periodStartDate": "2026-02-10",
    "periodEndDate": "2026-02-10",
    "deliveryAt": "2026-02-10",
    "deliveryTerms": "Entrega del producto en la puerta de la casa",
    "terms": "Este es mi termino y condiciones",
    "termDay": 30,
    "paymentMeanCode": "10",
    "sellerName": "Juan Vendedor",
    "branch": {
        "name": "Sucursal Centro / Punto de Venta Norte / Oficina Principal",
        "address": "Dirección de la sucursal",
        "regionCode": "11",
        "regionName": "Bogotá",
        "cityCode": "11001",
        "cityName": "BOGOTÁ. D.C. (DC)",
        "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",
        "economicActivities": "7020;5140",
        "BillingAddress": {
            "address": "Dirección del cliente",
            "countryName": "Colombia",
            "countryCode": "CO",
            "regionName": "Bogotá",
            "regionCode": "11",
            "cityName": "Bogotá",
            "cityCode": "11001",
            "postalCode": "11001",
            "neighborhood": "Las mercedes",
            "phone": "1234567890",
            "contactName": "Alexandra Champlin"
        },
        "ShippingAddress": {
            "address": "Direccion de entrega del cliente",
            "countryName": "Colombia",
            "countryCode": "CO",
            "regionName": "Bogotá",
            "regionCode": "11",
            "cityName": "Bogotá",
            "cityCode": "11001",
            "postalCode": "11001",
            "neighborhood": "Las mercedes",
            "phone": "1234567890",
            "contactName": "Megan Jones MD"
        }
    },
    "lines": [
        {
            "standardType": "001",
            "standardCode": "123",
            "code": "e",
            "name": "Producto número 1",
            "modelName": "Modelo Prueba",
            "description": "descripcion del producto numero 1",
            "brandName": "Marca1",
            "itemCodeSupplier": "Supplier123",
            "unitMeasurementCode": "94",
            "unitMeasurementName": "Unidad",
            "price": 5000,
            "quantity": 1,
            "discountAmount": 500,
            "chargeAmount": 800,
            "taxes": [
                {
                    "name": "Iva",
                    "code": "01",
                    "type": "P",
                    "rate": 19,
                    "amount": 1007,
                    "base": 5300
                }
            ],
            "withholdings": [
                {
                    "name": "Rete Fuente",
                    "code": "06",
                    "type": "P",
                    "rate": 2.5,
                    "amount": 132.5,
                    "base": 5300
                }
            ],
            "charges": [
                {
                    "name": "Mi cargo",
                    "type": "F",
                    "rate": 0,
                    "amount": 800
                }
            ],
            "discounts": [
                {
                    "name": "Mi descuento",
                    "type": "P",
                    "rate": 10,
                    "amount": 500
                }
            ]
        }
    ],
    "totals": {
        "amount": 5300,
        "prepaymentAmount": 0,
        "taxesAmount": 1007,
        "withholdingAmount": 132.5,
        "discountsAmount": 0,
        "chargesAmount": 0
    },
    "notes": [
        "Esta es mi nota del documento"
    ],
    "remark": "Estos son mis comentarios del documento",
    "healthSector": {
        "serviceProviderCode": "0123456789",
        "paymentMethod": "Pago individual por caso",
        "coverageOrBenefitPlan": "01",
        "contractNumber": "031554",
        "policyNumber": "256489782",
        "copayment": 0,
        "moderatorFee": 0,
        "sharedPaymentsInVoluntaryPlans": 0,
        "advance": 0,
        "startDateService": "2025/02/17",
        "endDateService": "2025/02/17"
    }
}'
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
Resoluciones
Siguiente
Crear factura divisas
Built with