Entiende · Cómo funciona en 30 segundos
Así funciona, en 30 segundos.
3 conceptos clave · toca para ver
Credenciales · Llaves de prueba con un clic
Tus llaves de prueba. Ya son tuyas.
Sin registro. Son públicas y solo funcionan en pruebas.
Guárdalas en variables de entorno de tu servidor: es el mismo patrón que usarás en producción. El CSD de pruebas (.cer, .key y su contraseña) viene en el Demo PHP, en la carpeta CertificadoPruebas.
Primer timbre · Copia, pega y timbra
Elige tu lenguaje. Copia. Timbra.
Escenarios · Errores, cancelación y consultas
Respuestas que puedes recibir.
0 de 6 probadosEjemplos de lo que responde la API en cada caso, para que tu código los maneje antes de producción. Son respuestas de ejemplo; no se envía ninguna solicitud.
TestCfd33TestCfd33TestCfd33CancelTestEstatusCFDIConsultarAcuseCancelacionChecklist · Listo para producción
¿Listo para producción?
0 / 8Producción · Cambia una palabra y sale
Para producción cambias esto. Solo esto.
TestCfd33→GetTicketEn el SAC asignas tus folios. En el ATD consultas tus timbres.
Checklist
- Usuario y clave en variables de entorno, nunca en código
- Todas las llamadas salen de tu servidor, no del navegador
- CSD vigente (no la FIEL) para sellar
- Un 503 no se reintenta en automático: se corrige el XML
- Ante un error de red, consulta el estatus antes de reintentar para evitar duplicados
- Guardas `Cfdi` y el UUID de `Timbre` en tu base de datos
- Probaste cancelación con motivo 01 y 02
- Usas https en todas las llamadas
¿Algo no funciona? Lo resolvemos aquí.
¿Qué te está pasando?
La llamada no responde
¿Llegas al servicio?
No conecta / timeout
Revisa tu salida a internet y que la URL sea https://cfdi.realvirtual.com.mx/api/npm/. Si persiste, consulta avisos de mantenimiento.
Responde 500
Excepción del servicio. Consulta el estatus del CFDI antes de reintentar para no duplicar el timbrado.
Me responde 400 ERROR
Falta un parámetro o tiene otro tipo. Lee el campo `error` y revisa mayúsculas: `RFCEmisor` ≠ `RfcEmisor`.
Me responde 503 FAILED
¿Qué dice Descripcion?
Habla del sello o certificado
Probablemente sellaste con la FIEL o con un CSD vencido. Sella con tu CSD vigente.
Habla de credenciales
¿Usas credenciales de pruebas con GetTicket? En pruebas va TestCfd33; en producción, tus credenciales con GetTicket.
Otra cosa
Es un rechazo fiscal del XML. Corrige según Descripcion. Si no lo entiendes, envíanos el texto (nunca tu llave ni contraseñas).
No sé si se timbró
Consulta con EstatusCFDI usando RFC emisor, receptor, total y UUID antes de volver a enviar.
Nunca te pediremos contraseñas, llaves privadas ni certificados completos.
Demo C# y Demo PHP para tu equipo
Proyectos de ejemplo con su manual, y la DLL para .NET.
¿Atorado de verdad? Escríbenos.
Cuéntanos qué operación llamas y qué respuesta recibes; el equipo técnico te contesta.
Contactar al equipo técnico →