OpenDTE Enterprise Edition Online Services SDK v2.1

Transcripción

1 OpenDTE Enterprise Edition Online ervices DK v2.1 an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

2 1 Introducción El presente documento, describe las funcionalidades de los ervicios Web que complementan el sistema OpenDTE. La primera describe un Webervice que realizará la tarea de timbre y firma digital de un DTE recibido como dato de entrada en formato TXT o XML, para responder indicando el estado resultante de la operación, un string con el valor del TED y una URL que indica la ubicación del PDF generado Posteriormente se detallan los nuevos Webervice implementados para mejorar la integración con el sistema de gestión. 2 Descripción Funcionalidades 2.1 Webservice FirmaDTE Este servicio es el encargado de recibir un archivo TXT que representa un DTE según el formato definido por OpenDTE, el cual debe validar, procesar y generar el XML del DTE, para posteriormente generar el timbre electrónico y la firma digital sobre el DTE. También puede recibir como entrada un XML según el formato del II, el cual no contendrá el timbre electrónico no firma digital. Realizado todo este proceso, debe responder indicando el resultado de la operación, una cadena indicando el valor del elemento TED utilizado para generar el timbre electrónico y una URL desde la cual se pueda descargar el PDF que es la representación impresa del DTE firmado. 2.2 Webservice ConsultaEstadoDTE Este servicio es el encargado de responder por el estado del DTE en el sistema de OpenDTE. Debe recibir como argumentos de entrada los datos que identifican al DTE: RUT emisor, tipo DTE y folio. Generará como respuesta el estado de DTE con un código y glosa asociada. En el siguiente diagrama, se muestran los Webervices de FirmaDTE y ConsultaEstadoDTE, que para el caso de la firma del DTE además de responder al usuario debe enviar a la base de datos del sistema OpenDTE el XML del DTE generado, para que este sistema realice todo el procesamiento de envío al II y al cliente. an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

3 2.3 Manejo Certificado Digital Actualmente el sistema OpenDTE, para las tareas de firma digital con certificado de persona, recibe los datos de clave y certificado digital como argumentos del módulo, los cuales quedan explícitos en cada invocación de la funcionalidad. La idea de esta funcionalidad, es que todas las aplicaciones que realizan firma digital, obtenga el certificado y la clave desde la base de datos del sistema y sigan con el proceso tal cual operan hoy. an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

4 3 Parámetros de Entrada y alida 3.1 FirmaDTE Los parámetros de entrada del servicio de FirmaDTE se detallan en la siguiente tabla: RUTEmisor tring numérico 1-8 RUT emisor DTE DVEmisor tring alfanumérico 1-1 Dígito verificador RUT emisor DTE TipoArchivo tring alfanumérico 3-3 TXT o XML Archivo tring alfanumérico - Contenido del archivo Cabe mencionar que el elemento Archivo se debe escribir como un tring codificado dentro del XML que representa el requerimiento al Webervice. Los parámetros de salida del webservice FirmaDTE se detallan en la siguiente tabla: Estado tring numérico 1-1 1: Firma OK 0: Error en Firma Glosa tring alfanumérico Descripción del Error, solo cuando Estado = 0 TED tring alfanumérico - XML codificado del TED URLpdf tring alfanumérico URL descarga PDF N an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

5 3.2 ConsultaEstadoDTE Los parámetros de entrada del servicio de ConsultaEstadoDTE se detallan en la siguiente tabla: RUTEmisor tring numérico 1-8 RUT emisor DTE DVEmisor tring alfanumérico 1-1 Dígito verificador RUT emisor DTE TipoDTE tring numérico 1-2 Indica el tipo de DTE, según código II Folio tring numérico 1-10 Folio DTE a consultar Los parámetros de salida del servicio de ConsultaEstadoDTE se detallan en la siguiente tabla: Estado tring numérico 1-10 Número que identifica el estado Glosa tring alfanumérico Mensajes asociados a estado Cabe mencionar que el estado de un DTE variará en el tiempo de acuerdo a las operaciones que realiza el sistema OpenDTE y la glosa asociada al estado será la que este sistema maneja. an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

6 3.3 ConsultaXMLDTE Los parámetros de entrada del servicio de ConsultaXMLDTE se detallan en la siguiente tabla: emisor tring numérico 10 RUT emisor DTE folio tring numérico 10 Folio DTE a consultar tipo tring numérico 1-2 Indica el tipo de DTE, según código II Los parámetros de salida del servicio de ConsultaXMLDTE se detallan en la siguiente tabla: status tring 300 Glosa de status del DTE según el II glosaejecucion tring alfanumérico Glosa ejecución W timbre tring - Texto del TED xml tring - XML del DTE an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

7 3.4 Agrega Los parámetros de entrada del servicio de Agrega se detallan en la siguiente tabla: emisor tring numérico 10 RUT emisor DTE receptor tring numérico 10 RUT del receptor para el que se desea agregar nombredestinat ario tring numérico 1-2 Nombre del destinatario tipoenvio tring 3 xml o pdf tring 100 Dirección para envío Los parámetros de salida del servicio de Agrega se detallan en la siguiente tabla: Codigo tring numérico : proceso OK 0: error Glosa tring alfanumérico Mensajes asociados a estado an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

8 3.5 Reenvia DTE Los parámetros de entrada del servicio de Reenvia DTE se detallan en la siguiente tabla: emisor tring numérico 10 RUT emisor DTE foliodte tring numérico 10 Folio DTE a enviar tipodte tring numérico 1-2 Indica el tipo de DTE, según código II tipoenvio tring 3 xml o pdf destinatario tring 100 Dirección envío Los parámetros de salida del servicio de Reenvia DTE se detallan en la siguiente tabla: Codigo tring numérico : proceso OK 0: error Glosa tring alfanumérico Mensajes asociados a estado an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

9 3.6 EliminaDTE Los parámetros de entrada del servicio de EliminaDTE se detallan en la siguiente tabla: rutemisor tring numérico 10 RUT emisor DTE rutreceptor tring numérico 10 RUT receptor DTE tipodte tring numérico 1-2 Indica el tipo de DTE, según código II foliodte tring numérico 10 Folio DTE a enviar Los parámetros de salida del servicio de EliminaDTE se detallan en la siguiente tabla: Codigo tring numérico : proceso OK 0: error Glosa tring alfanumérico Mensajes asociados a estado an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

10 1.1 IngresaReciboMercaderias Los parámetros de entrada del servicio de IngresaReciboMercaderias se detallan en la siguiente tabla: rutreceptor tring numérico 10 RUT receptor DTE foliodte tring numérico 10 Folio DTE a enviar tipodte tring numérico 1-2 Indica el tipo de DTE, según código II recinto tring 100 recinto en que se recibió Mercadería rutfirma tring numérico 100 RUT quien recibió Mercadería Los parámetros de salida del servicio de IngresaReciboMercaderias se detallan en la siguiente tabla: Codigo tring numérico : proceso OK 0: error Glosa tring alfanumérico Mensajes asociados a estado an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

11 Anexo 1: Errores Webervice FirmaDTE Código Retorno Descripción 1 OK. El Documento fue firmado en forma exitosa. 0 Error General al firmar DTE Errores de Datos (esquema erróneo, rut no corresponde, etc..) 1000 Error en Esquema DTE 1001 Error en Parámetros de llamada al W 1002 Error de formato en Archivo XML 1003 Tipo de Archivo no soportado 1004 RUT en XML no corresponde al parámetro de Web ervice Errores II Errores de Folios (Folio duplicado, no hay caf.. etc) 3000 Folio Duplicado 3001 Error, no se puede obtener folio disponible de tabla CAF 3002 Rango de CAF no disponible Errores de Parámetros OpenDTE. Los parámetros o no existen o no están configurados correctamente No fue posible crear archivo temporal en PATH_DIRECTORIO_ENTRADA 4001 Error de I/O al crear archivo temporal en PATH_DIRECTORIO_ENTRADA 4002 Error al firmar DTE. Ver mensaje con detalle. Algunas posibilidades: - No está configurada la plantilla PDF an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago

12 - No hay permisos para crear PDF Error al crear carpeta para almacenar PDF, causas: - No hay espacio en disco - No hay permisos de escritura 4004 Error de I/O al generar PDF Error al firmar DTE, Certificado Expirado. an Pio X 2390, oficina 1001, (Metro Los Leones) Providencia antiago