Fichiers et PDF

Les fichiers d'une fiche

Un champ fichier ou image se lit comme un tableau de descripteurs :

{
  "id": "95de4c64c07d71b550d5e245bc17e998",
  "name": "kbis.pdf",
  "size": 1024,
  "contentType": "application/pdf",
  "downloadUrl": "https://acme.deltia.co/api/v1/crm/entities/societes/records/8f2…/files/95de4c64c07d71b550d5e245bc17e998",
  "expiresAt": null
}

• size et contentType valent null quand Deltia ne les connaît pas, ce qui arrive notamment pour les images.
• expiresAt est la date de renouvellement du document, quand le champ en porte une.
• id est stable : vous pouvez le conserver.

Seule la version en vigueur d'un fichier est exposée. Les versions précédentes et celles en attente de validation ne sont pas téléchargeables.

Télécharger un fichier

Appelez downloadUrl avec votre clé :

curl -L https://acme.deltia.co/api/v1/crm/entities/societes/records/8f2…/files/95de… \
  -H "Authorization: Bearer dlt_…" -o kbis.pdf

L'API répond 302 vers une adresse de téléchargement valable cinq minutes. Suivez la redirection (-L avec curl), mais ne conservez pas cette adresse : repassez par downloadUrl à chaque téléchargement. C'est ce qui garantit qu'une clé révoquée ne télécharge plus rien.

Le PDF d'une facture ou d'un devis

curl https://acme.deltia.co/api/v1/facture/invoices/<id>/pdf \
  -H "Authorization: Bearer dlt_…" -o facture.pdf

La réponse est le PDF lui-même (application/pdf), en pièce jointe nommée d'après le numéro du document. Même chose pour un devis avec /facture/quotes/<id>/pdf. Chaque document annonce cette adresse dans son champ pdfUrl.

Deux réponses propres aux PDF :

• 404 pdf-not-available : le document existe, mais aucun PDF n'a encore été produit — typiquement une facture pas encore transmise à la plateforme de facturation électronique ;
• 502 upstream-error : la plateforme de facturation électronique n'a pas répondu ; réessayez plus tard.