# Consulta de Estado de Upload DTE **Archivo fuente:** `estado_envio.pdf` **Páginas:** 24 > Conversión automática a Markdown a partir del PDF cargado. Se conserva el texto extraído y se agregan separadores por página. Las figuras o diagramas se mencionan cuando el texto extraído los referencia; no se incrustan imágenes. --- ## Página 1 Manual de Desarrollador Externo Consulta de Estado de Upload Dte ## OI2004_ CEUPDTE _MDE_1.10 Oficina Internet Subdirección Informática Servicio Impuestos Internos Fecha: 08/11/2004 --- ## Página 2 ## INDICE CONTROL DE VERSIONES .................................................................................................................3 INTRODUCCIÓN .................................................................................................................................4 CAPITULO 1........................................................................................................................................5 OBJETIVOS Y CARACTERISTICAS ..................................................................................................5 1. O BJETIVOS DE LA APLICACIÓN................................ ................................ ................................ ............5 2. CARACTERÍSTICA DE LA APLICACIÓN ...................................................................................................5 CAPITULO 2........................................................................................................................................6 WSDL DE Q UERY EST U P ................................ ................................ ................................ ....................6 2.1.1 WSDL DE Q UERY ESTU P. JWS .....................................................................................................6 2.1.2 D ETALLE PARÁMETROS DEL WSDL .........................................................................................9 CAPITULO 3...................................................................................................................................... 10 DETALLE PARÁMETROS DEL SERVICIO....................................................................................... 10 3.1 PARÁMETROS DE E NTRADA ......................................................................................................... 10 #### 3.1.1 EJEMPLO R EAL P ARÁMETROS DE E NTRADA FORMATO WSDL................................ .......................... 10 3.2 PARÁMETROS DE S ALIDA ............................................................................................................. 11 3.3 ESTADOS DE S ALIDA ................................................................................................................... 11 3.4 EJEMPLOS DE SALIDA ................................................................................................................. 12 #### 3.4.1 EJEMPLO P ARÁMETROS DE S ALIDA WSDL CODIFICADO E STADO EPR ............................................ 12 CAMBIAR SALIDA DEACURDO A EJEMPLO 3.4.1.1 .................................................................................... 12 3.4.1.1 E JEMPLO PARÁMETROS DE SALIDA D ECODIFICADO ..................................................................... 12 3.5 ESTADOS DE S ALIDA POR ERROR.............................................................................................. 13 3.5.1 Errores de Consulta: ................................ ................................ ................................ .......... 13 3.5.2 Errores por Autenticación: ................................ ................................ ................................ .. 14 3.5.3 Otros Errores: .................................................................................................................... 14 #### 3.5.1 EJEMPLODE SALIDA ERROR WSDL CODIFICADO (ERR_CODE 2) .............................................. 15 #### 3.5.1.1 E JEMPLO DE S ALIDA ERROR WSDL DECODIFICADO ( ERR_CODE 2: ERROR: DE PROCESO) ..... 15 CAPITULO 4...................................................................................................................................... 16 EJEMPLOS DE SALIDA FORMATO XML........................................................................................ 16 ### 4.1 EJEMPLO P ARÁMETROS DE S ALIDA E STADO RSC (RECHAZADO POR ERROR EN SCHEMA ) ..................... 16 ### 4.2 EJEMPLO P ARÁMETROS DE S ALIDA E STADO SOK (S CHEMA V ALIDADO ).............................................. 16 ### 4.3 EJEMPLO P ARÁMETROS DE S ALIDA E STADO CRT (CARATULA OK) ..................................................... 16 ### 4.4 EJEMPLO P ARÁMETROS DE S ALIDA E STADO RFR (P ARAMETROS DE ENTRADA INCOMPLETOS )............... 17 ### 4.5 EJEMPLO P ARÁMETROS DE S ALIDA E STADO FOK (ERROR : RETORNO DATOS) ............................... 17 ### 4.6 EJEMPLO P ARÁMETROS DE S ALIDA E STADO PRD (ERROR : RETORNO DATOS ) ....................................17 ### 4.7 EJEMPLO P ARÁMETROS DE S ALIDA E STADO RCT (RECHAZADO POR ERROR EN CARÁTULA ) .................. 18 ### 4.8 EJEMPLO P ARÁMETROS DE S ALIDA E STADO EPR (ENVÍO P ROCESADO ).............................................. 18 ### 4.9 EJEMPLO P ARÁMETROS DE S ALIDA SRV_CODE 1( ERROR: DE PROCESO )....................................... 18 ### 4.10 EJEMPLO P ARÁMETROS DE S ALIDA ERR_CODE 2(ERROR: DE PROCESO )..................................... 18 ### 4.11 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-3 (ERROR: RUT USUA RIO NO EXISTE) ................ 19 ### 4.12 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO- 4(ERROR: OBTENCIÓN DE DATOS ).................... 19 ### 4.13 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-5(ERROR: RETORNO DATOS) ............................... 19 ### 4.14 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-6(ERROR: USUARIO NO AUTORIZADO) .............. 19 ### 4.15 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO- 7(ERROR: RETORNO DATOS)............................... 19 ### 4.16 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-8(ERROR: RETORNO DE DATOS) ......................... 20 ### 4.17 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-9(ERROR: RETORNO DE DATOS )........................ 20 ### 4.18 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-10(ERROR: VALIDA RUT)...................................... 20 1 --- ## Página 3 ### 4.19 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-11(ERROR: CONSULTA) ......................................... 20 ### 4.20 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-12(ERROR: RETORNO CONSULTA) ...................... 20 ### 4.21 EJEMPLO P ARÁMETROS DE S ALIDA ESTADO-13(ERROR: USUARIO NULO) ................................ 21 ### 4.22 E JEMPLO P ARÁMETROS DE S ALIDA ESTADO-14 (ERROR: XML RETORNO) .............................. 21 ### 4.23 EJEMPLO P ARÁMETROS DE S ALIDA E STADO 002 (ERROR: TOKEN INACTIVO) ............................. 21 ### 4.24 EJEMPLO P ARÁMETROS DE S ALIDA E STADO 003 (ERROR: TOKEN NO EXISTE)............................ 21 ### 4.25 EJEMPLO P ARÁMETROS DE S ALIDA E STADO 001 (ECOOKIE INACTIVO)........................................ 21 CAPITULO 5...................................................................................................................................... 22 GUIA PARA REALIZAR PRUEBAS................................ ................................ ................................ .. 22 REFERENCIAS .............................................................................................................................. 23 2 --- ## Página 4 ## CONTROL DE VERSIONES ## CONTROL DE VERSIONES Versión Fecha Autor Revisor 1.0 29/01/2003 Zulema Olguín T. Quentin Sherman 1.1 24/04/2003 Zulema Olguín T. Quentin Sherman 1.3 22/04/2003 Zulema Olguín T. Quentin Sherman 1.4 11/08/2003 Zulema Olguín T. Se agregaron Estados de salida 1.5 08/04/2004 Zulema Olguín T Se modifico Url en Capitulo 5 (Guía para Pruebas, le faltaba la “s” al http) Donde decía: http://maullin.sii.cl/DTEWS/QueryEstUp.j ws?WSDL http://maullin.sii.cl/DTEWS/QueryEstUp.j ws?WSDL Se cambio por: https://maullin.sii.cl/DTEWS/QueryEstUp .jws?WSDL https://maullin.sii.cl/DTEWS/QueryEstUp .jws?WSDL 1.6 08/04/2004 Zulema Olguín T. Se m odifico texto de introducción (como acceder a los WS del SII) 1.7 07/05/2004 Zulema Olguín T. Se modifico texto de los mensajes de salida: 3.5.3 Otros Errores 1.8 15/06/2004 Zulema Olguín T. Se agrego al XML de salida un número de atención (), ver punto 3.2 1.9 11/08/2004 Zulema Olguín T. Se modifica URL WS: https://maullin.sii.cl/DTEWS/QueryE stUp.jws?WSDL 1.10 08/11/2004 Zulema Olguín T Se agrego estado “001” (Cookie . Inactivo), ver punto : 3.5.2 3 --- ## Página 5 ## INTRODUCCIÓN Consulta Estado de Upload DTE (CEUPDTE), como parte del proyecto Documentos Tributarios Electrónicos (DTE), entrega a las empresas un servicio (“QueryEstUp”), el cual permite consultar a través de WEB SERVICES, el estado de un archivo DTE enviado al SII, mediante Upload. Este documento está dirigido a quienes tengan la misión de utilizar y probar el servicio mencionado anteriormente (QueryEstUp). Para acceder a los servicios que ofrece el SII, se debe utilizar WSDL(Web Services Definition Language). WSDL es un lenguaje descriptor, basado en XML, que permite conocer en forma abstracta, la gramática de los componentes de un Web Service (ubicación, formato, tipos de datos, servicios, funciones, parámetros de entrada, salida, etc). Para poder acceder a un WSDL, se debe conocer su ubicación, por ejemplo: La ubicación del WSDL, para el ambiente de certificación de QueryEstUp.jws, es: https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL. Cuando el cliente conoce el WSDL del servicio, puede construir un Request en formato SOAP (Simple Object Access Protocolo), para luego enviarlo hacia el proveedor de servicio, previa Autenticación. Respecto a la Autenticación, para poder realizar consultas hacia cualquier Web Service entregado por el SII, los clientes deben estar previamente autenticados a través de la ## AUTENTICACIÓN AUTOMATICA. Para la implementación de la Autenticación Automática, es necesario ver Manual de Desarrollador – OI2003_AUTAUTOM_MDE_1.2 Requisitos de uso. Para poder utilizar este manual, es necesario tener previo conocimiento de XML, Web Services y Certificado Digital. Recomendaciones: Se recomienda el uso de la herramienta XMLSPY5 de la Altova GmbH http://www.altova.com 4 --- ## Página 6 ## CAPITULO 1 ## OBJETIVOS Y CARACTERISTICAS ## 1. Objetivos de la aplicación El objetivo de este servicio es informar el Estado de un archivo DTE, enviado mediante Upload. ## 2. Característica de la aplicación ü El servicio QueryEstUp, es de tipo “Consulta” -”Respuesta ü Es una aplicación B2B. ü Esta aplicación puede ser utilizada por aquellos usuarios habilitados para su uso. 5 --- ## Página 7 ## CAPITULO 2 WSDL DE QueryEstUp La ubicación del WSDL, para esta aplicación (QueryEstUp) es: https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL #### 2.1.1 WSDL de QueryEstUp.jws ```xml ```xml ``` 6 --- ## Página 8 ```xml ```xml ```xml ``` Figura 2.1.1 8 --- ## Página 10 #### 2.1.2 Detalle Parámetros del WSDL De acuerdo a lo destacado en el recuadro del esquema WSDL figura 2.1.1, QueryEstUp entrega sólo un servicio “getEstUp”, el cual requiere de los siguientes parámetros de entrada: Rut, Dv, TrackId y Token. 9 --- ## Página 11 ## CAPITULO 3 ## DETALLE PARÁMETROS DEL SERVICIO ### 3.1 Parámetros de Entrada Los parámetros de entrada requeridos por el servicio, se detallan en el siguiente ejemplo: #### 3.1.1 Ejemplo Real Parámetros de Entrada Formato WSDL ```xml ``` Donde: Campo Tipo Largo Detalle Obligatorios Rut String numérico 1-8 Corresponde al Rut Consultado S Dv String Alfanumérico 1-1 Corresponde al DV del Rut S Consultado TrackId String numérico 1-10 Corresponde al identificador de S Envió(similar al número de atención o folio) Token String Alfanumérico 1-40 Es un Token es un identificador S único el cual es almacenado y enviado al cliente en el Header del Response de la Autenticación Automática con Certificado Digital (CD), y permite la búsqueda de toda la información relacionada a una sesión del cliente. 10 --- ## Página 12 ### 3.2 Parámetros de Salida La salida del Servicio corresponden a un “string” XML codificado, por lo tanto necesario que el programa cliente sea capaz de decodificar el “string” y llevarlo a formato original, los campos de retorno son: TRACKID, ESTADO y GLOSA, NUM_ATENCIÓN. Donde: Campo Tipo Largo Detalle Obligatorios TRACKID String numérico 1-10 identificador de Envió(similar al S número de atención o folio) ESTADO String numérico 1-3 Código Estado S GLOSA String Alfanumérico 1-40 Detalle Código S NUM_ATENCION String 1-40 Número de Atención, S Identificador de la consulta ### 3.3 Estados de Salida El resultado de la consulta puede arrojar uno de los siguientes Estados: Estado Tipo Glosa RSC String Rechazado por Error en Schema SOK String Schema Validado CRT String numérico Carátula OK RFR String numérico Rechazado por Error en Firma FOK String numérico Firma de Envió Validada PDR String numérico Envió en Proceso RCT String numérico Rechazado por Error en Carátula EPR String numérico Envió Procesado 11 --- ## Página 13 ### 3.4 Ejemplos de Salida A continuación se mostrará una serie de ejemplos de salida en ambos formatos Codificado y Decodificado. #### 3.4.1 Ejemplo Parámetros de Salida WSDL Codificado Estado EPR ```xml ```xml ```xml <?xml version ="1.0" ``` encoding ="UTF-8"?> ## <SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema"><SII:RESP_HDR><TRACKID>5329 2</TRACKID><ESTADO>EPR</ESTADO><GLOSA>Envio Procesado</GLOSA></SII:RESP_HDR><SII:RESP_BODY><TIPO_DOCTO>56</TI PO_DOCTO><INFORMADOS>1</INFORMADOS><ACEPTADOS>0</ACEPTADOS><RE CHAZADOS>1</RECHAZADOS><REPAROS>0</REPAROS> <NUM_ATENCION>532 ( 2004/06/14 16:44:20)</NUM_ATENCION></SII:RESP_BODY></SII:RESPUESTA> ```xml ``` Cambiar salida deacurdo a Ejemplo 3.4.1.1 #### 3.4.1.1 Ejemplo Parámetros de Salida Decodificado ```xml 53292 EPR Envio Procesado 56 1 0 1 0 532 ( 2004/06/14 16:44:20) ``` 12 --- ## Página 14 ### 3.5 Estados de Salida por ERROR El resultado de la consulta puede arrojar uno de los siguientes Estados de Error: #### 3.5.1 Errores de Consulta: ## ü SRV_CODE ## ü SQL_CODE ## ü ERR_CODE Donde : SRV_CODE Tipo Largo Glosa 0 String numérico 1-1 Todo Ok 1 String numérico 1-1 Error en Entrada 2 String numérico 1-1 Error SQL SQL_CODE Tipo Largo Glosa 0 S tring numérico 1-2 Schema Validado OTRO S tring numérico 1-2 Código de Oracle ERR_CODE Tipo Largo Glosa 0 S tring numérico 1-1 Se retorna el estado 1 S tring numérico 1-1 El envío no es de la Empresa, faltan parámetros de entrada. 2 S tring numérico 1-1 Error de Proceso 13 --- ## Página 15 #### 3.5.2 Errores por Autenticación: TOKEN Tipo Largo Glosa 001 S tring 1-3 Cookie Inactivo(o Token Inactivo) 002 S tring 1-3 Token Inactivo 003 S tring 1-3 Token No Existe #### 3.5.3 Otros Errores: ESTADO Tipo Largo Glosa -1 String numérico 1-1 ERROR: RETORNO CAMPO ESTADO, NO EXISTE -2 String numérico 1-1 ERROR RETORNO -3 String numérico 1-1 ERROR: RUT USUARIO NO EXISTE -4 String numérico 1-1 ERROR OBTENCION DE DATOS -5 String numérico 1-1 ERROR RETORNO DATOS -6 String numérico 1-1 ERROR: USUARIO NO AUTORIZADO -7 String numérico 1-1 ERROR RETORNO DATOS -8 String numérico 1-1 ERROR: RETORNO DATOS -9 String numérico 1-1 ERROR: RETORNO DATOS -10 String numérico 1-2 ERROR: VALIDA RUT USUARIO -11 String numérico 1-2 ERR_CODE, SQL_CODE, SRV_CODE -12 String numérico 1-2 ERROR: RETORNO CONSULTA -13 String numérico 1-2 ERROR RUT USUARIO NULO -14 String numérico 1-2 ERROR XML RETORNO DATOS Otros 14 --- ## Página 16 #### 3.5.1 Ejemplode Salida ERROR WSDL Codificado (ERR_CODE 2) ```xml ```xml ```xml <?xml version="1.0" encoding="UTF-8"?> ``` ## <SII:RESPUESTA xmlns:SII="http://www.sii.cl/XMLSchema"><SII:RESP_HDR><E STADO>- 1</ESTADO><ERR_CODE>2</ERR_CODE><SQL_CODE/><SRV_COD E/></SII:RESP_HDR> <NUM_ATENCION>532 ( 2004/06/14 16:44:20)</NUM_ATENCION></SII:RESPUESTA> ```xml ``` #### 3.5.1.1 Ejemplo de Salida ERROR WSDL Decodificado (ERR_CODE 2: ERROR: De proceso) ```xml -1 2 532 ( 2004/06/14 16:44:20) ``` 15 --- ## Página 17 ## CAPITULO 4 ## EJEMPLOS DE SALIDA FORMATO XML En este capítulo, se muestran los ejemplos de los posibles Estados de Salida de la aplicación. ### 4.1 Ejemplo Parámetros de Salida Estado RSC ( Rechazado por Error en Schema) ```xml RSC Rechazado por Error en Schema 532 ( 2004/06/14 16:44:20) ``` ### 4.2 Ejemplo Parámetros de Salida Estado SOK (Schema Validado) ```xml SDK Schema Validado 532 ( 2004/06/14 16:44:20) ``` ### 4.3 Ejemplo Parámetros de Salida Estado CRT (Caratula OK) ```xml CRT Caratula OK 532 ( 2004/06/14 16:44:20) ``` 16 --- ## Página 18 ### 4.4 Ejemplo Parámetros de Salida Estado RFR (Parametros de Entrada Incompletos) § ```xml RFR Rechazado por Error en Firma 532 ( 2004/06/14 16:44:20) ``` ### 4.5 Ejemplo Parámetros de Salida Estado FOK (Error: RETORNO DATOS) § ```xml 05 Error: RETORNO DATOS 532 ( 2004/06/14 16:44:20) ``` ### 4.6 Ejemplo Parámetros de Salida Estado PRD (Error: Retorno Datos) § ```xml PRD Error Retorno Datos 532 ( 2004/06/14 16:44:20) ``` 17 --- ## Página 19 ### 4.7 Ejemplo Parámetros de Salida Estado RCT ( Rechazado por Error en Carátula) ```xml RCT Rechazado por Error en Carátula 532 ( 2004/06/14 16:44:20) ``` ### 4.8 Ejemplo Parámetros de Salida Estado EPR (Envío Procesado) § ```xml 251 EPR Envio Procesado 532 ( 2004/06/14 16:44:20) 33 1 1 0 0 ``` ### 4.9 Ejemplo Parámetros de Salida SRV_CODE 1(ERROR: De proceso ) ```xml -11 1 532 ( 2004/06/14 16:44:20) ``` ### 4.10 Ejemplo Parámetros de Salida ERR_CODE 2(ERROR: De proceso) ```xml -11 2 532 ( 2004/06/14 16:44:20) ``` 18 --- ## Página 20 ### 4.11 Ejemplo Parámetros de Salida ESTADO-3 (ERROR: RUT USUARIO NO EXISTE ) ```xml -3 ERROR : RUT USUARIO NO EXISTE ``` ### 4.12 Ejemplo Parámetros de Salida ESTADO-4(ERROR: OBTENCIÓN DE DATOS ) ```xml -4 ERROR : OBTENCIÓN DE DATOS -5 ERROR : RETORNO DE DATOS -6 ERROR :USUARIO NO AUTORIZADO -7 ERROR: RETORNO DATOS -8 ERROR: RETORNO DE DATOS ``` ### 4.17 Ejemplo Parámetros de Salida ESTADO-9(ERROR: RETORNO DE DATOS ) ```xml -9 ERROR: RETORNO DE DATOS -10 ERROR: VALIDA RUT -11 1 0 0 555 ( 2004/06/15 12:46:08) ``` ### 4.20 Ejemplo Parámetros de Salida ESTADO-12(ERROR: RETORNO CONSULTA) ```xml -12 ERROR: RETORNO DATOS -13 ERROR: RUT USUARIO -14 ERROR: XML RETORNO ``` ### 4.23 Ejemplo Parámetros de Salida Estado 002 (ERROR: TOKEN INACTIVO) ```xml 002 TOKEN+INACTIVO ``` ### 4.24 Ejemplo Parámetros de Salida Estado 003 (ERROR: TOKEN NO EXISTE ) ```xml 003 NO+EXISTE ``` ### 4.25 Ejemplo Parámetros de Salida Estado 001 (ECOOKIE INACTIVO) ```xml 001 COOKIE INACTIVO ``` 21 --- ## Página 23 ## CAPITULO 5 ## GUIA PARA REALIZAR PRUEBAS Para probar el servicio, se deben seguir los siguientes pasos: 1.- Autenticarse mediante Autenticación Automática con Certificado Digital(CD). El proceso de la Autenticación Automática con CD, permitirá obtener un Token, el cuál es requerido como parámetro de Entrada por la aplicación (QueryEstUp). Para la implementación de la Autenticación Automática, se recomienda ver Manual del Desarrollador “Ws Autenticación con Certificado Digital”. 2.- Una vez obtenido el Token(de acuerdo a lo detallado más arriba en paso 1), se debe invocar al sitio de Certificación, en donde se encuentra el WS para QueryEstUp: https://maullin.sii.cl/DTEWS/QueryEstUp.jws?WSDL 3.- Luego, para realizar las pruebas, se le deben pasar los parámetros de entrada de la consulta, Rut, Dv, TrackID y Token. 4.- Se obtiene Respuesta. ## ü TRACKID ü ESTADO ü GLOSA ## ü NUM_ATENCIÓN ü TIPO_DOCTO (Solo si Estado es EPR) ü INFORMADOS (Solo si Estado es EPR) ü ACEPTADOS (Solo si Estado es EPR) ü RECHAZADOS (Solo si Estado es EPR) ü REPAROS (Solo si Estado es EPR) Nota: El ambiente de producción, es idéntico al de certificación, solo cambia el nombre del servidor, tal como se indica más abajo. https://palena.sii.cl/DTEWS/QueryEstUp.jws?WSDL 22 --- ## Página 24 ## REFERENCIAS Para mayor información sobre temas tratados en este manual, se recomienda visitar: Documentación WSDL: http://www.w3.org/TR/wsdl Herramienta XMLSPY : http://www.xmlspy.com/features_wsdl.html 23 ---