Developers · Quickstart
De tu primera llamada a una factura en PDF.
Conecta tu clave de pruebas, prepara los datos y recorre el ciclo completo de una factura. Cinco pasos, siete peticiones y el mismo contrato que usarás en producción.
cURL o Node.js · API REST · Sandbox aislado
Antes de la primera llamada
Una clave. Un entorno de pruebas.
Crea una cuenta y abre Ajustes → Desarrolladores → Claves API. Elige una clave de test y guarda su secreto en el servidor.
Crear mi clave de pruebasaccount:readseries:readtaxes:readcontacts:writeinvoices:writeinvoices:sendpdfs:readfact_test_Todo empieza en el sandbox
La primera clave de test prepara una empresa aislada. La emisión usa su propia numeración; los correos y los envíos a la AEAT no salen al exterior.
https://api.factuarea.com/v1Prepara tu terminal
Bash, cURL y uuidgen. Para la alternativa JavaScript, Node.js 20 o superior. Sustituye TU_CLAVE y ejecuta esta preparación una vez en la misma terminal.
Conserva cada REQUEST_ID al reintentar la misma operación con el mismo cuerpo. Para una operación nueva, genera otro. Nunca expongas la clave API en el navegador.
export FACTUAREA_API_KEY="fact_test_TU_CLAVE"
export CONTACT_REQUEST_ID="$(uuidgen)"
export INVOICE_REQUEST_ID="$(uuidgen)"
export SEND_REQUEST_ID="$(uuidgen)"El recorrido completo
De la conexión al documento.
Elige un paso y consulta su petición. Ejecuta el código en tu terminal; aquí puedes explorar el recorrido sin enviar peticiones.
Comprueba tu clave y tu cuenta
La primera llamada confirma a qué empresa pertenece la clave y qué permisos tiene. No crea documentos.
/account: "${FACTUAREA_API_KEY:?FACTUAREA_API_KEY}"curl --fail-with-body --silent --show-error \ --request GET \ "https://api.factuarea.com/v1/account" \ --header "Authorization: Bearer $FACTUAREA_API_KEY""company" "plan" "api_key"Permiso requerido
account:readRevisa data.company y data.api_key.scopes antes de continuar.
Las peticiones de esta guía se preparan con tu clave de test.
Si algo no encaja
Lee el error. Sigue adelante.
El estado HTTP te orienta; el código y el mensaje de la respuesta indican qué debes revisar.
Consultar errores y respuestasinvalid_api_keyLa clave no autentica
Comprueba el secreto completo y la cabecera Authorization: Bearer. Si has perdido el secreto, crea o rota la clave desde tu cuenta.
Verifica que FACTUAREA_API_KEY esté exportada en la terminal.
Tu integración, a partir de aquí
La primera factura es el principio.
Dudas
Antes de conectar tu aplicación
No. La clave de test se crea con una cuenta normal, y la empresa de pruebas se aprovisiona al crear esa primera clave.
Tu negocio, mejor conectadoLa factura de prueba está a cinco pasos
Crea la cuenta, saca una clave fact_test_ y sigue el flujo. La factura se numera dentro del sandbox y sus efectos externos no salen de él.