Centro de Integración

De cero a tu primer timbre.
Sin reuniones.

Tu integración0 de 6
Tu progreso se guarda en este navegador.
Entiende · Cómo funciona en 30 segundos
Paso 1 de 6

Así funciona, en 30 segundos.

Tu sistema arma el XMLCFDI 4.0
Lo sellas con tu CSDDe tu lado
Lo envías a Realvirtual1 llamada POST
Recibes CFDI + UUIDTimbrado por el SAT

3 conceptos clave · toca para ver

Credenciales · Llaves de prueba con un clic
Paso 2 de 6

Tus llaves de prueba. Ya son tuyas.

Sin registro. Son públicas y solo funcionan en pruebas.

Credenciales de pruebasSOLO PRUEBAS
RFCXIA190128J61
Usuariofgomez
Contraseña12121212
Descargar Demo PHP con CSD

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
Paso 3 de 6

Elige tu lenguaje. Copia. Timbra.

curl · TestCfd33
curl -X POST https://cfdi.realvirtual.com.mx/api/npm/TestCfd33 \
  -H "Content-Type: application/json" \
  -d "{\"strUserName\":\"$RV_USUARIO\",
       \"strPassword\":\"$RV_CLAVE\",
       \"base64Cfd\":\"$(base64 -w0 cfdi.xml)\"}"
El botón es una simulación. Para timbrar de verdad, pega el comando en tu terminal con las llaves de pruebas.
Escenarios · Errores, cancelación y consultas
Paso 4 de 6

Respuestas que puedes recibir.

0 de 6 probados

Ejemplos 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.

Timbrar correctamenteTestCfd33
Falta un parámetroTestCfd33
Rechazo del PACTestCfd33
Cancelar en 2 pasosCancelTest
Consultar estatusEstatusCFDI
Recuperar acuseConsultarAcuseCancelacion
Checklist · Listo para producción
Paso 5 de 6

¿Listo para producción?

0 / 8
Producción · Cambia una palabra y sale
Paso 6 de 6

Para producción cambias esto. Solo esto.

OperaciónTestCfd33→GetTicket
CredencialesLas de pruebas→Tu usuario y clave
CSDCSD de pruebas→Tu CSD vigente
URLLa misma=La misma
Después de activar, usa tus paneles

En 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.

Demos y manuales

Demo C# y Demo PHP para tu equipo

Proyectos de ejemplo con su manual, y la DLL para .NET.

Respaldo

¿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 →
Realvirtual
Centro de Integración
De cero a tu primer timbre.
Sin reuniones.
Tu integración0 de 6
Tu progreso se guarda en este navegador.
Entiende · Cómo funciona en 30 segundos
Paso 1 de 6

Así funciona, en 30 segundos.

Tu sistema arma el XMLCFDI 4.0
Lo sellas con tu CSDDe tu lado
Lo envías a Realvirtual1 llamada POST
Recibes CFDI + UUIDTimbrado por el SAT

3 conceptos clave · toca para ver

Credenciales · Llaves de prueba con un clic
Paso 2 de 6

Tus llaves de prueba. Ya son tuyas.

Sin registro. Son públicas y solo funcionan en pruebas.

Credenciales de pruebasSOLO PRUEBAS
RFCXIA190128J61
Usuariofgomez
Contraseña12121212
Descargar Demo PHP con CSD

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
Paso 3 de 6

Elige tu lenguaje. Copia. Timbra.

curl · TestCfd33
curl -X POST https://cfdi.realvirtual.com.mx/api/npm/TestCfd33 \
  -H "Content-Type: application/json" \
  -d "{\"strUserName\":\"$RV_USUARIO\",
       \"strPassword\":\"$RV_CLAVE\",
       \"base64Cfd\":\"$(base64 -w0 cfdi.xml)\"}"
El botón es una simulación. Para timbrar de verdad, pega el comando en tu terminal con las llaves de pruebas.
Escenarios · Errores, cancelación y consultas
Paso 4 de 6

Respuestas que puedes recibir.

0 de 6 probados

Ejemplos 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.

Timbrar correctamenteTestCfd33
Falta un parámetroTestCfd33
Rechazo del PACTestCfd33
Cancelar en 2 pasosCancelTest
Consultar estatusEstatusCFDI
Recuperar acuseConsultarAcuseCancelacion
Checklist · Listo para producción
Paso 5 de 6

¿Listo para producción?

0 / 8
Producción · Cambia una palabra y sale
Paso 6 de 6

Para producción cambias esto. Solo esto.

OperaciónTestCfd33→GetTicket
CredencialesLas de pruebas→Tu usuario y clave
CSDCSD de pruebas→Tu CSD vigente
URLLa misma=La misma
Después de activar, usa tus paneles

En 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.

Demos y manuales

Demo C# y Demo PHP para tu equipo

Proyectos de ejemplo con su manual, y la DLL para .NET.

Respaldo

¿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 →