DIAN - Resolución 3 de 07-01-20201

DIAN Breecónd e impuesy tÁreorasna s Nacionales

RESOLUCIÓN NÚMERO 000003

C 0.7 ENE 2020 ) Por medio de la cual se establecen las especificaciones técnicas para la presentación de información por parte de los puertos y muelles, relacionados con el aviso de finalización de descargue y el informe de los detalles de la carga y unidades de carga efectivamente descargadas, a través de los servicios informáticos electrónicos de la Dirección de Impuestos y Aduanas Nacionales. LA DIRECTORA GENERAL (E) DE LA UNIDAD ADMINISTRATIVA ESPECIAL DIRECCIÓN DE IMPUESTOS Y ADUANAS NACIONALES En uso de sus facultades legales y en especial las dispuestas en el numeral 12 del artículo 6 del Decreto 4048 de 2008, y en el Capítulo 1 del Título 5 del Decreto 1165 del 2 de julio de 2019, y CONSIDERANDO Que el artículo 24 del Decreto 1165 de 2019, establece que los Servicios Informáticos Electrónicos de que trata el presente Decreto serán los dispuestos por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales (DIAN), acogiendo los estándares internacionalmente aceptados. Que conforme al artículo 150 del Decreto 1165 de 2019, el responsable del puerto o muelle en el modo de transporte marítimo debe informar acerca de la finalización el descargue en las condiciones allí establecidas, a través de los servicios informáticos electrónicos y la Resolución 000046 de 26 de Julio de 2019, en el artículo 193 establece las condiciones de presentación de la información requerida. Que el parágrafo 2 del artículo 151 del Decreto 1165 de -2019 establece la obligación para el

responsable del puesto o muelle de presentar la información de los detalles de la carga y unidades de carga efectivamente descargada, y el artículo 195 de la Resolución 000046 de 26 de Julio de - 2019 establece la información detallada que debe contener dicho informe. Que se hace necesario señalar las características técnicas de los mecanismos para la presentación de la información relacionada con el aviso de finalización de descargue y el informe de los detalles de la carga y unidades de carga efectivamente descargadas, por parte de los puertos y muelles, en los sistemas de información de la Dirección de Impuestos y Aduanas Nacionales, siendo este, uno de los mecanismos electrónicos de recepción de información a través de los cuales se puede cumplir con las obligaciones citadas. : Que en cumplimiento de lo dispuesto en el artículo 3 y el numeral 8 del artículo 8 de la Ley 1437 de 2011, Código de Procedimiento Administrativo y de lo Contencioso Administrativo, 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 12 a 18 de noviembre de 2019, Por lo anterior y en atención al Principio de Eficiencia indicado en el numeral 1 artículo 2 Decreto 1165 de 2019, el Director General de la Unidad Administrativa Especial Dirección de impuestos y Aduanas Nacionales. Rp o 000003 0 7 ENE 2020 RESOLUCIÓN NUMERO de Hoja No. 2 X Continuación de la Resolución “Por medio de la cual se establecen las especificaciones técnicas para la presentación de información por parte de los puertos y muelles, relacionados con el aviso de finalización de descargue y el informe de los detalles de la carga y unidades de carga efectivamente descargadas, a través

de los servicios informáticos electrónicos de la Dirección de Impuestos y Aduanas Nacionales.” RESUELVE UE a ARTICULO 1%: ÁMBITO DE APLICACIÓN. La presente Resolución aplica para la presentación del aviso de finalización de descargue y el informe de los detalles de la carga y unidades de carga efectivamente descargadas, conforme al artículo 150 y el parágrafo 2 del artículo 151 del Decreto 1165 de 2019, por parte de los responsables de puertos y muelles, cuando opten por cumplir dichas obligaciones a través del mecanismo acá dispuesto. ARTÍCULO 2. INFORMACIÓN DEL AVISO DE FINALIZACIÓN DE DESCARGUE E INFORME DE LOS DETALLES DE LA CARGA RECIBIDA. La información a suministrar por parte del responsable del puerto o muelle, deberá ser presentada en los términos y condiciones establecidos en el artículo 150, parágrafo 2 del artículo 151 del Decreto 1165 de 2019 y el artículo 195 de la Resolución 046 de 2019, teniendo en cuenta las características técnicas establecidas en los siguientes anexos, 2.1 Presentar Informe Detalles Carga Recibida. Anexo 1. 2.2 Presentar Aviso Fin Descargue. Anexo 2. Los anexos técnicos para el cumplimiento de obligaciones, hacen parte integral de la presente Resolución. ARTÍCULO 3. 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 4. La presente resolución rige a partir de quince (15) días calendario siguientes a su publicación en el Diario Oficial.

PUBLÍQUESE Y CUMPLASE

Dada en Bogotá D.C.alos (7 ENE 2020 O

Le LA BARRIGA LESMES

Directora General (E)

Proyecto: Erika Ximena Castiblanco Borbón Aulo/?

Luis Alberto Herrera Montaño Funcionarios de la Coordinación de la Dinámica de los Procesos Revisó: Juan Carlos Rodriguez Valenzuela, Subdirección de Gestión de Comercio ExterioIDMuElA. Claudia Patricia Marin Jaramillo, Subdirectora de Gestión de Comercio Exterior cbuela. Alvaro Ernive Malaver Salamanca, Subdirección de Gestión de Tecnología de Información y Telecomunicaciones 1d Héctor Leonel Mesa Lara, Subdirector de Gestión de Tecnología de Información y Tetecomunicaciones (A) e, Aprobó: Claudia Patricia Marín Jaramillo, Directora de Gestión de Aduanas echueha. Liliana Andrea Forero Gómez, Directora de Gestión Jurídica Héctor Leonel Mesa Lara, Director de Gestión Organizacional (A) FL Y 7 . a . 1 + o. 00 0:00 3 0 7 ENE 2020 t A . ro Xe e ol € SIY A 0 . - Drección de Impuestos y Aduanas Nacionales Anexo Técnico 1. Presentar Informe Detalles Carga Recibida

ESQUEMA SERVICIOS WEB REST DE

INTEROPERABILIDAD

DIAN ¿y DIAN E 130 . - Ditección de Impuestos y Aduanas Nacionales

1S0S MIG 0003 0 7 ENE 2020 | Ñ

3 DIAN on . mirra, =m . Diescción de tmouertos y Ava=e Hacionties Contenido O 3 1.1 ODJEtIVO ...occooococannonn nonn nr cnanono enner orenon ennero nenn neno nna nn ononoo rran onn rcro orenon ronrnannecnnnnonnn os 3 A 3 2 Especificación del Servicio .......ooo.n.oninnininicioniccioronn crn cno croconna nrcca nnanr cn nnn aanarn noc ccnarrnan nros s 3 2.1 Descripción General del ServiciO.....oooooocococccccccocnncnononononrcncoronenccnnnnncanoconononanacrocanaanonos 3 1.1.1 Consideraciones de Seguridad ........ooococonncoooncnonoconncnocannocnc onrnanc nna oraonnaoancnancnnnaa s 5 3 Operaciones del ServiciO.........oooonoocacrcac rnoncnononcncnocn ccnnc cccnnconoo ncnna ronrnaonnn caanonn oraraornnnnans s 5 3.1 Generación informe detalles Carga Recibida f1210 .....oooooooononncnncnnccononociconannnnonacinccinne 5 . 31.1 Información General Operación .....ccooooncccnnnncnoconononnnnoronnnnnccnnnnnorncnnnornrannccanunenona 5 3.1.2 EMPTARAS conconconconnn ccn orornanronnrr aroco nrooern oarann raa rarna nrarnaraono os errar arman ano enracarrecoro 6 3.1.3 SOÍÍAS ..oooooooccociononcccononnn cr canono non conon nan canon ron canon orar anna nor aran narrar o nna nana n cnn rannn ina ronno 6

4 Tabla ErrOres.......ocioccccnnn inoo nno nnonoc rocn nnn nnc noon nnonninnroonrnonc ro anron rroe nnn raor nrn caon nnn naarniocnes 10 5 Tablas ParamétricaS.......ooocoooooconccncononoornnncnacco nreon nra ncroa nn cnoarrnano nnanca cranr ornnccnnnnancinninón 10 6 Ejemplo JSON .oooococcicncccocccocccccccoocnorocnan dcen ccc orcna ananno nnr nro rnnoo nanr nr noon nanonn nnocne naorannarainnas s 11 3 DIAN im Dirección 09 Irpuers y Acura Naciones i «Mo360 00 3 0 7 ENE 2020 1 ON] ,. "o Z El emprendimiento | minhacienL di alMz es de todos E 052 mi Dirección de Impuestos y Aduenas Nacionales. 1 Introducción 1.1 Objetivo Este documento está orientado a establecer, dentro de los servicios de interoperabilidad de los sistemas Muisca de la DIAN, la especificación técnica para la presentación del informe de los detalles de la carga recibida (F1210), procedimientos adelantados a la llegada de la mercancía al Territorio Aduanero Nacional. 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. ¡WT 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 ta 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 ¿y DIAN Drecuón de lmpueztos y Adunun Hacioneles. AO 3 0 7 ENE 2020 o EN RD» D IA N Ñ PEl DeAm prOeinrd imiento Miinnhhaacciieennddaa. 8011 Direcriós de trguesos y Aduanas Nacionales. El sistema del cliente envía al API de Identidad su El Servicio Interperabiidad | identificacióny sus credenciats encriptadas, solicita al Servicio de ; El Servio verfica y sies conforme retoma un token, bajo tdentidad que verifique el |; tas condiciones que impane la entidad para su manejo, token. po KA AMAXAXNXo_ A ST II co AS 5 NS ms == - | | , , , y| H '

; 1: login() | Servicio Identidad DIAN ' ' ; >» 1 4 2.1: verificar Identidad() ¡Sistema Cliente Ss «Control» SIE 2: envía Cata Obligacion() —> 2.2: procesar Data() Servicio Interoperabilidad SIE DIAN | Elsstema delchente envía mensaje al Servicio de Si k respuesta del Servicio de Identidad respectoz E valdez interoperabidad, en dicho mensaje el cliente deltokenes postiva, el Servicio de interopenabildad envía envía eltoken que recibió deíAPI de identidad y ta b data recibida junto con las credenciales de l Sistema data correspondiente al aympimiento de ta Cliente, a1SIE, para su registro, procesamiento, e inclusión obligación. en el proceso de negocio correspondiente. El SIE elabora respuesta satisfactoria o de error, de acuerdo aslel proceso ha tenido éxto ono, que envía alServicio de interopesabilidad. 0:0 040 03 0 7 ENE 2020 O) es de todos 1.111 Consideraciones de Seguridad Es importante aclarar que, para el consumo de los servicios se debe incluir en el encabezado la información del Clientld y el Authorization. Nombre Campo Descripción Obligatoriedad Longitud Tipo clientld Entregado por la DIAN, identificador dado S 50 Alfanumérico a la aplicación registrada Authorization Es el id Token obtenido en la S 500 Numérico autenticación con identidad 3 Operaciones del Servicio 3.1 Generación informe detalles Carga Recibida f1210 3.1.1 Información General Operación Definir las características y contenido de los archivos donde se reporta la información de la

generación del informe de detalles de carga recibida f1210. Nombre Generación informe detalles carga recibida 1210 Servicio Método HTTP POST URL car . . , 7 . httos://api.dian.gov.co/cargaimportaciones/descargue/v1/informedetallescargarecibida/ Producción Descripción Genera el informe de detalles de carga recibida 1210 Servicio e Elsistema de la DIAN debe estar disponible. Precondiciones e Laaplicación externa cuenta con un token valido Post e El sistema de la DIAN entrega el número de formato 1210 generado condiciones DIAN SIA Ay Dimoción ds Irouesios y Aduanas Macioneies coo qa '000003 Elemprendimiento E e DIAN e es de todos ' 01 Diacción de impuestos y Aduar.as Nacionales 3.1.2 Entradas Headers parameters Atributo Valor Accept application/json Authorization Bearer JWT! clientld Identificación del Usuario Registrado Content-Type application/json 3.1.3 Salidas Se envía respuesta HTTP al cliente con alguno de los siguientes códigos de respuesta: Código respuesta Descripción 200 Se retorna el numero de formulario 1210 generado y la fecha de generación 400 Petición invalida (DMensaje es el objeto para especificar la causa del rechazo) 403 Mensajes detallados de error asociados a privilegios La obtención de cualquier código de respuesta HTTP diferente a 200 OK en el consumo de servicios se considera como error. Token generado por el servicio de identidad Valor suministrado por la Dian en el registro de la aplicación Dirección de impuesy tAcouasna s Nacionales 3 0 0 0 0 0 sodot ed se adartne ydoB .

o t n e i m i d n e r p m e El .nóicaunitnoc a allated es lauc le adibiceRagraCsellateDemrofniD otejbo la árednopserroc NOSJ otamrof ne adartne ed ydob lE a d i b i c e R a g r a C s e l l a t e D e m r o f n i D

N OTAMROF

ALLISAC

NÓISREV

O P M A C

NOICPIRCSED

GILBO OTAD OPIT

OPMAC ERBMON

42 7V0121 e d o t s e i f i n a m e d o r e m ú n al de al n i o ic p f s o e r a or arg C c | x o c i r é m u N o t s e i f i n a m o r e m u N o t s e i f i n a M m u n otamrof oremuN | retnAotamroFPmun roiretna rot 73 7V0121 r o i r e t n a o t a m r o f o r e m u N | X o c i r é m u N 7 V 0 1 2 1 agrac ed dadinU | iceRagraCsedadinu olgerrA sadibiceR sadib s a d i b i c e r a g r a c e d s e d a d i n u las n o c o l g e r r A | X icaVserodenetnoc soicav serodenetnoC

so 7V0121 s o í c a v s e r o d e n e t n o c dos n o c o l g e r r A X| o l g e r r A sadibiceRagraCsedadinu »

N OTAMROF

ALLISAC

NÓISREV

G N O L

O T A D TIPO O P M A C E R B M O N

O P M A C NOICPIRCSED opit ogidóC VotnemucoDopiTdoc ejaiv ed otnemucod ejai 7V0121 2 o c i r é m u n a f l A ejaiv otnemucod opit ogidóC narTotnemucoDmun etrops 70121 o t n e m u oc rte d o p s o n r a me tr u N de 41 ocirémuN e t r o p s n a r t o t n e m u c o d o r e m u N arTotnemucoDahcef etropsn 03 7V0121 e t r o p s n a r t o t n e m u c o d l e d a h c e F 6 o c i r é m u n a f l A e d o t n e m u c o e d t r o a p h n c a e r F t 1 3 7 V 0 1 2 1 2 ocirémunaflA agrac ed opit ogidóC agraCopiTdoc a g r a c o p i t o g i d ó C gKoturBosep 23 7V0121 6 o c i r é m u n a

f l A s o m a r g o l i k o t u r b o s e P somargolik ne oturb oseP sedadinu AN 7V0121 s e d a d i n u AN olgerrA a g r a c e d s e d a d i n u las n o c o l g e r r A NAID al ed RSOP anretsiS le ne omalcer o aicneregus ,ajeuq ,nóicitep us elumroF s e n o i c a c i n u m 23 o ce l e T1 0 4 3 0 y9 n ó i .txe c a m r o f 0 0 5 4 n I2 8 ed a í g o l3 -— 9 9 9 9 o n7 c0 e6 T edX B P n ó i t s e G ed n ó i c c e r i d b u S 25 osip 8 3 - C 6 2N 8 .arC 1 1 7 1 1 1 l a t s o p o g i d ó C o c . v o g . n a i d . w w w NAID 93¿ .seianoiceH senaA y sotseuerb sd nóicceriD au er as 0202 ENE 7 0 300000 NN a d n ; ie c a h n ¡ i M o t n e i m endi odos rt emp de El es ay s e t d a y d i n u a N A I D 3 N

N OTAMROF N !OICP ]1IRCSED

GNOL

OTAD OPIT OPMAC

ERBMON

OPMAC AJOH ALLISAC NÓISREV rodenetnoc oremuN | 02 ocirémunaflA| rodenetnoc oremuN rodenetnoCmun|1 |33 7V0121 odatse ogidóC | odenetnoCodatsEdoc |1 43 rodenetnoc odatse ogidoC | 2 ocirémuN rodenetnoc r 7V0121 soicaVserodenetnoc

N O I C P I R C S E

D

G N O L

O T A D

OPIT

O P M A C

E R B M O N

O P M A C N AJOH | a N s a C MATO N Ó I S RR FOE V rodenetnoc oremuN |02 ocirémunaflA | rodenetnoc oremuN rodenetnoCmun|1 53 70121 : odatse ogidóC | odenetnoCodatsEdoc |1 63 rodenetnoc odatse ogidóC | 2 ocirémuN rodenetnoc r 7V0121 adilas ydoB . .nóicaunitnoc a allated es lauc le ejasneMD otejbo la árednopserroc NOSJ otamrof ne adilas ed ydob lE adilas sotaD N N

OTAMROF

N

O I C P I R C S E D

G N O L

OTAD OPIT

O P M A C

E R B M O N

O P

M A C ajoH | aiuisac | N Ó I S R E V ed emrofni le arap odareneg oiralumrof ed oremuN emrofni oremuN | sellateDemrofnimun|1 4 adibicer agrac ed sellated | 51 ocirémuN | adibicer agrac sellated adibiceRagraC 7V0121 nóicidepxe nóiccasnart al ed avitcefe ahceF | 51 ocirémunaflA |¡ nóiccasnart ed ahceF noiccasnarTahcef|1 799 7V0121 o N 3 Nacionales r A A lauras I y mpuerios s L D 0% Desoción )Y yU s e n o i c a c i mun 32 o ce1 Tel 0340 y 9 formulseu petición, queja, sugerenciao reclamo en el Sistema POSR de la DIAN Subdireccid óe n Gestiónd e Tecnologíd ae Información . Cra8 . N2 6C-3p 8i s5 o2 PBX6 079 99— 9 3 824 50e 0x t. 1 1 7 1 1 1 latsop o g i d ó C o c . v o g . n a i d . w w w 3 0 0 0 0 0 rorre ed ejasneM . O d n é 0 i c aE 2 h 20 n i m

| E N E o t n 7 e i m 0 i d n e s o d o rt p m e e d lE se 5ejasneMD N

”N OTAMROF

N O I C

P I R C S E D

G N O L

O T A D

TIPO

O P M A C

E R B M O N

O P M A C

AJOH

| ALLISAC

N Ó I S R E V ogidóc |AN |AN 740121 r o r r e e d e j a s n e m e d o g i d ó C | 4 o c i r é m u N o g i d ó c opmac|AN ¡jAN 7V0121 o c i r é m u n a f l A o p m a c opmac |02 odallated ejasneM | AN |AN 7V0121 o d a l l a t e d e j a s n e m n o c r o r r e e d n ó i c a m r o f n I | E 0 O 2 N E M E o c i r 4 é 1 m u n a f l A o d a l l a t s e n o e i d c a c e i j a s n u m o 23 n ce M e l e T1 0 4 3 0 y9 NAID al ed ASQP ametsiS lc ne omalcer o aicneregus ,ajeuq ,nóicitep us elumroF

n ó i c a m r o f n I ed a í g o l o n c e T ed n ó i t s e G ed n ó i c c e r i d b u S .txe 0 0 5 4 2 8 3 — 9 9 9 9 7 0 6 X B P 2S osip 8 3 - C 6 £N 8 .arC 1 1 7 1 1 1 l a t s o p o g i d ó C o c . v o g . n a i d . w w w a d n e i c a h n i M 0 2 o 0 t 2 n e i m E N i d n E e r p 7 m e 0 lE E : 3 0 0 0 0 0 a N A I D ' o l :sopmac sert setneiugis sol noc NOSJ otamrof ne se oicivres adilas aL s o d a n o i c a l e r s á m e d s s o e l r o r , r 0 E ÓN 20 la IPCI b R go Ta ESC di la D ó c n e n u n a a c di e n d i n o e p s s e o r i r c o vi c r e s o os el exit con e e j t : a n s e n m e a m c i l f E i c ta: pe GO o s I N e ÓD C

4 nóicamrofni al ratneserp arap odazirotua oN 2101 nóicamrofni al odnaivne átse euq obirra ed ragul le noc ednopserroc on odatlusnoc otseifinam lE 5001 s a c i r t é m a r a P s a l b a T 5 :agraC nóicatropmI .sacirtémaraP salbaT reV secaf.sacirtemaraPatlusnoCfeD/noicazirtemaraPbeW/oc.vog.naid.acsium//:sptth serorrE albaT 6 NÓICPIRCSED OGIDÓC nóicamrofni al ratneserp arap odazirotua oN 2101 nóicamrofni al odnaivne átse euq obirra ed ragul le noc ednopserroc on odatlusnoc otseifinam lE 5001 s a c i r t é m a r a P s a l b a T 7 NAID y sos 0 mA senoicacinumoceleT y nóicamrofnI ed aígolonceT ed nóitseG ed nóicceridbuS e nu 117111 latsop ogidóC NS NE A+ oc.vog.naid.www 0 2 0 2 E N E 7 0 3 0 0 0 0 0 otneimidnerpme lE : sodot ed se N

AI D y

Y 1 selanoicaN sanaudA y sontsóeuipmIc ecderiD s e c a f . s a c i r t e m a r a P a t l u s n o C f e D / n o i : c a a z g i r a C r t e m n a ó r i a c P a t r o p m I b e W / o c . v . o s g a c . n i r t é a i d N O S m . J a r a c a s o P i l s u m p m a / e l / j b a T : s o E t r e V t h 8 1 [ :"adibiceRagraCsellateDemrofniD" ,"311157100575611" :"otseifinaMmun" ,0 :"roiretnAotamroFmun" [ :"sadibiceRagraCsedadinu" [ ,"1" :"ejaiVotnemucoDopiTdoc" ,"5emiX" :"etropsnarTotnemucoDmun" ,"12609102" :"etropsnarTotnemucoDahcef" ,2 :"agraCopiTdoc" ,0004 :"gKoturBosep“ ( :"sedadinu 1 ,"300" :"rodenetnoCmun" "1" :"rodenetnoCodatsEdoc" 1 ) ,l [ :"soicaVserodenetnoc" 1 ,"5tnoc" :"rodenetnoCmun“ "1" :"rodenetnoCodatsEdoc" ) ] ) ) N A I a s se al na an uo di AcsN .a y

O D sotseupmI y E A ' nóicceriD ed . a c yY M s e n o i c a c i n u m 23 o c e l e T1 0 4 3 0 y9 NAID al ed RSQP ametsiS le ne n ó ai íc ga om lr o f n eI d .txe 0 0 5 4 2 8 3 — 9 9 9 9 omalcer o aicneregus ,ajeuq ,nóicitep us elumroF n ó i c cn eóo rin itc d se b e eT ed uG d S 7 0 6 X B P 25 osip 8 3 - C 6 2N 8 ,arC 1 1 7 1 1 1 latsop o g i d ó C o c . v o g . n a i d . w w w 0 2 0 2 E N E 7 0 3 0 0 0 0 0 otneimidnerpme lE sodot ed se 4 selanoicaN ssnaucA y sotseupmI ed nóicceriD allinoB knarF órobalE . : . . Ñ > selanoicaN sotseupmi sanau ydA Sit nóccerD ad MAR s o c m s e n o i c a c i n u m 23 o c e l e T1 0 4 3 0 y9 NAID al ed RSQP ametsiS le ne

omalcer o aicneregus ,ajeuq ,nóicitep us elumroF n ó i c c e r i d b u S en dó i t s e G a í g o edl o n c e T n ó i c ea dm r o f n I . .arC 8 3 2 8NC 6 osip 25X B P7 09 69 9 9 2 80 —30 5 4 .txe 1 1 7 1 1 1 latsop o g i d ó Cwww.dian.gov.co RA O003 0 7 ENE 2020 . e Ea D IAN Y El emprendimient es de todos visi . Drrección de Impuestos y Adi vanas Nacionales Anexo Técnico 2. Presentar Aviso Fin Descargue

ESQUEMA SERVICIOS WEB REST DE

INTEROPERABILIDAD DIAN Formule su petición, queja, sugerencia o rectamo en el Sistema POSR de la DIAN e e Subdirección de Gestión de Tecnología de Información y Telecomunicaciones “TLI T Drain de guetos y Aguas Necoraos Cra. 8 N2 6C-38 piso 52 PBX 607 9999 — 382 4500 ext. 90340132 Código postal 111711 www.dian.gov.co ME | 0.7 ENE 2020 cs oa El emprendimiento KT, Mi es de todos Va S " Dirección de Impuestos y Aduanas Nacionales Contenido Y, IMtTOAUCCIÓN ......cccccccconiranna onnn ncnna rn nnararann nno narra oarrne nao nn narm nnn onrnonncnnroo nnn raoannnan oanarn nnannonnn es 3 O AA 3

O AA 3 1.2. Terminología ..ccooncoooonccnncnnc cora nnann nn onerna nrar nrrao nnanao nnn ncnnnnnrornrnn otennen anden nnoLeonnncnecennan i 3 2 Especificación del Servicio .......o.oooonioncninnannnonocaniccronnoc nrtan ccrnnnnr rcrn rninornraonnnnea rnnancni 4 2.1 Descripción General del ServiCiO...ononcocconiouconanononananonncononnnanonnnnnononnonnrcnncnrnnnononcnrononoes 4 2,1.1 Consideraciones de Seguridad ....ooccccononooccrccnnanananononocnrannnnornnarnaonn aannanniannonnnnnnos 5 3 Operaciones del SerViCiO....oooooionnoncocicnccccononinnnnnoonnnonnanrno rcoon nnna cnanna cnnn nrcannnr rcanr nrnannanor e 5 3.1 Presentar: Aviso de Finalización de Descargue Formato 1288.....0oooocccconocccnanonncancnarannnns 5 3.1.1 Información General Operación ..ooooooocoocoocancnnannoncnnnnnanncnrononannanonnnnanonanncnnonanoonon 5 3.1.2 ENÁIAÍAS c.cccccccnooccnononononann non n rn Ren erre Rene ne arre nenrennnnnioanraniannnas 6 3.1.3 SaldaS ...ooooconccccnnc nn crcna ccnr ncanrnrnann onRARA oR RRn RR eenen nn rno rn nnn nnn nrecnron co ns 8

Estructura JSON Salida..................oooooooonocccnccnccnonacoronononnononnanicnnonocnnononononconnrnnnncanicnnnns 9 4 Tabla ErTOres........oooocccacnaro rn rcoonn oncnnnnera crncnennoeninennn in 9 E EU 9 Formule su petición, queja, sugerencia o reclamo en el Sistema POSR de la DIAN 1d Subdirección de Gestión de Tecnología de Información y Telecomunicaciones ani Dreta de Imsaos y Acuse Nader Cra. 8 N2 6C-38 piso 52 PBX 607 9999 — 382 4500 ext. 90340132 Código postal 111711 www.dian.gov.co 5 43000003 0 7 ENE 2020 1 : A El emprendimiento Minhacienda SA D IA N ES es de todos Dirección de brouesos y Adganss Haclonales

1. Introducción 1.1 Objetivo Este documento está orientado a establecer, dentro de los servicios de interoperabilidad de los sistemas Muisca de la DIAN, la especificación técnica para la presentación del aviso de finalización de descargue (F1288), procedimientos adelantados a la llegada de la mercancia al Territorio

Aduanero Nacional. 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. Formule su petición, queja, sugerencia o rectama en el Sistema POSR de la DIAN 7 SA Subdirección de Gestión de Tecnología de Información y Telecomunicaciones SY Decó rguess y Aduerzs Made Cra. 8 N2 6C-38 piso 52 PBX 607 9999 — 382 4500 ext. 90340132 Código postal 111711 www.dian.gov.co 0:050,0 0 3 0.7 ENE 2020 ..: DIAN El emprendimiento SA) es de todos 051 Dirección de Impuestos y Aduanas Nacionales 2 Especificación del Servicio 2.1 Descripción General del Servicio El sistema del cliente envía 21.49 de identidad su El Servicio intemperabiidad identificación y sus credenciales encriptodas.. sokcita al Servico de El Servico verfica y sies conforme retoma un token, bajo identelad que verifique el

ss condiciones que impone la entidad para su manejo, token, Servicio identidad DIAN 1: logini) me» ¡Sistema Cliente A 2: envía Data Obligacioni) Ú Servicio Interoperabilidad A a 2.1: verificar identidad() : «Control» stE —> 2.2: procesar Datal)

SIE DIAN

[ES £isistema delcherte envía mensaje al Serriiade Sila respuesta del Servicio de Identidad respecto a da valdez interoperabiidad, en dicho mensaje el ciente deltoken es postiva, el Servicio de interoperabitidad envías envía eltoken que recibió del APi de identidad y la ta data recibida junto con las credencdie aSlisetesma data correspondiente alcumplmiento de la Chente, ai51£, para suregistro, procesamiento, € inclusión obigación. en el proceso de negocio correspondiente, El SIE elabora respuesta satisfactoria o de error, de acuerdo asiel peooeso hatenidoéxto ono, que envía alSereicio de interoperabiidad. DIAN Formule su petición, queja, sugerencia o reclamo en el Sistema POSR de la DIAN ISA Subdirección de Gestión de Tecnología de Información y Telecomunicaciones 11000 Dirección de Impuestos y Aduanas Nacionales Cra. 8 N26C-38 piso 52 PBX 607 9999 — 382 4500 ext. 90340132 Código postal 111711 www.dian.gov.co 000003 0 7 ENE 2020 ¿3 DIAN El emprendimiento 2 es de todos 80100 Drescón de lrpuestos y Acuer Naciorales 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 Clientld y el Authorization. y O Nombre Campo Descripción Obligatoriedad | Longitud Tipo E X E Clientld Entregado por la DIAN, identificador dado S 50 Alfanumérico a la aplicación registrada 4 “ Authorization Es el id Token obtenido en la S 500 Numérico autenticación con identidad 3 Operaciones del Servicio -3.1 Presentar: Aviso de Finalización de Descargue Formato 1288 3.1.1 Información General Operación Permite el intercambio de información con los Puertos para el cumplimiento de la obligación de presentar el Aviso de Finalización de Descargue, formato 1288 Nombre . a o Presentar Aviso de Finalización de Descargue. Servicio Método HTTP POST URL Producción ¡ httos://api.dian.gov.co/cargaimportaciones/descargue/v1/avisofinalizaciondescargue o Servicio que permite intercambio de información con los Puertos para el Descripción o o , a o cumplimiento de la obligación de presentar el Aviso de Finalización de Descargue, Servicio formato 1288. e e Elsistema de la DIAN debe estar disponible.

Precondiciones o : e Laaplicación externa cuenta con un token valido Post e El sistema de la DIAN recibe los parámetros para realizar la presentación del condiciones Aviso de Finalización de Descargue y retorna la información de respuesta.

Formute su petición, queja, sugerencia o reclarmo en el Sistema POSR de la DIAN 3 DIAN Subdirección de Gestión de Tecnología de Información y Telecomunicaciones 0 Deucción de lroyesios y Aduna Hacicruóys Cra, 8 N2 6C-38 piso 52 PBX 607 9999 — 382 4500 ext. 90340132

Código postal 111711 www.dian.gov.cO 0 2 0 2 E N a E d n 7 ie i c a . h 0 An i M o t n e i m i d n e s o d o rh p m e ed lE sS . 3 0 0 0 0 0 . N A I D 3 sadartnE 21.3 ? o d a r t s i g e R o r o l a V i r a u s U n o l e d s i / n o i t a c i l r e r? T W J n ó i c a c i f i t n p a e p e d a B i s r e t e m a r o t u a b p i r t s A r e d n a e H o i t a e t p e c c z i r o h t u d l t n e i l A A c nosj/noitacilppa epyT-tnetnoC retemarap ydoB e o t e j b o l e d a r u t c u r t s e al a o d r e u c a e d : n ó N i O c S a J u o t n i t n a o m c r o f a n e a l l a t n e ó d i c i e s t e p l a al u c e al d n y ó d i o c B a m le r o n f n e i e s e d r a c o i s d e n r i g n i n e b e e d d e u a g d r a r t n e a c s e D n e d o i c s a o z r i t l e a m n á i r F a o p s i v s o L A D

eugracseDnoicazilaniFosivAD ”N 7N OTAMROF G N O L

O T A D OPIT O P M A C E R B M O N O P M A C _ N Ó I S R E V

N OOIICCPPIIRRCSED

.GuBo AYOH | ALLISAC o t s e i f i n a M 5 6 1 1 led n ó i c a z i l a o t a m r o f le o n i f n e t a m r o f la a d a n o i c a l e r n ó i c a m r o f n I . a g r a C e d e d a r o h y a h c e f al a e d n o p s e r r o C a d a s e r p x e r a t s e e b e d , e u g r a c s e d ' s s m m h h d d m m y y y v y ' S s| 4 1 o t s e i f i n a M s o t a a h c D e D F o t s e i f i n a