T1.1 Resolución 000110 de 11-10-2021.pdf

Anexo T1.1 Inscripción en el Registro Único Tributario (RUT) a través de las Cámara de Comercio Versión 1 - 2021

Tabla de contenido

1. Control de versiones ................................ ................................ ................................ ..... 2

2. Notas de la liberación de versiones ................................ ................................ .............. 2

3. Especificación del Servicio................................ ................................ ............................ 3 3.1. Información General Servicio ................................ ................................ ................ 3 3.1.1. Servicios REST ................................ ................................ ................................ ..... 3 3.2. Funcionalidad ................................ ................................ ................................ ........ 4 3.3. Estados de respuesta del servicio ................................ ................................ ......... 5

4. Operaciones ................................ ................................ ................................ ................. 6 4.1. Operación: Inscripción Registro Único Tributario Cámara Comercio ..................... 6 4.1.1. Información General Operación ................................ ................................ ............ 6 4.1.2. Header ................................ ................................ ................................ .................. 6 4.1.3. Entradas ................................ ................................ ................................ ............... 6 4.1.3.1. Ejemplo de trama del request ................................ ................................ ............ 6 4.1.4. Salidas ................................ ................................ ................................ .................. 7 4.1.5. Ejemplo del mensaje response ................................ ................................ ............. 8 4.2. Operación: Inscripción Registro Único Tributario Cámara Comercio ................... 10 4.2.1. Información General Operación ................................ ................................ .......... 10 4.2.2. Header ................................ ................................ ................................ ................ 10 4.2.3. Entradas ................................ ................................ ................................ ............. 10 4.2.4. Salida ................................ ................................ ................................ .................. 10 4.2.4.1. Ejemplo de trama del request ................................ ................................ .......... 11 4.2.4.2. Ejemplo del mensaje response ................................ ................................ ....... 11

5. Tablas de códigos ................................ ................................ ................................ .......... 122

1. Control de versiones

4.2.4.1. Ejemplo de trama del request ................................ ................................ .......... 11 4.2.4.2. Ejemplo del mensaje response ................................ ................................ ....... 11

5. Tablas de códigos ................................ ................................ ................................ .......... 122

1. Control de versiones

Versión Fecha (dd/mm/aaaa) Responsable Descripción 1.0 16/02/2021 Juan Carlos Arias Piñeros

Especificación Inicial del Servicio 1.1 18/05/2021 Juan Carlos Arias Piñeros

Ajuste por creación operación de validación independiente

2. Notas de la liberación de versiones

Versión 1.0

• Especificación Inicial del Servicio3

3. Especificación del Servicio

3.1. Información General Servicio 3.1.1. Servicios REST

Espacio de Nombres Producción https://api.dian.gov.co Espacio de Nombre Pruebas Precondiciones • El sistema de la DIAN debe estar funcionando • La aplicación tiene un token valido

Postcondiciones • El sistema de la DIAN recibe la petición y retorna respuesta acorde a lo solicitado4

3.2. Funcionalidad

1. Ingresar Solicitud:

a. El sistema de Inscripción Rut Vue, recibe un documento XML el cual contiene la información requerida para la generación de un documento Rut y se registra como una solicitud. b. El sistema valida que el documento XML cumpla el formato requerido, c. El sistema valida que la información suministrada sea válida para la generación de un borrador Rut.

2. Formalizar Solicitud:

a. El sistema genera documento borrador Rut y lo deja en estado enviado listo para ser formalizado. b. El sistema formaliza el documento Rut generado.

de un borrador Rut.

2. Formalizar Solicitud:

a. El sistema genera documento borrador Rut y lo deja en estado enviado listo para ser formalizado. b. El sistema formaliza el documento Rut generado. c. El sistema entrega mensaje que contiene el identificador documento Rut, numero de NIT asignado y digito de verificación.5

3.3. Estados de respuesta del servicio

• OK = Exitoso • RE = Registrado
• NV = No Válido
• PR = En Proceso6

4. Operaciones

4.1. Operación: Inscripción Registro Único Tributario Cámara Comercio

4.1.1. Información General Operación

Nombre Operación Solicitud Registro Único Tributario Cámara Comercio Nombre Técnico InscripcionRUTVUE Comando HTTP POST Endpoint /v1/camaracomercio/{numCamara}/solicitudes Descripción Operación Este servicio permite la generación de solicitud de registros Rut mediante él envió de información realizado por cámara y comercio.

4.1.2. Header

Accept application/xml Authorization Bearer <token> Clientid <clientId> Content-Type application/xml 4.1.3. Entradas

La petición requiere los siguientes parámetros

Nombre del Parámetro Descripción Obligatoriedad Longitud Tipo Path Parameters numCamara Código numérico que identifica la cámara que realiza el tramite S Min = 1 Max =2 Numérico

a. numCamara: Posibles valores

Cámaras de comercio (Información tomada de la tabla MAS_CAMARAS_COMERCIO) COD_CAMARA IDE_MUNICIPIO NOM_CAMARA 1 1091850 Camara de Armenia 2 1091882 Camara de Barrancabermeja

Cámaras de comercio (Información tomada de la tabla MAS_CAMARAS_COMERCIO) COD_CAMARA IDE_MUNICIPIO NOM_CAMARA 1 1091850 Camara de Armenia 2 1091882 Camara de Barrancabermeja 3 1091127 Camara de Barranquilla 4 1091150 Camara de Comercio Bogota 5 1091876 Camara de Bucaramanga 6 1092055 Camara de Buenaventura 7 1092056 Camara de Buga 8 1092049 Camara de Cali 9 1091158 Camara de Cartagena 10 1092061 Camara de Cartago 11 1091806 Camara de Cucuta ….. …… …… … ..

4.1.3.1. Ejemplo de trama del request

El cuerpo del mensaje en formato XML, se compone7

4.1.4. Salidas El mensaje de respuesta en formato XML se compone de los campos definidos a continuación:

• RE = Registrado. <?xml version="1.0" encoding="ISO-8859-1"?> <d_001_4_cc xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="d_ws_d_001_4_cc.xsd">

<h_1> <co_h_1> <cab> <ca_2 v="1"/> <ca_4/> </cab> <ca_24 v="2"/> <ca_25 v="22"/> <ca_26 v="12799638"/> <ca_27 v="2008-03-06"/> <ca_28 v="169"/> <ca_29 v="11"/> <ca_30 v="001"/> <ca_31 v="CAMARA64"/>

<ca_26 v="12799638"/> <ca_27 v="2008-03-06"/> <ca_28 v="169"/> <ca_29 v="11"/> <ca_30 v="001"/> <ca_31 v="CAMARA64"/> <ca_32 v="COMERCIO64"/> <ca_33 v="PERSONA64"/> <ca_34 v="NATURAL64"/> <ca_37 v=""/> <ca_38 v="169"/> <ca_39 v="11"/> <ca_40 v="001"/> <ca_41 v="CR 67 7 08"/> <ca_42 v="PRUEBAW@CORREO.COM"/> <ca_43 v="76886"/> <ca_44 v="1234567"/> <ca_46 v="1104"/> <ca_47 v="2010-03-04"/> <ca_53> <itE id="1" v="12"/> </ca_53> <ca_52 v="001"/> <ca_61 v="2012-11-01"/> <pie> <ca_984 v="98671719"/>

<ca_985 v="PRUEBA CRISTINA ORA11 NOV01-2012"/>

</pie> </co_h_1> </h_1> <h_2> <co_h_2 id="1"> <ca_71> <itE id="1" v="09"/> </ca_71> <ca_75> <itE id="1" v="03"/> </ca_75> <ca_76> <itF id="1" v="2010-02-01"/> </ca_76> <ca_77>

<ca_75> <itE id="1" v="03"/> </ca_75> <ca_76> <itF id="1" v="2010-02-01"/> </ca_76> <ca_77> <itC id="1" v="0053319448"/> </ca_77> <ca_78> <itE id="1" v="05"/> </ca_78> <ca_79> <itE id="1" v="21"/> </ca_79> </co_h_2> </h_2> </d_001_4_cc>8

El documento enviado en formato XML es válido contra el esquema, los datos contenidos en el documento son los necesarios para la generación del registro.

La respuesta a este escenario es un XML similar al siguiente:

o est = Estado de Respuesta o cc = Código de la Cámara de Comercio o mat = Matricula Mercantil o ideSolicitud = identificador Solicitud

• NV = No Válido.

Esta respuesta se da cuando el XML que es enviado al servicio no es válido contra el esquema.

La respuesta a este escenario es similar a:

o est = Estado de Respuesta o ev = Lista de errores de Validación o e = Mensaje de Error o id_ef = Código del estado ó error (Hace parte de una lista de estados y errores). o id_g = Código del grupo ó página a la cual pertenece la casilla. o id_c = Código de la casilla. o n_o = Número de Ocurrencia ó Copia de la página a la cual pertenece la casilla. o n_it = Número de Iteración (fila ó columna). Este número únicamente se aplica

o id_c = Código de la casilla. o n_o = Número de Ocurrencia ó Copia de la página a la cual pertenece la casilla. o n_it = Número de Iteración (fila ó columna). Este número únicamente se aplica para casillas o tipo columna. Es decir, cuando una misma casilla puede tener varios valores. o anag = Anagrama de un nombre ó una dirección. Es para uso interno de la DIAN. o id_obj = identificador correspondiente a un registro interno. Es para uso interno de la DIAN. o act = Indica si el error está activo (‘s’ ó ‘n’).

4.1.5. Ejemplo del mensaje response

a. El documento valida correctamente la información <?xml version="1.0" encoding="UTF-8"?> <resp_ing_sol_rut_cc est="RE"> <num_solicitud_cc cc="4" con="1" ideSolicitud="ba76a974-d34c-4f9c-a6e2b2a654837120" mat="0099005233"/> </resp_ing_sol_rut_cc>

<resp_ing_sol_rut_cc est="NV"> <ev> <e> Se presentá una excepción al intentar validar el XML. </e> </ev> </resp_ing_sol_rut_cc>

<resp_ing_sol_rut_cc est="NV"> <ev> <e> Error de homonimia. Persona consistente con nombres y nit pero no digito el NIT. </e> </ev> </resp_ing_sol_rut_cc>

<resp_ing_sol_rut_cc est="NV"> <ev> <e act="n" id_c="161" id_ef="899" id_g="6" n_it="1" n_o="1"/> </ev> </resp_ing_sol_rut_cc>9

<resp_ing_sol_rut_cc est="NV"> <ev> <e act="n" id_c="161" id_ef="899" id_g="6" n_it="1" n_o="1"/> </ev> </resp_ing_sol_rut_cc>9

b. El Documento no valida correctamente el formato del documento Xml

c. El Documento no valida correctamente la información contenida en el documento10

4.2. Operación: Inscripción Registro Único Tributario Cámara Comercio

4.2.1. Información General Operación

Nombre Operación Formalizar solicitud Cámara Comercio Nombre Técnico InscripcionRUTVUE Comando HTTP POST Endpoint /v1/camaracomercio/{numCamara}/solicitudes/{ideSolicitud}/formalizar Descripción Operación Este servicio permite la formalización de solicitud de registros Rut mediante él envió de información realizado por cámara y comercio, entrega como resultado Nit y Ide Documento Rut. 4.2.2. Header

Accept application/xml Authorization Bearer <token> Clientid <clientId> Content-Type application/xml 4.2.3. Entradas La petición requiere los siguientes parámetros

Nombre del Parámetro Descripción Obligatoriedad Longitud Tipo Path Parameters numCamara Código numérico que identifica la cámara que realiza el tramite S Min = 1 Max =2 Numérico IdeSolicitud Identificador solicitud cámara comercio S 37 Cadena

4.2.4. Salida El mensaje de respuesta en formato XML se compone de los campos definidos a continuación:

• OK = Exitoso.

o est = Estado de Respuesta o cc = Código de la Cámara de Comercio o mat = Matricula Mercantil

El mensaje de respuesta en formato XML se compone de los campos definidos a continuación:

• OK = Exitoso.

o est = Estado de Respuesta o cc = Código de la Cámara de Comercio o mat = Matricula Mercantil o ideDocRut = Ide Documento Rut o nit = Número de identificación Tributario o dv = Digito de verificación de Nit

• NF = No Formalizado.

Esta respuesta se da cuando el XML que es enviado al servicio no es válido contra el esquema.

La respuesta a este escenario es similar a:

<?xml version="1.0" encoding="UTF-8"?> <resp_ing_sol_rut_cc est="OK"> <num_nit_cc cc="4" con="1" dv="6" ideDocRut="14132120292" mat="88005232" nit="700085881"/> </resp_ing_sol_rut_cc>11

4.2.4.1. Ejemplo de trama del request

4.2.4.2. Ejemplo del mensaje response

a. El documento se formalizar correctamente

b. El proceso de formalización fallo

<resp_ing_sol_rut_cc est="NF"> <ev> <e> Se presentá un error al momento de formalizar. </e> </ev> </resp_ing_sol_rut_cc>12

Anexos

5. Tablas de códigos

Código de Respuesta

Código Respuest a Nombre Respuesta Detalle de la Respuesta

Acción a Seguir 200 Éxito La transacción ha sido exitosa N/A 401 Acceso no Permitido Los parámetros de autenticación no son válidos. Acceso denegado a aplicación. Obtener un token valido y

Acción a Seguir 200 Éxito La transacción ha sido exitosa N/A 401 Acceso no Permitido Los parámetros de autenticación no son válidos. Acceso denegado a aplicación. Obtener un token valido y enviar la trama 422 Entidad no procesable La petición estaba bien formada pero no se pudo completar. Validar la respuesta y solicitar soporte según sea el caso 500 Error interno del servidor Ocurrió un error inesperado en el servidor Solicitar soporte técnico

NOTA: El 401 no se responden usando la estructura definida en los servicios debido a que nunca alcanza a llegar al servicio. Son interceptados por la capa de seguridad y devueltos con el código HTTP y una breve descripción.