del comercio exterior mexicano ventanilla única del comercio exterior mexicano Revisión del consumo del Web Service de Digitalización de la VUCEM y Errores comunes detectados

Contacto SAT Web Service Luis Oscar Albarrán: contacto@ventanilla. gob Contacto SAT Web Service Luis Oscar Albarrán: contacto@ventanilla.gob.mx

Índice Introducción del Webservice de Digitalización ¿Qué es la Digitalización de Documentos de Comercio Exterior? Hojas informativas relacionadas Operaciones  del Webservice de Digitalización Protocolo MTOM Errores más comunes: Error de autenticidad Referencia CID Adjuntar archivo .pdf ID del tipo de documento Estructura de la cadena original Hash Firma inválida Codificación del Certificado y Firma

Introducción del Webservice de Digitalización ¿Qué es la Digitalización de Documentos de Comercio Exterior?   Es el almacenamiento de los documentos digitalizados necesarios para el despacho aduanero de mercancías, el cual se comunicará con el Sistema Automatizado Aduanero Integral y con los sistemas del Despacho Aduanero con el objeto de la eliminación del papel.   Las notas informativas relacionadas con la Digitalización de Documentos, relacionadas al Portal Web y al Servicio Web se encuentran en: https://www.ventanillaunica.gob.mx/vucem/SobreVU/Descargas/index.htm Hoja Informativa No. 06 - Digitalización Hoja informativa No. 46 - Servicio Web Digitalización Hoja Informativa No. 49 - Servicio Web Digitalización Hoja Informativa No. 52 - Liga para pruebas de Servicios Web Introducción del Webservice de Digitalización

Operaciones del Webservice de Digitalización El Webservice para digitalizar documentos cuenta con tres operaciones: 1. Consulta del catálogo de tipos de documentos. La Cadena original:     RFC del Solicitante* 2. Registro de documentos digitalizados. La Cadena Original: Correo electrónico* Clave Tipo de documento* Nombre del documento* RFC para consulta Hash del Documento Digitalizado* 3. Consulta de Estatus de Registro. Folio de la operación* Nota: Datos marcados con * son obligatorios. Los datos deben estar separados por pipes “|”   Operaciones del Webservice de Digitalización

Protocolo MTOM Para consumir el servicio ‘Web service digitalización' debe estar habilitado el protocolo MTOM (Message Transmission Optimization Mechanism) que permite el envÍo y recepción de datos binarios de forma óptima

Errores Comunes Error de autenticidad Se presenta cuando el Password no corresponde al RFC de la persona que registra el COVE, o viceversa, o en su defecto, no se está importando correctamente la política de seguridad, por lo que la aplicación no puede obtener el RFC y el Password del usuario.

Referencia ‘cid:’ CID es una referencia para que el contenido sepa por donde va viajar el archivo adjunto, en este caso nosotros usamos esta referencia por la aplicación que se utiliza (SOAPui). En el archivo XSD que se encuentra en la sección de descargas de Ventanilla Unica, está establecido que el usuario declarará un arreglo de bytes indicando el archivo .pdf a adjuntar. 

Adjuntar .pdf Para adjuntar un archivo .pdf se debe declarar un arreglo de bytes en base 64: <dig:archivo> 31c8628382d7f94a8e49a1b44b2f6d74b e49a1b44b2f6d74bff09c5c </dig:archivo>

ID del Tipo de Documento El id tipo de documento va hacer referencia al nombre del documento que se va a adjuntar, hay varios tipos de documentos los cuales se pueden consultar mediante el webservice. Ejemplo: <ns2:tipoDeDocumento> <ns2:idTipoDeDocumento>421</ns2:idTipoDeDocumento> <ns2:descripcion>Comprobante de la importación temporal de la embarcación debidamente formalizado.</ns2:descripcion> </ns2:tipoDeDocumento>

Estructura de la Cadena Original La Cadena Original del solicitante debe estar formada y ordenada como a continuación se describe: • RFC del Solicitante* • Correo electrónico* • Clave Tipo de documento* • Nombre del documento* • RFC para consulta • Hash del Documento Digitalizado*

Hash Generar el Hash del documento a digitalizar, de lo contrario mostrará el mensaje de cadena inválida. Para obtener el hash se usa el algoritmo SHA-1 el cual produce una salida resumen de 160 bits (20 bytes) de un mensaje que puede tener un tamaño máximo de 264 bits. |5341062dde72465f40dcb3becd987416a67bf432|

Se recibe cuando ya no existe ningún error en la cadena original. Firma Inválida Se recibe cuando ya no existe ningún error en la cadena original. Se presenta debido a que cualquier cambio en la Cadena Original es visto como una Cadena nueva, por lo que el firmado de esta debe ser cada vez que se le realice alguna modificación por muy pequeña que esta sea.

El certificado y la firma es incorrecto , Lo correcto es base64 Codificación de Certificado y Firma El certificado y la firma es incorrecto , Lo correcto es base64

Implementación de trámites AGA/COVE Fin Implementación de trámites AGA/COVE