Ligas a otros servicios
Notas sobre versiones
Las ligas tendrán terminación con número de versión del CFDI, normalmente se mantienen las ligas anteriores mientras estas se siguen ocupando durante periodos de transición y para minimizar las modificaciones en el código de la aplicación.
Ejemplos de ligas en el transcurso de los años.
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR33
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR40
Codificación
Todos los valores deben estar codificados en UTF8 y URL Encoding. En el caso del RFC podría tener RFCs con Ñ y & en ellos. Es importante que vayan correctamente codificados.
Si su libraría no soporte codificar y no sabe como hacerlo, deberá por lo menos reemplazar los siguientes valores de acuerdo a esta tabla:
& --> %26
Ñ --> %C3%91
AÑA202001NR45 -> A%C3%91A202001NR45
A&R020321l34 -> A%26R020321l34
Descargar xml del servidor EasySmart a su sistema después de facturar.
opción 1
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR40?rfc=AAA010101AAA&rfc2=YMM941123295&factura=A374775&cmd=download_xml
opción 2
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR40?rfc=AAA010101AAA&rfc2=YMM941123295&serie=A&folio=374775&cmd=download_xml
Una ves descargado el XML, puede salvarlo en su propio sistema, procesarlo o cualquier otra cosa que desee hacer con el.
En el paquete del distribuidor se incluye un ejecutable como ejemplo y el código de Visual Basic de como se codificó este desarrollo.
Revise que la descarga es un XML y no un mensaje de error, si el texto descargado no inicia con la etiqueta de xml, es un error, y puede desplegar la información.
Reimprimir Factura
Si necesita desplegar una factura para su reimpresión puede hacerlo llamando la liga siguiente con los parámetros correctos.
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR40?rfc=AAA010101AAA&rfc2=YMM941123295&factura=374775&cmd=print_xml
opción 2
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR40?rfc=AAA010101AAA&rfc2=YMM941123295&serie=A&folio=374775&cmd=print_xml
En el paquete del distribuidor se incluye un ejecutable como ejemplo y el código de Visual Basic de como se codificó este desarrollo.
Cancelar un CFDi
Si puede programar o agregar interfaces al sistema administrativo. Llame el url con los datos correspondientes en el ejemplo para cancelar una factura.
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR40?cmd=cancela_uuid&rfc_emisor=<rfc>&uuid=<UUID>&cuenta=<usuario>&passwd=<contraseña>&motivo=<motivo>&respuesta=TXT
- respuesta
- TXT regresa respuesta como texto (tanto errores como xml de cancelación)
- JSON regresa respuesta JSON, error o xml cancelación en campo message
- Otros valores son ignorados y por omisión regresa respuesta en formato HTML para errores o el xml
Códigos de error reportados
| Mensaje | Descripción |
|---|---|
| 201 | Solicitud de cancelación exitosa Se considera una solicitud de cancelación exitosa, sin embargo esto no asegura su cancelación |
| 202 | Folio Fiscal Previamente Cancelado Se considera solicitud de cancelación previamente enviada. Estatus Cancelado ante el SAT. |
| 203 | Folio Fiscal No Correspondiente al Emisor |
| 204 | Folio Fiscal No Aplicable a Cancelación |
| 205 | Folio Fiscal No Existente El SAT da una prorroga de 48 hrs para que el comprobante aparezca con estatus Vigente posterior al envió por parte del Proveedor de Certificación de CFDI. Puede que algunos comprobantes no aparezcan al momento, es necesario esperar por lo menos 48 hrs. |
| 206 | UUID no corresponde a un CFDI del Sector Primario |
| 207 | No se especificó el motivo de cancelación o el motivo no es valido El UUID sustitución no existe, está cancelado o tiene una fecha de emisión anterior a la fecha de emisión del comprobante original. |
| 208 | Folio Sustitución invalido |
| 209 | Folio Sustitución no requerido. |
| 210 | La fecha de solicitud de cancelación es mayor a la fecha de declaración |
| 211 | La fecha de solicitud de cancelación límite para factura global |
| 212 | Relación no valida o inexistente |
| 300 | Usuario No Válido |
| 301 | XML Mal Formado Este código de error se regresa cuando el request posee información invalida, ejemplo: un RFC de receptor no válido. |
| 302 | Sello Mal Formado |
| 304 | Certificado Revocado o Caduco El certificado puede ser inválido por múltiples razones como son el tipo, la vigencia, etc. |
| 305 | Certificado Inválido El certificado puede ser inválido por múltiples razones como son el tipo, la vigencia, etc. |
| 309 | Certificado Inválido El certificado puede ser inválido por múltiples razones como son el tipo, la vigencia, etc. |
| 310 | CSD Inválido |
| 311 | Motivo inválido Clave de motivo de cancelación no válida |
| 312 | UUID no relacionado UUID no relacionado de acuerdo a la clave de motivo de cancelación |
Saldo Folios
Si desea conocer el saldo que le queda en el servidor.
https://facturas.easysmart.com.mx/cgi-bin/externos/timbrarGR?cmd=saldo_folios&cuenta=CUENTA_USUARIO&passwd=CONTRASEÑA_USUARIO
Notas sobre el envío emails
El sistema envía una copia a la cuenta de correo que esté configurada en el portal del cliente. Y hasta 3 correos adicionales en el campo email de la factura. Emails adicionales a 3 son ignorados. El sistema valida que todas las cuentas no estén reportadas como inválidas.
Si una cuenta está reportada como incorrecta o inválida, la debe eliminar o reemplazar, el sistema no permitirá generar la factura mientras el campo de email contenga cuentas inválidas.
Obtener CBB
Si desea generar el CBB para descargar y crear su propio PDF
https://facturas.easysmart.com.mx/cgi-bin/externos/getCBB?cuenta=CUENTA_USUARIO&passwd=CONTRASEÑA_USUARIO&rfc_emisor=XXX&rfc_receptor=YYY&total=123&uuid=UUID-DE-LA-FACTURA
Continuar a: Facturar / Notas de crédito
Continuar a : Generar recibos de nómina
Continuar a : Documentos de Pago
Continuar a : Subir Archivo Batch para escuelas
Continuar a : Retenciones y Pagos