Manual 4G Factor

4G FACTOR, S.A. DE C.V.WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.3.5 Creado en Creado por 14/08/14 HPC Contenido 1. Glosario de Términos.............................................................................................3 2. Introducción..........................................................................................................3 2.1. Versionamiento.................................................................................................................................. 3 2.2. Almacenamiento y cancelación de CFDIs........................................................................................... 3 3. Interfase de Conexión............................................................................................4 4. Servicios Web principales.......................................................................................5 4.1. Abrir sesión (openSession)................................................................................................................. 5 4.2. Cerrar sesión (closeSession)............................................................................................................... 6 4.3. Timbrado de CFD (createCFDI)........................................................................................................... 6 4.4. Timbrado de CFD sin sesión (createCFDI_NS).....................................................................................8 4.5. Timbrado de CFD sin sesión con addenda y error descriptivo (createCFDI_NSE)................................8 4.6. Solicitud de cancelación de CFDI (cancelCFDIRequest)......................................................................9 4.7. Solicitud de cancelación de CFDI con certificado, llave y contraseña de la llave sin sesión (cancelCFDIcpkRequest_NS)................................................................................................................................... 11 4.8. Estado de cancelación de CFDI (cancelCFDIStatus)..........................................................................12 4.9. Estado de cancelación de CFDI sin sesión (cancelCFDIStatus_NS)....................................................13 4.10. Buscar CFDI (searchCFDI)............................................................................................................... 15 5. Servicios Web complementarios...........................................................................16 5.1. Validar CFD (validateCFD)................................................................................................................ 16 5.2. Validar CFD sin sesión (validateCFD_NS).......................................................................................... 17 5.3. Estadísticas de uso del servicio (serviceUsage)................................................................................17 5.4. Solicitud de timbres (stampsRequest).............................................................................................. 19 5.5. Creación de Comprobante Fiscal (createVoucher)............................................................................20 5.6. Creación de Comprobante Fiscal sin sesión (createVoucher_NS).....................................................24 5.7. Creación de código de barras bidimensional (createCBB)................................................................25 5.8. Creación de código de barras bidimensional sin sesión (createCBB_NS)..........................................26 6. Flujos de operación..............................................................................................27 6.1. Empleando token de sesión.............................................................................................................. 27 6.2. Sin token de sesión.......................................................................................................................... 27 Apéndice A. Códigos de error...................................................................................28 Apéndice B. Juego de caracteres permitido...............................................................30 ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 1 de 29 4G FACTOR, S.A. DE C.V. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.3.5 Creado en Creado por 14/08/14 HPC 1. Glosario de Términos ASCII UTF8 XML SOAP CFD CSD TOKEN Siglas en inglés de American Standard Code for Information Interchange – Es el juego de caracteres estándar utilizado para comunicaciones entre computadoras Siglas en inglés de Universal character set Transformation Format 8 bit – Es el juego de caracteres estándar utilizado para los comprobantes digitales de acuerdo al Anexo 20 del SAT Siglas en inglés de eXtensible Markup Language – Lenguaje de marcado extendido que se propone como un estándar para el intercambio de información estructurada entre diferentes plataformas Siglas de Simple Object Access Protocol – Es un protcolo estándar que define cómo dos objetos en diferentes procesos pueden comunicarse por medio de intercambio de datos XML Siglas de Comprobante Fiscal Digital – Es la representación electrónica en formato XML de una transacción de compra-venta de acuerdo a los lineamientos del SAT Siglas de Certificado de Sello Digital – Certificado que entrega el SAT al contribuyente para trámites electrónicos Código alfanumérico empleado para autenticación de servicios 2. Introducción 4G Factor ofrece su servicio de Timbrado de Comprobantes Fiscales Digitales a los contribuyentes de la República Mexicana por medio del acceso a sus servicios web destinados a éste fin. El sistema realiza todas las validaciones necesarias para certificar que el CFD que el contribuyente trata de firmar, cumpla con las normas del SAT, tanto el formato del XML como la fecha de generación del mismo. El uso de los servicios web que 4G Factor ofrece al público requieren de un contrato de servicios previamente establecido con el contribuyente que desea emplearlos, así como la adquisición de paquetes de timbres. 2.1. Versionamiento Para distinguir cada una de las versiones de nuestro servicio web se emplea la nomenclatura publicación.versión.revisión; la publicación representa el orden de publicación de nuestro servicio web, la versión representa el juego de servicios publicados en la publicación y revisión el orden de actualizaciones aplicadas a los servicios de la versión. 2.2. Almacenamiento y cancelación de CFDIs 4G Factor S.A. de C.V. mantiene disponibles uno por uno todos los CFDIs timbrados en el mes corriente y los tres meses anteriores y en forma de archivos comprimidos del cuarto mes en adelante hasta por dos años y pueden ser descargados desde la plataforma web. Los servicios de cancelación sólo permiten cancelar los CFDIs timbrados en el mes corriente y los tres meses anteriores; los detalles de los mismos aparecen en los apartados 4.6 a 4.9 de éste documento. ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 2 de 29 Interfase de Conexión El acceso a dichos servicios se realiza mediante el intercambio de archivos XML usando la especificación SOAP 1.3. DE C. Conexión entre el Contribuyente y el Servidor de Timbrado 1 http://www. Cliente de Servicio Web Servicios Web Servidor de Timbrado de 4G Factor Internet Contribuyente Firewall Figura 1. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.A. S.V.w3.5 Creado en Creado por 14/08/14 HPC 3.4G FACTOR.org/TR/2000/NOTE-SOAP-20000508/ ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 3 de 29 .11 usando como transporte al Internet. errorCode xsd:int Si el registro fue exitoso éste campo contiene el token de la sesión En caso de error en la generación de la sesión éste campo indica la clave de error Códigos de error: Código 5100 ID Formato Autorizado por Descripción Caracteres inválidos en campo username (fuera del rango UTF8) 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 4 de 29 .ok xsd:boolean • True si la sesión fué creada exitósamente • False si no se pudo crear la sesión ses. Por razones de seguridad el contribuyente puede tener sólo una sesión abierta. en caso de requerir más se deberá solicitar a 4G Factor el motivo y justificación del requerimiento.4G FACTOR. Una vez generado. Un token tiene un tiempo de inactividad máximo de 10 minutos. Servicios Web principales Esta sección indica de forma detallada cómo interactuar con los servicios web ofertados por 4G Factor para el timbrado de CFDs. después de los cuales es invalidado. Si se intenta usar un token inválido en la llamada a algún servicio se devolverá el error correspondiente. DE C. Abrir sesión (openSession) Para realizar cualquier operación con los servicios web. 4. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.V. S. el contribuyente debe primero firmarse al sistema llamando a ésta función. En el apéndice A se encuentra el WSDL para acceso a los servicios.token xsd:string ses.3. Parámetros de entrada: Nombre Tipo Descripción username xsd:string Nombre de usuario asignado por 4G Factor password xsd:string Contraseña de usuario asignada por 4G Factor Tipo Descripción Parámetros de salida: Nombre ses wspacType: sesRecord Contenedor de los parámetros del servicio ses. puede ser usado para el llamado a los demás servicios disponibles. El token está conformado por una cadena alfanumérica de códigos UTF8.A.1.5 Creado en Creado por 14/08/14 HPC 4. El resultado de la llamada a la misma es un token identificador de sesión. DE C. Parámetros de entrada: Nombre Tipo token xsd:string Descripción Token devuelto por el servicio de abrir sesión Parámetros de salida: Nombre Tipo ses wspacType: sesRecord ses. el contribuyente lo llamará cada vez que requiera hacer un timbrado. Cada vez que se genera un timbre se debita del paquete de timbres en producción.5 Creado en Creado por 14/08/14 HPC 4. la combinación username y password son inválidas ID Documento Revisión 4GF-PAC-WSPAC 2.errorCode xsd:int Descripción Contenedor de parámetros de salida • True si la sesión se cerró correctamente • False si la sesión no se pudo cerrar En caso de error éste campo indica la clave del mismo Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5201 Token de sesión inválido 5202 Sesión previamente cerrada 5203 Sesión expirada 4. Si se olvida de hacerlo el sistema invalidará al token automáticamente después de 10 minutos de inactividad.3. Timbrado de CFD (createCFDI) Éste es el servicio de timbrado de CFDs principal.4G FACTOR. S. 4G Factor envía una alarma por correo electrónico al contribuyente cuando al paquete le quede un 20% de timbres disponibles.A. Una vez establecida la sesión. ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 5 de 29 .V. WSPAC – Servicios Web Para Timbrado de CFDs 5101 Caracteres inválidos en campo password (fuera del rango UTF8) 5200 Error de autenticación. Cerrar sesión (closeSession) Cuando el contribuyente no tenga la necesidad de timbrar más CFDs por un periodo de tiempo debe cerrar la sesión que tenga activa.2.ok xsd:string ses.3. xml xsd:string XML a timbrar Tipo Descripción Parámetros de salida: Nombre cfdi wspacType: cfdiRecord Contenedor de parámetros de salida cfdi. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.3.errorCode xsd:int cfdi.5 Creado en Creado por 14/08/14 HPC Parámetros de entrada: Nombre Tipo Descripción cfd wspacType: cfdRecord Contenedor de parámetros del servicio cfd. DE C.uuid xsd:string UUID del timbre cfdi.date En caso de error en la generación del CFDI éste campo indica la clave de error xsd:dateTime Fecha de certificación cfdi.4G FACTOR.string xsd:string Cadena original del timbre cfdi.xml xsd:string XML timbrado cfdi.cfdStamp xsd:string Sello del CFD timbrado cfdi.A.V. S.satStamp xsd:string Sello del SAT Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5103 Caracteres inválidos en campo xml (fuera del rango UTF8) 5201 Token de sesión inválido 5300 No más timbres disponibles 5400 RFC de CFD no autorizado para timbrar 301 Error en la estructura del XML con respecto al ANEXO 20 de la Resolución Miscelánea Fiscal 2010 302 Sello mal formado o inválido 303 Sello de firma no corresponde a CSD del emisor 304 CSD del contribuyente vencido o inválido 305 La fecha de emisión no esta dentro de la vigencia del CSD del Emisor ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 6 de 29 .token xsd:string Token de sesión válido cfd.certNumber xsd:string Número de certificado del SAT cfdi.ok xsd:boolean • True si la generación del CFDI fué exitosa • False si la generación del CFDI falló cfdi. username xsd:string Nombre de usuario asignado por 4G Factor cfd_ns.password xsd:string Contraseña de usuario asignada por 4G Factor cfd_ns. ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 7 de 29 .5. el servicio extrae la addenda del XML para proceder al timbrado y envío al SAT. DE C. WSPAC – Servicios Web Para Timbrado de CFDs 306 El certificado no es de tipo CSD 307 El CFDI contiene un timbre previo 308 Certificado no expedido por el SAT 401 CFD fuera de fecha (emitido hace más de 72 horas) 402 RFC del emisor no se encuentra en el régimen de contribuyentes 403 La fecha de emisión no es posterior al 01 de enero 2012 404 La fecha de emisión está en el futuro ID Documento Revisión 4GF-PAC-WSPAC 2. acto seguido inserta nuevamente la addenda y devuelve el CFDI junto con ella. Entrega el mismo resultado y los mismos errores que el servicio del apartado 4. Si se desea recuperar un comprobante que haya sido timbrado previamente que contenía una addenda. ésta última no aparecerá en el comprobante devuelto.4.3 (createCFDI). Timbrado de CFD sin sesión con addenda y error descriptivo (createCFDI_NSE) Éste servicio permite al usuario incluir el tag de addenda en el XML del comprobante a timbrar. Los códigos de error que aplican para éste servicio son los mismos del servicio del apartado 4. Se debe tener en cuenta que la addenda no se almacena en la base de datos ni se entrega al SAT.A.5 Creado en Creado por 14/08/14 HPC 4. un nuevo parámetro incluye la descripción del mismo.3. En el caso de que el servicio detecte un error en el XML enviado. Parámetros de entrada: Nombre Tipo cfd_ns Descripción wspacType: Contenedor de parámetros del servicio cfd_NSRecord cfd_ns. Timbrado de CFD sin sesión (createCFDI_NS) Servicio de timbrado de CFD que no requiere de abrir una sesión previamente y mantenerla activa.xml xsd:string XML a timbrar 4.4G FACTOR.V. S.3 (createCFDI). Para solicitar la cancelación de más de un CFDI se deberán indicar en el parámetro UUID todos los UUIDs de los CFDIs a cancelar separándolos por un caracter “|” (pipe).date xsd:dateTime Fecha de certificación cfdi. La cancelación de CFDIs se hace de forma diferida.cfdStamp xsd:string Sello del CFD timbrado cfdi.errorCode xsd:int En caso de error en la generación del CFDI éste campo indica la clave de error cfdi. S.xml xsd:string XML a timbrar Tipo Descripción Parámetros de salida: Nombre cfdi wspacType: cfdiRecord Contenedor de parámetros de salida cfdi.string xsd:string Cadena original del timbre cfdi.username xsd:string Nombre de usuario asignado por 4G Factor cfd_ns.certNumber xsd:string Número de certificado del SAT cfdi.uuid xsd:string UUID del timbre cfdi. DE C.3.A. Solicitud de cancelación de CFDI (cancelCFDIRequest) Cuando el contribuyente desee cancelar un timbre realizado previamente deberá hacer un llamado a éste servicio indicando el UUID del CFDI a cancelar. por tanto después de hacer la solicitud se deberá emplear el servicio de “Estado de cancelación de CFDI” o el servicio de “Estado de cancelación de CFDI sin ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 8 de 29 .6.xml xsd:string XML timbrado cfdi.errorDescription xsd:string En caso de error en la generación del CFDI contiene la descripción del mismo cfdi.4G FACTOR.ok xsd:boolean • True si la generación del CFDI fué exitosa • False si la generación del CFDI falló cfdi.satStamp xsd:string Sello del SAT 4. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.V.5 Creado en Creado por 14/08/14 HPC Parámetros de entrada: Nombre Tipo cfd_ns Descripción wspacType: Contenedor de parámetros del servicio cfd_NSRecord cfd_ns. Se puede solicitar la cancelación de un paquete de hasta 10 CFDIs.password xsd:string Contraseña de usuario cfd_ns. aquellos que no los presenten serán puestos en proceso de cancelación. S. Los CFDIs que presenten error en la solicitud de cancelación serán indicados en la respuesta del servicio y serán removidos de la misma. Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5104 Caracteres inválidos en campo uuid (fuera del rango UTF8) 5201 Token de sesión inválido 202 UUID previamente cancelado 203 UUID a cancelar no pertenece a contribuyente 205 UUID a cancelar desconocido ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 9 de 29 .A. DE C. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.V. Parámetros de entrada: Nombre Tipo Descripción cancelCfdiReq wspacType: cancelCfdiRequestRecord cancelCfdiReq....ok xsd:boolean • True si se aceptó la solicitud de cancelación para todos los UUIDs indicados • False si se generó un error en la solicitud de cancelación de algún UUID cancelReq.3.uuid xsd:string UUID del CFDI a cancelar (UUID|UUID|. Una vez que un CFDI entra al proceso de cancelación no podrá ser removido del mismo.5 Creado en Creado por 14/08/14 HPC sesión” para verificar el resultado de la misma.4G FACTOR..token xsd:string Token de sesión válido cancelCfdiReq.uuid xsd:string En caso de que se presentase error en alguno(s) de(los) CFDIs solicitados se indicará el UUID y la clave de error correspondientes de la forma: UUID:errorCode|UUID:errorCode|.errorCode xsd:int En caso de generarse un error. en éste campo se deposita el código del mismo (-1 indica que se presentaron errores en alguno(s) de(los) CFDIs solicitados cancelReq. Se recomienda esperar al menos 5 minutos antes de acceder al servicio. para más de un CFDI) Contenedor de parámetros del servicio Parámetros de salida: Nombre Tipo Descripción wspacType: Contenedor de parámetros de salida cancelCfdiRequestResposeRecord cancelReq cancelReq. 3.password xsd:string Contraseña de usuario cancelReq.key_hex xsd:string Llave del certificado del emisor del UUID a cancelar en formato hexadecimal cancelReq.7. S. sean vigentes y que correspondan a los usados durante el sellado del CFDI a cancelar. la cancelación del CFDI se hace de forma diferida.cert_hex xsd:string Certificado del emisor del UUID a cancelar en formato hexadecimal cancelReq. por tanto después de hacer la solicitud se deberá emplear el servicio de “Estado de cancelación de CFDI” o el servicio de “Estado de cancelación de CFDI sin sesión” para verificar el resultado de la misma.V.username xsd:string Nombre de usuario asignado por 4G Factor cancelReq. Al igual que en el servicio del apartado 4. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.4G FACTOR.uuid xsd:string UUID del CFDI a cancelar cancelReq. que el SAT lo tenga registrado.6.A. que el certificado. Una vez que un CFDI entra al proceso de cancelación no podrá ser removido del mismo. la llave y la contraseña de la misma que fueron empleados para sellar el CFDI del lado del cliente.5 Creado en Creado por 14/08/14 HPC 4. Parámetros de entrada: Nombre Tipo Descripción cancelReq wspacType: cancelCFDIcpkRequest_NSRecord cancelReq. Tanto el certificado y la llave deben ser convertidos a su expresión hexadecimal como cadena de caracteres para ser enviados al servicio web. llave y contraseña de la llave sin sesión (cancelCFDIcpkRequest_NS) Éste servicio permite la cancelación de un UUID sin requerir de un token de sesión y proporcionando el certificado. Solicitud de cancelación de CFDI con certificado. Tanto el certificado como la llave proporcionados se mantienen en el sistema durante el proceso de cancelación y son desechados inmediatamente después de completado haya sido o no exitoso. Si el CFDI a cancelar presenta error en la solicitud éste será indicado en la respuesta del servicio. que tenga al menos cuatro horas de haber sido timbrado. DE C. El servicio validará que el CFDI haya sido timbrado por el usuario que solicita la cancelación. Se recomienda esperar al menos 5 minutos antes de acceder al servicio. la llave y la contraseña correspondan entre sí.key_pass word xsd:string Contraseña de la llave del certificado ID Formato Autorizado por 4GF-PAC-CFDI HPC Contenedor de parámetros del servicio Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 10 de 29 . Parámetros de entrada: Nombre Tipo cancelCfdiStt ID Formato Autorizado por wspacType: cancelCfdiStatusRequestRe- 4GF-PAC-CFDI HPC Descripción Contenedor de parámetros del servicio Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 11 de 29 .A.uuid xsd:string • True si se aceptó la solicitud de cancelación para el UUID indicado • False si se generó un error en la solicitud de cancelación del UUID En caso de generarse un error.V.errorCode xsd:int cancelReq. S.4G FACTOR.ok xsd:boolean cancelReq. en éste campo se deposita el código del mismo UUID procesado Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5104 Caracteres inválidos en campo uuid (fuera del rango UTF8) 5501 Certificado inválido 5502 Llave inválida 5503 El UUID está fuera del tiempo permitido para solicitar su cancelación 5504 La llave no corresponde al certificado 5505 El RFC del emisor del UUID no corresponde al RFC del certificado 202 UUID previamente cancelado 203 UUID a cancelar no pertenece a contribuyente 205 UUID a cancelar desconocido 4.3.5 Creado en Creado por 14/08/14 HPC Parámetros de salida: Nombre Tipo Descripción wspacType: Contenedor de parámetros de salida cancelCFDIckp Request_NSRe sposeRecord cancelReq cancelReq.8. Estado de cancelación de CFDI (cancelCFDIStatus) Después de solicitar la cancelación de uno o más CFDIs es necesario acceder a éste servicio para verificar el estado de la cancelación de los mismos. DE C. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2. El servicio permite la consulta del estado de cancelación de un CFDI por vez. 8.errorCode xsd:int cancelStt.token xsd:string Token de sesión válido cancelCfdiStt. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.5 Creado en Creado por 14/08/14 HPC cord cancelCfdiStt. en éste campo se deposita el código del mismo XML del acuse de cancelación del SAT para el CFDI consultado (vacío en caso de error) Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5104 Caracteres inválidos en campo uuid (fuera del rango UTF8) 5201 Token de sesión inválido 200 UUID en proceso de cancelación 202 UUID previamente cancelado 203 UUID consultado no pertenece a contribuyente 205 UUID consultado desconocido 206 UUID no solicitado para cancelación 4.V.A.ok xsd:boolean • True si el CFDI consultado está cancelado • False si se presentó un error en la consulta cancelStt. S.uuid xsd:string UUID del CFDI a verificar Parámetros de salida: Nombre Tipo Descripción cancelStt wspacType: cancelCfdiStatusResponseRecord Contenedor de parámetros de salida cancelStt. El servicio permite la consulta del estado de cancelación de un CFDI por vez.ack xsd:string En caso de generarse un error. éste servicio permite verificar el estado de la cancelación de un UUID con la diferencia que no hace falta tener una sesión abierta. DE C.3. ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 12 de 29 .4G FACTOR. Estado de cancelación de CFDI sin sesión (cancelCFDIStatus_NS) De forma similar al servicio web del apartado 4.9. la combinación username y password son inválidas 200 UUID en proceso de cancelación 202 UUID previamente cancelado 203 UUID consultado no pertenece a contribuyente 205 UUID consultado desconocido 206 UUID no solicitado para cancelación ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 13 de 29 . DE C.errorCode xsd:int cancelStt.ok xsd:boolean cancelStt.password xsd:string Contraseña de usuario cancelStt. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.uuid xsd:string UUID del CFDI a verificar Parámetros de salida: Nombre Tipo Descripción wspacType: Contenedor de parámetros de salida cancelCFDIStat us_NSRespons eRecord cancelStt cancelStt. S.5 Creado en Creado por 14/08/14 HPC Parámetros de entrada: Nombre Tipo Descripción wspacType: Contenedor de parámetros del servicio cancelCFDIStat us_NSRequest Record cancelStt cancelStt.3.A.ack xsd:string • True si el CFDI consultado está cancelado • False si se presentó un error en la consulta En caso de generarse un error.V. en éste campo se deposita el código del mismo XML del acuse de cancelación del SAT para el CFDI consultado (vacío en caso de error) Códigos de error: Código Descripción 5100 Caracteres inválidos en campo username (fuera del rango UTF8) 5101 Caracteres inválidos en campo password (fuera del rango UTF8) 5104 Caracteres inválidos en campo uuid (fuera del rango UTF8) 5200 Error de autenticación.username xsd:string Nombre de usuario asignado por 4G Factor cancelStt.4G FACTOR. token xsd:string Token de sesión válido searchCfdi. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.5 Creado en Creado por 14/08/14 HPC 4.uuid xsd:string UUID del CFDI a localizar Contenedor de parámetros del servicio Parámetros de salida: Nombre Tipo Descripción cfdi wspacType: cfdiRecord Contenedor de parámetros de salida cfdi.A.certNumber xsd:string Número de certificado del SAT cfdi.string xsd:string Cadena original del timbre cfdi. DE C. Buscar CFDI (searchCFDI) Servicio disponible al contribuyente para recuperar CFDIs previamente emitidos.date En caso de generarse un error en éste campo se deposita la clave del mismo xsd:dateTime Fecha de certifiación cfdi.3.ok xsd:boolean • True si se encontró el CFDI • False si se generó un error en la búsqueda del CFDI cfdi. Parámetros de entrada: Nombre Tipo Descripción searchCfdi wspacType: searchCfdiRecord searchCfdi.cfdStamp xsd:string Sello del CFD timbrado cfdi.uuid xsd:string UUID del timbre cfdi. S.V.10.errorCode xsd:int cfdi.xml xsd:string XML timbrado cfdi.satStamp xsd:string Sello del SAT Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5104 Caracteres inválidos en campo uuid (fuera del rango UTF8) 5201 Token de sesión inválido 203 UUID consultado no pertenece a contribuyente 205 UUID consultado desconocido 208 UUID inválido ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 14 de 29 .4G FACTOR. Su propósito es el de proveer al contribuyente de un mecanismo que le permita asegurarse que los CFDs que su sistema genera sean correctos.4G FACTOR.A.ok xsd:boolean valid. El uso de éste servicio es sólo para pruebas y no para operación normal. DE C. Parámetros de entrada: Nombre Tipo Descripción cfd wspacType: cfdRecord Contenedor de parámetros del servicio cfd. S.xml xsd:string XML del CFD a validar Tipo Descripción Parámetros de salida: Nombre wspacType: Contenedor de parámetros de salida validateCfdResponseRecord valid valid.5 Creado en Creado por 14/08/14 HPC 5.errorCode xsd:int • True si la validación del CFD fué exitosa • False si la validación del CFD falló En caso de error en la validación del CFD éste campo indica la clave de error Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5103 Caracteres inválidos en campo xml (fuera del rango UTF8) 5201 Token de sesión inválido 301 Error en la estructura del XML con respecto al ANEXO 20 de la Resolución Miscelánea Fiscal 2010 302 Sello mal formado o inválido 303 Sello de firma no corresponde a CSD del emisor 304 CSD del contribuyente vencido o inválido 305 La fecha de emisión no esta dentro de la vigencia del CSD del Emisor ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 15 de 29 . WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.V.token xsd:string Token de sesión válido cfd.1. no genera ningún tipo de timbre fiscal. Validar CFD (validateCFD) Éste servicio se emplea sólo para verificar la correcta creación del CFD por parte del contribuyente. Servicios Web complementarios 5.3. 1.4G FACTOR. Parámetros de entrada: Nombre Tipo token xsd:string Descripción Token devuelto por el servicio de abrir sesión Parámetros de salida: Nombre stats ID Formato Autorizado por Tipo wspacType: 4GF-PAC-CFDI HPC Descripción Contenedor de parámetros de salida Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 16 de 29 . DE C. S.xml xsd:string XML de CFD a verificar 5. Parámetros de entrada: Nombre Tipo cfd_ns Descripción wspacType: Contenedor de parámetros del servicio cfd_NSRecord cfd_ns.3. (validateCFD). Estadísticas de uso del servicio (serviceUsage) Por medio de éste servicio el contribuyente puede recuperar la información de los paquetes de timbres que ha adquirido y la cantidad disponible en el vigente.V.5 Creado en Creado por 14/08/14 HPC 5.username xsd:string Nombre de usuario asignado por 4G Factor cfd_ns.A.2. Entrega el mismo resultado y los mismos errores que el servicio del apartado 5. WSPAC – Servicios Web Para Timbrado de CFDs 306 El certificado no es de tipo CSD 307 El CFDI contiene un timbre previo 308 Certificado no expedido por el SAT 401 CFD fuera de fecha (emitido hace más de 72 horas) 402 RFC del emisor no se encuentra en el régimen de contribuyentes 403 La fecha de emisión no es posterior al 01 de enero 2012 404 La fecha de emisión está en el futuro ID Documento Revisión 4GF-PAC-WSPAC 2. Validar CFD sin sesión (validateCFD_NS) Servicio de verificación de CFD que no requiere de abrir una sesión previamente y mantenerla activa.password xsd:string Contraseña de usuario cfd_ns.3. 4G FACTOR.550 timbres ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 17 de 29 .errorCode xsd:int En caso de error éste campo indica la clave del mismo stats.stampsTotal xsd:int Cantidad total de timbres disponibles en el paquete pkg.pkg wspacType: pkgRecord Contenedor de paquetes de timbrado Estructura de datos de un paquete de timbres (wspacType:pkgRecord) Nombre Tipo Descripción pkg complex:cfdi Contenedor de parámetros de un paquete de timbrado pkg.requestTime xsd:time Hora de solicitud del paquete pkg.exhaustTime xsd:time Hora en la que se consumieron todos los timbres (00:00:00 si hay disponibles) pkg.requestDate xsd:date Fecha de solicitud del paquete pkg. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2. DE C.status xsd:int Estado del paquete (ver tabla anexa) pkg.5 Creado en Creado por 14/08/14 HPC statsRecord stats.id xsd:int Identificador único del paquete de timbres asignado por 4G Factor pkg.3.ok xsd:string • True si se obtuvieron las estadísticas correctamente • False si se generó un error stats.A.550 timbres 6 Paquete de 5.exhaustDate xsd:date Fecha en la que se consumieron todos los timbres (1900-01-01 si hay disponibles) pkg.stampsUsed xsd:int Cantidad de timbres consumidos del paquete Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5201 Token de sesión inválido Tipos de paquetes de timbrado: ID Descripción 1 Paquete de 150 timbres 2 Paquete de 350 timbres 3 Paquete de 750 timbres ID Descripción 4 Paquete de 1.typeId xsd:int Identificador del tipo de paquete (ver tabla anexa) pkg.V. S.550 timbres 5 Paquete de 2. Sólo un paquete de timbres puede estar disponible a la vez y es marcado con este estatus. el sistema de facturación automático de 4G Factor emitirá la factura electrónica del mismo y la enviará al correo electrónico registrado del contribuyente para su pago. Una vez solicitado el paquete.3. Estado en el que queda un paquete después de que el sistema de facturación de paquetes de timbres de 4G Factor ha enviado la factura del mismo 4 Disponible. El estado de un paquete de timbres solicitado puede ser monitoreado con el servicio serviceUsage.4.A.000 timbres 8 Paquete de timbres ilimitados ID Documento Revisión 4GF-PAC-WSPAC 2.4G FACTOR.token xsd:string reqPkg. Una vez solicitado un paquete. Cuando un paquete de timbres no es liquidado en el tiempo límite que 4G Factor establece es cancelado automáticamente 5. Una vez que el departamento contable de 4G Factor valida el pago de un paquete éste último queda disponible para su uso por el contribuyente 5 En producción.5 Creado en Creado por 14/08/14 HPC Estado de paquete de timbrado: ID Descripción 1 Solicitado. empleará éste servicio para solicitarlos. S. Parámetros de entrada: Nombre Tipo reqPkg wspacType: Contenedor de parámetros del servicio reqPkgRecord reqPkg. 4G Factor genera la factura electrónica del mismo y la envía por correo electrónico al contribuyente para su pago 3 Esperando pago.V. WSPAC – Servicios Web Para Timbrado de CFDs ID Descripción 7 Paquete de 10. DE C. Si el contribuyente adquirió más de un paquete se irán consumiendo conforme a su fecha de compra 6 Cancelado. Solicitud de timbres (stampsRequest) Cuando el contribuyente determina que necesita un nuevo paquete de timbres.typeId xsd:int ID Formato Autorizado por Descripción 4GF-PAC-CFDI HPC Token de sesión válido ID del paquete que se desea solicitar Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 18 de 29 . Cuando el contribuyente determina que los timbres que tiene disponibles no le son suficientes solicita un nuevo paquete de timbres 2 En proceso de facturación. &apos. Parámetros de entrada: Nombre Tipo voucher wspacType: voucherRecord voucher. &gt.A. Se debe tener en cuenta que los caracteres (“) comilla doble.errorCode xsd:int • True si la solicitud se llevó a cabo correctamente • False si la solicitud generó algún error En caso de error en la solicitud éste campo indica la clave de error Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5105 ID de paquete de timbres inválido 5201 Token de sesión inválido 5.ok xsd:boolean reqResp.5. Creación de Comprobante Fiscal (createVoucher) Si no se cuenta o no se desea realizar el XML del CFD éste es el servicio que otorga la solución más simple.vdata wspacType: vdataRecord ID Formato Autorizado por 4GF-PAC-CFDI HPC Descripción Tipo complejo contenedor de parámetros del servicio Token de sesión válido Tipo complejo contenedor de los elementos del comprobante electrónico Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 19 de 29 .5 Creado en Creado por 14/08/14 HPC Parámetros de salida: Nombre Tipo Descripción wspacType: Contenedor de parámetros de salida reqPkgResponseRecrod reqResp reqResp. (<) menor que. (>) mayor que y (&) deben ser escapados a su secuencia HTML respectiva (&quot. llaves y contraseña de llaves para los RFCs que lo emplearán.3.V. S. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2. El servicio toma como parámetros de entrada los datos del receptor y los conceptos asociados al comprobante y entrega como resultado el XML timbrado. DE C.token xsd:string voucher. &lt.). y &amp. Debe tener en cuenta que para que el servicio opere satisfactoriamente debe subir al aplicativo Web el o los certificados.4G FACTOR. (') comilla simple. V. DE C.5 Creado en Creado por 14/08/14 HPC Estructura del comprobante (wspacType:vdataRecord) Nombre Tipo vhead Descripción wspacType: Tipo complejo contenedor de los elementos de la cabecera del comprobante vheadRecord (REQUERIDO) item wspacType: itemRecord Tipo complejo contenedor de una partida que se incluye en el comprobante (REQUERIDO) tax wspacType: taxRecord Tipo complejo contenedor de un impuesto que se incluye en el comprobante (REQUERIDO) retention wspacType: Tipo complejo contenedor de una retención que se incluye en el comprobante retentionRecord (OPCIONAL) Estructura del encabezado del comprobante (wspacType:vheadRecord) Nombre Tipo Descripción voucherType xsd:string Tipo de comprobante (“ingreso”.4G FACTOR. S. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2. “egreso” ó “traslado”) (REQUERIDO) series xsd:string Serie del comprobante (OPCIONAL) consecutive xsd:int issuerName xsd:string Nombre del emisor del comprobante (REQUERIDO) issuerRfc xsd:string RFC del emisor del comprobante (REQUERIDO) issuerRegime xsd:string Régimen del emisor del comprobante (REQUERIDO) issuerAddr wspacType: addressRecord Dirección fiscal del emisor del comprobante (REQUERIDO) issuedAtAddr wspacType: addressRecord Dirección donde se emite el comprobante (REQUERIDO) receiverName xsd:string Nombre del receptor del comprobante (REQUERIDO) receiverRfc xsd:string RFC del receptor del comprobante (REQUERIDO) receiverAddr WspacType: addressRecord subTotal xsd:double Número decimal que representa el subtotal del comprobante (REQUERIDO) discount xsd:double Número decimal que representa el descuento incluido en el comprobante (OPCIONAL) total xsd:double Número decimal que representa el total del comprobante (REQUERIDO) currency xsd:string Moneda base en la que se expresan los montos del comprobante (OPCIONAL) exchangeRate xsd:double Tipo de cambio.A. usarlo cuando la moneda base no sea MXN (OPCIONAL) accountNumber xsd:string Número de cuenta generadora del pago del comprobante (OPCIONAL) paymentType xsd:string Forma en que se realiza el pago del comprobante (REQUERIDO) Número entero que representa el folio del comprobante (OPCIONAL) Dirección fiscal del receptor del comprobante (REQUERIDO) paymentSource xsd:string Método con el que se paga el comprobante (REQUERIDO) referenceConsecutive xsd:string UUID del comprobante original para pago en parcialidades (OPCIONAL) referenceSeries xsd:string UUID del comprobante original para pago en parcialidades (OPCIONAL) referenceIssueDate xsd:string Fecha de emisión del UUID original (YYYY-MM-DDTHH:MM:SS) para pago en ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 20 de 29 .3. A. WSPAC – Servicios Web Para Timbrado de CFDs Nombre Tipo ID Documento Revisión 4GF-PAC-WSPAC 2. IEPS) (REQUERIDO) amount xsd:double Número decimal que indica el importe del impuesto (REQUERIDO) rate xsd:double Número decimal que indica la tasa del impuesto (ej. el resultado de multiplicar la cantidad de piezas por el valor unitario (REQUERIDO) Estructura de datos de un impuesto (wspacType:taxRecord) Nombre Tipo Descripción name xsd:string Nombre del impuesto (IVA. DE C. 16.3.00 representa el 16%) (REQUERIDO) ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 21 de 29 .5 Creado en Creado por 14/08/14 HPC Descripción parcialidades (OPCIONAL) referenceAmount xsd:doube Monto total del UUID original para pago en parcialidades (OPCIONAL) Estructura de datos de una dirección (wspacType:addressRecord) Nombre Tipo Descripción street xsd:string Calle de la dirección fiscal del emisor del comprobante (REQUERIDO) residence xsd:string Colonia de la dirección fiscal del emisor del comprobante (OPCIONAL) externalNum xsd:string Número exterior de la dirección fiscal del emisor del comprobante (OPCIONAL) internalNum xsd:string Número interior de la dirección fiscal del emisor del comprobante (OPCIONAL) zip xsd:string Código postal de la dirección fiscal del emisor del comprobante. S.V. deben ser cinco caracteres numéricos (REQUERIDO) state xsd:string Estado de la dirección fiscal del emisor del comprobante (REQUERIDO) municipallity xsd:string Municipio de la dirección fiscal del emisor del comprobante (REQUERIDO) country xsd:string País de la dirección fiscal del emisor del comprobante (REQUERIDO) Estructura de datos de un concepto (wspacType:itemRecord) Nombre Tipo Descripción order xsd:int Número entero ordinal de la partida (OPCIONAL) id xsd:string Código del concepto de la partida (OPCIONAL) description xsd:string Descripción del concepto de la partida (REQUERIDO) quantity xsd:double Número decimal que indica la cantidad de piezas de la partida (REQUERIDO) units xsd:string Tipo de unidad del concepto de la partida (REQUERIDO) value xsd:double Valor unitario de la partida (REQUERIDO) amount xsd:double Monto de la partida.4G FACTOR. ISR) (REQUERIDO) amount xsd:double Número decimal que indica el importe del impuesto retenido (REQUERIDO) Parámetros de salida: Nombre Tipo Descripción cfdi wspacType: cfdiRecord Contenedor de parámetros de salida cfdi. S.xml xsd:string XML timbrado cfdi.cfdStamp xsd:string Sello del CFD timbrado cfdi.errorCode xsd:int cfdi.A. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.date En caso de error en la generación del CFDI éste campo indica la clave de error xsd:dateTime Fecha de certificación cfdi. DE C.uuid xsd:string UUID del timbre cfdi.3.certNumber xsd:string Número de certificado del SAT cfdi.ok xsd:boolean • True si la generación del CFDI fué exitosa • False si la generación del CFDI falló cfdi.string xsd:string Cadena original del timbre cfdi.5 Creado en Creado por 14/08/14 HPC Estructura de datos de una retención (wspacType:retentionRecord) Nombre Tipo Descripción name xsd:string Nombre del impuesto retenido (IVA.satStamp xsd:string Sello del SAT Códigos de error: Código Descripción 3001 Falta estado y municipio en la dirección donde se emite el comprobante 3002 Fata forma de pago 3003 Falta método de pago 3004 Falta subtotal del comprobante 3005 Falta total del comprobante 3006 Falta tipo de comprobante 3007 Falta nombre / RFC del emisor 3008 Falta calle en domicilio fiscal 3009 Falta código postal en domicilio fiscal 3010 Falta estado en domicilio fiscal 3011 Falta municipio en domicilio fiscal 3012 Falta país en domicilio fiscal ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 22 de 29 .4G FACTOR.V. 6. WSPAC – Servicios Web Para Timbrado de CFDs 3013 Falta calle en dirección de expedición del comprobante 3014 Falta código postal en dirección de expedición del comprobante 3015 Falta estado en dirección de expedición del comprobante 3016 Falta municipio en dirección de expedición del comprobante 3017 Falta país en dirección de expedición del comprobante 3018 Falta régimen del emisor 3019 Falta nombre / RFC del receptor 3020 Falta calle en dirección del receptor 3021 Falta código postal en dirección del receptor 3022 Falta estado en dirección del receptor 3023 Falta municipio en dirección del receptor 3024 Falta país en dirección del receptor 3025 Falta descripción en un concepto 3026 Falta cantidad en un concepto 3027 Faltan unidades en un concepto 3028 Falta valor unitario en un concepto 3029 Falta importe en un concepto 3030 Falta nombre de retención / importe en una retención 3031 Falta nombre de impuesto / importe / tasa en un impuesto 3032 No hay certificado disponible para sellar el CFD 3033 No hay número de certificado disponible 3034 No hay llave disponible para sellar el CFD 3035 Error al sellar el CFD 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5103 Caracteres inválidos en datos del comprobante (fuera del rango UTF8) 5201 Token de sesión inválido 5300 No más timbres disponibles 5400 RFC de emisor no autorizado para timbrar ID Documento Revisión 4GF-PAC-WSPAC 2. DE C. Refiera al servicio createVoucher del apartado 5.A.4G FACTOR.5 Creado en Creado por 14/08/14 HPC 5. errores y resultados que el servicio entrega.V.5 para las restricciones. S. ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 23 de 29 . Creación de Comprobante Fiscal sin sesión (createVoucher_NS) Si se desea crear un comprobante fiscal sin tener que abrir una sesión y mantenerla activa se puede emplear éste servicio.3. vdata wspacType: vdataRecord Tipo complejo contenedor de los elementos del comprobante electrónico 5. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.3.V.errorCode xsd:int cbb.ok xsd:boolean • True si la solicitud se llevó a cabo correctamente • False si la solicitud generó algún error cbb.A.4G FACTOR.7.token xsd:string Token de sesión válido cbbReq. Creación de código de barras bidimensional (createCBB) Servicio que permite obtener la imagen del código de barras bidimensional que se debe incluir en la representación impresa de un CFDI.password xsd:string Contraseña de usuario de timbrado voucher_ns. DE C.5 Creado en Creado por 14/08/14 HPC Parámetros de entrada: Nombre Tipo voucher_ns Descripción wspacType: Contenedor de parámetros del servicio cfd_NSRecord voucher_ns.uuid xsd:string UUID del que se desea obtener el código de barras bidimensional Tipo Descripción Parámetros de salida: Nombre cbb wspacType: cbbRecrod Contenedor de parámetros de salida cbb. S. Parámetros de entrada: Nombre Tipo cbbReq wspacType: Descripción Contenedor de parámetros del servicio createCbbRecord cbbReq.username xsd:string Nombre de usuario de timbrado voucher_ns. La imagen generada es un PNG y se devuelve como una cadena de texto codificada en base 64.cbb xsd:string ID Formato Autorizado por 4GF-PAC-CFDI HPC En caso de error en la solicitud éste campo indica la clave de error Imagen PNG del CBB en forma de cadena de caracteres en base 64 Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 24 de 29 . username xsd:string Nombre de usuario de timbrado cbbNSReq.uuid xsd:string UUID del que se desea obtener el código de barras bidimensional ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 25 de 29 . Parámetros de entrada: Nombre Tipo cbbNSReq wspacType: Descripción Contenedor de parámetros del servicio createCbb_NSRecord cbbNSReq. Refiera a dicho servicio para restricciones. DE C.3. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.V.8.4G FACTOR.5 Creado en Creado por 14/08/14 HPC Códigos de error: Código Descripción 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5201 Token de sesión inválido 5202 Sesión previamente cerrada 5203 Sesión expirada 203 UUID consultado no pertenece a contribuyente 205 UUID consultado desconocido 208 UUID inválido 5. S.password xsd:string Contraseña de usuario de timbrado cbbNSReq.7 que no requiere de abrir una sesión y mantenerla activa. resultados y códigos de error. Creación de código de barras bidimensional sin sesión (createCBB_NS) Servicio similar al del apartado 5.A. ...4G FACTOR.password) session token createCFDI(token.passw ord. :contribuyente stamp() :4GFwebservices openSession(username. :contribuyente :4GFwebservices stamp() createCFDI_NS(username..5 Creado en Creado por 14/08/14 HPC 6.3.A..V. DE C. Flujos de operación 6..) cfdi closeSession(token) acknowledge Figura 2.1. Flujo de timbrado de CFDs sin token de sesión ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 26 de 29 . S.) cfdi Figura 3. Empleando token de sesión En la figura 2 se muestra un diagrama secuencial UML con el flujo típico que realiza el contribuyente con los Servicios Web de 4G Factor para el timbrado de un CFD empleando token de sesión.2.. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2. 6.. Sin token de sesión En la figura 3 se muestra un diagrama secuencial UML con el flujo típico que realiza el contribuyente con los Servicios Web de 4G Factor para el timbrado de un CFD sin emplear token de sesión. Flujo de timbrado de CFDs con token de sesión El contribuyente puede firmar varios CFDs durante el proceso llamando al servicio createCFDI una y otra vez hasta terminar antes de llamar al servicio closeSession. DE C. Códigos de error Código Descripción 5100 Caracteres inválidos en campo username (fuera del rango UTF8) 5101 Caracteres inválidos en campo password (fuera del rango UTF8) 5102 Caracteres inválidos en campo token (fuera del rango UTF8) 5103 Caracteres inválidos en campo xml (fuera del rango UTF8) 5104 Caracteres inválidos en campo uuid (fuera del rango UTF8) 5105 ID de paquete de timbres inválido 5200 Error de autenticación. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.V.4G FACTOR.5 Creado en Creado por 14/08/14 HPC Apéndice A. la combinación username y password son inválidas 5201 Token de sesión inválido 5202 Sesión previamente cerrada 5203 Sesión expirada 5300 No más timbres disponibles 5400 RFC en CFD no autorizado para timbrar 5501 Certificado inválido 5502 Llave inválida 5503 El UUID está fuera del tiempo permitido para solicitar su cancelación 5504 La llave no corresponde al certificado 5505 El RFC del emisor del UUID no corresponde al RFC del certificado 200 UUID en proceso de cancelación 202 UUID previamente cancelado 203 UUID consultado no pertenece a contribuyente 205 UUID consultado desconocido 206 UUID no solicitado para cancelación 207 UUID en fecha inválida para cancelación (debe ser cancelado al menos 48 horas depués de su emisión) 208 UUID inválido 301 Error en la estructura del XML con respecto al ANEXO 20 de la Resolución Miscelánea Fiscal 2010 302 Sello mal formado o inválido 303 Sello de firma no corresponde a CSD del emisor 304 CSD del contribuyente vencido o inválido 305 La fecha de emisión no esta dentro de la vigencia del CSD del Emisor 306 El certificado no es de tipo CSD 307 El CFDI contiene un timbre previo 308 Certificado no expedido por el SAT 309 CFD duplicado 401 CFD fuera de fecha (emitido hace más de 72 horas) 402 RFC del emisor no se encuentra en el régimen de contribuyentes ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 27 de 29 . S.A.3. V. DE C.3. WSPAC – Servicios Web Para Timbrado de CFDs 403 La fecha de emisión no es posterior al 01 de enero 2012 404 La fecha de emisión está en el futuro 3001 Falta estado y municipio en la dirección donde se emite el comprobante 3002 Fata forma de pago 3003 Falta método de pago 3004 Falta subtotal del comprobante 3005 Falta total del comprobante 3006 Falta tipo de comprobante 3007 Falta nombre / RFC del emisor 3008 Falta calle en domicilio fiscal 3009 Falta código postal en domicilio fiscal 3010 Falta estado en domicilio fiscal 3011 Falta municipio en domicilio fiscal 3012 Falta país en domicilio fiscal 3013 Falta calle en dirección de expedición del comprobante 3014 Falta código postal en dirección de expedición del comprobante 3015 Falta estado en dirección de expedición del comprobante 3016 Falta municipio en dirección de expedición del comprobante 3017 Falta país en dirección de expedición del comprobante 3018 Falta régimen del emisor 3019 Falta nombre / RFC del receptor 3020 Falta calle en dirección del receptor 3021 Falta código postal en dirección del receptor 3022 Falta estado en dirección del receptor 3023 Falta municipio en dirección del receptor 3024 Falta país en dirección del receptor 3025 Falta descripción en un concepto 3026 Falta cantidad en un concepto 3027 Faltan unidades en un concepto 3028 Falta valor unitario en un concepto 3029 Falta importe en un concepto 3030 Falta nombre de retención / importe en una retención 3031 Falta nombre de impuesto / importe / tasa en un impuesto 3032 No hay certificado disponible para sellar el CFD 3033 No hay número de certificado disponible 3034 No hay llave disponible para sellar el CFD 3035 Error al sellar el CFD ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión ID Documento Revisión 4GF-PAC-WSPAC 2.5 Creado en Creado por 14/08/14 HPC 0 Clasificación de la Información 01/02/11 Pública Página 28 de 29 . S.4G FACTOR.A. V.A. En el caso del < se deberá usar la secuencia &lt. Juego de caracteres permitido Letras minúsculas: abcdefghijklmnopqrstuvwxyz Letras mayúsculas: ABCDEFGHIJKLMNOPQRSTUVWXYZ Números 0123456789 Caracteres especiales: !#$%()*+.4G FACTOR.-. WSPAC – Servicios Web Para Timbrado de CFDs ID Documento Revisión 4GF-PAC-WSPAC 2.=?@[ ]^_`{|}~¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆ ÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ\ Caracteres que deben ir escapados por requerimiento del SAT: ▪ ▪ ▪ ▪ ▪ En el caso del & se deberá usar la secuencia &amp. DE C. donde HHH es un número hexadecimal NOTAS: ID Formato Autorizado por 4GF-PAC-CFDI HPC Revisión Fecha de revisión 0 Clasificación de la Información 01/02/11 Pública Página 29 de 29 . En el caso del ' se deberá usar la secuencia &apos./0123456789:. En el caso del > se deberá usar la secuencia &gt. • • El caracter de espacio es obviamente permitido Los caracteres de tabulación. En el caso del " se deberá usar la secuencia &quot.5 Creado en Creado por 14/08/14 HPC Apéndice B.3. S. avance de línea u otros que el usuario requiera deberán escaparse con su secuencia HTML de acuerdo al formato &#nnn. donde nnn es un número decimal o al formato &#xHHH.