PlaxpInvoiceInicio
Solicitar acceso

Guía · Ambiente de pruebas

Credenciales de prueba de Hacienda (TRIBU-CR)

Antes de emitir en real conviene probar todo el flujo contra el ambiente de staging de Hacienda. Acá está qué credenciales necesitás, en qué se diferencia del ambiente de producción y cómo emitir de prueba sin generar comprobantes con validez fiscal.

¿Qué es el sandbox de Hacienda?

Hacienda expone dos ambientes independientes de recepción de comprobantes: staging (pruebas) y producción. Son servidores y credenciales distintos. Lo que emitís en staging sirve para validar tu integración de punta a punta —generación del XML, firma, envío, consulta de estado— pero no tiene validez fiscal.

ATV pasó a ser TRIBU-CR

Desde 2025 el portal de Hacienda migró de ATV a TRIBU-CR. El usuario y contraseña que usás para autenticar la emisión siguen siendo los de tu cuenta tributaria; en la documentación y el código todavía vas a ver referencias a "ATV" por compatibilidad.

¿Qué credenciales necesito?

Para emitir (en cualquier ambiente) hacen falta tres cosas del emisor:

  • Usuario y contraseña de TRIBU-CR — con los que Hacienda te autentica para recibir el comprobante.
  • Certificado .p12 — el certificado de firma digital (formato PKCS#12) que emite Hacienda para tu cédula.
  • PIN del .p12 — la llave criptográfica que desbloquea el certificado.

En Plaxp esos datos se guardan por emisor y los secretos (PIN y contraseña) quedan cifrados en reposo con AES-256. Cómo funciona la firma con ese certificado lo explicamos en .

¿Cómo obtengo las credenciales de prueba?

El certificado .p12 y el usuario de TRIBU-CR se tramitan ante Hacienda a nombre de tu cédula (física o jurídica). El mismo certificado sirve para staging y producción; lo que cambia es el ambiente contra el que emitís. Si estás integrando con Plaxp, te configuramos un emisor en modo sandbox para que pruebes sin tocar producción.

Un flag, no dos integraciones

En Plaxp el ambiente es un campo del emisor (sandbox o production). Tu código no cambia entre uno y otro: el mismo POST se enruta al servidor de Hacienda que corresponda. Pasás a producción cambiando el ambiente del emisor, no tu integración.

¿En qué se diferencia staging de producción?

Son endpoints y realms de autenticación distintos de Hacienda:

ambientes-hacienda
# STAGING (pruebas)
recepción:  https://api-sandbox.comprobanteselectronicos.go.cr/recepcion/v1/recepcion
auth (IDP): https://idp.comprobanteselectronicos.go.cr/auth/realms/rut-stag/...

# PRODUCCIÓN
recepción:  https://api.comprobanteselectronicos.go.cr/recepcion/v1/recepcion
auth (IDP): https://idp.comprobanteselectronicos.go.cr/auth/realms/rut/...

Plaxp selecciona automáticamente el par correcto según el ambiente del emisor. No tenés que manejar estas URLs en tu código.

¿Cómo paso a producción?

Cuando tu integración funciona en staging —el comprobante se firma, Hacienda lo acepta y el receptor recibe su correo con PDF y XML— pasás el emisor a production. A partir de ahí los comprobantes tienen validez fiscal y consumen consecutivos reales, así que conviene tener resuelto el manejo de rechazos: .

¿Querés un emisor de sandbox?

Te damos credenciales de sandbox y te acompañamos en la integración. Escribinos y arrancamos hoy.

Solicitar acceso a la API

Te acompañamos en la puesta en marcha · soporte rápido de gente real · fácil de usar para todo tu equipo. Somos gente ayudando gente.