# Reenvío de Correo de Validación DTE **Archivo fuente:** `OIFE2005_wsDTECorreo_MDE.pdf` **Páginas:** 10 > 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 Solicitud Reenvío de Correo Validación DTE Oficina Factura Electrónica Subdirección Informática Servicio Impuestos Internos Fecha:11/05/2007 --- ## Página 2 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## INDICE INTRODUCCIÓN .................................................................................................................................3 CAPITULO 1........................................................................................................................................4 OBJETIVOS Y CARACTERISTICAS ..................................................................................................4 1.1 OBJETIVOS DE LA APLICACIÓN .......................................................................................................4 1.2 CARACTERÍSTICA DE LA APLICACIÓN ..............................................................................................4 CAPITULO 2........................................................................................................................................5 WSDL DE WSDTECORREO .................................................................................................................5 2.1 GRAMÁTICA DEL WSDL...............................................................................................................5 2.1.1 WSDL de wsDTECorreo ...................................................................................................5 CAPITULO 3........................................................................................................................................6 DETALLE DE PARÁMETROS DEL SERVICIO ...................................................................................6 3.1 PARÁMETROS DE E NTRADA ..........................................................................................................6 #### 3.1.1 Ejemplo Real Parámetros de Entrada Formato WSDL ........................................................6 3.2 PARÁMETROS DE SALIDA .............................................................................................................7 3.2.1 Ejemplos de Salida Formato WSDL ...................................................................................7 3.3 VALORES DE SALIDA ...................................................................................................................8 ### 3.4 VALORES DE ESTADO PARA SALIDAS CON ERROR ..........................................................................8 3.4.1 Errores de Datos: .............................................................................................................8 3.4.2 Errores por Autenticación: .................................................................................................8 3.4.3 Otros Errores: ..................................................................................................................8 CAPITULO 4........................................................................................................................................9 GUIA PARA REALIZAR PRUEBAS ................................ ................................ ................................ ....9 4.1 PRUEBA DEL S ERVICIO ................................................................................................................9 REFERENCIAS ................................................................................................................................. 10 --- ## Página 3 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## INTRODUCCIÓN El servicio wsDTECorreo, forma parte del proyecto Documentos Tributarios Electrónicos (DTE), y corresponde a un servicio que permite a las empresas (contribuyentes) solicitar en forma automática al SII el reenvío de los correos con diagnostico de validación DTE para trackids específicos. Este documento está dirigido a quienes tengan la misión de utilizar y probar este servicio. La forma de acceder a este servicio es a través de WSDL (Web Services Definition Language). Este es un lenguaje descriptor, basado en XML, que permite conocer en forma abstracta, la gramática de los componentes de un webservice (ubicación, formato, tipos de datos, servicios, funciones, parámetros de entrada, salida, etc). El WSDL que se detalla en este documento apunta al ambiente de certificación del SII, sin embargo este ambiente es una copia fiel del ambiente de producción. La ubicación del WSDL de wsDTECorreo es: Certificación : https://maullin.sii.cl/DTEWS/services/wsDTECorreo?wsdl Producción : https://palena.sii.cl/DTEWS/services/wsDTECorreo?wsdl Una vez que el cliente conoce el WSDL del webservice, debe construir un Request en formato SOAP (Simple Object Access Protocolo), para luego enviarlo hacia el proveedor de servicio (SII), previa Autenticación. Respecto a la Autenticación, para poder realizar consultas hacia cualquier webservice entregado por el SII, los clientes deben estar previamente autenticados a través de la AUTENTICACIÓN AUTOMATICA. 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 ( http://www.altova.com ). --- ## Página 4 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## CAPITULO 1 ## OBJETIVOS Y CARACTERISTICAS ### 1.1 Objetivos de la aplicación El servicio wsDTECorreo, forma parte del proyecto Documentos Tributarios Electrónicos (DTE), y corresponde a un servicio que permite a las empresas (contribuyentes) solicitar en forma automática al SII el reenvío de los correos con diagnostico de validación DTE para trackids específicos. ### 1.2 Característica de la aplicación ü El servicio wsDTECorreo es de tipo “Consulta-Respuesta” ü Es una aplicación B2B. ü Esta aplicación puede ser utilizada por aquellos usuarios habilitados para su uso. ü Para solicitar un reenvío de correo el contribuyente autenticado, debe tener representación sobre la empresa emisora de los documentos. --- ## Página 5 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## CAPITULO 2 WSDL de wsDTECorreo ### 2.1 Gramática del WSDL El siguiente cuadro muestra el WSDL del webservice wsDTECorreo. #### 2.1.1 WSDL de wsDTECorreo ```xml ```xml ``` ```xml ``` ```xml ``` ```xml ``` Figura 2-1 --- ## Página 6 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## CAPITULO 3 ## DETALLE DE 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 ```xml String String String String ``` Figura 3-1 Donde: Campo Tipo Largo Detalle Obligatorio Token String Alfanumérico 1-40 El Token es un identificador único que S identifica a un contribuyente , 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. El contribuyente autenticado debe tener representación sobre la empresa emisora. RutEmpresa String numérico 1-8 Rut de la Empresa emisora del envio S DvEmpresa String Alfanumérico 1-1 Dv del Emisor. S TrackId String numérico 1-10 Trackid al que se le solicita el reenvío. S Tabla 3-1 --- ## Página 7 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ### 3.2 Parámetros de Salida La salida del servicio corresponden a un “string” XML codificado, por lo tanto, es necesario que el programa cliente sea capaz de decodificar el “string” y llevarlo a formato original, los campos de retorno ## son: ESTADO y GLOSA, ERR_CODE, GLOSA_ERR, NUM_ATENCIÓN. #### 3.2.1 Ejemplos de Salida Formato WSDL ```xml 0 ``` Figura 3-2 Respuesta Correcta ```xml 105 TRACKID NO EXISTE ``` Figura 3-3 Respuesta con error ```xml 114 ENVIO NO HA CONCLUIDO VALIDACION ``` Figura 3-4 Respuesta con error, no existe correo para reenvio Donde: Campo Tipo Largo Detalle Obligatorios ESTADO String 1-3 Código Estado de la S operación GLOSA String Alfanumérico 1-40 En caso de Error indica S una glosa descriptiva del error. Tabla 3-2 --- ## Página 8 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ### 3.3 Valores de Salida El resultado del requerimiento puede arrojar uno de los siguientes valores: Estado Tipo Largo Glosa 0 String 1-3 Requerimiento recibido OK. <> 0 String 1-3 Ha ocurrido un error. Tabla 3-3 ### 3.4 Valores de estado para salidas con ERROR #### 3.4.1 Errores de Datos: El resultado de la consulta puede arrojar uno de los siguientes Estados de Error: Estado Tipo Largo Glosa 101 String 1-3 Error en dígito verificador del Rut de la empresa. 102 String 1-3 Faltan datos de entrada 105 String 1-3 Error TrackId no existe 106 String 1-3 Usuario autenticado no tiene permisos sobre Empresa. 114 String 1-3 Envío solicitado no ha concluido su validación, por lo tanto no existe correo. Tabla 3-4 #### 3.4.2 Errores por Autenticación: Estado Tipo Largo Glosa 104 String numérico 1-3 Token Inactivo o No Existe Tabla 3-5 #### 3.4.3 Otros Errores: Estado Tipo Largo Glosa 103 String 1-3 Error Interno. 107 String 1-3 Error Interno 108 String 1-3 Error Interno 110 String 1-3 Error Interno 111 String 1-3 Error Interno 112 String 1-3 Error Interno 113 String 1-3 Error Interno Tabla 3-6 --- ## Página 9 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## CAPITULO 4 ## GUIA PARA REALIZAR PRUEBAS ### 4.1 Prueba del Servicio Para probar el servicio, se deben seguir los siguientes pasos: 1.- Autenticarse mediante Autenticación Automática con Certificado Digital (CD). Nota: 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 el webservice wsDTECorreo. Para la implementación de la autenticación, se recomienda ver “Manual del Desarrollador Autenticación Automática”. 2.- Una vez obtenido el Token, se debe invocar al sitio donde se encuentra el webservice wsDTECorreo, ejemplo: Certificación : https://maullin.sii.cl/DTEWS/services/wsDTECorreo?wsdl Producción : https://palena.sii.cl/DTEWS/services/wsDTECorreo?wsdl 3.- Luego, para realizar las pruebas, al WS invocado, se le deben pasar los parámetros de entrada requeridos por la función reenvioCorreo, estos son: Token, RutEmpresa, DvEmpresa, TrackId. 4.- Como respuesta del WS se obtiene un XML con los siguientes tags: ü ESTADO ü GLOSA (solo en caso de error) --- ## Página 10 WS para Reenvío de Correos con Diagnóstico de Validación DTE Versión 1.0 – 10/01/2006 ## 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 Manual del Desarrollador Autenticación Automática : http://www.sii.cl/factura_electronica/autenticacion.pdf ---