¿Qué es el SEIDA?
El Sistema Electrónico de Intercambio de Documentos Aduaneros (SEIDA), es parte del proyecto del nuevo proceso de despacho aduanero, e implementa el nuevo esquema de transmisión de las declaraciones de aduaneras, manifiestos de carga y otros documentos aduaneros en formato XML, para su respectiva validación y aceptación.
El SEIDA está Implementado como un servicio web, y realiza las siguientes validaciones:
El SEIDA está Implementado como un servicio web, y realiza las siguientes validaciones:
- Validación en línea, que permite identificar errores de estructura de los datos, formatos, tipos de datos, datos obligatorios, autenticación con Clave SOL.
- Y una validación en diferido, que permite aplicar las reglas de negocio a la información, de acuerdo a la transacción a realizar. La respuesta a esta validación debe ser consulta por el mismo servicio.
El servicio requiere ser autenticado con la Clave SOL y utiliza el estándar en esquema de aseguramiento de servicios web, conocido como WS-Security .
El modelo permite el proceso de la recepción y validación de muchos documentos en simultáneo, agilizando los trámites aduaneros que se realizan por transmisión electrónica.
El modelo permite el proceso de la recepción y validación de muchos documentos en simultáneo, agilizando los trámites aduaneros que se realizan por transmisión electrónica.
La versión inicial del SEIDA, requería por parte del operador de comercio exterior el uso de una aplicación cliente proporcionado por SUNAT, llamado API . Esta aplicación construida en C++, era el encargado de realizar las invocaciones al SEIDA, y recibir las respuestas, tal como se muestra en la siguiente ilustración:
El API recibe como parámetros la Clave SOL (RUC, usuario y clave), el código de envío, un número de transacción y un archivo ZIP que contiene el archivo XML, y se encarga de realizar la transmisión del archivo al SEIDA a través de la Internet. El SEIDA valida los datos de autenticación, y si es correcta, pasa a validar en línea la estructura del archivo XML. El SEIDA siempre retorna un Acuse de Recibo, existan o no errores en la validación inicial. Si no hay errores en la validación inicial, se transfiere la información al proceso de validación diferido, que se encargará de aplicar las reglas de negocio al contenido del archivo XML, generando posteriormente una respuesta de conformidad o no conformidad a la información.
El API se encarga también de realizar la consulta del resultado del proceso de envíos electrónicos, en este escenario, envía la Clave SOL, y el número de ticket. La consulta genera un archivo XML en respuesta, de acuerdo al esquema ResponsePeru_1p0.xsd.
Este proceso puede ser visto en la siguiente ilustración:
El API se encarga también de realizar la consulta del resultado del proceso de envíos electrónicos, en este escenario, envía la Clave SOL, y el número de ticket. La consulta genera un archivo XML en respuesta, de acuerdo al esquema ResponsePeru_1p0.xsd.
Este proceso puede ser visto en la siguiente ilustración:
- La respuesta consta de las siguientes secciones:
- Cabecera (información general)
- Cuerpo de la respuesta (de existir una, puesto que cuando hay errores o advertencias, no se genera)
- Errores (de existir)
- Advertencias (de existir), en el archivo XML los puede ubicar como warnings.
A partir de la fecha, se ha liberado el uso del servicio web, para que pueda ser invocado sin necesidad del API, para los casos donde los operadores puedan implementar el cliente que realice las peticiones al SEIDA directamente. Para esto, se ha elaborado un manual, donde se especifica los parámetros a utilizar y los requisitos que deben cumplir para que su implementación sea considerada válida.
Adicionalmente a esta liberación de uso, se ha construido también un cliente del SEIDA en el lenguaje Java, en reemplazo al cliente Excel + API que se liberó. Este cliente Java, es de uso libre y se distribuye junto con los fuentes.
Adicionalmente a esta liberación de uso, se ha construido también un cliente del SEIDA en el lenguaje Java, en reemplazo al cliente Excel + API que se liberó. Este cliente Java, es de uso libre y se distribuye junto con los fuentes.
Los códigos de error que genera el servicio Web, son los siguientes:
- 91500=Usuario o contraseña incorrectos.
- 91510=El sistema no puede responder su solicitud. Intente nuevamente o comuníquese con su Administrador.
- 91520=El archivo comprimido contiene más de un elemento.
- 91521=El archivo comprimido se encuentra corrupto.
- 91522=El archivo contenido no es un archivo XML.
- 91523=El archivo enviado no pudo ser descomprimido.
- 91530=La validación de esquema ha fallado por la siguiente razon
- 91531=Ha ocurrido un problema durante la validación del XML
- 91532=No se encuentra el archivo de esquema solicitado. Asegúrese que la ruta es correcta e intente otra vez.
- 91533=Ha ocurrido un problema al leer el archivo XML. Es posible que la codificación no sea la adecuada. Verifique esta situación e intente otra vez.
- 91540=No se han encontrado reglas de conversion apropiadas para la transacción solicitada. Verifique el número de transacción.
- 91550=El numero de transacción enviado en el XML no corresponde al enviado al receptor. Verifique el número de transacción.
- 91551=Una fecha no puede ser vacía o null.
- 91552=Formato numérico incorrecto
- 91553=Formato de fecha incorrecto
- 91554=Error de mandatoriedad
- 91555=Error de formato
- 91560=Error de Validación de Control
- 91570=Error en código de Transacción
- 00132=Orden de envío en Proceso
1 WS-Security (Seguridad en Servicios Web) es un protocolo de comunicaciones que suministra un medio para aplicar seguridad a los Servicios Web. (http://es.wikipedia.org/wiki/WS-Security)
2 API, Esta aplicación utiliza una herramienta de comunicación con Servicios Web para programas en C, llamada gSOAP (http://www.cs.fsu.edu/~engelen/soap.html).
