Método: POST
EndPoint:
Pruebas
https://servicios-pruebas.afacturar.com/api/rips/cargar_nota_ajuste
Producción
https://servicios.afacturar.com/api/rips/cargar_nota_ajuste
Seguridad SSL: Afacturar cuenta en sus endpoint con certificados de seguridad (DigiCert SHA2 Extended Validation Server CA), su aplicación debe ser capaz de negociar y validar dicho certificado.
Las notas de ajuste RIPS permiten corregir la información de los servicios de salud reportados, sin modificar la factura electrónica original. El valor total de los RIPS ajustados debe coincidir con el valor total de la factura electrónica asociada. Si la corrección implica modificar el valor de la factura, deberá realizarse el proceso de nota crédito correspondiente..
Accept: application/json
Authorization: Bearer Token asignado a cada cliente
documento_obligado: Número de identificación del cliente
data: JSON
json_rips: JSON
| informacion_documento | Objeto | Requerido | ||||||||||||||||||||||||
|
Información del documento electronico Especificación: |
||||||||||||||||||||||||||
|
||||||||||||||||||||||||||
| informacion_documento_referencia | Objeto | Requerido | ||||||||||||||||||||||||||||||
|
Información del documento electronico de referencia, es decir la factura Especificación: |
||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||
| generalidades | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||
|
Generalidades Especificación: |
||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||
{
"informacion_documento": {
"numero_documento": "",
"fecha_documento": ""
},
"informacion_documento_referencia": {
"cufe_cude": "",
"fecha_documento": "",
"numero_documento": ""
},
"generalidades": {
"tipo_ambiente_dian": "",
"identificador_transmision": "",
"integrador": {
"nombre": "",
"tipo": ""
}
}
}
| numDocumentoldObligado | String | Requerido |
|
Número del NIT con el cual se identifique el facturador electrónico en salud. Especificación: |
||
| numFactura | String | No_Requerido |
|
Número que corresponda al sistema de numeración consecutiva según las disposiciones de la DIAN Especificación: |
||
| tipoNota | String - Parametrizado | Requerido |
|
Tipo de nota débito o crédito, o nota ajuste RIPS que se requiere realizar para un ajuste contable o en las facturas, ya sea por errores o por el cambio de condiciones que generan un mayor o menor valor monetario de la respectiva cuenta o la necesidad de ajustar RIPS en aquellos casos cuando no exista ajuste en el valor monetario Especificación: Valor => NC |
||
| numNota | String | Requerido |
|
Número de la nota crédito, débito o nota ajuste RIPS emitida por el facturador electrónico en salud. Si utiliza prefijo + numero Especificación: Minimo de 1 caracter |
||
| usuarios | array | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Datos del usuario Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| consultas | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
consultas Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| procedimientos | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
procedimientos Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| urgencias | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
urgencias Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hospitalizacion | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
hospitalizacion Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recienNacidos | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
recienNacidos Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| medicamentos | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
medicamentos Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| otros_servicios | Objeto | Requerido | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
otros servicios Especificación: |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{
"numDocumentoIdObligado": "",
"numFactura": "",
"tipoNota": "",
"numNota": "",
"usuarios": [
{
"tipoDocumentoIdentificacion": "",
"numDocumentoIdentificacion": "",
"tipoUsuario": "",
"fechaNacimiento": "",
"codSexo": "",
"codPaisResidencia": "",
"codMunicipioResidencia": "",
"codZonaTerritorialResidencia": "",
"incapacidad": "",
"consecutivo": "",
"codPaisOrigen": "",
"registroSIRAS": null,
"servicios": {
"consultas": [
{
"codPrestador": "",
"fechaInicioAtencion": "",
"numAutorizacion": "",
"codConsulta": "",
"modalidadGrupoServicioTecSal": "",
"grupoServicios": "",
"codServicio": "",
"finalidadTecnologiaSalud": "",
"causaMotivoAtencion": "",
"codDiagnosticoPrincipal": "",
"codDiagnosticoPrincipalCIE11": "",
"nomCodDiagnosticoPrincipalCIE11": "",
"codDiagnosticoRelacionado1": null,
"codDiagnosticoRelacionado1CIE11": "",
"nomCodDiagnosticoRelacionado1CIE11": "",
"codDiagnosticoRelacionado2": null,
"codDiagnosticoRelacionado2CIE11": null,
"nomCodDiagnosticoRelacionado2CIE11": null,
"codDiagnosticoRelacionado3": null,
"codDiagnosticoRelacionado3CIE11": "",
"nomCodDiagnosticoRelacionado3CIE11": "",
"tipoDiagnosticoPrincipal": "",
"tipoDocumentoIdentificacion": "",
"numDocumentoIdentificacion": "",
"vrServicio": 0,
"conceptoRecaudo": "",
"valorPagoModerador": 0,
"numFEVPagoModerador": null,
"codigoVIDA": null,
"consecutivo": 0
}
],
"procedimientos": [
{
"codPrestador": "",
"fechaInicioAtencion": "",
"idMIPRES": null,
"numAutorizacion": null,
"codProcedimiento": "",
"viaIngresoServicioSalud": "",
"modalidadGrupoServicioTecSal": "",
"grupoServicios": "",
"codServicio": "",
"finalidadTecnologiaSalud": "",
"tipoDocumentoIdentificacion": "",
"numDocumentoIdentificacion": "",
"codDiagnosticoPrincipal": "",
"codDiagnosticoPrincipalCIE11": "",
"nomCodDiagnosticoPrincipalCIE11": "",
"codDiagnosticoRelacionado": "",
"codDiagnosticoRelacionadoCIE11": "",
"nomCodDiagnosticoRelacionadoCIE11": "",
"codComplicacion": "",
"codComplicacionCIE11": "",
"nomComplicacionCIE11": "",
"vrServicio": 0,
"conceptoRecaudo": "0",
"valorPagoModerador": 0,
"numFEVPagoModerador": "",
"codigoVIDA": "",
"consecutivo": 0
}
],
"urgencias": [
{
"codPrestador": "",
"fechaInicioAtencion": "",
"causaMotivoAtencion": "",
"codDiagnosticoPrincipal": "",
"codDiagnosticoPrincipalCIE11": "",
"nomCodDiagnosticoPrincipalCIE11": "",
"codDiagnosticoPrincipalE": "",
"codDiagnosticoPrincipalECIE11": "",
"nomCodDiagnosticoPrincipalECIE11": "",
"codDiagnosticoRelacionadoE1": null,
"codDiagnosticoRelacionado1CIE11": "",
"nomCodDiagnosticoRelacionado1CIE11": "",
"codDiagnosticoRelacionadoE2": null,
"codDiagnosticoRelacionado2CIE11": "",
"nomCodDiagnosticoRelacionado2CIE11": "",
"codDiagnosticoRelacionadoE3": null,
"codDiagnosticoRelacionado3CIE11": "",
"nomCodDiagnosticoRelacionado3CIE11": "",
"condicionDestinoUsuarioEgreso": "",
"codDiagnosticoCausaMuerte": null,
"fechaEgreso": "",
"codigoVIDA": "",
"consecutivo": 0
}
],
"hospitalizacion": [
{
"codPrestador": "",
"viaIngresoServicioSalud": "",
"fechaInicioAtencion": "",
"numAutorizacion": "",
"causaMotivoAtencion": "",
"codDiagnosticoPrincipal": "",
"codDiagnosticoPrincipalCIE11": "",
"nomCodDiagnosticoPrincipalCIE11": "",
"codDiagnosticoPrincipalE": "",
"codDiagnosticoPrincipalECIE11": "",
"nomCodDiagnosticoPrincipalECIE11": "",
"codDiagnosticoRelacionadoE1": null,
"codDiagnosticoRelacionado1CIE11": "",
"nomCodDiagnosticoRelacionado1CIE11": "",
"codDiagnosticoRelacionadoE2": null,
"codDiagnosticoRelacionado2CIE11": "",
"nomCodDiagnosticoRelacionado2CIE11": "",
"codDiagnosticoRelacionadoE3": null,
"codDiagnosticoRelacionado3CIE11": "",
"nomCodDiagnosticoRelacionado3CIE11": "",
"codComplicacion": null,
"codComplicacionCIE11": "",
"nomComplicacionCIE11": "",
"condicionDestinoUsuarioEgreso": "",
"codDiagnosticoCausaMuerte": null,
"fechaEgreso": "",
"codigoVIDA": "",
"consecutivo": 0
}
],
"recienNacidos": [
{
"codPrestador": "",
"tipoDocumentoIdentificacion": "",
"numDocumentoIdentificacion": "",
"fechaNacimiento": "",
"edadGestacional": 0,
"numConsultasCPrenatal": 0,
"codSexoBiologico": "",
"peso": 0,
"codDiagnosticoPrincipal": "",
"condicionDestinoUsuarioEgreso": "",
"codDiagnosticoCausaMuerte": null,
"fechaEgreso": "",
"codigoVIDA": "",
"consecutivo": 1
}
],
"medicamentos": [
{
"codPrestador": "",
"idMIPRES": "",
"fechaDispensAdmon": "",
"codDiagnosticoPrincipal": "",
"codDiagnosticoPrincipalCIE11": null,
"nomCodDiagnosticoPrincipalCIE11": null,
"codDiagnosticoRelacionado": null,
"codDiagnosticoRelacionadoCIE11": null,
"nomCodDiagnosticoRelacionadoCIE11": null,
"tipoMedicamento": "",
"codTecnologiaSalud": "",
"nomTecnologiaSalud": null,
"concentracionMedicamento": 0,
"unidadMedida": 0,
"formaFarmaceutica": "",
"unidadMinDispensa": 0,
"cantidadMedicamento": 0,
"diasTratamiento": 0,
"tipoDocumentoIdentificacion": "",
"numDocumentoIdentificacion": "",
"vrUnitMedicamento": 0,
"vrDispensacion": 0,
"vrServicio": 0,
"conceptoRecaudo": "",
"valorPagoModerador": 0,
"numFEVPagoModerador": "",
"consecutivo": 1,
"codigoVIDA": ""
}
]
}
}
]
}
{
"codigo_error": 0,
"descripcion_error": "OK",
"tiempo_ejecucion": 2.8475100994110109,
"transaccion": "5e5e5e5e5e55e",
"resultado": {
"cuv": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"fecha_radicacion": "2025-10-01 00:00"
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
{
"codigo_error": 400,
"descripcion_error": "Parametro de entrada json_rips",
"tiempo_ejecucion": 0.068549156188964844,
"resultado": [
{
"propiedad": "tipoNota",
"descripcion": "json_rips => The property tipoNota is required"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO"
}
{
"codigo_error": 400,
"descripcion_error": "Parametro de entrada json_rips",
"tiempo_ejecucion": 0.068549156188964844,
"resultado": [
{
"propiedad": "usuarios[0].tipoDocumentoIdentificacion",
"descripcion": "json_rips => Does not have a value in the enumeration [\"CC\",\"CE\",\"CD\",\"PA\",\"PE\",\"RC\",\"TI\",\"CN\",\"AS\",\"MS\",\"DE\",\"SI\",\"NI\",\"NV\",\"PT\",\"SC\"]"
},
{
"propiedad": "usuarios[0].codSexo",
"descripcion": "json_rips => Does not have a value in the enumeration [\"M\",\"H\",\"I\"]"
},
{
"propiedad": "",
"descripcion": "json_rips => The property numFactra is not defined and the definition does not allow additional properties"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO"
}
{
"codigo_error": 500,
"descripcion_error": "Unauthenticated."
}
JSON data
{
"informacion_documento": {
"numero_documento": "NA2026111",
"fecha_documento": "2026-11-19"
},
"informacion_documento_referencia": {
"cufe_cude": "ec26637824ff0cf9c94ec37bde3fdbac04b90f130573e61e48cf78df201e74909e24a6ad0aece2bb6994b51491a4d5cb",
"fecha_documento": "2026-11-09",
"numero_documento": "SETT754"
},
"generalidades": {
"tipo_ambiente_dian": 2,
"identificador_transmision": "2026-11-19 12:47:22",
"integrador": {
"nombre": "WEB",
"tipo": "WEB"
}
}
}
JSON RIPS
{
"numDocumentoIdObligado": "11223344",
"numFactura": "SETT28",
"tipoNota": "NA",
"numNota": "NA1",
"usuarios": [
{
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "10101010101",
"tipoUsuario": "01",
"fechaNacimiento": "1990-08-02",
"codSexo": "F",
"codPaisResidencia": "170",
"codMunicipioResidencia": "41001",
"codZonaTerritorialResidencia": "02",
"incapacidad": "NO",
"consecutivo": 1,
"codPaisOrigen": "170",
"servicios": {
"consultas": [
{
"codPrestador": "111111111111",
"fechaInicioAtencion": "2025-01-22 13:20",
"numAutorizacion": "2000272",
"codConsulta": "890242",
"modalidadGrupoServicioTecSal": "01",
"grupoServicios": "01",
"codServicio": 308,
"finalidadTecnologiaSalud": "44",
"causaMotivoAtencion": "38",
"codDiagnosticoPrincipal": "B86X",
"codDiagnosticoRelacionado1": null,
"codDiagnosticoRelacionado2": null,
"codDiagnosticoRelacionado3": null,
"tipoDiagnosticoPrincipal": "01",
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "7691730",
"vrServicio": 149000,
"conceptoRecaudo": "03",
"valorPagoModerador": 87000,
"numFEVPagoModerador": null,
"consecutivo": 1
}
]
}
}
]
}
Cuando usted hace un llamado a la API, puede recibir los siguientes mensajes de error en la respuesta. Puede que haya algo mal con su solicitud o puede que algo esté mal de nuestra parte. Los errores responden con un código de error y JSON que contiene un mensaje, una descripción y un código API más preciso.
| Código | Estado | Descripción | Acción sugerida |
|---|---|---|---|
| 28 | Timeout | La operación duro más de 60 seg | |
| 15 | Error retornado por la DIAN | La información enviada no cumple con el estandar del XML o los valores no estan bien calculados | |
| 400 | Solicitud incorrecta | Hay un problema con su solicitud | Compruebe que su solicitud sigue la documentación de la API y utiliza la sintaxis correcta. |
| 401 | No autorizado | No tiene la autorización necesaria para realizar la solicitud. | Asegúrese de estar utilizando una clave API válida con los permisos necesarios para su solicitud. |
| 403 | Prohibido | El servidor entendió la solicitud, pero se negó a cumplirla. | Vea si su plan en Afacturar.com incluye el recurso que está solicitando y su clave API tiene las autorizaciones necesarias. |
| 404 | No encontrado | El servidor no pudo encontrar el recurso solicitado. | Cambie su URL de solicitud para que coincida con un punto final API válido. |
| 405 | Método no permitido | El recurso no tiene el método especificado. (por ejemplo, PUT en las transmisiones) | Cambie el método para seguir la documentación del recurso. |
| 409 | Conflicto | Un conflicto surgió de su solicitud. (por ejemplo, el OFE no esta asociado al código de autorización) | Modificar la carga útil para eliminar el conflicto.. |
| 415 | Tipo de medio no admitido | La solicitud no está en un formato compatible. | Verifique que su encabezado Content-Type sea compatible y que su solicitud cumpla con la documentación. |
| 422 | Entidad no procesable | La solicitud fue sintácticamente correcta pero falló debido a errores semánticos. | Asegúrese de que su solicitud incluya todos los campos obligatorios y que sus datos sean válidos. |
| 429 | Exceder el límite de envío | Se excede el numero de transacciones permitido (120 por minuto). | Verifique que se encuentra dentro de los límites acordados con Afacturar. |
| 500 | Error de servidor interno | Algo salió mal de nuestro lado. | Pruebe la solicitud nuevamente más tarde. Si el error no se resuelve, póngase en contacto con el soporte técnico soporte@afacturar.com. |
| 503 | Servicio no disponible | Estamos experimentando niveles de tráfico más altos de lo normal. | Prueba la solicitud nuevamente, ya estamos enterado del problema para aumentar la capacidad. |
curl --location 'https://servicios-pruebas.afacturar.com/api/rips/cargar_nota_ajuste' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN_OBLIGADO' \
--header 'Content-Type: multipart/form-data; boundary=' \
--form 'documento_obligado="830020470"' \
--form 'data="{
\"informacion_documento\": {
\"numero_documento\": \"NA2026111\",
\"fecha_documento\": \"2026-11-19\"
},
\"informacion_documento_referencia\": {
\"cufe_cude\": \"ec26637824ff0cf9c94ec37bde3fdbac04b90f130573e61e48cf78df201e74909e24a6ad0aece2bb6994b51491a4d5cb\",
\"fecha_documento\": \"2026-11-09\",
\"numero_documento\": \"SETT754\"
},
\"generalidades\": {
\"tipo_ambiente_dian\": 2,
\"identificador_transmision\": \"2026-11-19 12:47:22\",
\"integrador\": {
\"nombre\": \"WEB\",
\"tipo\": \"WEB\"
}
}
}"' \
--form 'json_rips="{
\"numDocumentoIdObligado\": \"830020470\",
\"numFactura\": \"SETT754\",
\"tipoNota\": \"NA\",
\"numNota\": \"NA2026111\",
\"usuarios\": [
{
\"tipoDocumentoIdentificacion\": \"TI\",
\"numDocumentoIdentificacion\": \"12345678\",
\"tipoUsuario\": \"12\",
\"fechaNacimiento\": \"2019-05-08\",
\"codSexo\": \"M\",
\"codPaisResidencia\": \"170\",
\"codMunicipioResidencia\": \"11001\",
\"codZonaTerritorialResidencia\": \"02\",
\"incapacidad\": \"NO\",
\"consecutivo\": 1,
\"codPaisOrigen\": \"170\",
\"registroSIRAS\": null,
\"servicios\": {
\"consultas\": [
{
\"codPrestador\": \"66666666666\",
\"fechaInicioAtencion\": \"2026-10-02 00:00\",
\"numAutorizacion\": \"\",
\"codConsulta\": \"232403\",
\"modalidadGrupoServicioTecSal\": \"01\",
\"grupoServicios\": \"01\",
\"codServicio\": 1102,
\"finalidadTecnologiaSalud\": \"16\",
\"causaMotivoAtencion\": \"26\",
\"codDiagnosticoPrincipal\": \"K028\",
\"codDiagnosticoPrincipalCIE11\": null,
\"nomCodDiagnosticoPrincipalCIE11\": null,
\"codDiagnosticoRelacionado1\": null,
\"codDiagnosticoRelacionado1CIE11\": null,
\"nomCodDiagnosticoRelacionado1CIE11\": null,
\"codDiagnosticoRelacionado2\": null,
\"codDiagnosticoRelacionado2CIE11\": null,
\"nomCodDiagnosticoRelacionado2CIE11\": null,
\"codDiagnosticoRelacionado3\": null,
\"codDiagnosticoRelacionado3CIE11\": null,
\"nomCodDiagnosticoRelacionado3CIE11\": null,
\"tipoDiagnosticoPrincipal\": \"02\",
\"tipoDocumentoIdentificacion\": \"CC\",
\"numDocumentoIdentificacion\": \"2369789\",
\"vrServicio\": 500000,
\"conceptoRecaudo\": \"05\",
\"valorPagoModerador\": 0,
\"numFEVPagoModerador\": \"SETT754\",
\"codigoVIDA\": null,
\"consecutivo\": 1
}
]
}
}
]
}"'
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://servicios-pruebas.afacturar.com/api/rips/cargar_nota_ajuste");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer TOKEN_OBLIGADO");
var content = new MultipartFormDataContent();
content.Add(new StringContent("830020470"), "documento_obligado");
content.Add(new StringContent("{
\"informacion_documento\": {
\"numero_documento\": \"NA2026111\",
\"fecha_documento\": \"2026-11-19\"
},
\"informacion_documento_referencia\": {
\"cufe_cude\": \"ec26637824ff0cf9c94ec37bde3fdbac04b90f130573e61e48cf78df201e74909e24a6ad0aece2bb6994b51491a4d5cb\",
\"fecha_documento\": \"2026-11-09\",
\"numero_documento\": \"SETT754\"
},
\"generalidades\": {
\"tipo_ambiente_dian\": 2,
\"identificador_transmision\": \"2026-11-19 12:47:22\",
\"integrador\": {
\"nombre\": \"WEB\",
\"tipo\": \"INTRANET\"
}
}
}"), "data");
content.Add(new StringContent("{
\"numDocumentoIdObligado\": \"830020470\",
\"numFactura\": \"SETT754\",
\"tipoNota\": \"NA\",
\"numNota\": \"NA2026111\",
\"usuarios\": [
{
\"tipoDocumentoIdentificacion\": \"TI\",
\"numDocumentoIdentificacion\": \"12345678\",
\"tipoUsuario\": \"12\",
\"fechaNacimiento\": \"2019-05-08\",
\"codSexo\": \"M\",
\"codPaisResidencia\": \"170\",
\"codMunicipioResidencia\": \"11001\",
\"codZonaTerritorialResidencia\": \"02\",
\"incapacidad\": \"NO\",
\"consecutivo\": 1,
\"codPaisOrigen\": \"170\",
\"registroSIRAS\": null,
\"servicios\": {
\"consultas\": [
{
\"codPrestador\": \"6666666\",
\"fechaInicioAtencion\": \"2026-10-02 00:00\",
\"numAutorizacion\": \"\",
\"codConsulta\": \"232403\",
\"modalidadGrupoServicioTecSal\": \"01\",
\"grupoServicios\": \"01\",
\"codServicio\": 1102,
\"finalidadTecnologiaSalud\": \"16\",
\"causaMotivoAtencion\": \"26\",
\"codDiagnosticoPrincipal\": \"K028\",
\"codDiagnosticoPrincipalCIE11\": null,
\"nomCodDiagnosticoPrincipalCIE11\": null,
\"codDiagnosticoRelacionado1\": null,
\"codDiagnosticoRelacionado1CIE11\": null,
\"nomCodDiagnosticoRelacionado1CIE11\": null,
\"codDiagnosticoRelacionado2\": null,
\"codDiagnosticoRelacionado2CIE11\": null,
\"nomCodDiagnosticoRelacionado2CIE11\": null,
\"codDiagnosticoRelacionado3\": null,
\"codDiagnosticoRelacionado3CIE11\": null,
\"nomCodDiagnosticoRelacionado3CIE11\": null,
\"tipoDiagnosticoPrincipal\": \"02\",
\"tipoDocumentoIdentificacion\": \"CC\",
\"numDocumentoIdentificacion\": \"2369789\",
\"vrServicio\": 500000,
\"conceptoRecaudo\": \"05\",
\"valorPagoModerador\": 0,
\"numFEVPagoModerador\": \"SETT754\",
\"codigoVIDA\": null,
\"consecutivo\": 1
}
]
}
}
]
}"), "json_rips");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
| Versión | Cambios | Fecha de liberación |
|---|---|---|
| 1 | Publicación del API | 11 de noviembre de 2026 |