Inicio  |  Timbrado  |  2.1. Librerias  |  2.1.2. Documentación JAR's  |  2.1.2.1. JAR Timbrado API Doc
La LCO fue actualizada por última vez el 03/dic/2024

ws-timbrado-client-2015-12-09.jar

La librería contiene las clases necesarias para invocar el Webservice de Timbrado directamente (creando los objetos e instancias necesarias y hacer la invocación manual), o invocar los métodos que ya se encargan de hacer la invocación por ellos mismos.

Descarga: ws-timbrado-client-2015-12-09.jar
Agregar librería, netbeans o eclipse: 2.1.2. Documentación JAR's.

Notas:
1.- Estas clases hacen uso directo del Webservice de timbrado.
2.- Dentro de este JAR se incluyen las clases generadas para mandar llamar directamente el Webservice de timbrado.


com.solucionfactible.cfdi.ws.timbrado.client
Clase Timbrado

com.solucionfactible.cfdi.ws.timbrado.client.Timbrado

Timbrado provee métodos para timbrar y cancelar comprobantes fiscales digitales.

Para invocar el método de timbrado y enviar un CFDI al ambiente de TESTING puede hacerse:

    String user = "testing@solucionfactible.com";
    String pass = "timbrado.SF.16672";
    String rutaXML = "C:\CFDI_10F";
    boolean produccion = false;
    Timbrado timbrado = new Timbrado();
    CFDICertificacion cert = timbrado.timbrar(user, pass, rutaXML, produccion);

    System.out.println("WS Producción: " + (produccion ? "Si" : "No"));
    System.out.println("Status:  " + cert.getStatus());
    System.out.println("Mensaje: " + cert.getMensaje());
    CFDIResultadoCertificacion[] resultados = cert.getResultados();
    if (resultados != null) {
        for (CFDIResultadoCertificacion r : resultados) {
            if (r != null) {
                int rStatus = r.getStatus();
                System.out.println(String.format("[%d] %s", rStatus, r.getMensaje()));
                //Operación creada exitosamente o previamente ya creado
                if (rStatus == 200) { 
                    System.out.println(String.format("CFDI timbrado con folio: %s", r.getUuid()));
                    System.out.println(String.format("Certificado SAT: %s", r.getSelloSAT()));
                    System.out.println("Cadena original del Timbre Fiscal digital: " + r.getCadenaOriginal());
                    System.out.println("XML de CFDI con Timbre Fiscal Digital:");
                    //El CFDI con el TimbreFiscalDigital ya incluido
                    System.out.println(new String(r.getCfdiTimbrado()));
                    //Se usa la libreria de apache commons codec.
                    String qrCodeB64 = new String(org.apache.commons.codec.binary.Base64.encodeBase64(r.getQrCode()));
                    System.out.println("QRCode en base64: " + qrCodeB64);
                }
                System.out.println();
            }
        }
    }
            

Posible mal interpretación por métodos duplicados

Nota: el paquete com.solucionfactible.cfdi.ws.timbrado contiene las clases e interfaces que pueden ser usadas para la invocación directa del Webservice, a su vez contiene una interface Timbrado que no debe ser confundida con la que se define en este documento.

Resumen de métodos
CFDICancelacion cancelar(String usuario, String password, String[] uuid, String cer, String key, String passwordCer)
Cancela un CFDI.
CFDICertificacion timbrar(String usuario, String password, String archivo, boolean produccion)
Timbra un CFDI.

Detalle de los métodos

cancelar

public CFDICancelacion cancelar(String usuario, 
                                String password, 
                                String[] uuid, 
                                String cer, 
                                String key, 
                                String passwordCer,
                                boolean produccion) 
                         throws Exception
            
Cancela un comprobante dado y regresa la respuesta del Webservice en un objeto de tipo com.solucionfactible.cfdi.ws.timbrado.xsd.CFDICancelacion .

CFDICancelacion

Atributos del tipo CFDICancelacion, se describen en la siguiente tabla:
Nombre Descripción Requerido
status El código status de la operación. Códigos de respuesta de cancelación
mensaje El mensaje de respuesta, una cadena de caracteres detallando el status de la operación.
resultados Un array de CFDIResultadoCancelacion. Atributos se detallan en la tabla CFDIResultadoCancelacion. No
Atributos de CFDIResultadoCancelacion
Nombre Descripción Requerido
status Status del resultado de la cancelación del CFDI, para detalles de los códigos de status de cancelación consulte Códigos de respuesta de cancelación.
mensaje Mensaje detallado de la operación realizada o descripción del error.
uuid Folio fiscal del CFDI que se canceló.
statusUUID Status de respuesta del SAT para el comprobante que se envió a cancelación, para detalles de los códigos de status de cancelación consulte “Códigos de respuesta del SAT para la cancelación de CFDI”. Condicional
Parámetros:
String usuario - El nombre de usuario (usualmente un correo electrónico) que se usa para autenticarse y conectarse a su implementación.
String password - La contraseña de usuario.
String[] uuid - Un array de objetos String que contiene los UUID a cancelar, uno en cada objeto String.
String cer - Ruta a el archivo certificado (archivo .cer).
String key - Ruta a la llave del certificado (archivo .key).
String passwordCer - Contraseña del certificado.
boolean produccion - Boolean que indica si debe enviarse la solicitud de cancelación a producción (true) o a ambiente de testing (false).
Returns:
Un objeto com.​solucionfactible.​cfdi.​ws.​timbrado.​xsd.CFDICancelacion que contiene la respuesta del Webservice.
Throws:
Exception - Si no se encuentra algún archivo.

timbrar

public CFDICertificacion timbrar(String usuario, 
                                 String password, 
                                 String archivo, 
                                 boolean produccion)
                          throws Exception
            
Timbra un CFDI dado y regresa la respuesta del WebService en un objeto de tipo com.solucionfactible.cfdi.ws.timbrado.xsd.CFDICertificacion
Atributos de CFDICertificacion, describen en la siguiente tabla
Nombre Descripción Requerido
status El código status de la operación. Códigos de respuesta de timbrado
mensaje El mensaje de respuesta, una cadena de caracteres detallando el status de la operación.
resultados Un array de CFDIResultadoCertificacion, un tipo compuesto cuyos atributos se detallan en la tabla “Atributos de CFDIResultadoCertificacion”. No
Atributos de CFDIResultadoCertificacion
Nombre Descripción Requerido
status Status del resultado de validación y timbrado del CFDI, para detalles de los códigos de status de certificación consulte Códigos de respuesta de timbrado.
mensaje Mensaje detallado de la operación realizada o descripción del error.
uuid Folio fiscal del CFDI que se timbró. Condicional
versionTFD Versión del complemento de Timbre Fiscal Digital. Condicional
fechaTimbrado Fecha de timbrado del CFDI. Condicional
selloSAT Sello del SAT, el sello del Timbre Fiscal Digital. Condicional
certificadoSAT Número de serie del certificado del SAT empleado para timbrar el CFDI. Condicional
cadenaOriginal Cadena original del Timbre Fiscal Digital o Complemento de Certificaciónes. Condicional
cfdiTimbrado CFDI con el Timbre Fiscal Digital. Condicional
qrCode Código bidimensional QRCode del CFDI, son los datos binarios de una imagen en formato png. Condicional
Parámetros:
String usuario - El nombre de usuario (usualmente un correo electrónico) que se usa para autenticarse y conectarse a su implementación.
String password - La contraseña de usuario.
String archivo - Ruta del archivo XML que se va a timbrar.
boolean produccion - Bandera que especifica si mandar el comprobante a producción o a testing
true=PRODUCCION
Returns:
Un objeto com.​solucionfactible.​cfdi.​ws.​timbrado.​xsd.CFDICertificacion que contiene la respuesta del Webservice.
Throws:
Exception si no se encuentra el archivo o no es un archivo regular.
Datos de contacto
comments powered by Disqus