En Realvirtual, estamos comprometidos con facilitarle a los desarrolladores la implementación de soluciones para la facturación electrónica. Integrar el timbrado de CFDI con PHP o C# puede parecer una tarea compleja, especialmente cuando se requiere cumplir con los lineamientos del SAT. Nuestra plataforma se encarga de todo el proceso para que tú puedas timbrar CFDIs por JSON, XML o archivo, sin complicaciones.
Nosotros nos encargamos de: Estructura XML conforme al SAT, Cadena original y sello digital, Timbrado con PAC certificado, Verificación de validez fiscal, Generación de PDF personalizable, Codificación UTF-8 y caracteres especiales, y Actualizaciones automáticas del SAT. Con nuestro servicio, tú envías los datos y nosotros generamos XML, sellamos, timbramos y creamos el PDF.
Proceso de Integración Simplificado en 4 Pasos
La integración es sencilla, desde crear tu cuenta hasta timbrar tu primer CFDI:
-
Sube tus certificados CSD: Inicia sesión y sube tus Certificados de Sello Digital (.key y .cer) en Configuración → Certificados SAT. ⚠️ No confundir con e.firma (FIEL). Usa los del CSD.
-
Obtén tu API Key: En Configuración → Datos fiscales, al fondo encontrarás tu API Key. Cópiala en un lugar seguro.
Lea también: Guía para resolver el error XML mal formado al timbrar tu CFDI
-
Haz tu primera petición: Verifica tu conexión consultando tu saldo de créditos con un simple GET.
-
Comienza a timbrar tus CFDIs.
Beneficios y Especificaciones Técnicas
Nuestra infraestructura está diseñada para ofrecer el mejor rendimiento y seguridad.
Rendimiento y Fiabilidad
-
Latencia < 100ms: Ofrecemos timbrado de alta velocidad con infraestructura en AWS y Google Cloud, balanceadores de carga y fail-over automático entre múltiples PACs.
-
99.99% Uptime: Contamos con una infraestructura de alta disponibilidad con redundancia geográfica, monitoreo 24/7 y escalado automático.
Lea también: Soluciones efectivas para fallos en la generación de CFDI con Aspel SAE
Compatibilidad y Seguridad
-
Cualquier lenguaje: Nuestra API es REST + JSON compatible con PHP, Python, Java, C#, Node.js, Go, Ruby, Swift, Kotlin y cualquier lenguaje con HTTP.
-
Seguridad empresarial: Garantizamos encriptación TLS 1.2+, autenticación por API Key, auditoría de acceso y cumplimiento normativo completo.
-
Documentación completa: Ponemos a tu disposición guías paso a paso, ejemplos de cada tipo de CFDI, referencias técnicas y un ambiente sandbox gratuito con 10 timbres.
-
REST sobre HTTPS: Ofrecemos endpoints para timbrado, cancelación, consulta, descarga de PDF y XML. La autenticación se realiza por API Key en headers.
Tipos de CFDI y Complementos Soportados
No importa si timbras por JSON, XML Base64 o Multipart. Soportamos todos los tipos de CFDI y complementos vigentes, siempre actualizados a la última versión del SAT.
Lea también: Cómo Obtener tu Constancia SAT
Entre los complementos disponibles vía API se encuentran:
- Carta Porte 3.1 (Ingreso y Traslado)
- Complemento de Pagos 2.0 Rev. B
- BIEDU (Instituciones Educativas)
- Nómina 1.2 Rev.
- Y todos los demás complementos vigentes.
Preguntas Frecuentes sobre la API de Timbrado
Generación de XML y Sellos
¿Necesito generar el XML, sellos o cadenas originales? Depende de tu método de timbrado. Con el método JSON (el más popular), NO necesitas nada de eso: envías los datos y nosotros nos encargamos de todo. Si ya generas tu propio XML sellado, puedes enviarlo vía XML Base64 o XML Multipart y nosotros solo lo timbramos.
Costo y Consumo de Créditos
¿La API tiene costo adicional? No, la API de timbrado está incluida sin costo adicional en todos los paquetes de folios. Los 3 métodos de timbrado están disponibles. Solo consumes un timbre (crédito) por cada CFDI generado exitosamente.
Velocidad de Timbrado
¿Cuánto tarda en timbrar un CFDI? El tiempo promedio de timbrado es menor a 100 milisegundos. Nuestra infraestructura híbrida en AWS y Google Cloud con balanceadores de carga y múltiples PACs garantiza alta disponibilidad y velocidad.
Ambiente de Prueba Gratuito
¿Puedo probar la API sin costo? Sí, contamos con un ambiente sandbox completamente gratuito en sandbox-app.facturadigital.com.mx con 10 timbres de prueba. El sandbox replica exactamente el comportamiento del ambiente productivo, incluyendo los 3 métodos de timbrado.
Compatibilidad de Lenguajes
¿En qué lenguajes puedo integrar la API? Nuestra API es REST sobre HTTPS y se comunica con JSON, por lo que puedes integrarla con cualquier lenguaje de programación: PHP, Python, Java, C#, Node.js, Go, Ruby, Swift, Kotlin, y cualquier otro que soporte peticiones HTTP.
Migración desde Otros PACs
¿Puedo migrar desde otro PAC sin modificar mi código? Sí. Si ya generas tu XML sellado, puedes enviarlo tal cual mediante nuestros métodos XML Base64 o XML Multipart. Solo cambias la URL del endpoint y la autenticación, sin modificar tu generador de XML.
Herramientas Específicas para PHP y C#
Para facilitar aún más la integración, hemos desarrollado herramientas específicas. Nuestro Demo para PHP es un pequeño sistema de prueba que simula el flujo completo de timbrado CFDI. Ambos demos están completamente configurados para ejecutarse en el Ambiente de Pruebas del SAT, utilizando un RFC de pruebas. Los demos están configurados para funcionar con nuestro ambiente de pruebas utilizando un RFC destinado para ello.
Ambos demos tienen una función para consultar el estatus del CFDI directamente con el SAT, usando el folio fiscal y el RFC del emisor siempre y cuando el timbrado se haya realizado en ambiente productivo. Ya sea que trabajes en PHP o en C#, ahora tienes a tu disposición herramientas completas para integrar timbrado de manera rápida y segura.