Método: POST
EndPoint:
Pruebas
https://servicios-pruebas.afacturar.com/api/rips/cargar_fe_rips
Producción
https://servicios.afacturar.com/api/rips/cargar_fe_rips
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.
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: |
||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||
| generalidades | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||
|
Generalidades Especificación: |
||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||
{
"informacion_documento": {
"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 | No_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: |
||
| numNota | String | No_Requerido |
|
Número de la nota crédito, débito o nota ajuste RIPS emitida por el facturador electrónico en salud. Especificación: |
||
| 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": null,
"numNota": null,
"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": "numFactura",
"descripcion": "json_rips => The property numFactura 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": {
"cufe_cude": "be27ab71fea9c9fd8c01231235d221115d063a9be5b618d97597cb5792d86f857fe12345667890ca99f3613d3f6b7a97af",
"fecha_documento": "2025-01-30",
"numero_documento": "SETT28"
},
"generalidades": {
"tipo_ambiente_dian": 2,
"identificador_transmision": "20250130",
"integrador": {
"nombre": "WEB",
"tipo": "WEB"
}
}
}
JSON factura
{
"facturas": [
{
"encabezado": {
"id_factura": "28",
"fecha": "2025-01-29",
"hora": "16:15:15",
"nota": [
"{'SON':'PESOS MCTE.'",
"'variable':'0'}'"
],
"moneda": "COP",
"tipo_factura": 10,
"metodo_de_pago": 2,
"tipo_de_pago": 45,
"numero_orden": "",
"numero_resolucion_facturacion": "18760000001",
"fecha_vencimiento": "2025-02-27",
"prefijo": "SETT"
},
"sector": {
"tipo": "SALUD",
"tipo_operacion": "SS-CUFE",
"coleccion": [
{
"nombre": "usuario",
"informacion_adicional": [
{
"variable": "CODIGO_PRESTADOR",
"valor": "111111111111"
},
{
"variable": "MODALIDAD_PAGO",
"valor": "04"
},
{
"variable": "COBERTURA_PLAN_BENEFICIOS",
"valor": "08"
},
{
"variable": "NUMERO_CONTRATO",
"valor": "NA"
},
{
"variable": "NUMERO_POLIZA",
"valor": "NA"
},
{
"variable": "COPAGO",
"valor": "0.00"
},
{
"variable": "CUOTA_MODERADORA",
"valor": "0.00"
},
{
"variable": "PAGOS_COMPARTIDOS",
"valor": "0.00"
},
{
"variable": "CUOTA_RECUPERACION",
"valor": "0.00"
}
]
}
]
},
"periodo_facturacion": {
"fecha_inicio": "2025-01-01",
"fecha_fin": "2025-01-25"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "90000000",
"correo_electronico": "info@ejejmplo.co",
"numero_movil": "7777777",
"nombre": {
"razon_social": "Empresa de ejemplo",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "AK 10",
"RUT": {
"resp_calidades_atributos": [
"R-99-PN"
],
"usuario_aduanero": [
]
}
},
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "74500.00",
"descripcion": "CONSULTA DE PRIMERA VEZ POR ESPECIALISTA EN DERMATOLOGIA",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0",
"valor_base_cargo_descuento": "74500.00",
"valor_cargo_descuento": "0.00"
},
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "74500.00",
"valor_total_detalle": "74500.00",
"informacion_adicional": [
{
"variable": "DESCRIPCION",
"valor": "CONSULTA DE PRIMERA VEZ POR ESPECIALISTA EN DERMATOLOGIA"
},
{
"variable": "IDENTIFICACION_USUARIO",
"valor": "1010066265"
},
{
"variable": "NUMERO_AUTORIZACION",
"valor": "2000272"
},
{
"variable": "CODIGO_PRESTADOR_SERVICIO",
"valor": "4100100150"
}
]
},
{
"numero_linea": 2,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "74500.00",
"descripcion": "CONSULTA DE PRIMERA VEZ POR ESPECIALISTA EN DERMATOLOGIA",
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0",
"valor_base_cargo_descuento": "74500.00",
"valor_cargo_descuento": "0.00"
},
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"impuestos_detalle": {
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_impuesto": "0.00",
"valor_impuesto": "0.00"
},
"retenciones_detalle": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"valor_total_detalle_con_cargo_descuento": "74500.00",
"valor_total_detalle": "74500.00",
"informacion_adicional": [
{
"variable": "DESCRIPCION",
"valor": "CONSULTA DE PRIMERA VEZ POR ESPECIALISTA EN DERMATOLOGIA"
},
{
"variable": "IDENTIFICACION_USUARIO",
"valor": "1020842114"
},
{
"variable": "NUMERO_AUTORIZACION",
"valor": "8774537"
},
{
"variable": "CODIGO_PRESTADOR_SERVICIO",
"valor": "4100100150"
}
]
}
],
"impuestos": [
{
"codigo_impuesto": 0,
"porcentaje_impuesto": "0.00",
"valor_base_calculo_impuesto": "0.00",
"valor_total_impuesto": "0.00"
}
],
"retenciones": [
{
"codigo": 0,
"porcentaje": "0.00",
"valor_base": "0.00",
"valor_retenido": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"valor_factura": {
"valor_base": "149000",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos": "149000.00",
"valor_anticipo": "87000.00",
"valor_descuento_total": "0.00",
"valor_total_recargos": "0.00",
"valor_total_impuesto_1": "0.00",
"valor_total_impuesto_2": "0.00",
"valor_total_impuesto_3": "0.00",
"valor_total_impuesto_4": "0.00",
"valor_total_reteiva": "0.00",
"valor_total_retefuente": "0.00",
"valor_total_reteica": "0.00",
"total_factura": "149000.00",
"valor_total_a_pagar": "62000.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "20250130",
"rg_tipo": "",
"rg_base_64": "",
"integrador": {
"nombre": "WEB",
"tipo": "WEB"
}
}
}
JSON RIPS
{
"numDocumentoIdObligado": "11223344",
"numFactura": "SETT28",
"tipoNota": null,
"numNota": null,
"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_fe_rips' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token_obligado' \
--form 'json_rips="{
\"numDocumentoIdObligado\": \"123123123\",
\"numFactra\": \"SETT32\",
\"tipoNota\": null,
\"numNota\": null,
\"usuarios\": [
{
\"tipoDocumentoIdentificacion\": \"CW\",
\"numDocumentoIdentificacion\": \"3333333\",
\"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\": \"2222222\",
\"vrServicio\": 149000,
\"conceptoRecaudo\": \"03\",
\"valorPagoModerador\": 87000,
\"numFEVPagoModerador\": null,
\"consecutivo\": 1
}
]
}
}
]
}"' \
--form 'documento_obligado="7691730"' \
--form 'data="{
\"informacion_documento\": {
\"cufe_cude\": \"be27ab71fea9c9fd8c0a07fd3d21111111111222228d97597cb5792d86f857fe3ba1561f02ca99f3613d3f6b7a97af\",
\"fecha_documento\": \"2025-01-30\",
\"numero_documento\": \"SETT32\"
},
\"generalidades\": {
\"tipo_ambiente_dian\": 2,
\"identificador_transmision\": \"20220913_122843\",
\"integrador\": {
\"nombre\": \"WEB\",
\"tipo\": \"WEB\"
}
}
}"'
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://servicios-pruebas.afacturar.com/api/rips/cargar_fe_rips");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer token_obligado");
var content = new MultipartFormDataContent();
content.Add(new StringContent("{
\"numDocumentoIdObligado\": \"123123123\",
\"numFactra\": \"SETT32\",
\"tipoNota\": null,
\"numNota\": null,
\"usuarios\": [
{
\"tipoDocumentoIdentificacion\": \"CW\",
\"numDocumentoIdentificacion\": \"5555555\",
\"tipoUsuario\": \"01\",
\"fechaNacimiento\": \"1990-08-02\",
\"codSexo\": \"F\",
\"codPaisResidencia\": \"170\",
\"codMunicipioResidencia\": \"41001\",
\"codZonaTerritorialResidencia\": \"02\",
\"incapacidad\": \"NO\",
\"consecutivo\": 1,
\"codPaisOrigen\": \"170\",
\"servicios\": {
\"consultas\": [
{
\"codPrestador\": \"111111111\",
\"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\": \"2222222\",
\"vrServicio\": 149000,
\"conceptoRecaudo\": \"03\",
\"valorPagoModerador\": 87000,
\"numFEVPagoModerador\": null,
\"consecutivo\": 1
}
]
}
}
]
}"), "json_rips");
content.Add(new StringContent("123123123"), "documento_obligado");
content.Add(new StringContent("{
\"informacion_documento\": {
\"cufe_cude\": \"be27ab71fea9c9fd8c0a07fd3d221111111111b618d97597cb5792d86f857fe3ba1561f02ca99f3613d3f6b7a97af\",
\"fecha_documento\": \"2025-01-30\",
\"numero_documento\": \"SETT32\"
},
\"generalidades\": {
\"tipo_ambiente_dian\": 2,
\"identificador_transmision\": \"20220913_122843\",
\"integrador\": {
\"nombre\": \"WEB\",
\"tipo\": \"WEB\"
}
}
}"), "data");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
| Versión | Cambios | Fecha de liberación |
|---|---|---|
| 3 | Actualización de la documentación RIPS incorporando los nuevos campos definidos en la Resolución 948 de 2026, incluyendo soporte para CIE11, código VIDA, registro SIRAS y demás estructuras asociadas. Se identifican visualmente los campos nuevos en la documentación para facilitar la integración. | 18 de junio de 2026 |
| 2 | Publicación del API| | 30 de enero de 2025 |