Entorno de pruebas
El entorno de pruebas sirve para probar una integración antes de usarla en producción. Nada de lo que se hace en él tiene validez:
- Cómo se crea: desde el apartado “Claves de API” de la sección “Configuración” de la aplicación web de producción, con el botón “Crear entorno de pruebas”. Hace falta un plan activo.
- Qué se copia: los datos de la empresa, sus series, clientes, proveedores y productos, y tu usuario (sin tu contraseña). Las facturas, los gastos y los ingresos no se copian: el entorno empieza sin documentos. Los identificadores (
id) de la empresa, los clientes, los proveedores y los productos son los mismos que en producción. - Claves de API: al crearlo se muestra una clave que empieza por
tuk_test_. Se puede volver a ver y copiar en cualquier momento, desde el mismo apartado de producción o desde “Claves de API” en la aplicación web del entorno de pruebas, donde también se pueden crear más. Solo sirve en el entorno de pruebas, y las claves de producción (tuk_) solo en producción, que se muestran una sola vez; si se usa una en el entorno equivocado, la respuesta es401con un mensaje que lo indica. Las claves de pruebas y las de producción son independientes: borrar una no afecta a la otra. - TicketBAI: se simula. Nada se envía a Hacienda: al emitir una factura se da por aceptada en el momento. Su PDF lleva un identificador
TBAI-PRUEBA-...y un QR que lo indican. Las validaciones de Tukonta antes de enviar son las mismas que en producción. - PDF: todas las facturas llevan la marca de agua «DOCUMENTO DE PRUEBA – SIN VALIDEZ FISCAL».
- Emails: solo llegan a los usuarios del entorno de pruebas, con «[PRUEBA]» delante del asunto. Al enviar una factura por email (
POST /invoices/:id/email) se envía a tu correo, no al del cliente. - Límites: 100 facturas al mes, 20 emails de facturas al día y 300 peticiones cada 5 minutos. Al superarlos, la respuesta es
429. - Entrar: el botón “Abrir entorno de pruebas” abre la aplicación web del entorno de pruebas con la sesión ya iniciada. Para entrar directamente en
https://sandbox.tukonta.com, ponte allí una contraseña con “¿Has olvidado tu contraseña?”: la de producción no se copia. - Reiniciar: el botón “Reiniciar” de la aplicación web de producción borra lo hecho en el entorno de pruebas y vuelve a copiar los datos de la empresa. Las claves de API siguen valiendo y el límite de facturas del mes no vuelve a empezar.
- Cuándo deja de funcionar: si la empresa deja de tener un plan activo en producción o tu usuario sale de ella, el entorno de pruebas deja de funcionar hasta que se recupere. Si no se usa en 90 días, se borra; se puede volver a crear.