Developers · Quickstart
De la primera crida a una factura en PDF.
Connecta la clau de proves, prepara les dades i recorre el cicle complet d’una factura. Cinc passos, set peticions i el mateix contracte que faràs servir en producció.
cURL o Node.js · API REST · Sandbox aïllat
Abans de la primera crida
Una clau. Un entorn de proves.
Crea un compte i obre Configuració → Desenvolupadors → Claus API. Tria una clau de test i desa’n el secret al servidor.
Crear la meva clau de provesaccount:readseries:readtaxes:readcontacts:writeinvoices:writeinvoices:sendpdfs:readfact_test_Tot comença al sandbox
La primera clau de test prepara una empresa aïllada. L’emissió fa servir la seva numeració; els correus i els enviaments a l’AEAT no surten a l’exterior.
https://api.factuarea.com/v1Prepara el terminal
Bash, cURL i uuidgen. Per a l’alternativa JavaScript, Node.js 20 o superior. Substitueix TU_CLAVE i executa aquesta preparació un cop al mateix terminal.
Conserva cada REQUEST_ID quan reintentis la mateixa operació amb el mateix cos. Per a una operació nova, genera’n un altre. No exposis mai la clau API al 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 recorregut complet
De la connexió al document.
Tria un pas i consulta’n la petició. Executa el codi al terminal; aquí pots explorar el recorregut sense enviar peticions.
Comprova la clau i el compte
La primera crida confirma a quina empresa pertany la clau i quins permisos té. No crea documents.
/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"Permís necessari
account:readRevisa data.company i data.api_key.scopes abans de continuar.
Les peticions d’aquesta guia es preparen amb la clau de test.
Si alguna cosa no encaixa
Llegeix l’error. Continua.
L’estat HTTP t’orienta; el codi i el missatge de la resposta indiquen què cal revisar.
Consultar errors i respostesinvalid_api_keyLa clau no autentica
Comprova el secret complet i la capçalera Authorization: Bearer. Si has perdut el secret, crea o rota la clau des del compte.
Verifica que FACTUAREA_API_KEY estigui exportada al terminal.
La integració, a partir d’aquí
La primera factura és el principi.
Dubtes
Abans de connectar l’aplicació
No. La clau de test es crea amb un compte normal, i l’empresa de proves s’aprovisiona en crear aquesta primera clau.
El teu negoci, més connectatLa factura de prova és a cinc passos
Crea el compte, treu una clau fact_test_ i segueix el flux. La factura es numera dins del sandbox i els seus efectes externs no en surten.