Ambientes

Hacienda tiene dos ambientes: pruebas (staging) y producción. Aster los expone como dos modos, y el modo lo decide la llave con la que llamás a la API.

	Prueba	Producción
Llave	aster_test_…	aster_live_…
Ambiente de Hacienda	Pruebas (staging), o veredicto simulado	Producción
environment en las respuestas	staging	production
Validez fiscal	Ninguna	Comprobante real
Costo	Gratis e ilimitado	Cuenta para el uso del plan
Requiere plan pagado	No	Sí
Certificado y credenciales	Opcionales (los de pruebas)	Obligatorios (los de producción)

La misma solicitud funciona en los dos modos sin cambios. Para pasar a producción solo cambiás la llave. Ver pasar a producción.

Modo de prueba

El modo de prueba funciona de dos formas, según si tu organización tiene certificado de pruebas.

Sandbox simulado

Si la organización no tiene certificado ni credenciales de pruebas, Aster valida el comprobante con las mismas reglas de producción, arma el XML, lo firma con un certificado de pruebas de la plataforma y devuelve un veredicto simulado, sin contactar a Hacienda. Así podés integrar en minutos, antes de tener un certificado.

El veredicto simulado es accepted. Para probar el manejo de rechazos, pedí uno con metadata.simulate:

{
  "document": { "document_type": "01" },
  "metadata": { "simulate": "rejected" }
}

El comprobante simulado recorre el mismo ciclo de vida y dispara los mismos webhooks que uno real.

Hacienda staging

Si la organización tiene certificado .p12 y credenciales de pruebas, los comprobantes de prueba van al ambiente de pruebas de Hacienda y el veredicto es el de Hacienda. Es la forma de comprobar tu integración contra el validador real antes de salir a producción.

Los certificados y credenciales de pruebas se generan en Hacienda por separado de los de producción. Se suben en el portal o con POST /organizations/me/certificate y "environment": "staging".

Modo de producción

Las llaves aster_live_ envían al ambiente de producción de Hacienda. Los comprobantes tienen validez fiscal y se entregan al receptor. Requieren:

• un plan pagado activo en la cuenta;
• el certificado .p12 de producción y su PIN, con la misma cédula que la organización;
• las credenciales de Hacienda de producción (atv_user y atv_password).

Qué es independiente en cada ambiente

• Certificados y credenciales. Cada organización tiene un juego para pruebas y otro para producción. GET /organizations/me/certificate muestra el estado de ambos.
• Consecutivos. Hacienda trata pruebas y producción como espacios de numeración separados, y Aster también: el contador de pruebas nunca gasta números de producción. Ver consecutivo.
• Comprobantes. Una llave de prueba no ve los comprobantes de producción y viceversa. Una nota de crédito de producción solo puede referenciar una factura de producción.

Qué cuenta para el uso

Solo cuentan los comprobantes de producción que recibieron un veredicto final de Hacienda (aceptado o rechazado):

Operación	Cuenta como
Comprobante de producción aceptado o rechazado por Hacienda	1
Mensaje Receptor de producción con veredicto final	0,5
Reintentos y reenvíos automáticos del mismo comprobante	0
Solicitudes que fallan la validación	0
Cualquier operación en modo de prueba	0

Las respuestas de producción incluyen el uso del mes en los encabezados X-Usage-Month-Count y X-Usage-Month-Limit. El portal te avisa por correo al llegar al 80 % y al 100 % del plan.

Cuando el uso del mes llega al límite del plan más los paquetes que hayas comprado, la API responde 402 quota_exceeded antes de firmar, así que el comprobante no se registra y el consecutivo no se gasta. Mejorá de plan o agregá un paquete en cualquier momento desde el portal; la facturación se reanuda en menos de un minuto. La respuesta trae los enlaces directos en error.upgrade_url y error.pack_url. Ver errores.