Enviament de documents
Envia documents per correu, acredita la identitat del remitent i distingeix els errors d’identitat dels límits d’enviament.
Fes servir l’operació d’enviament del tipus de document que necessitis, amb el seu scope d’enviament i la capçalera d’idempotència declarada. Enviar, marcar com a enviat, descarregar un PDF i presentar a FACe són operacions diferents. Una petició acceptada per l’API no demostra que el destinatari hagi rebut el correu; consulta el registre de lliurament de correus.
curl -X POST "https://api.factuarea.com/v1/invoices/$INVOICE_ID/send" \
-H "Authorization: Bearer $FACTUAREA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: send-fac-2026-00042" \
--data '{
"to": "facturacion@acme.example"
}'Identitat del remitent
Quan s’aplica la comprovació d’identitat del remitent, una subscripció activa de Factuarea o una identificació censal acceptada n’acrediten la identitat. Introduir les dades d’una targeta no és la condició que consulta el servei. Una resposta censal absent o no disponible no acredita identitat; la subscripció activa continua sent una alternativa.
El rebuig fa servir 422 sender_identity_not_verified. Completa la verificació censal o activa la subscripció i després reintenta l’enviament previst. Aquesta guia descriu el comportament quan la comprovació està activa; l’aplicació depèn de la configuració del servei.
Empreses gestionades i mode test
En una empresa gestionada, la identitat del remitent es resol contra la seva gestoria. La gestoria ha de corregir la identitat rebutjada; no demanis a l’empresa gestionada que contracti una subscripció pròpia. Una empresa de sandbox continua subjecta a la supressió del mode test: els correus de documents no es lliuren a destinataris reals.
Gestiona els errors d’enviament
La identitat acreditada no elimina les quotes de correu ni la resta de pressupostos del compte. Un 429 requereix l’actuació i el temps de reintent indicats a la resposta de límits; els reintents immediats no ho resolen. Un error de validació requereix corregir-ne el camp. Conserva request_id quan investiguis una petició acceptada amb un lliurament inesperat. L’autosend_enabled de la botiga fa servir les mateixes garanties d’enviament.