T8.57 Anexo Resolución 489 de 2022.pdf

Anexo T8.57 Versión 1.0

Información Pública

Control de Versiones

Fecha Versión Descripción Responsable 2021-11-09 1.0

Versión Inicial.

DIAN2

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Contenido

1. Definiciones ................................ ................................ ................................ ................. 3

2. Formatos de comunicación ................................ ................................ ......................... 3

3. Especificación de Servicios ................................ ................................ ......................... 3 3.1. Información del servicio ................................ ................................ ............................ 3 3.2. Funcionalidad ................................ ................................ ................................ ........... 4

4. Operaciones del servicio ................................ ................................ ............................. 5 4.1. Operación: Envío de solicitud ................................ ................................ ................... 5 4.1.1. Información general de la operación ................................ ................................ .... 5 4.1.2. Entradas ................................ ................................ ................................ .............. 5 4.1.3. Ejemplo de mensaje de envío de una solicitud ................................ .................... 8 4.1.4. Salidas ................................ ................................ ................................ ............... 10 4.1.5. Ejemplo del mensaje response Exitoso para envío de una solicitud .................. 12 4.1.6. Ejemplo del mensaje response NO Exitoso para envío de una solicitud ............ 12 4.1.7. Notificación de solicitud gestionada (Opcional) ................................ .................. 12 4.2. Operación: Consultar resultado gestión ................................ ................................ . 13 4.2.1. Información de la operación ................................ ................................ ............... 13 4.2.2. Entradas ................................ ................................ ................................ ............ 14

4.2. Operación: Consultar resultado gestión ................................ ................................ . 13 4.2.1. Información de la operación ................................ ................................ ............... 13 4.2.2. Entradas ................................ ................................ ................................ ............ 14 4.2.3. Ejemplo ................................ ................................ ................................ ............. 14 4.2.4. Salidas ................................ ................................ ................................ ............... 14 4.2.5. Ejemplo del mensaje response Exitoso para consultar el resultado de una solicitud Gestionada ................................ ................................ ................................ ........ 16 4.2.6. Ejemplo del mensaje response Exitoso para consultar el resultado de una solicitud No Gestionada ................................ ................................ ................................ ... 16 4.2.7. Ejemplo del mensaje response NO Exitoso para consultar el resultado de la gestión de una solicitud ................................ ................................ ................................ ... 16 4.3. Operación: Notificación de Pago ................................ ................................ ............ 17 4.3.1. Información general de la operación ................................ ................................ .. 17 4.3.2. Entradas ................................ ................................ ................................ ............ 17 4.3.3. Ejemplo ................................ ................................ ................................ ............. 18 4.3.4. Salidas ................................ ................................ ................................ ............... 18 4.3.5. Ejemplo del mensaje response Exitoso para envío de un pago ......................... 20 4.3.6. Ejemplo del mensaje response NO Exitoso para envío de un pago ................... 20

5. Tablas ................................ ................................ ................................ ....................... 20 5.1. Tabla CODIGOS DE RESPUESTA ................................ ................................ ........ 20 5.2. Tabla TIPOS DE DOCUMENTO ................................ ................................ ............ 21 5.3. Tabla SECCIONALES ................................ ................................ ............................ 21 5.4. Tabla LUGARES DE SALIDA ................................ ................................ ................. 22 5.5. Tabla PAISES ................................ ................................ ................................ ........ 223

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología

5.5. Tabla PAISES ................................ ................................ ................................ ........ 223

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co

1. Definiciones

Termino/Abreviatura Descripción TOKEN También conocido como token de autenticación o token criptográfico es un elemento electrónico que se le da a un usuario autorizado de un servicio computarizado para facilitar el proceso de autenticación. REST-Based Web Service

Representational State Transfer (REST por sus siglas en ingles), son una forma de proveer interoperabilidad entre sistemas. Los servicios que cumplen con los requerimientos REST permitir a sistemas acceder y manipular representaciones de Recursos Web usando una forma única y predefinida de operaciones sin estado. JSON

JavaScript Object Notation, es un formato mínimo y legible para estructurar datos. Es utilizado para la transmisión de datos entre aplicaciones web como una alternativa al XML. valetkey Patrón de diseño que utiliza un token que proporciona a los clientes acceso directo restringido a un recurso específico para descargar la transferencia de datos de la aplicación. Esto es particularmente útil en aplicaciones que utilizan colas o sistemas de almacenamiento alojados en la nube, y puede minimizar el costo y maximizar la escalabilidad y el rendimiento. (https://docs.microsoft.com/enus/azure/architecture/patterns/valet-key)

2. Formatos de comunicación

• Protocolo de aplicación: REST-Based Web Service (API Web), • Formato de intercambio de datos en el contenido del mensaje: JSON

(https://docs.microsoft.com/enus/azure/architecture/patterns/valet-key)

2. Formatos de comunicación

• Protocolo de aplicación: REST-Based Web Service (API Web), • Formato de intercambio de datos en el contenido del mensaje: JSON • Formato de codificación en el contenido del mensaje: UTF-8. • Formato de datos de tipo Datetime: Los datos de tipo datetime (fecha y hora) se deben enviar usando el formato YYYY-MM-DDThh:mm:ss.SSS, usando la hora local colombiana

(para facilitar los procesos de comparación de fechas). Ejemplo, 2017 -0716T19:20:30.984.

3. Especificación de Servicios 3.1. Información del servicio

Nombre del servicio Servicio de devolución IVA turista Nombre técnico IvaTurista Consumido por Empresa operadora Comando HTTP ambiente Producción http://api.azure.dian.gov.co/devolucion/4

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Comando HTTP ambiente Pruebas http://apipruebasexternas.dian.gov.co/devolucion/

Versión 1.0

3.2. Funcionalidad

1. La empresa operadora envía a la DIAN los datos de una solicitud de IVA turista. La DIAN confirma la recepción de la solicitud enviando un numero de ticket a la empresa operadora.

1. La empresa operadora envía a la DIAN los datos de una solicitud de IVA turista. La DIAN confirma la recepción de la solicitud enviando un numero de ticket a la empresa operadora.

2. La DIAN notifica a la empresa operadora cuando una solicitud de devolución IVA turista ha sido gestionada , a través de la url enviada en el atributo href del objeto callBack incluido en la solicitud recibida. La empresa operadora puede o no exponer la url para recibir la respuesta de la notificación del resultado de la gestión de la solicitud. En el caso en el que no se envíe una url, la empresa operadora tendrá que cumplir las precondiciones mencionadas en el numeral 4.2.1. Información de la operación.

3. La empresa operadora consulta el resultado de la gestión de una solicitud de IVA turista. La DIAN responde a la empresa operadora enviando el valor solicitado, el valor aprobado y el valor rechazado.

4. La empresa operadora envía a la DIAN la información del pago realizado al turista, de acuerdo al valor aprobado por la DIAN. La DIAN confirma la recepción del pago enviando un numero de ticket a la empresa operadora.

1 Empresa Operadora DIAN 2 3 4 Envío de solicitud Notificación de procesamiento de la solicitud (opcional) Consultar resultado gestión Recibir pago5

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711

Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co

4. Operaciones del servicio 4.1. Operación: Envío de solicitud 4.1.1. Información general de la operación

Nombre operación Envío de solicitud. Comando HTTP ambiente Producción POST http://api.azure.dian.gov.co/devolucion/v1/turistas/{identificacion}/iva Comando HTTP ambiente Pruebas http://apipruebasexternas.dian.gov.co/devolucion/v1/turistas/{identificacion}/iva Descripción de la operación Envío de una solicitud de devolución IVA turista. Precondiciones • El sistema de la DIAN debe estar funcionando. • La aplicación de la empresa operadora tiene un token válido. PostCondiciones • El sistema de la DIAN recibe una solicitud de devolución de IVA turista y retorna una respuesta a la empresa operadora.

4.1.2. Entradas

El men saje de request en formato JSON se compone de los campos definidos a continuación:6

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores numeroRadicado Numérico 14 SI Consecutivo generado por la

Código postal 111711 www.dian.gov.co Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores numeroRadicado Numérico 14 SI Consecutivo generado por la empresa operadora.

Estructura: 4 dígitos del año, 2 dígitos de seccional, 8 dígitos del consecutivo nacional. fechaRadicado Alfanumérico N/A SI Fecha del sistema en el momento de presentar la solicitud diligenciada manualmente por el turista. Aplica formato YYYY-MMDDThh:mm:ss.SSS. informacionTurista Objeto N/A SI Información del turista. fechaIngreso Alfanumérico 10 SI Fecha en que ingresa el turista al país. Aplicar formato YYYY-MM-DD. datosSalidaPais Objeto N/A SI Objeto que contiene la información del lugar de salida del país. totalFacturas Numérico 4 SI Cantidad facturas adjuntas. valorTotal Numérico 9 SI Valor total compras. valorTotalIva Numérico 9 SI Valor total solicitud IVA. avalVerificaViajeros Boolean 1 SI Si procede inspección física o no. facturas Objeto N/A SI Objeto que contiene la información de las facturas relacionadas en la solicitud. observaciones Alfanumérico 250 NO Observaciones asociadas a la solicitud.7

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co

Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co codigoDireccionSeccional Numérico 2 SI Código de la seccional relacionada al lugar donde se radica la solicitud. Ver tabla SECCIONALES. callback Objeto N/A SI Objeto con la información para envío de notificación del proceso. OBJETOS ASOCIADOS informacionTurista datosIdentificacionTurista Objeto N/A SI Datos de Identificación de un turista. numeroTarjetaCredito Alfanumérico 16 SI Número de tarjeta de crédito del turista. correoElectronico Alfanumérico 60 SI Correo electrónico del turista. datosIdentificacionTurista datosBasicosIdentificacion Objeto N/A SI Datos básicos de Identificación de un turista. codigoPais Numérico 3 SI Código del país origen del turista. Ver tabla PAISES. datosBasicosIdentificacion tipoIdentificacion Alfanumérico 4 SI Tipo documento identificación turista. Ver tabla TIPOS DE DOCUMENTO. numeroIdentificacion Alfanumérico 30 SI Número del documento de identificación del turista. primerNombre Alfanumérico 50 SI Primer nombre del turista. otrosNombres Alfanumérico 50 NO Otros nombres del turista. primerApellido Alfanumérico 50 SI Primer apellido del turista. segundoApellido Alfanumérico 50 NO Segundo apellido del turista. datosSalidaPais codigoLugar Numerico 2 SI Código del lugar de salida. Ver tabla

LUGARES DE

turista. segundoApellido Alfanumérico 50 NO Segundo apellido del turista. datosSalidaPais codigoLugar Numerico 2 SI Código del lugar de salida. Ver tabla

LUGARES DE

SALIDA.8

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co fecha Alfanumerico 10 SI Fecha de salida del turista del país. Aplicar formato YYYY-MM-DD. facturas nitEmisor Numérico 14 SI NIT emisor. prefijo Alfanumérico 4 NO Prefijo de la factura. consecutivo Alfanumerico 16 SI Número de la factura. fecha Alfanumerico 8 SI Fecha de la factura. Formato YYYY-MMDD. valorIva Numérico 9 SI Valor IVA de la factura. valorTotal Numérico 9 SI Valor total de la factura. cufe Alfanumérico 96 SI Código único que identifica a una factura electrónica. items Objeto N/A SI Representa los items incluidos en las facturas relacionadas en la solicitud. items codigo Alfanumérico 10 SI Código del ítem descripcion Alfanumérico 250 SI Descripción del ítem valorIva Numérico 9 SI Valor IVA del ítem valorTotal Numérico 9 SI Valor total del ítem, no tiene incluido el IVA indicadorBien Boolean N/A SI Indica si el item de la factura es un bien o no. callback

valorIva Numérico 9 SI Valor IVA del ítem valorTotal Numérico 9 SI Valor total del ítem, no tiene incluido el IVA indicadorBien Boolean N/A SI Indica si el item de la factura es un bien o no. callback rel Alfanumérico 100 NO Descripcion del callback. href Alfanumérico 500 SI url para envío de terminación del proceso. Valor proporcionado por la empresa operadora. method Alfanumérico 10 NO Método http para envio de respuesta.

4.1.3. Ejemplo de mensaje de envío de una solicitud9

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Ejemplo de una solicitud con 1 factura y 1 item.

{ "numeroRadicado": 202132000008, "fechaRadicado": "2021-09-27T16:13:53.085", "informacionTurista": { "datosIdentificacionTurista": { "datosBasicosIdentificacion": { "tipoIdentificacion": "CE", "numeroIdentificacion": "A999999", "primerApellido": "AA1", "segundoApellido": "", "primerNombre": "NN1", "otrosNombres": "" }, "codigoPais": 63 }, "numeroTarjetaCredito": 1111222233334444, "correoElectronico": "test@correo.com" },

"otrosNombres": "" }, "codigoPais": 63 }, "numeroTarjetaCredito": 1111222233334444, "correoElectronico": "test@correo.com" }, "fechaIngreso": "2020-10-07", "datosSalidaPais": { "codigoLugar": 32, "fecha": "2020-11-07" }, "totalFacturas": 1, "valorTotal": 120000, "valorTotalIva": 30000, "avalVerificacionViajeros": true, "facturas": [ { "nitEmisor": 700, "prefijo": "AB", "consecutivo": "0001", "fecha": "2021-05-03", "valorIva": 37500, "valorTotal": 200000, "cufe": "27174bf0a0daef147ffe0a9dcc19d6e40e0749aacc6e43cd79c73be4e2c2dff4087f7e4 5a1d537f091391671c174453b", "items": [ { "codigo": "5", "descripcion": "zapatos", "valorIva": 10000, "valorTotal": 60000, "indicadorBien": true } ]10

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co } ],

Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co } ], "codigoDireccionSeccional": 5, "observaciones": "", "callback": { "rel": null, "href":"http://www.empresaoperadora.com/recibirNotificacionSolicitud", "method": "GET" } }

4.1.4. Salidas

El mensaje de response en formato JSON se compone de los campos definidos a continuación:11

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores resultados Arreglo de objetos tipo ValetKeyStatu s N/A NO Arreglo que contiene los resultados obtenidos. Valor retornado por la DIAN. totalRegistros Numérico 4 SI Cantidad de solicitudes recibidas. Por defecto el total de registros es 1 estampaTiempo Alfanumerico N/A SI Fecha y hora de entrega de la respuesta. Aplica formato YYYY-MMDDThh:mm:ss.SSS. mensajes Arreglo de objetos de tipo Mensaje N/A NO Descripción del mensaje de la respuesta OBJETOS ASOCIADOS ValetKeyStatus id Alfanumérico 50 SI Identificador del ticket asignado al proceso.

mensajes Arreglo de objetos de tipo Mensaje N/A NO Descripción del mensaje de la respuesta OBJETOS ASOCIADOS ValetKeyStatus id Alfanumérico 50 SI Identificador del ticket asignado al proceso. fechaInicio Alfanumérico N/A SI Fecha de inicio del procesamiento. Aplica formato YYYY-MMDDThh:mm:ss.SSS. tiempoEjecucion Alfanumérico 15 NO Tiempo de finalización del procesamiento. estado Alfanumérico 15 SI Estado del procesamiento:

ERROR,

EN_PROCESO,

TERMINADO, NO_PROCESADO notificado Boolean N/A NO Indica si hubo notificación de procesamiento. Mensaje tipo Alfanumérico 8 SI Corresponde a uno de los siguientes datos: [INFO, WARNING, FATAL, ERROR] codigo Numérico 5 SI Código del mensaje de respuesta. Ver tabla CODIGOS DE RESPUESA. mensaje Alfanumérico 200 SI Nombre del mensaje de respuesta. descripcion Alfanumérico 500 NO Descripción del mensaje de respuesta.12

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co 4.1.5. Ejemplo del mensaje response Exitoso para envío de una solicitud

{ "resultados": [ { "id": "2a07d7e6-a6d3-4e0c-8073-404c9f60aed0",

4.1.5. Ejemplo del mensaje response Exitoso para envío de una solicitud

{ "resultados": [ { "id": "2a07d7e6-a6d3-4e0c-8073-404c9f60aed0", "fechaInicio": "2021-11-02T16:43:55.087", "tiempoEjecucion": null, "estado": "NO_PROCESADO", "notificado": false } ], "totalRegistros": 1, "estampaTiempo": "2021-11-02T16:43:55.899", "mensajes": null } 4.1.6. Ejemplo del mensaje response NO Exitoso para envío de una solicitud

{ "resultados": null, "totalRegistros": 0, "estampaTiempo": "2021-11-02T16:56:09.373", "mensajes": [ { "tipo": "ERROR", "codigo": 30009, "mensaje": "Error en validación de parámetros", "descripcion": "El parámetro 'Número de identificación' must not be empty.: [informacionTurista.datosIdentificacionTurista.datosBasicosIdentificacion.numeroIdentifica cion]" } ] }

4.1.7. Notificación de solicitud gestionada (Opcional)

Cuando se realice la actualización del procesamiento del ticket de envío de solicitud por parte de la DIAN, se realiza la notificación hacia la empresa operadora a través de la url informada en el atributo href del objeto callBack incluido en la solicitud recibida. Después de que la empresa operadora recibe la notificación de cambio de estado del ticket, podrá ejecutar la operación 4.2. Operación: Consultar resultado gestión.

informada en el atributo href del objeto callBack incluido en la solicitud recibida. Después de que la empresa operadora recibe la notificación de cambio de estado del ticket, podrá ejecutar la operación 4.2. Operación: Consultar resultado gestión.

Ejemplo de url expuesta por la empresa operadora:13

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co http://www.empresaoperadora.com/recibirNotificacionSolicitud?valetKeyId=0575bfda56a2-4f03-8b63-fd921bc03529

4.2. Operación: Consultar resultado gestión

4.2.1. Información de la operación

Nombre operación Consultar el resultado de la gestión de una solicitud. Comando HTTP ambiente Producción GET http://api.azure.dian.gov.co/devolucion/v1/ turistas/{identificacion}/iva/{numeroRadicado}/resultadoGestion Comando HTTP ambiente Pruebas http://apipruebasexternas.dian.gov.co/devolucion/v1/ turistas/{identificacion}/iva/{numeroRadicado}/resultadoGestion

Descripción de la operación Consultar el resultado gestión de la solicitud con base a la información obtenida por la fuente. Precondiciones • El sistema de la DIAN debe estar funcionando. • La aplicación de la empresa operadora tiene un token válido. • La solicitud consultada debió ser recibida por la DIAN anteriormente.

obtenida por la fuente. Precondiciones • El sistema de la DIAN debe estar funcionando. • La aplicación de la empresa operadora tiene un token válido. • La solicitud consultada debió ser recibida por la DIAN anteriormente.

Si la empresa operadora no informa una url valida en el atributo href del objeto callBack incluido en la solicitud recibida, se aplican las siguientes precondiciones: • La empresa operadora deberá esperar a que hayan transcurrido (5) días desde el envío de la solicitud a la fecha en que se realice la consulta del resultado de la gestión de la solicitud. • Si han transcurrido (5) días desde el envío de la solicitud a la fecha de la consulta del resultado de la gestión, y no se obtiene respuesta de los valores del resultado de la gestión (Ver 4.2.6. Ejemplo del mensaje response Exitoso para consultar el resultado de una solicitud No Gestionada), la empresa operadora podrá consultar de nuevo cada (12) horas. PostCondiciones • La empresa operadora recibe los valores del resultado de la gestión de la solicitud de devolución de IVA a turista.14

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co

4.2.2. Entradas

La url de la solicitud contiene los siguientes parámetros:

Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores {identificacion} Alfanumérico 30 SI Identificación del turista de la forma: tipo de identificación “-“ número de identificación.

Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores {identificacion} Alfanumérico 30 SI Identificación del turista de la forma: tipo de identificación “-“ número de identificación. {numeroRadicado} Numérico 14 SI Numero de radicado asociado a la solicitud de devolución.

4.2.3. Ejemplo

http://api.azure.dian.gov.co/devolucion/v1/turistas/CE4357/iva/202132000010/resultadoGestion

4.2.4. Salidas

El mensaje de response en formato JSON se compone de los campos definidos a continuación:15

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores resultados Arreglo de objetos de tipo ResultadoGestion N/A NO Arreglo que contiene los resultados obtenidos. totalRegistros Numérico 4 SI Cantidad de solicitudes recibidas. Por defecto es 1. estampaTiempo Alfanumerico N/A SI Fecha y hora de entrega de la respuesta. Aplica formato YYYY-MMDDThh:mm:ss.SSS. mensajes Arreglo de objetos de tipo Mensaje N/A NO Descripción del mensaje de la respuesta OBJETOS ASOCIADOS ResultadoGestion valorTotalSolicitado Numérico 9 NO Corresponde al atributo valorTotalIva incluido en la

mensajes Arreglo de objetos de tipo Mensaje N/A NO Descripción del mensaje de la respuesta OBJETOS ASOCIADOS ResultadoGestion valorTotalSolicitado Numérico 9 NO Corresponde al atributo valorTotalIva incluido en la solicitud. (Ver 4.1.2. Entradas) valorTotalRechazado Numérico 9 NO Valor rechazado durante la gestión de la solicitud por parte de la DIAN. valorTotalDevuelto Numérico 9 NO Valor aprobado durante la gestión de la solicitud por parte de la DIAN. Valor para ser devuelto al turista. Mensaje tipo Alfanumérico 8 SI Corresponde a uno de los siguientes datos: [INFO, WARNING, FATAL, ERROR] codigo Numérico 5 SI Código del mensaje de respuesta. Ver tabla CODIGOS DE RESPUESA. mensaje Alfanumérico 200 SI Nombre del mensaje de respuesta. descripcion Alfanumérico 500 NO Descripción del mensaje de respuesta.16

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co

4.2.5. Ejemplo del mensaje response Exitoso para consultar el resultado de una solicitud Gestionada

{ "resultados": [ { "valorTotalSolicitado": 100000, "valorTotalRechazado": 0, "valorTotalDevuelto": 100000 } ],

solicitud Gestionada

{ "resultados": [ { "valorTotalSolicitado": 100000, "valorTotalRechazado": 0, "valorTotalDevuelto": 100000 } ], "totalRegistros": 1, "estampaTiempo": "2021-11-02T16:59:19.371", "mensajes": null }

4.2.6. Ejemplo del mensaje response Exitoso para consultar el resultado de una solicitud No Gestionada

{ "resultados": null, "totalRegistros": 0, "estampaTiempo": "2021-11-02T17:00:07.499", "mensajes": [ { "tipo": "WARNING", "codigo": 30805, "mensaje": "Información de resultado gestión no encontrada", "descripcion": "La Información de resultado gestión para la solicitud con número de radicado {0} no fue encontrada." } ] }

4.2.7. Ejemplo del mensaje response NO Exitoso para consultar el resultado de la gestión de una solicitud

{ "resultados": null, "totalRegistros": 0, "estampaTiempo": "2021-11-02T17:00:07.499", "mensajes": [ { "tipo": "ERROR",17

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co

Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co "codigo": 30801, "mensaje": "Solicitud no encontrada", "descripcion": "Solicitud con número de radicado: {0} no encontrada." } ] }

4.3. Operación: Notificación de Pago 4.3.1. Información general de la operación

Nombre operación Notificar el pago de una solicitud Comando HTTP ambiente Producción POST http://api.azure.dian.gov.co/devolucion/v1/ turistas/{identificacion}/iva/{numeroRadicado}/pagos

Comando HTTP ambiente Pruebas http://apipruebasexternas.dian.gov.co/devolucion/v1/ turistas/{identificacion}/iva/{numeroRadicado}/pagos

Descripción de la operación Recibe la información de pagos realizados por devolución de IVA a turistas. Precondiciones • El sistema de la DIAN debe estar funcionando. • La aplicación de la empresa operadora tiene un token válido. • La empresa operadora debe haber realizado el pago de la devolución exitosamente. PostCondiciones • El sistema de la DIAN recibe la información de un pago de devolución de IVA turista y retorna una respuesta a la empresa operadora.

4.3.2. Entradas

El mensaje de request en formato JSON se compone de los campos definidos a continuación:18

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología

El mensaje de request en formato JSON se compone de los campos definidos a continuación:18

Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Dirección de Gestión de Innovación y Tecnología Cra. 8 Nº 6C-38 piso 5º PBX 607 9999 - 382 4500 ext. 903401 Código postal 111711 www.dian.gov.co Nombre del Campo Tipo de Dato Tamaño Requerido SI/NO Valores numeroTarjetaCredito Numérico 16 SI Número tarjeta crédito turista expedida fuera del país. valorTransaccion Numérico 9 SI Valor abonado a la tarjeta de crédito del turista extranjero. fechaTransaccion Alfanumérico 16 SI Fecha del pago YYYY-MMDDThh:mm:ss.SSS numeroTransaccion Numérico 50 SI Número de la transacción electrónica de abono de la devolución. observaciones Alfanumérico 250 NO Observaciones asociadas a la solicitud.

4.3.3. Ejemplo

{ "numeroTarjetaCredito": "1111222233334444", "valorTransaccion": 100000, "fechaTransaccion": "2020-11-07T15:15:43.074", "nume