Manual de Referencia DigitalStamp •1• © 2006 IT COMPLEMENTS S.A DE C.V. :::: REFERENCIA TECNICA :::: Autor: Edgar Adrián Muñoz Morales Fecha de Creación: Marzo, 2013 Fecha de Actualización: pág. 2 • CONTROL DE CAMBIOS • Registro de cambios Fecha pág. 3 Autor Versión Observaciones • DigitalStamp • DigitalStamp v2.0.0.0 - Componente WebService Cliente que se conecta con el PAC ATEB para el timbrado de CFDIs. Sintaxis: java -jar DigitalStamp.jar <requestFile> <responseFile> -mode <mode> -target <target> username <user> -password <pwd> [-connection <http> | <saaj>] -trustStore <trustStoreFile> -trustStorePass <trustStoreFilePassword> Donde: <requestFile> es el archivo de entrada. Pero para la cancelación este archivo es armado al vuelo con los datos de RFC y Folios a cancelar, por tal razón no se usa. <responseFile> es el archivo de salida retornado por el target. <mode> es el modo de conexión: TEST = Ambiente de pruebas (Por defecto) PROD = Ambiente productivo <target> es el destino al cual conectarse. Valores posibles: ATEB : Conexión al PAC de ATEB <user> es el usuario de autentificación para la conexión. Esto lo proporciona el PAC a cada cliente. <pwd> es la contraseña de autentificación. <trustStoreFile> es el archivo almacén de llaves donde se almacenan todos los certificados que se consideran de confianza. Las conexiones https envían el certificado del servidor al cual se está conectando. Si este certificado está dentro de este almacén, la conexión se efectúa. Caso contrario es rechazado. Para importar certificados X509 a un almacén de llaves de confianza, checar la documentación de Java keytool. <trustStoreFilePassword> es la contraseña del almacén de llaves. Esta contraseña es requerida al momento de la creación de este archivo y protege al almacén de uso indebido. <http> Tipo de conexión http para conectarse con el Web Service Servidor. Ventaja: Consume poco CPU <saaj> Tipo de conexión saaj para conectarse con el Web Service Servidor. Nota: Si no se define el tipo de conexión, toma por defecto la conexión saaj. Ejemplo: java -jar DigitalStamp.jar dummy.xml salida.xml -mode PROD -target ATEB -username 0000000001 -password pwd -connection http pág. 4 • DigitalStamp • DigitalStamp v2.0.0.1 Contiene nueva funcionalidad para cancelar CFDIs, se indica mediante el parámetro -cancelar. Ejemplo: java -jar DigitalStamp.jar dummy.xml salida_cancel.xml -mode PROD target ATEB -username 0000000001 -password pwd -connection http -cancelar Contiene nuevo parámetro para definir la url donde se va a conectar el Web Service. -endPoint <url a conectar> Ejemplo: java -jar DigitalStamp.jar dummy.xml salida.xml -mode PROD -target ATEB -username 0000000001 -password pwd -connection http -endPoint •1• © 2006 IT COMPLEMENTS S.A DE C.V. • DigitalStamp • DigitalStamp v2.0.0.2 Se eliminó parámetro -endpoint. Se modificó funcionalidad de cancelación de CFDIs, se agregaron los siguientes parámetros para la cancelación: Ejemplo: java -jar DigitalStamp.jar <requestFile> <responseFile> -mode <mode> -target <target> -username <user> -password <pwd> [-connection <http> | <saaj>] java -jar DigitalStamp2.jar dummy.xml Salida_cancel.xml -username 0000001 password pwd -connection http -trustStore ds.keystore -trustStorePass sat-prueba -mode test -cancelar -privateKey iep921123j76_1104041717s.key -publicKey 00001000000103214196.cer -privateKeyPass xx1pwd -rfc IEP921123J76 -uuids 80B93B4C-4EAF-428B-BC2C-5AAD7CA72BB1 "Para cancelación" Donde: <dummy.xml> Parametro comodín pero requerido para <requestFile> -cancelar Parámetro que indica que se va a cancelar. Si no se pone este parámetro, por la función por defecto es TIMBRAR. <privateKey> Nombre del archivo de la llave privada de la empresa a cancelar UUID. Archivo con extensión .key <publicKey> Nombre del archivo del certificado de la empresa a cancelar UUID. Archivo con extensión .cer <privateKeyPass> Password de la llave privada. <rfc> RFC de la empresa a Cancelar UUID(s) <uuids> Lista de UUID o UUIDs a Timbrar. Si se va a timbrar más de 1, agruparlos entre " (comillas) y separarlos por , (coma)