TimbrePrimeros pasos
De cero a tu primer documento aceptado en el sandbox.
El sandbox está abierto desde el primer minuto y no hace falta pedirlo. Producción la activás vos desde el panel, y el proyecto queda listo en cuanto termina de prepararse. Crearlo no presenta nada ante Hacienda: lo que habilita documentos reales son las credenciales de producción de cada contribuyente, que se cargan aparte. Está todo en Producción.
El camino contra el sandbox
Autenticate
Con la llave de tu proyecto de sandbox, en el encabezado
Authorization. Autenticación tiene el formato y qué pasa cuando falla.Configurá el contribuyente
Dado de alta a nombre de quien vas a emitir, con sus credenciales de sandbox cargadas. Configurar sandbox tiene el camino completo, de cero a listo para facturar.
Cotizá
Mandá la venta a Cotizar para ver los impuestos que calcula. No crea nada ni consume un consecutivo, así que repetilo las veces que necesités.
Emití
El mismo documento, ahora contra Emitir, con un
Idempotency-Key. Repetir la petición con la misma llave devuelve el documento que ya existe, no uno nuevo.Seguí el estado
Un documento no queda aceptado al instante. Estados lista los once que puede tomar hasta el veredicto de Hacienda.
Registrá el webhook
Para que Timbre te avise en vez de que vos preguntes. Webhooks tiene el formato y cómo verificar la firma.
Descargá los artefactos
XML firmado, respuesta de Hacienda, comprobante —todo queda en Artefactos, verificable por hash.
Cuando algo falla
Errores tiene el formato de la respuesta y la lista completa de códigos. Es el primer lugar a revisar antes de asumir que el problema es de Hacienda.
Cuando el sandbox ya funciona
Repetí el mismo camino en producción: otra llave, las credenciales de producción de ese contribuyente, mismo flujo. Configurar producción tiene los pasos, y Producción lo que cambia y lo que no se hereda del sandbox.