CFDi client
Contents
1. C CfdiClient Archivo Edici n Yer Favoritos Herramientas Ayuda a J st s P P B squeda Carpetas Ey Direcci n c 1cfdicient Sr Nombre Tama o Tipo Fecha de modificaci n Atributos DATOS Carpeta de archivos 16 02 2011 13 56 docs Carpeta de archivos 16 02 2011 13 56 lib Carpeta de archivos 16 02 2011 13 56 logs Carpeta de archivos 09 02 2011 9 03 la cfdiClient jar 71KB Executable Jar File 09 02 2011 9 03 A 1 cfdiClient properties 1KB Archivo PROPERTIES 09 02 2011 9 03 A 12 cfdilog4j properties 1KB Archivo PROPERTIES 09 02 2011 9 03 A Mes CFDiClient Manual de Usua 176KB Adobe Acrobat 7 0 16 02 2011 14 00 A T GetCfdi exe 416KB Aplicaci n 09 02 2011 9 03 A TO GetTimbreCfdi exe 416KB Aplicaci n 09 02 2011 9 03 A 10 objetos Debe permitir el acceso seguro al servicio CFDi de EDICOM en su ordenador Este servicio se accede a trav s de una conexi n a internet a trav s de una conexi n segura HTTPS puerto 443 en la URL del web service CFDi de EDICOM https cfdiws sedeb2b com EdiwinWS services CFDi AnrcHivos IMPORTANTES e CfdiClient properties Archivo de configuraci n de la herramienta Los par metros de la herramienta pueden definirse por defecto en este documento o pueden definirse en el momento de la llamada al ejecutable Es recomendable definirlas en el archivo de configuraci n aunque puntualmente se pueden sobrescribir los2. llamar a una funci n si falta alg n par metro obligatorio por configurar EL dato wsUrl no debe ser modificado CfdiClient properties wsUrl https cfdiws sedeb2b com EdiwinWS services CFDi WsUser XXX000000XXX wsPass XXXXXXXXXXXXXXX inputDir C CfdiClient DATOS in outputDir C CfdiClient DATOS out fileComprobante xml test true o false Nota La informaci n del RFC indicado en el ejemplo es ficticia CFDi client 3 Cliente en modo comando 13
3. FDi de Edicom y devolver los comprobantes timbrados enviados al SAT en forma de archivos xml Llamada GetCfdi exe Nota Los comandos deben ejecutarse desde el procesador de l nea de comandos o mediante ficheros de proceso por lotes ficheros bat Modo de empleo CAPTOR SS wal SS US Ss co TT 9 Pass pasemworze n melp9l f i motel ima 9 OM Ste Dalie OUt DIAM e tSst uses ElicdasiioCcompizolecnaire Par metros Ww WsUrl Url de acceso al servicio u wsUser Nombre de usuario del servicio p wsPass Contrase a de acceso al servicio i inputDir Directorio de entrada donde se encuentra los comprobantes firmados por el usuario 0 outputDir Directorio de salida donde se reciben los comprobantes una vez timbrados h help Muestra la ayuda t test Ejecuta el webservice en modo TEST CFDi client 3 Cliente en modo comando 10 Datos CFDi client ficheroComprobante Nombre del fichero o m scara que contendr los ficheros que formar n los comprobantes a timbrar Puede contener la ruta completa junto con el nombre del fichero en este caso el directorio de entrada no se tendr en cuenta Respuesta Respuesta satisfactoria Devuelve los comprobantes timbrados enviados al SAT en la carpeta especificada como directorio de salida Respuesta de error Devolver un mensaje de error indicando los comprobantes que no se han podido
4. car el servicio directamente sobre la URL est ndar del servicio o si fuera necesario se puede especificar la URL del servicio Constructores e CfdiClient Crea la instancia del cliente para acceder al servicio de CFDi con la URL por defecto Nota URL por defecto https cfdiws sedeb2b com EdiwinwWS services CFD i e CfdiClient java lang String wsUrl Crea la instancia del cliente para acceder al servicio de CFDi especificando la URL de acceso al servicio Una vez inicializado el cliente lo nico que hace falta es invocar el m todo correspondiente a la funci n del servicio que queremos invocar M todos byte getCfdi java lang String usuario java lang String pass byte zipFile throws CfdiException Genera la petici n de timbrado del comprobante al webService En caso de que la ejecuci n se realice correctamente devolver el comprobante timbrado como un byte que contendr el fichero zip con el comprobante timbrado En caso de que haya alg n error en la ejecuci n la llamada devolver una excepci n CFDi client 2 API de programaci n 6 CFDi client CfdiException que contendr un c digo con el tipo de error y un texto con la explicaci n del error byte getCfdiTest java lang String usuario java lang String pass byte zipFile throws CfdiException Genera la petici n de timbrado del comprobante al webService en modo de prueba Ejecutar el servicio en modo de prueba significa que el timbre g
5. e Su Usuario de acceso al servicio e Su Contrase a de acceso al servicio Este documento ofrece el enlace a la WSDL del servicio pero adem s Edicom ofrece a sus clientes la herramienta CFDiClient pensado para facilitar el uso del servicio Web Service CFDi a los usuarios La herramienta CFDiClient ofrece API de programaci n Se ofrece un API de programaci n desarrollado en el lenguaje de programaci n JAVA que permite invocar de forma f cil y sencilla las funciones ofrecidas por el webservice CFDI e Clientes pregenerados Se ofrece tambi n un par de clientes ya generados destinados a que los usuarios puedan invocar directamente el servicio desde su ordenador utilizando el sistema operativo Windows ACCESO AL SERVICIO La URL de acceso al webservice CFDi de Edicom es la siguiente https cfdiws sedeb2b com EdiwinWS services CFDI La implementaci n del servicio se realiza a trav s del protocolo https De esta forma se utiliza un canal de comunicaciones seguro con el Proveedor de Servicios de Emisi n de CFDI PSECFD I Paquetes peL API DE PROGRAMACI N La herramienta CFDiClient incluye un API de programaci n en el lenguaje de programaci n JAVA para poder acceder al servicio Se trata de la librer a cfdiClient ar situada en el directorio del cliente Esta librer a utiliza las librer as externas situadas en el directorio lib para implementar las llamadas SOAP necesarias para invocar el servicio CFDi clien
6. edicomcfal Ea de Si n de pr CFDI Client Manual de Usuario edicom connecting business CFDi client T tulo del documento CFDi client Nombre del fichero ES CFDiClient Manual de Usuario odt Versi n 1 0 Estado VIGENTE Fecha 28 02 2011 Autor Oscar Albert Arcas Revisi n Aprobaci n Revisado por Francisco Belda Escamilla Fecha 28 02 2011 Aprobado por Oscar Albert Arcas Fecha 28 02 2011 Historial de cambios Versi n Fecha Descripci n de la acci n P ginas 1 0 28 02 2011 Versi n inicial todas CFDi client 2 CFDi client ndice de contenido AA O 4 SAT do A IS NOS E E ATEA 4 Accesoal Serviciota aa e r rA T E e Eaa a E A E LaEa aan 4 Paquetes del API dE programaci ensa aE a E A EE araa a aaa aa aaa ana 4 Funciones del cliente webservice CDi ide 5 PR IKA E E E E T T E ETEA ET E T 6 ZANCADA E AAA A A ATEN EEEE AA AA LALA bd 6 2 2 Paquete com edicom ediwinws cfdi ClieNt oooocncicninnnnncncnnnnnnnennnnennrnnnconnononcnn cnn non conca nnn anno nana cenar anne 6 Objeto CAC aa A a e s 6 EXCOPCION CfAIEXCEpt A A a A A A A LA E 7 2 3 Paquete com edicom ediwinws service cfdi ed NDA acia Se a 7 ZARPAQUEtE COM CO0iCONCdIWIAWS diiniita 8 Objeto GetCfdi eotea a A a A A A E A O aia EE aE AE ESS 8 Objeto GetTimbreCfdi 3 Client e n modo COMANOO ecscoicin nan nenioniac
7. enerado no es v lido y que no se env a al SAT En caso de que la ejecuci n se realice correctamente devolver el comprobante timbrado como un byte que contendr el fichero zip con el comprobante timbrado En caso de que haya alg n error en la ejecuci n la llamada devolver una excepci n CfdiException que contendr un c digo con el tipo de error y un texto con la explicaci n del error byte getTimbreCfdi java lang String usuario java lang String pass byte zipFile throws CfdiException Genera la petici n de timbrado del comprobante al webService y devuelve nicamente el timbre del comprobante timbrado en vez del comprobante completo En caso de que la ejecuci n se realice correctamente devolver el comprobante timbrado como un byte que contendr el fichero zip con el contenido del nodo del timbre del comprobante timbrado En caso de que haya alg n error en la ejecuci n la llamada devolver una excepci n CfdiException que contendr un c digo con el tipo de error y un texto con la explicaci n del error byte getTimbreCfdiTest java lang String usuario java lang String pass byte zipFile throws CfdiException Genera la petici n de timbrado del comprobante al webService en modo de prueba y devuelve nicamente el timbre del comprobante timbrado en vez del comprobante completo Ejecutar el servicio en modo de prueba significa que el timbre generado no es v lido y que no se env a al SAT En caso de que la ejec
8. enviar al SAT En caso de que alguno de los comprobantes seleccionados por la m scara se haya enviado correctamente su comprobante timbrado estar disponible en la carpeta de salida del cliente GerTimBRECFDI EXE Permit e obtener la informaci n de timbrado de los comprobantes timbrados a partir de los comprobantes firmados por el usuario El cliente GetTimbreCfdi exe se invoca para timbrar el com probante a trav s del servicio CFDi de Edicom y devolver en un archivo el timbre del comprobante timbrado no los comprobantes timbrados en formato XML Llamada GetTimbreCfdi exe Modo de empleo GetTimbreCtfdi w wsUrl url u wsUser usuario p webass pasemorze a help l i gt i inputDir dabise O outputDir outDir t test test ficheroComprobante Par metros Datos w wsUrl Url de acceso al servicio u wsUser Nombre de usuario p wsPass Password i inputDir Directorio de entrada donde se encuentra los comprobantes firmados por el usuario 0 outputDir Directorio de salida donde se reciben en el caso de GetTimbreCfdi los timbres de los comprobantes h help Muestra la ayuda t test Ejecuta el webservice en modo TEST ficheroComprobante Nombre del fichero o m scara que contendr los ficheros que formar n los comprobantes a timbrar Por ejemplo fileComprobante xml usar todos los ficheros con extensi n xml de
9. icio e CFDiServiceLocator Objeto encargado de gestionar la URL donde invocar el servicio e CFDiSoapBindingStub Objeto encargado de transformar los objetos de las peticiones al formato SOAP y la respuesta SOAP al formato de objetos del servicio Excepciones e CFDiException Objeto encargado de devolver la informaci n del error que se haya producido en la invocaci n del servicio CFDi de EDICOM 2 4 PAQUETE COM EDICOM EDIWINWS CFDI Contiene los objetos que forman los ejecutables del cliente en modo comando ofrecido dentro de este cliente ObjeTO GeTCrDI Implementa el cliente para obtener el comprobante timbrado a partir del comprobante firmado por el usuario ObjeTO GeTTIMBRECFDI Implementa el cliente para obtener el timbre del comprobante timbrado a partir del comprobante firmado por el usuario CFDi client 2 API de programaci n 8 CFDi client 3 CLIENTE EN MODO COMANDO 3 1 INTRODUCCI N El paquete CfdiClient contiene un conjunto de comandos ejecutables desde la l nea de comandos para invocar el servicio INSTALACI N Para instalar el CfdiClient solo hay que ejecutar el fichero CfdiClient exe que crear un directorio CfdiClient y descomprimir los archivos de la aplicaci n Podr acceder a dicho directorio desde el Procesador de comandos de su sistema Es tambi n recomendable configurar debidamente los par metros por defecto para facilitar el uso de las funciones Ver apartado Par metros configurables
10. innndioninininononenenin anida nena rn ALAN eo aeaaea anase 9 SN A A A RN RRA 9 IMC A A A A AS 9 Archivos IMPONE a A LE id 9 y A A O E RATAS 10 TA RRA NO RON 10 GetTimbreCfdi exe 3 3 Par metros CON UA A al ida 12 Descripci n ii aaa 12 Ejemplo de una parametrizaci n COrTeCta oooooccccoccnoncononnnonnnononanonnonncnn non nonn non n ono R non RD nRnR RON RR RR RR R OR RR R RON RON NOR RON NOR Ran non nan rra nana nr rana n ra E EEEE 12 CFDi client 3 CFDi client 1 CFDI CLIENT 1 1 INTRODUCCI N CFDi es la plataforma webservice de EDICOM para generar los Comprobantes Fiscales Digitales a trav s de Internet Esta plataforma acredita a EDICOM como Proveedor Autorizado de CFD por el Servicio de Administraci n Tributaria convirti ndose as en Proveedor de Servicios de Expedici n de Comprobante Fiscal Digital a trav s de Internet PSECFDI conforme a los nuevos requerimientos especificados para realiza todas las validaciones de los CFDi exigidas por el SAT EDICOM proporciona servicios de timbrado de comprobantes firmados a trav s de su servicio ASP Application Service Provider y tambi n a trav s de web service El servicio CFDi de EDICOM permite la generaci n y obtenci n del comprobante timbrado o del timbre directamente a partir del comprobante previamente firmado por el cliente Cuando un cliente contrata el servicio CFDi de Edicom recibe e La URL del servicio y la documentaci n necesaria para ser utilizada
11. l directorio de entrada Puede contener la CFDi client 3 Cliente en modo comando 11 CFDi client ruta completa junto con el nombre del fichero En este caso el directorio de entrada no se tendr en cuenta Respuesta e Respuesta satisfactoria Devuelve los timbres de los comprobantes timbrados enviados al SAT en la carpeta especificada como directorio de salida e Respuesta de error Devolver un mensaje de error indicando los comprobantes que no se han podido enviar al SAT En caso de que alguno de los comprobantes seleccionados por la m scara se haya enviado correctamente su timbre correspondiente al comprobante timbrado estar disponible en la carpeta de salida del cliente 3 3 PAR METROS CONFIGURABLES Los par metros globales que utilizan todas las funciones de la herramienta est n recogidos en un solo archivo cfdiClient properties Es recomendable completar este archivo con los valores por defecto aunque es posible sobreescribirlos en la propia llamada DESCRIPCI N GENERAL wsUrl Permite indicar la URL de acceso al servicio web service de EDICOM Nota La URL del servicio es https cfdiws sedeb2b com EdiwinWS services CFDIi wsUser Permite indicar el nombre de usuario del servicio CFDi Normalmente este dato es el RFC de la empresa wsPass Permite indicar la contrase a de acceso al servicio CFDi Este dato es comunicado de manera confidencial al cliente inputDir Permite indicar el directorio de origen po
12. par metros escribi ndolos en el momento de la llamada e GetCfdi exe Ejecutable para la obtenci n de los comprobantes timbrados a partir de los xmls de los comprobantes firmados por el cliente CFDi client 3 Cliente en modo comando 9 CFDi client e GetTimbreCfdi exe Ejecutable para la obtenci n de los timbres de los comprobantes timbrados a partir de los xmls de los comprobantes firmados por el cliente Nota Los comandos deben ejecutarse desde el procesador de l nea de comandos o mediante ficheros de proceso por lotes ficheros bat 3 2 EJECUTABLES Los ejecutables que incluye el cliente CfdiClient son los siguientes Ejecutables Descripci n ver GetCfdi Generaci n de CFDI Permite obtener los comprobantes timbrados a partir de los 1 0 comprobantes firmados El cliente GetCfdi se invoca para timbrar los comprobantes ya firmados por el usuario Devuelve los comprobantes timbrados enviados al SAT GetTimbreCfdi Generaci n de timbre de CFDI Permite obtener el timbre del comprobante timbrado a 1 0 partir del comprobante firmado El cliente GetTimbreCfdi se invoca para timbrar los componentes ya firmados por el usuario Devuelve el timbre solo el timbre de los comprobantes timbrados enviados al SAT GeTCFDI EXE Permite obtener los comprobantes timbrados a partir de los comprobantes firmados por el usuario El cliente GetCfdi exe se invoca para timbrar los comprobantes a trav s del servicio C
13. r defecto de los comprobantes firmados en formato xml Cuando se ejecutan las aplicaciones se buscar n en este directorio los comprobantes a procesar outputDir Permite indicar el directorio de destino donde se depositan los comprobantes timbrados o los timbres resultantes de las llamadas a los ejecutables fileComprobante Permite indicar el comprobante a enviar o una m scara para seleccionar los ficheros espec ficos a enviar en el cliente Por ejemplo xml permite que se seleccionen todos los archivos con extensi n xml que existan en ese momento en el inputDir Nota El valor de fileComprobante puede ser una ruta absoluta con o sin m scara test Permite indicar si se ejecuta el cliente en el entorno de pruebas o en el entorno de env o de comprobantes al SAT Si se especifica test false los comprobantes se enviaran al SAT mientras que si se especifica test true los comprobantes no se enviar n el SAT Por defecto en caso de que no se indique nada en este par metro se trabaja en entorno de pruebas sin enviar los comprobantes timbrados al SAT EJEMPLO DE UNA PARAMETRIZACI N CORRECTA CFDi client 3 Cliente en modo comando 12 CFDi client Si no se indica lo contrario para fileComprobante se entiende que todos los archivos se obtienen dentro de inputDir y se generan en outputDir inputDir y outputDir pueden ser el mismo directorio Aunque no se recomienda Nota La descripci n de los par metros aparecer al
14. raci n del timbre de CFDi Permite realizar el timbrado del comprobante firmado 1 0 por el cliente y devuelve el timbre del comprobante timbrado Solo el timbre CFDi client 1 CFDi Client 5 CFDi client 2 API DE PROGRAMACI N 2 1 INTRODUCCI N El CFDiClient incluye un API de programaci n en el lenguaje de programaci n JAVA para poder acceder al servicio Se trata de la librer a cfdiClient jar situada en el directorio del cliente Esta librer a utiliza las librer as externas situadas en el directorio lib para implementar las llamadas SOAP necesarias para invocar el servicio En la carpeta docs del cliente est toda la documentaci n del API de programaci n en formato java docs El fichero index html contiene el ndice de este API El API est estructurado en tres paquetes de objetos que conforman tres partes diferenciadas de este API de programaci n e Paquete com edicom ediwinws cfdi client e Paquete com edicom ediwinws service cfdi e Paquete com edicom ediwinws cfdi 2 2 PAQUETE COM EDICOM EDIWINWS CFDI CLIENT Contiene el cliente necesario para poder invocar el servicio de timbrado A partir de la ejecuci n de este cliente se puede gestionar los timbres obtenidos conforme necesite el cliente ObjeTO CrDICLIENT El objeto CfdiClient es el encargado de gestionar todas las peticiones del cliente con el servicio CFDi de EDICOM El constructor de este cliente est sobrecargado para poder invo
15. t 1 CFDI Client 4 CFDi client El API est estructurado en tres paquetes de objetos que conforman tres partes diferenciadas de este API de programaci n Paquete Descripci n ver com edicom ediwinws cfdi client Contiene el cliente necesario para poder invocar el servicio de timbrado A 1 0 partir de la ejecuci n de este cliente se puede gestionar los timbres obtenidos conforme necesite el cliente Los objetos contenidos en este paquete son e Objecto CfdiClient e Excepci n CfdiExcepction com edicom ediwinws service cfdi Contiene los objetos que contienen la l gica de implementaci n de la petici n 1 0 SOAP del cliente necesaria para poder invocar el servicio de timbrado Estos objetos son autogenerados por la herramienta Wsdl2Java de Axis y por tanto no se van a explicar en detalle com edicom ediwinws cfdi Contiene los objetos que forman los ejecutables del cliente en modo 1 0 comando ofrecido dentro de este cliente Los objetos contenidos en este paquete son e Objeto GetCfdi Ejecutable en modo comando e Objeto GetTimbreCfdi Ejecutable en modo comando FUNCIONES DEL CLIENTE WEBSERVICE CFD1 La herramienta CfdiClient incluye dos ejecutables para invocar al servicio desde la l nea de comandos Funci n Descripci n getCfdi Generaci n de CFDi Permite realizar el timbrado del comprobante firmado por el 1 0 cliente y devuelve el comprobante timbrado getTimbreCfdi Gene
16. uci n se realice correctamente devolver el comprobante timbrado como un byte que contendr el fichero zip con el contenido del nodo del timbre del comprobante timbrado En caso de que haya alg n error en la ejecuci n la llamada devolver una excepci n CfdiException que contendr un c digo con el tipo de error y un texto con la explicaci n del error Excepci n CroiExcEPTION El objeto CfdiException es el encargado de devolver la informaci n del error que se haya producido en la invocaci n del servicio CFDi de EDICOM M todos e int getCod Devuelve el c digo del error e java lang String getText Devuelve el texto del error e java lang String getTextCode Devuelve una explicaci n del tipo de error obtenido 2 3 PAQUETE COM EDICOM EDIWINWS SERVICE CFDI Contiene los objetos que contienen la l gica de implementaci n de la petici n SOAP del cliente necesaria para poder invocar el servicio de timbrado ObseTOS PETICI N SOAP CFDi client 2 API de programaci n 7 CFDi client Estos objetos son autogenerados por la herramienta Wsdl2Java de Axis y por tanto no se van a explicar en detalle http axis apache org Interfaces e CFDi Interfaz de ejecuci n del servicio e CFDiService Interfaz de conexi n del servicio Classes e CancelaResponse Objeto que contiene la respuesta de la cancelaci n del servicio e CFDiProxy Objeto encargado de invocar de las peticiones SOAP del serv
Download Pdf Manuals
Related Search