DIAN - Resolución 36 de 17-03-2022

DIAN POR UNA COLOMBIA MÁS HOMESTA RESOLUCIÓN NÚMERO 900036 ( 17 MAR 2022) Por medio de la cual se establecen las especificaciones técnicas para el intercambio de información por parte de los puertos y/o muelles de servicio público, a través de los servicios informáticos electrónicos de la Dirección de Impuestos y Aduanas Nacionales, relacionado con la información de los documentos denominados ARIM y TARJA o sus equivalentes para el ingreso de mercancías al territorio aduanero nacional con destino a la importación. EL DIRECTOR GENERAL DE LA UNIDAD ADMINISTRATIVA ESPECIAL DIRECCIÓN DE IMPUESTOS Y ADUANAS NACIONALES En uso de las facultades legales y en especial las dispuestas en el numeral 2 del artículo 8 del Decreto 1742 de 2020 y en el Capítulo 7 del Título 1 del Decreto 1165 de 2019 y CONSIDERANDO Que el artículo 24 del Decreto 1165 de 2019 señala que los procedimientos para el cumplimiento de los trámites, operaciones u obligaciones aduaneras, así como para la aplicación de los diferentes regímenes aduaneros, deberán llevarse a cabo mediante el uso de los Servicios Informáticos Electrónicos dispuestos por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales (DIAN). Que el Intercambio de datos entre los sistemas de información de la Dirección de Impuestos y Aduanas Nacionales y puertos y/o muelles, busca agilizar y resolver oportuna y eficazmente los procedimientos para garantizar una operación logística óptima, mejorar significativamente los controles aduaneros en el marco de la inteligencia corporativa.

Que como parte del Proyecto de Modernización Aduanera, que comprende los Servicios de Intercambio de Información entre la Dirección de Impuestos y Aduanas Nacionales con los puertos y/o muelles de servicio público, se incluyó la opción de la emisión de la información de ARIM y TARJA o sus equivalentes para el ingreso de mercancías al territorio aduanero nacional con destino a la importación, con el propósito de potencializar la inteligencia corporativa junto con el control aduanero bajo la perspectiva de la facilitación al comercio exterior, Que se hace necesario señalar las características técnicas de los sistemas de información de la Dirección de Impuestos y Aduanas Nacionales para la estructura de datos que deben establecer los puertos y/o muelles de servicio público, para cumplir con el envío de la información correspondiente al ARIM y TARJA. Que en cumplimiento de lo dispuesto en el numeral 8 del artículo 8 de la ley 1437 de 2011 y lo previsto en el numeral 2 del artículo 32 de la Resolución 91 de 2021, el proyecto de resolución se publicó en la página web de la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales — DIAN, durante los días del 23 de febrero al 7 de marzo de 2022. Por lo anterior y en atención al Principio de Eficiencia indicado en el numeral 1 del artículo 2 Decreto 1165 de 2019, el Director General de la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales,

RESUELVE.

ARTÍCULO 1. Ámbito de aplicación. La presente resolución aplica a los servicios de intercambio de información a través de servicios informáticos electrónicos de la Dirección de Impuestos y Aduanas Nacionales (DIAN), para el envío de información de los puertos y/o muelles de servicio

público sobre los documentos denominados:

Ce RESOLUCIÓN NÚMERO 0900036 de 17 MAR 2022 Hoja No.

Continuación de la Resolución Por medio de la cual se establecen las especificaciones técnicas para el intercambio de información por parte de los puertos y/o muelles de servicio público, a través de los servicios informáticos electrónicos de la Dirección de Impuestos y Aduanas Nacionales, relacionado con la información de los documentos denominados ARIM y TARJA o sus equivalentes para el ingreso de mercancías al territorio aduanero nacional con destino a la importación.

ARIM: Es la autorización de retiro o ingreso de mercancías a la terminal portuaria, o su documento equivalente.

TARJA: Es el documento en el que se registra y controla la cantidad y estado de las mercancías que transporta un buque, que contiene la información detallada de una carga o descarga

(embarque o desembarque) y mediante el cual se certifica el recibo y despacho de todas las mercancías desde o hacia las instalaciones portuarias, o su documento equivalente. Los documentos objeto de envío de información al servicio informático de la Dirección de Impuestos y Aduanas Nacionales (DIAN) a los que hace referencia el presente artículo, serán aquellos que expide el puerto y/o muelle de servicio publico para el ingreso de mercancías al territorio aduanero nacional con destino a la importación. ARTICULO 2. Servicio de envío de la información del documento ARIM o su documento equivalente para importación. El servicio de envío de ARIM o su documento equivalente para importación a que se refiere el artículo 1 de la presente resolución, corresponde al envío a través del servicio informático de la Dirección de Impuestos y Aduanas Nacionales (DIAN), conforme al

Anexo Técnico 1, de los datos generados a partir del documento emitido por los puertos y/o muelles de servicio público denominado ARIM en carga suelta y carga contenerizada, para efectos del control por parte de la autoridad aduanera que se requiere en el régimen de tránsito aduanero y en la nacionalización de las mercancías. El Anexo Técnico 1 mencionado en el inciso anterior hace parte integral de la presente resolución. ARTICULO 3. Servicio de envío la información del documento TARJA o su documento equivalente para importación. El servicio de envío de TARJA o su documento equivalente para importación a que se refiere el artículo 1 de la presente resolución, corresponde al envío a través del servicio informático de la Dirección de Impuestos y Aduanas Nacionales (DIAN), conforme al Anexo Técnico 2, de los datos generados a partir del documento emitido por los puertos y/o muelles de servicio público denominado TARJA en carga suelta y carga contenerizada, para efectos del control por parte de la autoridad aduanera que se requiere a la llegada de las mercancías al territorio aduanero nacional. El Anexo Técnico 2 mencionado en el inciso anterior hace parte integral de la presente resolución. ARTÍCULO 4. Tablas Paramétricas. Las tablas paramétricas necesarias para conformar la información de los sistemas de información de la Dirección de Impuestos y Aduanas Nacionales, en cumplimiento de las especificaciones técnicas previstas en la presente resolución estarán a disposición en el portal de la DIAN, sección Otros Servicios Informáticos/Tablas paramétricas/ “importación carga".

ARTICULO 5. Publicar. La presente resolución ás ca publicada en el Diarios Oficial de conformidad con el artículo 65 de la Ley 1437 de 2011. ARTICULO €. Vigencia. La pre ente > vesolución o a partir de los quince (15) días ca pndario siguientes a su publicación en el Diario Oficial.

PUBLÍQUESE Y CUMPLASE 1

1 Dada en Bogotá D.C. a los 1 MAR 2022

MAN IVEIRA. asa

Director General DS

Proyectó: Carlos Esteban Gómez OS

Subdirección de Operación Aduanera Revisó. Vilma Esther Rodríguez Salazar Subdirección de Operación Aduanera RESOLUCIÓN NÚMERO_0 (00036 de 17 MAR 207 Hoja No. Continuación de la Resolución Por medio de la cual se establecen las especificaciones técnicas para el intercambio de información por parte de los puertos y/o muelles de servicio público, a través de los servicios informáticos electrónicos de la Dirección de Impuestos y Aduanas Nacionales, relacionado con la información de los documentos denominados ARIM y TARJA o sus equivalentes para el ingreso de mercancías al territorio aduanero nacional con destino a la importación. . AN Álvaro Ernive Malaver Salamanca 2%», Subdirección de Soluciones y Desarrollo Aleida Viviana Lopez Lopez Dirección de Gestión Jurídica

Aprobó: Inirida Paredes “7”

Subdirectora de Operación Aduanera w Divier Javier Alberto Saganome Jam Subdirector de Soluciones y Desarrollo ON Ingrid Magnolia Díaz Rincón “+ Directora de Gestión de Aduanas Liliana Andrea Forero Gómez 2

Directora de Gestión Jurídica $ ANEXOS: Corresponden al esquema de los servicios Web Rest de Interoperabilidad DIAN — Puertos y/o muelles de servicio público. Anexo 1. Intercambio de información entre la Dian y Puertos para recibir información de ARIM de Importación Anexo 2. Intercambio de información entre la Dian y Puertos para recibir información de TARJA de importación. 17 MAR 2022

Anexo Técnico 1. INTERCAMBIO DE INFORMACIÓN ENTRE LA DIAN Y

PUERTOS PARA RECIBIR INFORMACIÓN DE ARIM DE IMPORTACION

ESQUEMA SERVICIOS WEB REST DE INTEROPERABILIDAD

DIAN Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Contenido Anexo Técnico 1. INTERCAMBIO DE INFORMACIÓN ENTRE LA DIAN Y PUERTOS PARA RECIBIR INFORMACIÓN DE ARIM DE IMPORTACION ................................... 1

ESQUEMA SERVICIOS WEB REST DE INTEROPERABILIDAD .................................. 1

DIAN ...................................................................................................................................... 1 1 Introducción .................................................................................................................... 3 1.1 Objetivo ................................................................................................................... 3 1.2 Terminología ............................................................................................................ 3 2 Especificación del Servicio ............................................................................................. 3 2.1 Descripción General del Servicio ............................................................................ 3 2.1.1 Consideraciones de Seguridad .......................................................................... 4 3 Operaciones del Servicio ................................................................................................. 5 3.1 Enviar información de ARIM de carga suelta ......................................................... 5 3.1.1 Información General Operación ....................................................................... 5

3.1.2 Entradas ............................................................................................................ 6 3.1.3 Salidas ............................................................................................................... 7 3.2 Enviar información de ARIM de carga contenerizada ............................................ 8 3.2.1 Información General Operación ....................................................................... 8 3.2.2 Entradas ............................................................................................................ 9 3.2.3 Salidas ............................................................................................................. 10 Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 1 Introducción 1.1 Objetivo Este documento está orientado a la descripción de los servicios de interoperabilidad de los sistemas Muisca de la DIAN en lo relacionado a las operaciones aduaneras catalogadas en consultas, cumplimiento de obligaciones y recepción de información. 1.2 Terminología Para facilitar el entendimiento de este documento, se define la siguiente terminología de uso común. Término / 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. JWT JSON Web Token es un estándar abierto (RFC-7519) basado en JSON para crear un token que sirva para enviar datos entre aplicaciones o servicios y garantizar que sean válidos y seguros. El caso más comú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 permiten a los 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 transformación de datos entre aplicaciones web como una alternativa al XML. CLIENTE Aplicación externa que quiere interoperar con los servicios de la entidad. TOKEN ENDPOINT Para el caso de la DIAN, el token endpoint es sinónimo del servicio de identidad de la organización, quien es el encargado de administrar el ciclo de vida del token. 2 Especificación del Servicio 2.1 Descripción General del Servicio Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 2.1.1 Consideraciones de Seguridad Es importante aclarar que, para el consumo de los servicios se debe incluir en el encabezado la información del ClientId y el Authorization. Nombre Campo Descripción Obligatorio Longitud Tipo ClientID Entregado por la DIAN, identificador dado a la Si 50 Alfanumérico aplicación registrada Authorization Es el id Token obtenido en la autenticación Si 500 Numérico con identidad Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 3 Operaciones del Servicio 3.1 Enviar información de ARIM de carga suelta 3.1.1 Información General Operación Nombre Servicio Recepción de Información de ARIM de carga suelta de importación Método HTTP POST URL Producción https://api.dian.gov.co/cargaimportaciones/arim/v1/arimcargasuelta/

Descripción Servicio Servicio que permite el intercambio de información con los puertos para el envío de información del ARIM de carga suelta de importación. El puerto enviará los datos, el sistema validará las reglas que aplican, y retorna un mensaje de respuesta; es importante tener presente que para el uso del servicio, la aplicación cliente debe enviar en los encabezados de la petición, el ClientID y el token JWT obtenido del servicio de identidad de la DIAN, válido y vigente. Precondiciones  La aplicación externa está registrada y se encuentra activa, además, cuenta con un token JWT, generado por el servicio de identidad Dirección de Impuestos y Aduanas Nacionales (DIAN), válido y vigente  La aplicación debe corresponder a un usuario Titular de puertos y muelles de servicio público o privado; por esto cuenta con los roles necesarios.  La aplicación externa envía los encabezados de seguridad requeridos y los datos del ARIM, en el formato JSON, como se describe más adelante. Post condiciones  El servicio verifica el token recibido.  El servicio verifica la estructura del documento JSON recibido, practica validaciones de negocio que apliquen.  El servicio persiste los datos de auditoría de la interacción.  Si las validaciones son superadas, el servicio persiste la data del ARIM.  El servicio retorna a la aplicación cliente un mensaje informativo, acorde al éxito de la interacción, o descriptivo de la situación de error, si alguna de las validaciones no fue superada. Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

3.1.2 Entradas  Headers parameters Atributo Valor Authorization Bearer JWT1 ClientID Identificación del Usuario Registrado2

 BODY

De la forma: { "numeroRecaladaTerminal": "numrecalada", "numeroRetiroCarga": "numretiro",

"itemsCargaSuelta": [ { "numeroManifiestoCarga": 116570000000000, "numeroDocumentoTransporte": "numdocumentotr", "estadoAduaneroCarga": "1", "depositoDestino": "1", "pesoCarga": "1", "cantidadBultos": 1, "empresaSolicitaRetiro": "razonsocial" } ] } Longitud Dato Etiqueta Tipo Obligatorio Descripción max. Número de numeroRecaladaTerminal Alfanumérico 15 SI Registro de llegada o ingreso Recalada por de la Motonave a la terminal Terminal numeroRetiroCarga Alfanumérico 20 SI Número de Autorización de Número Retiro Retiro que Identifica al de la Carga Documento (ARIM) numeroManifiestoCarga Numérico 20 SI Número de Formato MUISCA No. Manifiesto 1165 de Carga numeroDocumentoTransporte Alfanumérico 40 SI No. del documento de No. Documento transporte Litográfico (BL) Transporte (BL) 1 Token generado por el servicio de Identidad Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN estadoAduaneroCarga Alfanumérico 50 SI Nacionalizada, Con Planilla

Estado Aduanero de Envío, En Tránsito de la Carga Alfanumérico 40 SI Lugar al que se traslada la depositoDestino carga, Depósito, Zona Franca. No obligatoria si en Depósito Destino “Estado Aduanero de la Carga” se marcó: Nacionalizada Cantidad Bultos cantidadBultos Numérico 10 SI Total Bultos Autorizados Numérico 15 SI Total Peso en Kg. Autorizado Peso Bruto pesoCarga decimal Empresa que empresaSolicitaRetiro Alfanumérico 100 SI Nombre o Razón Social solicita el retiro de la carga 3.1.3 Salidas Se envía respuesta HTTP al cliente con alguno de los siguientes códigos de respuesta: Respuesta Descripción HTTP-200 OK, la presentación solicitada ha sido exitosa. El servicio retorna un mensaje de la forma: { "fechaHora": "20211201115005", "respuesta": "Recibido en Fecha." } HTTP-400 Bad Request, Unauthorized, Forbidden

HTTP-401

HTTP-403

Se retorna cuando no se cumple alguna validación para realizar la operación, no se cuenta con un token válido y vigente; o no se cuenta con las condiciones de negocio para realizar la interacción. El servicio envía descripción de la situación en la siguiente estructura: { "respuesta": "CODIGO: MENSAJE", "fechaHora": "FECHA HORA" } Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 3.2 Enviar información de ARIM de carga contenerizada

3.2.1 Información General Operación Nombre Servicio Recepción de Información de ARIM de carga contenerizada de importación Método HTTP POST URL Producción https://api.dian.gov.co/cargaimportaciones/arim/v1/arimcontenedores/ Descripción Servicio Servicio que permite el intercambio de información con los puertos para el envío de información de ARIM de carga contenerizada de importación. El puerto enviará los datos, el sistema validará las reglas que aplican, y retorna un mensaje de respuesta; es importante tener presente que, para el uso del servicio, la aplicación cliente debe enviar en los encabezados de la petición, el ClientID y el token JWT obtenido del servicio de identidad de la DIAN, válido y vigente. Precondiciones  La aplicación externa está registrada y se encuentra activa, además, cuenta con un token JWT, generado por el servicio de identidad Dirección de Impuestos y Aduanas Nacionales (DIAN), válido y vigente  La aplicación debe corresponder a un usuario Titular de puertos y muelles de servicio público o privado; por esto cuenta con los roles necesarios.  La aplicación externa envía los encabezados de seguridad requeridos y los datos del ARIM, en el formato JSON, como se describe más adelante. Post condiciones  El servicio verifica el token recibido.  El servicio verifica la estructura del documento JSON recibido, practica validaciones de negocio que apliquen.  El servicio persiste los datos de auditoría de la interacción.  Si las validaciones son superadas, el servicio persiste la data del ARIM.  El servicio retorna a la aplicación cliente un mensaje informativo, acorde al éxito de la interacción, o descriptivo de la situación de error, si alguna de las validaciones no fue superada. Subdirección de Soluciones y Desarrollo

Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 3.2.2 Entradas  Headers parameters Atributo Valor Authorization Bearer JWT3 ClientID Identificación del Usuario Registrado4

 BODY

De la forma: { "numeroRecaladaTerminal": "numrecalada", "numeroRetiroCarga": "numretiro",

"itemsContenedores": [ { "numeroManifiestoCarga": 116570000000000, "numeroDocumentoTransporte": "numdocumento", "numeroContenedor": "numconten", "tamanoContenedor": "1", "tipoContenedor": "tipoconten", "estadoAduaneroCarga": "1", "depositoDestino": "1", "pesoCarga": "1", "empresaSolicitaRetiro": "razonsocial", "sello1": "numsello" } ] } Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Longitu Obligator Dato Etiqueta Tipo Descripción d max. io Número de numeroRecaladaTerminal Alfanumérico 15 SI Registro de llegada o ingreso Recalada por de la Motonave a la terminal Terminal Número Retiro de numeroRetiroCarga Alfanumérico 20 SI Número de Autorización de la Carga Retiro que Identifica al Documento (ARIM) No. Manifiesto de numeroManifiestoCarga Numérico 20 SI Número de Formato

Carga MUISCA 1165 No. Documento numeroDocumentoTransporte Alfanumérico 40 SI No. del documento de Transporte (BL) transporte Litográfico (BL) Número del numeroContenedor Alfanumérico 15 SI Número de Identificación Contenedor del Contenedor Tamaño del tamanoContenedor Alfanumérico 10 SI Medida en Pies (") del largo Contenedor del Contenedor, 40, 20. Tipo Contenedor tipoContenedor Alfanumérico 20 SI Características del contenedor. Flat Rack, Open Top, Reefer Sello1 sello1 Alfanumérico 15 SI No. del Sello o Precinto de seguridad del contenedor Estado Aduanero estadoAduaneroCarga Cadena 10 SI Nacionalizada, con Planilla de la Carga de Envío, en Tránsito Deposito Destino depositoDestino Cadena 40 SI Lugar al que se traslada la carga, depósito, zona franca. No obligatoria si en “Estado Aduanero de la Carga” se marcó: Nacionalizada Peso de la Carga pesoCarga Numérico 20 SI Total peso en Kg. Autorizado decimal Empresa que empresaSolicitaRetiro Cadena 100 SI Nombre o Razón Social solicita el retiro de la carga 3.2.3 Salidas Se envía respuesta HTTP al cliente con alguno de los siguientes códigos de respuesta: Respuesta Descripción HTTP-200 OK, la presentación solicitada ha sido exitosa. El servicio retorna un mensaje de la forma: Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

{ "fechaHora": "20211201115005", "respuesta": "Recibido en Fecha." } HTTP-400 Bad Request, Unauthorized, Forbidden

HTTP-401

HTTP-403

Se retorna cuando no se cumple alguna validación para realizar la operación, no se cuenta con un token válido y vigente; o no se cuenta con las condiciones de negocio para realizar la interacción. El servicio envía descripción de la situación en la siguiente estructura: { "respuesta": "CODIGO: MENSAJE", "fechaHora": "FECHA HORA" } Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN

Anexo Técnico 2. INTERCAMBIO DE INFORMACIÓN ENTRE LA DIAN Y

PUERTOS PARA RECIBIR INFORMACIÓN DE TARJA DE IMPORTACION

ESQUEMA SERVICIOS WEB REST DE INTEROPERABILIDAD

DIAN Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN Contenido Anexo Técnico 2. INTERCAMBIO DE INFORMACIÓN ENTRE LA DIAN Y PUERTOS PARA RECIBIR INFORMACIÓN DE TARJA DE IMPORTACION ................................. 1

ESQUEMA SERVICIOS WEB REST DE INTEROPERABILIDAD .................................. 1

DIAN ...................................................................................................................................... 1 1 Introducción .................................................................................................................... 3 1.1 Objetivo ................................................................................................................... 3

1.2 Terminología ............................................................................................................ 3 2 Especificación del Servicio ............................................................................................. 3 2.1 Descripción General del Servicio ............................................................................ 3 2.1.1 Consideraciones de Seguridad .......................................................................... 4 3 Operaciones del Servicio ................................................................................................. 5 3.1 Enviar información de Tarja de carga suelta ........................................................... 5 3.1.1 Información General Operación ....................................................................... 5 3.1.2 Entradas ............................................................................................................ 6 3.1.3 Salidas ............................................................................................................... 7 3.2 Enviar información de Tarja de carga contenerizada .............................................. 8 3.2.1 Información General Operación ....................................................................... 8 3.2.2 Entradas ............................................................................................................ 9 3.2.3 Salidas ............................................................................................................. 10 Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 1 Introducción 1.1 Objetivo Este documento está orientado a la descripción de los servicios de interoperabilidad de los sistemas Muisca de la DIAN en lo relacionado a las operaciones aduaneras catalogadas en consultas, cumplimiento de obligaciones y recepción de información. 1.2 Terminología Para facilitar el entendimiento de este documento, se define la siguiente terminología de uso común. Término / 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. JWT JSON Web Token es un estándar abierto (RFC-7519) basado en JSON para crear un

token que sirva para enviar datos entre aplicaciones o servicios y garantizar que sean válidos y seguros. El caso más comú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 permiten a los 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 transformación de datos entre aplicaciones web como una alternativa al XML. CLIENTE Aplicación externa que quiere interoperar con los servicios de la entidad. TOKEN ENDPOINT Para el caso de la DIAN, el token endpoint es sinónimo del servicio de identidad de la organización, quien es el encargado de administrar el ciclo de vida del token. 2 Especificación del Servicio 2.1 Descripción General del Servicio Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107 Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 2.1.1 Consideraciones de Seguridad Es importante aclarar que, para el consumo de los servicios se debe incluir en el encabezado la información del ClientId y el Authorization. Nombre Campo Descripción Obligatorio Longitud Tipo ClientID Entregado por la DIAN, identificador dado a la Si 50 Alfanumérico aplicación registrada Authorization Es el id Token obtenido en la autenticación Si 500 Numérico con identidad Subdirección de Soluciones y Desarrollo Cra 7 N°6C-54 Edificio Sendas | (601) 7428976 - 3103158107

Código postal 763570 www.dian.gov.co Formule su petición, queja, sugerencia o reclamo en el Sistema PQSR de la DIAN 3 Operaciones del Servicio 3.1 Enviar información de Tarja de carga suelta 3.1.1 Información General Operación Nombre Servicio Recepción de Información de tarja de carga suelta de importación Método HTTP POST URL Producción https://api.dian.gov.co/cargaimportaciones/tarja/v1/tarjacargasuelta/ Descripción Servicio Servicio que permite el intercambio de información con los puertos para el envío de información de tarja de carga suelta de importación. El puerto enviará los datos, el sistema validará las reglas que aplican, y retorna un mensaje de respuesta; es importante tener presente que para el uso del servicio, la aplicación cliente debe enviar en los encabezados de la petición, el ClientID y el token JWT obtenido del servicio de identidad de la DIAN, válido y vigente. Precondiciones 