Método: POST
EndPoint:
Pruebas
https://servicios-pruebas.afacturar.com/api/doc_equivalente/servicio_publico_domiciliario
Habilitación
https://servicios-habilitacion.afacturar.com/api/doc_equivalente/servicio_publico_domiciliario
Producción
https://servicios.afacturar.com/api/doc_equivalente/servicio_publico_domiciliario
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
testSetId: Número entregado en la DIAN para la Habilitación. Este parametro es soló para habilitación
facturas | Objeto | Requerido | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Información de la factura Especificación: |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
generalidades | Objeto | Requerido | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Generalidades Especificación: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
{
"facturas": [
{
"encabezado": {
"id_factura": "",
"fecha": "",
"hora": "",
"nota": [
"{'':''",
"'':''}"
],
"moneda": "",
"tipo_factura": "",
"numero_orden": "",
"tipo_operacion": "",
"fecha_pago_oportuno": "",
"fecha_ultimo_pago": "",
"codigo_referencia_pago": "",
"numero_contrato": ""
},
"servicio": [
{
"tipo": "",
"nombre": "",
"empresa_emite_servicio": "",
"empresa_de_recaudo": "",
"contrato": {
"numero": "",
"fecha": "",
"informacion_adicional": [
"",
""
]
},
"datos_suscriptor": {
"tipo_contribuyente": "",
"tipo_identificacion": "",
"identificacion": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"otros_nombres": "",
"primer_apellido": "",
"otros_apellidos": ""
},
"pais": "",
"departamento": "",
"ciudad": "",
"direccion": "",
"estrato": "",
"correo_electronico": ""
},
"datos_tercero": {
"tipo_contribuyente": "",
"tipo_identificacion": "",
"identificacion": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"otros_nombres": "",
"primer_apellido": "",
"otros_apellidos": ""
},
"pais": "",
"departamento": "",
"ciudad": "",
"direccion": "",
"correo_electronico": ""
},
"ciclo_facturado": {
"cantidad": "",
"periodicidad": "",
"informacion_adicional": [
"",
""
]
},
"consumo_parcial": {
"cantidad": "",
"unidad_medida": "",
"valor": "",
"moneda": ""
},
"precio_del_consumo": {
"cantidad": "",
"unidad_medida": "",
"valor": "",
"moneda": ""
},
"descuentos_credito": [
{
"descripcion": "",
"valor": "",
"moneda": ""
}
],
"cargo_debito": [
{
"descripcion": "",
"valor": "",
"moneda": ""
}
],
"valor_unitario": {
"valor": "",
"moneda": "",
"unidad_medida": "",
"cantidad": ""
},
"lectura_contador": {
"datos_medidor": "",
"lectura_anterior": {
"fecha": "",
"unidad_medida": "",
"cantidad": ""
},
"lectura_actual": {
"fecha": "",
"unidad_medida": "",
"cantidad": ""
},
"metodo_lectura": "",
"duracion_periodo": {
"unidad_medida": "",
"cantidad": ""
}
},
"historico_consumo": {
"valor_pago_anterior": "",
"valor_pago_anterior_moneda": "",
"ultimos_consumos": [
{
"cantidad": "",
"unidad_medida": "",
"fecha_inicial": "",
"fecha_final": "",
"dias_facturados_cantidad": "",
"dias_facturados_unidad_medida": "",
"valor_pago": "",
"valor_pago_moneda": ""
}
],
"promedio_consumo": {
"cantidad": "",
"unidad_medida": "",
"cantidad_dias": "",
"cantidad_dias_unidad_medida": ""
}
}
}
],
"periodo_facturacion": {
"fecha_inicio": "",
"fecha_fin": ""
},
"informacion_adquiriente": {
"tipo_contribuyente": "",
"tipo_regimen": "",
"tipo_identificacion": "",
"identificacion": "",
"correo_electronico": "",
"numero_movil": "",
"nombre": {
"razon_social": "",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "",
"departamento": "",
"ciudad": "",
"zona": "",
"direccion": "",
"RUT": {
"resp_calidades_atributos": [
""
],
"usuario_aduanero": [
""
]
}
},
"formas_de_pago": [
{
"metodo_de_pago": "",
"tipo_de_pago": "",
"identificador_de_pago": "",
"fecha_vencimiento": ""
}
],
"detalle_factura": [
{
"numero_linea": "",
"cantidad": "",
"unidad_de_cantidad": "",
"valor_unitario": "",
"descripcion": "",
"regalo": {
"es_regalo": "",
"cod_precio_referencia": "",
"precio_referencia": ""
},
"cargo_descuento": {
"es_descuento": "",
"porcentaje_cargo_descuento": "",
"valor_base_cargo_descuento": "",
"valor_cargo_descuento": ""
},
"impuestos_detalle": {
"codigo_impuesto": 1,
"porcentaje_impuesto": "",
"valor_base_impuesto": "",
"valor_impuesto": ""
},
"retenciones_detalle": [
{
"codigo": "",
"porcentaje": "",
"valor_base": "",
"valor_retenido": ""
}
],
"valor_total_detalle_con_cargo_descuento": "",
"valor_total_detalle": ""
}
],
"impuestos": [
{
"codigo_impuesto": "",
"porcentaje_impuesto": "",
"valor_base_calculo_impuesto": "",
"valor_total_impuesto": ""
}
],
"retenciones": [
{
"codigo": "",
"porcentaje": "",
"valor_base": "",
"valor_retenido": ""
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "",
"valor_base_calculo_recargo": "",
"valor_total_recargo": ""
}
],
"descuentos": [
{
"codigo_descuento": "",
"porcentaje_descuento": "",
"descripcion_descuento": "",
"valor_base_calculo_descuento": "",
"valor_total_descuento": ""
}
],
"valor_factura": {
"valor_base": "",
"valor_base_calculo_impuestos": "",
"valor_base_mas_impuestos": "",
"valor_anticipo": "0.00",
"valor_descuento_total": "",
"valor_total_recargos": "",
"valor_total_impuesto_1": "",
"valor_total_impuesto_2": "",
"valor_total_impuesto_3": "",
"valor_total_impuesto_4": "",
"valor_total_reteiva": "",
"valor_total_retefuente": "",
"valor_total_reteica": "",
"total_factura": "",
"valor_total_a_pagar": ""
}
}
],
"generalidades": {
"tipo_ambiente_dian": "",
"version": "",
"identificador_transmision": "",
"integrador": {
"nombre": "",
"tipo": ""
},
"fabricante_software": {
"nombre_apellido": "",
"razon_social": "",
"nombre_software": ""
},
"rg_tipo": "",
"rg_base_64": "",
"rg_px_qr": {
"x": "",
"y": "",
"size": ""
},
"rg_px_cufe": {
"x": "",
"y": "",
"size": ""
}
}
}
{
"codigo_error": 0,
"descripcion_error": "OK",
"tiempo_ejecucion": 2.8475100994110109,
"transaccion": "5e5e5e5e5e55e",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_factura": "SETP990001502",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
{
"codigo_error": 400,
"descripcion_error": "Hay un problema con la informacion entregada",
"tiempo_ejecucion": 0.01330113410949707,
"transaccion": "5e74ce82707f6",
"resultado": [
{
"propiedad": "facturas[0].encabezado.tipo_factura",
"descripcion": "The property tipo_factura is required"
},
{
"propiedad": "facturas[0].encabezado.tipo_factura",
"descripcion": "Does not have a value in the enumeration [1,2,3,5,6,7,8,9,10]"
},
{
"propiedad": "facturas[0].encabezado",
"descripcion": "The property tipo_factur is not defined and the definition does not allow additional properties"
}
],
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": ""
}
{
"codigo_error": 400,
"descripcion_error": "Hay problema(s) con la información entregada",
"resultado": [
[
{
"propiedad": "facturas->encabezado-> numero_resolucion_facturacion y facturas->encabezado-> prefijo",
"descripcion": "No exiten rangos de facturación para la resolución SET + 18760000001 "
},
{
"propiedad": "facturas->fecha_vencimiento",
"descripcion": "Si el metodo de pago es contado, la fecha de vencimiento debe ir vacia"
}
]
]
}
{
"codigo_error": 500,
"descripcion_error": "Unauthenticated."
}
{
"codigo_error": 15,
"descripcion_error": "La validación en la DIAN devuelve error(es)",
"tiempo_ejecucion": 1.9776690006256104,
"transaccion": "5e74d144dd565",
"resultado": {
"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"id_factura": "SETP990001504",
"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
},
"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
"ErrorMessage_DIAN": "Regla: FAU06, Rechazo: Valor Bruto más tributos es diferente a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle.Regla: FAU02, Rechazo: El Valor Bruto antes de tributos no es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial"
}
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. |
{
"facturas": [
{
"encabezado": {
"id_factura": "14",
"fecha": "2024-07-31",
"hora": "09:00:10",
"nota": [
"{'SON':'XXX XXX XXX'",
"'VARIABLE':'VALOR'}"
],
"moneda": "COP",
"tipo_factura": 10,
"numero_orden": "",
"tipo_operacion": 601,
"fecha_pago_oportuno": "2024-08-01",
"fecha_ultimo_pago": "2024-06-07",
"codigo_referencia_pago": "23464577895",
"numero_contrato": "6564041-1"
},
"servicio": [
{
"tipo": "PROPIO",
"nombre": "ENERGIA",
"empresa_emite_servicio": "ENEL Colombia S.A",
"empresa_de_recaudo": "ENEL Colombia S.A",
"contrato": {
"numero": "6564041-1",
"fecha": "2019-01-01",
"informacion_adicional": [
"nota contrato 1",
"nota contrato 2"
]
},
"datos_suscriptor": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"nombre": {
"razon_social": "Constructora Trazzar SAS",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"direccion": "Carrera 10",
"estrato": "3",
"correo_electronico": "info@teleinte.com"
},
"ciclo_facturado": {
"cantidad": "1",
"periodicidad": "1",
"informacion_adicional": [
"nota ciclo 1",
"nota ciclo 2"
]
},
"consumo_parcial": {
"cantidad": "78",
"unidad_medida": "KWH",
"valor": "59130.00",
"moneda": "COP"
},
"precio_del_consumo": {
"cantidad": "78",
"unidad_medida": "KWH",
"valor": "59130.00",
"moneda": "COP"
},
"descuentos_credito": [
{
"descripcion": "Consumo a subsidiar 130.00 kwh X Beneficio -15%",
"valor": "10435.00",
"moneda": "COP"
}
],
"cargo_debito": [
{
"descripcion": "Ajuste a decena",
"valor": "1.00",
"moneda": "COP"
}
],
"valor_unitario": {
"valor": "891.85",
"moneda": "COP",
"unidad_medida": "KWH",
"cantidad": "2.69"
},
"lectura_contador": {
"datos_medidor": "Medidor no. 117-100397",
"lectura_anterior": {
"fecha": "2024-06-23",
"unidad_medida": "KWH",
"cantidad": "12001"
},
"lectura_actual": {
"fecha": "2024-07-23",
"unidad_medida": "KWH",
"cantidad": "12174"
},
"metodo_lectura": "Toma exitosa",
"duracion_periodo": {
"unidad_medida": "DAY",
"cantidad": "29"
}
},
"historico_consumo": {
"valor_pago_anterior": "147990.00",
"valor_pago_anterior_moneda": "COP",
"ultimos_consumos": [
{
"cantidad": "120",
"unidad_medida": "KWH",
"fecha_inicial": "2024-06-01",
"fecha_final": "2024-06-30",
"dias_facturados_cantidad": "30",
"dias_facturados_unidad_medida": "DIAS",
"valor_pago": "90840.00",
"valor_pago_moneda": "COP"
}
],
"promedio_consumo": {
"cantidad": "99",
"unidad_medida": "KWH",
"cantidad_dias": "29",
"cantidad_dias_unidad_medida": "DAY"
}
}
}
],
"periodo_facturacion": {
"fecha_inicio": "2024-06-20",
"fecha_fin": "2024-07-18"
},
"informacion_adquiriente": {
"tipo_contribuyente": 1,
"tipo_regimen": 2,
"tipo_identificacion": 31,
"identificacion": "900730299",
"correo_electronico": "info@teleinte.com",
"numero_movil": "",
"nombre": {
"razon_social": "Contructora Trazzar S.A.S.",
"primer_nombre": "",
"segundo_nombre": "",
"apellido": ""
},
"pais": "CO",
"departamento": "11",
"ciudad": "11001",
"zona": "",
"direccion": "Carrera 10",
"estrato": 3,
"RUT": {
"resp_calidades_atributos": [
"R-99-PN"
],
"usuario_aduanero": [
""
]
}
},
"formas_de_pago": [
{
"metodo_de_pago": 1,
"tipo_de_pago": 41,
"identificador_de_pago": "ABDC",
"fecha_vencimiento": ""
}
],
"detalle_factura": [
{
"numero_linea": 1,
"cantidad": 1,
"unidad_de_cantidad": "94",
"valor_unitario": "59130.00",
"descripcion": "Consumo de energia",
"regalo": {
"es_regalo": false,
"cod_precio_referencia": 0,
"precio_referencia": "0.00"
},
"cargo_descuento": {
"es_descuento": false,
"porcentaje_cargo_descuento": "0.00",
"valor_base_cargo_descuento": "0.00",
"valor_cargo_descuento": "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": "59130.00",
"valor_total_detalle": "59130.00"
}
],
"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"
}
],
"recargos": [
{
"nombre_recargo": "",
"porcentaje_recargo": "0.00",
"valor_base_calculo_recargo": "0.00",
"valor_total_recargo": "0.00"
}
],
"descuentos": [
{
"codigo_descuento": 99,
"porcentaje_descuento": "0.00",
"descripcion_descuento": "No aplica",
"valor_base_calculo_descuento": "0.00",
"valor_total_descuento": "0.00"
}
],
"valor_factura": {
"valor_base": "59130.00",
"valor_base_calculo_impuestos": "0.00",
"valor_base_mas_impuestos": "59130.00",
"valor_anticipo": "0.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": "59130.00",
"valor_total_a_pagar": "59130.00"
}
}
],
"generalidades": {
"tipo_ambiente_dian": 2,
"version": 2,
"identificador_transmision": "2019 validación previa",
"integrador": {
"nombre": "Afacturar.com",
"tipo": "WEB"
},
"fabricante_software": {
"nombre_apellido": "Ricardo Albornoz",
"razon_social": "Teleinte S.A.S",
"nombre_software": "Afacturar.com"
}
}
}
curl --location 'https://servicios-pruebas.afacturar.com/api/doc_equivalente/servicio_publico_domiciliario' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token_obligado' \
--form 'documento_obligado="830020470"' \
--form 'data="{
\"facturas\": [
{
\"encabezado\": {
\"id_factura\": \"9\",
\"fecha\": \"2024-07-22\",
\"hora\": \"05:36:10\",
\"nota\": [
\"{'\''SON'\'':'\''XXX XXX XXX'\''\",
\"'\''VARIABLE'\'':'\''VALOR'\''}\"
],
\"moneda\": \"COP\",
\"tipo_factura\": 10,
\"numero_orden\": \"\",
\"tipo_operacion\": 601,
\"fecha_pago_oportuno\": \"2024-06-01\",
\"fecha_ultimo_pago\": \"2024-06-07\",
\"codigo_referencia_pago\": \"23464577895\",
\"numero_contrato\": \"12345\"
},
\"servicio\": [
{
\"nombre\": \"ENERGIA\",
\"empresa_emite_servicio\": \"ENEL Colombia S.A\",
\"empresa_de_recaudo\": \"ENEL Colombia S.A\",
\"contrato\": {
\"numero\": \"6564041-1\",
\"fecha\": \"2019-01-01\",
\"informacion_adicional\": [
\"nota contrato 1\",
\"nota contrato 2\"
]
},
\"datos_suscriptor\": {
\"nombres\": \"Nubia Andrea\",
\"apellidos\": \"Cañón Castellanos\",
\"pais\": \"CO\",
\"departamento\": \"11\",
\"ciudad\": \"11001\",
\"direccion\": \"Carrera 10\",
\"estrato\": \"3\",
\"correo_electronico\": \"acanon@teleinte.com\"
},
\"ciclo_facturado\": {
\"cantidad\": \"1\",
\"periodicidad\": \"MENSUAL\",
\"informacion_adicional\": [
\"nota ciclo 1\",
\"nota ciclo 2\"
]
},
\"consumo_parcial\": {
\"cantidad\": \"1181\",
\"unidad_medida\": \"KWH\",
\"valor\": \"90840.00\",
\"moneda\": \"COP\"
},
\"precio_del_consumo\": {
\"cantidad\": \"3.93\",
\"unidad_medida\": \"KWH\",
\"valor\": \"3028.00\",
\"moneda\": \"COP\"
},
\"descuentos_credito\": [
{
\"descripcion\": \"Consumo a subsidiar 130.00 kwh\",
\"valor\": \"16030.00\",
\"moneda\": \"COP\"
}
],
\"cargo_debito\": [
{
\"descripcion\": \"cargo fijo\",
\"valor\": \"7850.00\",
\"moneda\": \"COP\"
}
],
\"valor_unitario\": {
\"valor\": \"3028.00\",
\"moneda\": \"COP\",
\"unidad_medida\": \"KWH\",
\"cantidad\": \"1.00\"
},
\"lectura_contador\": {
\"datos_medidor\": \"Medidor no. 117-100397\",
\"lectura_anterior\": {
\"fecha\": \"2024-06-23\",
\"unidad_medida\": \"KWH\",
\"cantidad\": \"12001\"
},
\"lectura_actual\": {
\"fecha\": \"2024-07-23\",
\"unidad_medida\": \"KWH\",
\"cantidad\": \"12174\"
},
\"metodo_lectura\": \"Toma exitosa\",
\"duracion_periodo\": {
\"unidad_medida\": \"KWH\",
\"cantidad\": \"12174\"
}
},
\"historico_consumo\": {
\"valor_pago_anterior\": \"147990.00\",
\"valor_pago_anterior_moneda\": \"COP\",
\"ultimos_consumos\": [
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-06-01\",
\"fecha_final\": \"2024-06-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-05-01\",
\"fecha_final\": \"2024-05-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-04-01\",
\"fecha_final\": \"2024-04-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-03-01\",
\"fecha_final\": \"2024-03-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-02-01\",
\"fecha_final\": \"2024-02-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-01-01\",
\"fecha_final\": \"2024-01-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
}
],
\"promedio_consumo\": {
\"cantidad\": \"100\",
\"unidad_medida\": \"KWH\",
\"cantidad_dias\": \"30\",
\"cantidad_dias_unidad_medida\": \"DAY\"
}
}
}
],
\"periodo_facturacion\": {
\"fecha_inicio\": \"2022-12-01\",
\"fecha_fin\": \"2022-12-31\"
},
\"informacion_adquiriente\": {
\"tipo_contribuyente\": 1,
\"tipo_regimen\": 2,
\"tipo_identificacion\": 31,
\"identificacion\": \"900730299\",
\"correo_electronico\": \"info@teleinte.com\",
\"numero_movil\": \"\",
\"nombre\": {
\"razon_social\": \"PIXELPRO S.A.S.\",
\"primer_nombre\": \"\",
\"segundo_nombre\": \"\",
\"apellido\": \"\"
},
\"pais\": \"CO\",
\"departamento\": \"11\",
\"ciudad\": \"11001\",
\"zona\": \"\",
\"direccion\": \"Carrera 10\",
\"RUT\": {
\"resp_calidades_atributos\": [
\"R-99-PN\"
],
\"usuario_aduanero\": [
\"\"
]
}
},
\"formas_de_pago\": [
{
\"metodo_de_pago\": 1,
\"tipo_de_pago\": 41,
\"identificador_de_pago\": \"ABDC\",
\"fecha_vencimiento\": \"\"
}
],
\"detalle_factura\": [
{
\"numero_linea\": 1,
\"cantidad\": 1,
\"unidad_de_cantidad\": \"94\",
\"valor_unitario\": \"600000.00\",
\"descripcion\": \"Provisión inicial afacturar\",
\"regalo\": {
\"es_regalo\": false,
\"cod_precio_referencia\": 0,
\"precio_referencia\": \"0.00\"
},
\"cargo_descuento\": {
\"es_descuento\": false,
\"porcentaje_cargo_descuento\": \"0.00\",
\"valor_base_cargo_descuento\": \"0.00\",
\"valor_cargo_descuento\": \"0.00\"
},
\"impuestos_detalle\": {
\"codigo_impuesto\": 1,
\"porcentaje_impuesto\": \"19.00\",
\"valor_base_impuesto\": \"600000.00\",
\"valor_impuesto\": \"114000.00\"
},
\"retenciones_detalle\": [
{
\"codigo\": 0,
\"porcentaje\": \"0.00\",
\"valor_base\": \"0.00\",
\"valor_retenido\": \"0.00\"
}
],
\"valor_total_detalle_con_cargo_descuento\": \"600000.00\",
\"valor_total_detalle\": \"600000.00\"
}
],
\"impuestos\": [
{
\"codigo_impuesto\": 1,
\"porcentaje_impuesto\": \"19.00\",
\"valor_base_calculo_impuesto\": \"600000.00\",
\"valor_total_impuesto\": \"114000.00\"
}
],
\"retenciones\": [
{
\"codigo\": 0,
\"porcentaje\": \"0.00\",
\"valor_base\": \"0.00\",
\"valor_retenido\": \"0.00\"
}
],
\"recargos\": [
{
\"nombre_recargo\": \"\",
\"porcentaje_recargo\": \"0.00\",
\"valor_base_calculo_recargo\": \"0.00\",
\"valor_total_recargo\": \"0.00\"
}
],
\"descuentos\": [
{
\"codigo_descuento\": 99,
\"porcentaje_descuento\": \"0.00\",
\"descripcion_descuento\": \"No aplica\",
\"valor_base_calculo_descuento\": \"0.00\",
\"valor_total_descuento\": \"0.00\"
}
],
\"valor_factura\": {
\"valor_base\": \"600000.00\",
\"valor_base_calculo_impuestos\": \"600000.00\",
\"valor_base_mas_impuestos\": \"714000.00\",
\"valor_anticipo\": \"0.00\",
\"valor_descuento_total\": \"0.00\",
\"valor_total_recargos\": \"0.00\",
\"valor_total_impuesto_1\": \"114000.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\": \"714000.00\",
\"valor_total_a_pagar\": \"714000.00\"
}
}
],
\"generalidades\": {
\"tipo_ambiente_dian\": 2,
\"version\": 2,
\"identificador_transmision\": \"2019 validación previa\",
\"integrador\": {
\"nombre\": \"Afacturar.com\",
\"tipo\": \"WEB\"
},
\"fabricante_software\": {
\"nombre_apellido\": \"Ricardo Albornoz\",
\"razon_social\": \"Teleinte S.A.S\",
\"nombre_software\": \"Afacturar.com\"
}
}
}"'
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://servicios-pruebas.afacturar.com/api/doc_equivalente/servicio_publico_domiciliario");
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("{
\"facturas\": [
{
\"encabezado\": {
\"id_factura\": \"9\",
\"fecha\": \"2024-07-22\",
\"hora\": \"05:36:10\",
\"nota\": [
\"{'SON':'XXX XXX XXX'\",
\"'VARIABLE':'VALOR'}\"
],
\"moneda\": \"COP\",
\"tipo_factura\": 10,
\"numero_orden\": \"\",
\"tipo_operacion\": 601,
\"fecha_pago_oportuno\": \"2024-06-01\",
\"fecha_ultimo_pago\": \"2024-06-07\",
\"codigo_referencia_pago\": \"23464577895\",
\"numero_contrato\": \"12345\"
},
\"servicio\": [
{
\"nombre\": \"ENERGIA\",
\"empresa_emite_servicio\": \"ENEL Colombia S.A\",
\"empresa_de_recaudo\": \"ENEL Colombia S.A\",
\"contrato\": {
\"numero\": \"6564041-1\",
\"fecha\": \"2019-01-01\",
\"informacion_adicional\": [
\"nota contrato 1\",
\"nota contrato 2\"
]
},
\"datos_suscriptor\": {
\"nombres\": \"Nubia Andrea\",
\"apellidos\": \"Cañón Castellanos\",
\"pais\": \"CO\",
\"departamento\": \"11\",
\"ciudad\": \"11001\",
\"direccion\": \"Carrera 10\",
\"estrato\": \"3\",
\"correo_electronico\": \"acanon@teleinte.com\"
},
\"ciclo_facturado\": {
\"cantidad\": \"1\",
\"periodicidad\": \"MENSUAL\",
\"informacion_adicional\": [
\"nota ciclo 1\",
\"nota ciclo 2\"
]
},
\"consumo_parcial\": {
\"cantidad\": \"1181\",
\"unidad_medida\": \"KWH\",
\"valor\": \"90840.00\",
\"moneda\": \"COP\"
},
\"precio_del_consumo\": {
\"cantidad\": \"3.93\",
\"unidad_medida\": \"KWH\",
\"valor\": \"3028.00\",
\"moneda\": \"COP\"
},
\"descuentos_credito\": [
{
\"descripcion\": \"Consumo a subsidiar 130.00 kwh\",
\"valor\": \"16030.00\",
\"moneda\": \"COP\"
}
],
\"cargo_debito\": [
{
\"descripcion\": \"cargo fijo\",
\"valor\": \"7850.00\",
\"moneda\": \"COP\"
}
],
\"valor_unitario\": {
\"valor\": \"3028.00\",
\"moneda\": \"COP\",
\"unidad_medida\": \"KWH\",
\"cantidad\": \"1.00\"
},
\"lectura_contador\": {
\"datos_medidor\": \"Medidor no. 117-100397\",
\"lectura_anterior\": {
\"fecha\": \"2024-06-23\",
\"unidad_medida\": \"KWH\",
\"cantidad\": \"12001\"
},
\"lectura_actual\": {
\"fecha\": \"2024-07-23\",
\"unidad_medida\": \"KWH\",
\"cantidad\": \"12174\"
},
\"metodo_lectura\": \"Toma exitosa\",
\"duracion_periodo\": {
\"unidad_medida\": \"KWH\",
\"cantidad\": \"12174\"
}
},
\"historico_consumo\": {
\"valor_pago_anterior\": \"147990.00\",
\"valor_pago_anterior_moneda\": \"COP\",
\"ultimos_consumos\": [
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-06-01\",
\"fecha_final\": \"2024-06-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-05-01\",
\"fecha_final\": \"2024-05-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-04-01\",
\"fecha_final\": \"2024-04-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-03-01\",
\"fecha_final\": \"2024-03-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-02-01\",
\"fecha_final\": \"2024-02-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
},
{
\"cantidad\": \"120\",
\"unidad_medida\": \"KWH\",
\"fecha_inicial\": \"2024-01-01\",
\"fecha_final\": \"2024-01-30\",
\"dias_facturados_cantidad\": \"30\",
\"dias_facturados_unidad_medida\": \"DIAS\",
\"valor_pago\": \"120000.00\",
\"valor_pago_moneda\": \"COP\"
}
],
\"promedio_consumo\": {
\"cantidad\": \"100\",
\"unidad_medida\": \"KWH\",
\"cantidad_dias\": \"30\",
\"cantidad_dias_unidad_medida\": \"DAY\"
}
}
}
],
\"periodo_facturacion\": {
\"fecha_inicio\": \"2022-12-01\",
\"fecha_fin\": \"2022-12-31\"
},
\"informacion_adquiriente\": {
\"tipo_contribuyente\": 1,
\"tipo_regimen\": 2,
\"tipo_identificacion\": 31,
\"identificacion\": \"900730299\",
\"correo_electronico\": \"info@teleinte.com\",
\"numero_movil\": \"\",
\"nombre\": {
\"razon_social\": \"PIXELPRO S.A.S.\",
\"primer_nombre\": \"\",
\"segundo_nombre\": \"\",
\"apellido\": \"\"
},
\"pais\": \"CO\",
\"departamento\": \"11\",
\"ciudad\": \"11001\",
\"zona\": \"\",
\"direccion\": \"Carrera 10\",
\"RUT\": {
\"resp_calidades_atributos\": [
\"R-99-PN\"
],
\"usuario_aduanero\": [
\"\"
]
}
},
\"formas_de_pago\": [
{
\"metodo_de_pago\": 1,
\"tipo_de_pago\": 41,
\"identificador_de_pago\": \"ABDC\",
\"fecha_vencimiento\": \"\"
}
],
\"detalle_factura\": [
{
\"numero_linea\": 1,
\"cantidad\": 1,
\"unidad_de_cantidad\": \"94\",
\"valor_unitario\": \"600000.00\",
\"descripcion\": \"Provisión inicial afacturar\",
\"regalo\": {
\"es_regalo\": false,
\"cod_precio_referencia\": 0,
\"precio_referencia\": \"0.00\"
},
\"cargo_descuento\": {
\"es_descuento\": false,
\"porcentaje_cargo_descuento\": \"0.00\",
\"valor_base_cargo_descuento\": \"0.00\",
\"valor_cargo_descuento\": \"0.00\"
},
\"impuestos_detalle\": {
\"codigo_impuesto\": 1,
\"porcentaje_impuesto\": \"19.00\",
\"valor_base_impuesto\": \"600000.00\",
\"valor_impuesto\": \"114000.00\"
},
\"retenciones_detalle\": [
{
\"codigo\": 0,
\"porcentaje\": \"0.00\",
\"valor_base\": \"0.00\",
\"valor_retenido\": \"0.00\"
}
],
\"valor_total_detalle_con_cargo_descuento\": \"600000.00\",
\"valor_total_detalle\": \"600000.00\"
}
],
\"impuestos\": [
{
\"codigo_impuesto\": 1,
\"porcentaje_impuesto\": \"19.00\",
\"valor_base_calculo_impuesto\": \"600000.00\",
\"valor_total_impuesto\": \"114000.00\"
}
],
\"retenciones\": [
{
\"codigo\": 0,
\"porcentaje\": \"0.00\",
\"valor_base\": \"0.00\",
\"valor_retenido\": \"0.00\"
}
],
\"recargos\": [
{
\"nombre_recargo\": \"\",
\"porcentaje_recargo\": \"0.00\",
\"valor_base_calculo_recargo\": \"0.00\",
\"valor_total_recargo\": \"0.00\"
}
],
\"descuentos\": [
{
\"codigo_descuento\": 99,
\"porcentaje_descuento\": \"0.00\",
\"descripcion_descuento\": \"No aplica\",
\"valor_base_calculo_descuento\": \"0.00\",
\"valor_total_descuento\": \"0.00\"
}
],
\"valor_factura\": {
\"valor_base\": \"600000.00\",
\"valor_base_calculo_impuestos\": \"600000.00\",
\"valor_base_mas_impuestos\": \"714000.00\",
\"valor_anticipo\": \"0.00\",
\"valor_descuento_total\": \"0.00\",
\"valor_total_recargos\": \"0.00\",
\"valor_total_impuesto_1\": \"114000.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\": \"714000.00\",
\"valor_total_a_pagar\": \"714000.00\"
}
}
],
\"generalidades\": {
\"tipo_ambiente_dian\": 2,
\"version\": 2,
\"identificador_transmision\": \"2019 validación previa\",
\"integrador\": {
\"nombre\": \"Afacturar.com\",
\"tipo\": \"WEB\"
},
\"fabricante_software\": {
\"nombre_apellido\": \"Ricardo Albornoz\",
\"razon_social\": \"Teleinte S.A.S\",
\"nombre_software\": \"Afacturar.com\"
}
}
}"), "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 |
---|---|---|
2 | Creación del API | 23 de Julio de 2024 |