RESSOURCE API

Encaissement & Finance

Facturation, encaissement idempotent, solde de compte courant, rapprochement de fin de journée et e-Fatura. Les montants sont conservés en numeric(14,2) ; le solde de compte courant est dérivé, jamais saisi manuellement.

Accès anticipé Toute l'API

Points d'accès

12 point d'accès

Points d'accès de cette ressource. Chaque point est limité aux données du cabinet auquel la clé API est rattachée ; les points d'écriture prennent en charge l'en-tête Idempotency-Key.

POST /v1/invoices Crée une facture admin · secrétaire · praticien

GET /v1/invoices Liste les factures admin

GET /v1/invoices/{id} Récupère le détail d'une facture Tous les rôles autorisés

POST /v1/invoices/{id}/void Annule la facture (écriture inverse) admin

POST /v1/invoices/{id}/einvoice Envoie la facture en tant qu'e-Fatura (GİB) admin

GET /v1/einvoices Liste les enregistrements e-Fatura admin

POST /v1/payments Enregistre un encaissement (idempotent) admin · secrétaire · praticien

GET /v1/patients/{id}/balance Récupère le solde de compte courant du patient Tous les rôles autorisés

GET /v1/patients/{id}/ledger Liste les mouvements de compte courant du patient Tous les rôles autorisés

GET /v1/cash/day Récupère le résumé de caisse de fin de journée admin · secrétaire

GET /v1/cari Liste les soldes de comptes courants admin · secrétaire

GET /v1/billing/summary Récupère le résumé financier/encaissements admin · secrétaire

Exemple d'usage

Enregistrer un encaissement (idempotent)

Requête

curl -X POST https://api.udentiva.com/v1/payments \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: pay-7c3f..." \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","amount":"1500.00","method":"card"}'

Réponse

HTTP/1.1 201 Created
{
  "id": "pmt-9001",
  "amount": "1500.00",
  "method": "card",
  "created_at": "2026-06-24T09:15:00Z"
}

# Aynı Idempotency-Key ile tekrar → aynı kayıt döner, ikinci tahsilat OLUŞMAZ.

Sécurité de cette ressource

La sécurité n'est pas une fonctionnalité, c'est l'architecture elle-même. Les garanties applicables à cette ressource :

Encaissement idempotent : grâce à l'Idempotency-Key + au verrou serveur, même en cas de retransmission réseau, le même paiement n'est pas enregistré deux fois (pas de double encaissement).

Les montants sont toujours en numeric(14,2) ; aucun calcul arithmétique n'est effectué sur le montant provenant du client, l'arrondi se fait en un seul point sur le serveur.

Annulation/remboursement = écriture inverse (void/refund) ; la ligne n'est pas supprimée physiquement. Le solde de compte courant est dérivé comme Σfacture − Σpaiement.

Une opération multi-entités (facture + poste + paiement) est atomique dans une seule transaction : tout ou rien.

Tout le modèle de sécurité →

Format d'erreur

Les erreurs sont renvoyées dans une enveloppe cohérente ; le code s'adresse à la machine, le message à l'utilisateur. Aucune erreur interne / trace de pile n'est jamais divulguée.

{
  "error": {
    "code": "validation_failed",
    "message": "Champ invalide : e-mail"
  }
}

Autres ressources

Patients Rendez-vous & Agenda Odontogramme & Traitement Stock Imagerie Laboratoire Lead & CRM Tourisme médical Reporting & BI Webhooks Transfert de Données (Export API)

Souhaitez-vous un accès anticipé ?

Soyez le premier informé dès l'ouverture de l'API.

Contacter