Integración WS Nexura

A continuación, se define la estructura de los servicios de integración para sus posteriores pruebas.
 
1. Servicio de consulta de información de factura:
 
URL: https://ws.serviciosportal.adacsc.co/SITU/factura_info_nex
 
Parámetros (los parámetros pueden ser enviados vía GET o POST): 

•	documento: valor numérico referente al número de identificación del contribuyente. En caso de ser NIT no incluir el dígito de verificación.
•	objeto: valor numérico referente al consecutivo del establecimiento. En el caso del impuesto de ICO o número de ficha para el impuesto de predial.
•	fuente: valor numérico referente al identificador de la fuente. Para este caso se parametriza con tres (3) para la fuente de ingreso de ICO y cuatro (4) para a fuente de ingreso de predial respectivamente.

Respuesta:
 
{"codigo":11,"facturas":[{"numero_barras_ano":"","acuerdo_cuota":"","simbolo_barras":"ÍÊIYfÇÆ !8p42Ã40ÊG \"WY\\ÊÄ46!?ÃÎ","codigo_iac":"","direccion_completa":"DG 56  # 44 - 137 ","fecha_corte_reporte":"2022-04-01 00:00:00.0","nombre_zona":"","telefono1":"","actividad":"4711","conceptos":[{"codigo_concepto":"0196UI","valor_interes":520059,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":48127,"id_concepto":1,"nombre_concepto":"INDUSTRIA Y COMERCIO","subtotal":1698764,"vigencia_anterior":1130578,"valor":2555760,"valor_ano":"","periodo_actual":48127},{"codigo_concepto":"0596UI","valor_interes":0,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":0,"id_concepto":2,"nombre_concepto":"FACTURA INDUSTRIA","subtotal":31608,"vigencia_anterior":31608,"valor":2555760,"valor_ano":"","periodo_actual":0},{"codigo_concepto":"0996UI","valor_interes":0,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":1118304,"id_concepto":9,"nombre_concepto":"SANCION  INDUSTRIA","subtotal":1582488,"vigencia_anterior":464184,"valor":2555760,"valor_ano":"","periodo_actual":1118304},{"codigo_concepto":"1296UI","valor_interes":0,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":242000,"id_concepto":12,"nombre_concepto":"EXTEMPORANEIDAD  INDUSTRIA","subtotal":242000,"vigencia_anterior":0,"valor":2555760,"valor_ano":"","periodo_actual":242000},{"codigo_concepto":"SF0196UI","valor_interes":0,"descuento_ano":"","signo":"-","valor_neto_ano":"","vigencia_actual":-2265391,"id_concepto":53,"nombre_concepto":"SALDO A FAVOR INDUSTRIA Y COMERCIO","subtotal":-2265391,"vigencia_anterior":0,"valor":2555760,"valor_ano":"","periodo_actual":-2265391},{"codigo_concepto":"ICR005","valor_interes":448523,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":0,"id_concepto":289,"nombre_concepto":"RETROACTIVIDAD DE MATRICULA - ICO","subtotal":1087073,"vigencia_anterior":638550,"valor":2555760,"valor_ano":"","periodo_actual":0},{"codigo_concepto":"STBOMBERIL1","valor_interes":15578,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":1444,"id_concepto":430,"nombre_concepto":"SOBRE TASA BOMBERIL IND","subtotal":50935,"vigencia_anterior":33913,"valor":2555760,"valor_ano":"","periodo_actual":1444},{"codigo_concepto":"ICR008","valor_interes":13456,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":0,"id_concepto":4901,"nombre_concepto":"RETROACTIVIDAD BOMBERIL","subtotal":32613,"vigencia_anterior":19157,"valor":2555760,"valor_ano":"","periodo_actual":0},{"codigo_concepto":"DIFICO2020","valor_interes":0,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":0,"id_concepto":5077,"nombre_concepto":"Diferidos  ICO Mayo-Junio /2020","subtotal":92886,"vigencia_anterior":92886,"valor":2555760,"valor_ano":"","periodo_actual":0},{"codigo_concepto":"DIBOMBERIL2020","valor_interes":0,"descuento_ano":"","signo":"+","valor_neto_ano":"","vigencia_actual":0,"id_concepto":5079,"nombre_concepto":"Diferidos Bomberil Mayo-Junio /2020","subtotal":2784,"vigencia_anterior":2784,"valor":2555760,"valor_ano":"","periodo_actual":0}],"dir_ppal":"DG 56  # 44 - 137 ","milaje":0,"vencidas":25,"fecha_emision":"","nombre_tercero":"TORRES ZAPATA PATRICIA AMPARO","ruta_objeto":"0084576004001370001","valor_avaluo_unitario":2,"fecha_recargo_factura":"2022-01-31 00:00:00.0","mensaje2":"","mensaje1":"","destinacion":"","prefijo":"","fecha_con_recargo":"2022-01-31 00:00:00.0","valor":2555760,"entidad":"MUNICIPIO DE BELLO","fecha_elaboracion_factura":"2022-05-16 00:00:00.0","barrio":"NIQUIA BIFAMILIARES (CAMACOL)","fecha_vencimiento_factura":"2022-01-31 00:00:00.0","fecha_vencimiento_ano":"","nit_tercero":32556119,"factura":17336332,"numero_barras":"(415)7709998000124(8020)0018952016(3900)000002555760(96)20220131","avaluo_total":26602800,"fecha_ultimo_pago":"1900-01-01 00:00:00.0","loginy":"SITU","id_factura":17336332,"departamento":"ANTIOQUIA","factura_inicial":0,"codigo_tipo_factura":"INDUFAC001","nombre_tipo_factura":"ACTO DE LIQUIDACION IMPUESTO INDUSTRIA Y COMERCIO","tipo_codigo":"ESTABLECIMIENTO:","telefono":"","simbolo_barras_ano":"","periodo_facturacion":1,"matricula":"","municipio":"","codigo_objeto":"204148","consecutivo":18952016,"estado_factura":"A","modulo":"MODULO DE RECAUDO","resolucion_dian":"","id_fuente":3,"porcentaje_propietario":100}],"mensaje":"Se ha cargado la información satisfactoriamente."}
 
Cumpliendo la siguiente arquitectura:
 
 
 

Códigos de respuestas:

1.	No se ha especificado un número de cédula o NIT.
2.	No se ha especificado el tipo de fuente de ingreso.
3.	No se ha especificado un número de ficha predial o consecutivo de establecimiento.
4.	No se ha encontrado un contribuyente para el documento enviado.
5.	No se ha encontrado una fuente para el ID enviado.
6.	La fuente enviada no se encuentra parametrizada.
7.	No se ha encontrado un establecimiento para el consecutivo enviado.
8.	No se ha encontrado un predio para el número de ficha enviado.
9.	Se encontró más de 1 (una) factura activa.
10.	No se encontraron facturas activas para los parámetros enviados.
11.	Se ha cargado la información satisfactoriamente.

Siendo lo anterior, la única respuesta de carga satisfactoria de información es la asociada al código 11, todas las otras respuestas están asociadas a un problema en el proceso.
 
Casos de prueba:

Se adjunta (ver rpt_facturas_prueba.xlsx) documento con lista de datos de prueba. Para el caso del ejemplo se tomó el número de documento 32556119, objeto 204148 y fuente 3.
 
2. Servicio de recaudo:
 
URL: https://ws.serviciosportal.adacsc.co/SITU/factura_recaudo_nex
 
Parámetros (los parámetros pueden ser enviados vía GET o POST): 
 
•	documento: valor numérico referente al número de identificación del contribuyente. En caso de ser NIT no incluir el dígito de verificación.
•	objeto: valor numérico referente al consecutivo del establecimiento. En el caso del impuesto de ICO o número de ficha para el impuesto de predial.
•	fuente: valor numérico referente al identificador de la fuente. Para este caso se parametriza con tres (3) para la fuente de ingreso de ICO y cuatro (4) para a fuente de ingreso de predial respectivamente.
•	factura: valor numérico referente al consecutivo de la factura.
•	forma_pago: valor numérico referente al identificador de la forma de pago. Para el caso de la fuente de ingreso de ICO la forma de pago siempre será mensual, siendo así, el parámetro esperado será cuatro (4). Para el caso de la fuente de ingreso predial se espera una de las dos formas de pago que pueden ser: uno (1) cuando fue realizado el pago anual o dos (2) cuando el pago se realizó por trimestre.
•	valor: valor numérico referente al total de la factura a cancelar. Dicho valor debe coincidir con el impreso en el código de barras.
•	banco: valor numérico referente al código interno de la relación de banco y cuenta para posterior integración financiera. Para el caso del servidor de pruebas, toda petición de recaudo debería ir asociado con el valor banco 583.
Respuesta:
 
{"codigo":12,"mensaje":"Recaudo realizado satisfactoriamente."}
 
Cumpliendo la siguiente arquitectura:
 
 
 
Códigos de respuestas:

1.	No se ha especificado un número de cédula o NIT.
2.	No se ha especificado el tipo de fuente de ingreso.
3.	No se ha especificado un número de ficha predial o consecutivo de establecimiento.
4.	No se ha encontrado un contribuyente para el documento enviado.
5.	No se ha encontrado una fuente de ingreso para el ID enviado.
6.	No se ha especificado el número de factura.
7.	No se ha especificado la forma de pago.
8.	No se ha especificado el valor de la factura.
9.	No se ha especificado el banco.
10.	La fuente de ingreso enviada no se encuentra parametrizada.
11.	No se pudo aprobar el comprobante de ingreso para los parámetros enviados.
12.	Se ha realizado el recaudo satisfactoriamente.
13.	No se ha encontrado una factura activa para el consecutivo enviado.
14.	La forma de pago enviada no existe.
15.	No es una forma de pago relacionada a la fuente de ingreso enviada.
16.	El valor por pagar debe ser mayor a 0 (cero).
17.	No se ha encontrado un banco asociado al código enviado.
18.	No se ha encontrado un establecimiento para el consecutivo enviado.
19.	No se ha encontrado un predio para el número de ficha enviado.
20.	Inconsistencia de información para los parámetros enviados.

Siendo lo anterior, la única respuesta de carga satisfactoria de información es la asociada al código 12, todas las otras respuestas están asociadas a un problema en el proceso.