Sandbox & Escenarios de Prueba
El Sandbox reproduce respuestas SOAP y el ciclo asíncrono REST de las GRE sin conectarse a SUNAT ni consumir saldo de producción.
Para activar un comportamiento simulado, incluye la cabecera HTTP X-Sandbox-Scenario al emitir tu comprobante en sandbox:
X-Sandbox-Scenario: <nombre_del_escenario>Escenarios Soportados
default / accepted
Aceptación inmediata con CDR 0000.
accepted_with_warnings
Aceptación con observación y evento document.accepted_with_warnings.
rejected_2325
Rechazo por IGV inconsistente.
rejected_3279
Rechazo por tasa de IGV inválida.
rejected_4003 / duplicate
Documento duplicado ya registrado.
sunat_down
Indisponibilidad temporal y reintentos automáticos.
unauthorized_401
Credenciales rechazadas; en GRE ocurre antes de obtener ticket.
rate_limited_429
Límite temporal del servicio y backoff.
timeout_before_ticket
Timeout antes de confirmar la recepción GRE.
timeout_after_ticket
Timeout durante el polling de un ticket GRE existente.
processing_then_accepted
GRE permanece dos consultas en 98 y luego entrega CDR aceptado.
processing_then_rejected
GRE permanece dos consultas en 98 y luego entrega CDR rechazado.
cdr_missing
SUNAT informa procesamiento terminado pero todavía no adjunta CDR.
cdr_corrupt
Entrega un CDR ilegible para probar recuperación y alertas.
X-Sandbox-Scenario es de uso exclusivo para las API keys de Sandbox (entorno test). Peticiones de producción (Live) que incluyan esta cabecera serán rechazadas con un error 422 Unprocessable Entity para evitar emisiones erróneas accidentales. Los nombres desconocidos también se rechazan con 422; nunca se convierten silenciosamente en una aceptación.