Introduction
L’API U-Santé est une API REST sécurisée permettant aux centres de santé
d’enregistrer leurs données médicales et aux patients d’y accéder via nos applications mobiles.
API REST sécurisée – Format JSON – Authentification via Bearer Token
Connexion au Backoffice Client
Cette URL correspond à une page web sécurisée permettant
au centre de santé d'accéder à son tableau de bord.
🧪 Test
https://test.usante.unitechnology.pro/client/login
🚀 Production
https://api.usante.unitechnology.pro/client/login
Cette page n'est PAS une API REST.
Elle permet d'accéder aux statistiques et à la gestion du compte.
- 📊 Voir les statistiques
- 👤 Modifier ses informations personnelles
- 🏥 Modifier les informations du centre
- 🔑 Consulter la clé API
- 📁 Gérer les patients
Environnements API REST
🧪 Test
https://test.usante.unitechnology.pro/v1/clients
🚀 Production
https://api.usante.unitechnology.pro/v1/clients
Toujours tester en environnement TEST avant de passer en production.
Créer un Patient
Cet endpoint permet d’enregistrer un patient dans votre centre de santé.
Chaque patient est automatiquement rattaché à la société associée à votre API Key.
⚠️ Le numero_patient doit être unique pour chaque patient.
POST
/patients
https://api.usante.unitechnology.pro/v1/clients/patients
https://test.usante.unitechnology.pro/v1/clients/patients
Headers
Authorization: Bearer VOTRE_API_KEY
Content-Type: application/json
Accept: application/json
Body JSON
{
"patientData": {
"numero_patient": "PAT-00125",
"id": "INT-4587",
"nom": "KOUADIO",
"prenoms": "Jean Michel",
"date_naissance": "1990-05-12",
"lieu_naissance": "Abidjan",
"telephone": "+2250700000000",
"email": "jean@email.com",
"sexe": "1",
"nationalite": "Ivoirienne",
"ethnie": "Baoulé",
"lieu_habitation": "Cocody",
"numero_cmu": "CMU-548965",
"numero_piece": "CNI-45879632",
"genre": "Adulte",
"groupe_sanguin": "O+",
"nom_prenoms_pere": "KOUADIO Paul",
"date_naissance_pere": "1965-08-15",
"lieu_naissance_pere": "Bouaké",
"telephone_pere": "+2250100000000",
"nationalite_pere": "Ivoirienne",
"ethnie_pere": "Baoulé",
"lieu_habitation_pere": "Yamoussoukro",
"nom_prenoms_mere": "AMOIN Marie",
"date_naissance_mere": "1970-03-10",
"lieu_naissance_mere": "Daloa",
"telephone_mere": "+2250500000000",
"nationalite_mere": "Ivoirienne",
"ethnie_mere": "Bété",
"lieu_habitation_mere": "Abobo"
}
}
Description complète des Champs
| Champ |
Type |
Obligatoire |
Description |
| numero_patient |
string (100) |
Oui |
Identifiant unique du patient |
| id |
string (30) |
Oui |
Identifiant interne |
| nom |
string (255) |
Oui |
Nom du patient |
| prenoms |
string (255) |
Oui |
Prénoms du patient |
| date_naissance |
date (YYYY-MM-DD) |
Oui |
Date de naissance |
| lieu_naissance |
string |
Oui |
Lieu de naissance |
| telephone |
string (30) |
Non |
Téléphone du patient |
| email |
email |
Non |
Adresse email valide |
| sexe |
0 ou 1 |
Oui |
0 = Masculin, 1 = Féminin |
| nationalite |
string |
Non |
Nationalité du patient |
| ethnie |
string |
Non |
Ethnie du patient |
| lieu_habitation |
string |
Non |
Adresse du patient |
| numero_cmu |
string |
Non |
Numéro CMU |
| numero_piece |
string |
Non |
Numéro pièce d’identité |
| genre |
string |
Non |
Catégorie patient (auto-créée si inexistante) |
| groupe_sanguin |
string |
Non |
Groupe sanguin (auto-créé si inexistant) |
| nom_prenoms_pere |
string |
Non |
Nom et prénoms du père |
| date_naissance_pere |
date |
Non |
Date de naissance du père |
| lieu_naissance_pere |
string |
Non |
Lieu de naissance du père |
| telephone_pere |
string |
Non |
Téléphone du père |
| nationalite_pere |
string |
Non |
Nationalité du père |
| ethnie_pere |
string |
Non |
Ethnie du père |
| lieu_habitation_pere |
string |
Non |
Adresse du père |
| nom_prenoms_mere |
string |
Non |
Nom et prénoms de la mère |
| date_naissance_mere |
date |
Non |
Date de naissance de la mère |
| lieu_naissance_mere |
string |
Non |
Lieu de naissance de la mère |
| telephone_mere |
string |
Non |
Téléphone de la mère |
| nationalite_mere |
string |
Non |
Nationalité de la mère |
| ethnie_mere |
string |
Non |
Ethnie de la mère |
| lieu_habitation_mere |
string |
Non |
Adresse de la mère |
Réponse Succès (201)
{
"success": true,
"message": "Patient enregistré avec succès",
"data": {
"id": "INT-4587",
"numero_patient": "PAT-00125"
}
}
Patient déjà existant (409)
{
"success": false,
"message": "Ce patient est déjà enregistré"
}
Erreur de validation (422)
{
"success": false,
"message": "Erreur de validation",
"errors": {
"patientData.nom": [
"Le nom du patient est obligatoire."
]
}
}
Mettre à jour un Patient
Cet endpoint permet de mettre à jour les informations d’un patient existant.
Il faut fournir le numero_patient dans l’URL.
Seuls les champs présents dans le body seront mis à jour ; les autres resteront inchangés.
PUT
/patients/code/{patientCode}
https://api.usante.unitechnology.pro/v1/clients/patients/code/PAT-00125
Headers
Authorization: Bearer VOTRE_API_KEY
Content-Type: application/json
Accept: application/json
Body JSON
{
"patientData": {
"id": "INT-4587",
"nom": "KOUADIO",
"prenoms": "Jean Michel",
"date_naissance": "1990-05-12",
"lieu_naissance": "Abidjan",
"telephone": "+2250700000000",
"email": "jean@email.com",
"sexe": "1",
"nationalite": "Ivoirienne",
"ethnie": "Baoulé",
"lieu_habitation": "Cocody",
"numero_cmu": "CMU-548965",
"numero_piece": "CNI-45879632",
"genre": "Adulte",
"groupe_sanguin": "O+",
"nom_prenoms_pere": "KOUADIO Paul",
"date_naissance_pere": "1965-08-15",
"lieu_naissance_pere": "Bouaké",
"telephone_pere": "+2250100000000",
"nationalite_pere": "Ivoirienne",
"ethnie_pere": "Baoulé",
"lieu_habitation_pere": "Yamoussoukro",
"nom_prenoms_mere": "AMOIN Marie",
"date_naissance_mere": "1970-03-10",
"lieu_naissance_mere": "Daloa",
"telephone_mere": "+2250500000000",
"nationalite_mere": "Ivoirienne",
"ethnie_mere": "Bété",
"lieu_habitation_mere": "Abobo"
}
}
Description complète des Champs
| Champ |
Type |
Obligatoire |
Description |
| id |
string (30) |
Non |
Identifiant interne du patient |
| nom |
string (255) |
Non |
Nom du patient |
| prenoms |
string (255) |
Non |
Prénoms du patient |
| date_naissance |
date |
Non |
Date de naissance |
| lieu_naissance |
string |
Non |
Lieu de naissance |
| telephone |
string (30) |
Non |
Téléphone du patient |
| email |
email |
Non |
Adresse email |
| sexe |
0 ou 1 |
Non |
0 = Féminin, 1 = Masculin |
| nationalite |
string |
Non |
Nationalité du patient |
| ethnie |
string |
Non |
Ethnie du patient |
| lieu_habitation |
string |
Non |
Adresse du patient |
| numero_cmu |
string |
Non |
Numéro CMU |
| numero_piece |
string |
Non |
Numéro pièce d’identité |
| genre |
string |
Non |
Catégorie du patient (ex : Adulte) |
| groupe_sanguin |
string |
Non |
Groupe sanguin |
| nom_prenoms_pere |
string |
Non |
Nom et prénoms du père |
| date_naissance_pere |
date |
Non |
Date de naissance du père |
| lieu_naissance_pere |
string |
Non |
Lieu de naissance du père |
| telephone_pere |
string |
Non |
Téléphone du père |
| nationalite_pere |
string |
Non |
Nationalité du père |
| ethnie_pere |
string |
Non |
Ethnie du père |
| lieu_habitation_pere |
string |
Non |
Adresse du père |
| nom_prenoms_mere |
string |
Non |
Nom et prénoms de la mère |
| date_naissance_mere |
date |
Non |
Date de naissance de la mère |
| lieu_naissance_mere |
string |
Non |
Lieu de naissance de la mère |
| telephone_mere |
string |
Non |
Téléphone de la mère |
| nationalite_mere |
string |
Non |
Nationalité de la mère |
| ethnie_mere |
string |
Non |
Ethnie de la mère |
| lieu_habitation_mere |
string |
Non |
Adresse de la mère |
Réponse Succès (200)
{
"success": true,
"message": "Patient mis à jour avec succès",
"data": {
"id": "INT-4587",
"numero_patient": "PAT-00125"
}
}
Patient non trouvé (404)
{
"success": false,
"message": "Patient introuvable"
}
Erreur de validation (422)
{
"success": false,
"message": "Erreur de validation",
"errors": {
"patientData.nom": [
"Le nom du patient doit être une chaîne de caractères."
]
}
}
Lister les Patients
Cet endpoint permet de récupérer la liste des patients d'un client API.
La liste est paginée et peut être filtrée par numero_patient ou
nom.
GET
/patients
https://api.usante.unitechnology.pro/v1/clients/patients?per_page=20&nom=Jean
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres de requête (Query Params)
| Paramètre |
Type |
Obligatoire |
Description |
| per_page |
integer |
Non |
Nombre de patients par page (max 100, défaut 20) |
| numero_patient |
string |
Non |
Filtrer par numéro du patient exact |
| nom |
string |
Non |
Filtrer par nom du patient (recherche partielle) |
Réponse Succès (200)
{
"success": true,
"message": "Liste des patients",
"data": [
{
"id": "INT-4587",
"numero_patient": "PAT-00125",
"nom": "KOUADIO",
"prenoms": "Jean Michel",
"date_naissance": "1990-05-12",
"lieu_naissance": "Abidjan",
"telephone": "+2250700000000",
"email": "jean@email.com",
"sexe": "1",
"nationalite": "Ivoirienne",
"ethnie": "Baoulé",
"lieu_habitation": "Cocody",
"numero_cmu": "CMU-548965",
"numero_piece": "CNI-45879632",
"genre": "Adulte",
"groupe_sanguin": "O+"
},
{
"id": "INT-4588",
"numero_patient": "PAT-00126",
"nom": "DIOP",
"prenoms": "Fatou",
"date_naissance": "1985-11-25",
"lieu_naissance": "Bouaké",
"telephone": "+2250701111111",
"email": "fatou@email.com",
"sexe": "0",
"nationalite": "Ivoirienne",
"ethnie": "Bété",
"lieu_habitation": "Marcory",
"numero_cmu": "CMU-548966",
"numero_piece": "CNI-45879633",
"genre": "Adulte",
"groupe_sanguin": "A+"
}
],
"meta": {
"current_page": 1,
"last_page": 5,
"per_page": 20,
"total": 100
}
}
Afficher les informations d'un Patient
Cet endpoint permet de récupérer les informations détaillées d'un patient spécifique
en utilisant son numero_patient.
GET
/patients/code/{patientCode}
https://api.usante.unitechnology.pro/v1/clients/patients/code/PAT-00125
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres d'URL
| Paramètre |
Type |
Obligatoire |
Description |
| patientCode |
string |
Oui |
Le numéro du patient à afficher |
Réponse Succès (200)
{
"success": true,
"message": "Détails du patient",
"data": {
"id": "INT-4587",
"numero_patient": "PAT-00125",
"nom": "KOUADIO",
"prenoms": "Jean Michel",
"date_naissance": "1990-05-12",
"lieu_naissance": "Abidjan",
"telephone": "+2250700000000",
"email": "jean@email.com",
"sexe": "1",
"nationalite": "Ivoirienne",
"ethnie": "Baoulé",
"lieu_habitation": "Cocody",
"numero_cmu": "CMU-548965",
"numero_piece": "CNI-45879632",
"genre": "Adulte",
"groupe_sanguin": "O+",
"nom_prenoms_pere": "KOUADIO Paul",
"date_naissance_pere": "1965-03-10",
"lieu_naissance_pere": "Bouaké",
"telephone_pere": "+2250701111111",
"nationalite_pere": "Ivoirienne",
"ethnie_pere": "Baoulé",
"lieu_habitation_pere": "Abobo",
"nom_prenoms_mere": "KOUADIO Awa",
"date_naissance_mere": "1967-08-22",
"lieu_naissance_mere": "Yamoussoukro",
"telephone_mere": "+2250702222222",
"nationalite_mere": "Ivoirienne",
"ethnie_mere": "Baoulé",
"lieu_habitation_mere": "Cocody"
}
}
Créer un Reçu de Caisse pour un Patient
Cet endpoint permet d'enregistrer un reçu de caisse pour un patient spécifique,
avec les détails des services et actes associés.
POST
/patients/{patientCode}/receipts
https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts
Headers
Authorization: Bearer VOTRE_API_KEY
Content-Type: application/json
Accept: application/json
Paramètres d'URL
| Paramètre |
Type |
Obligatoire |
Description |
| patientCode |
string |
Oui |
Le numéro du patient pour lequel le reçu sera créé |
Body JSON
{
"recuData": {
"id": "REC-2026-001",
"numero_recu": "CAISSE-4587",
"date_recu": "2026-02-16",
"montant_total": 150000,
"net_a_payer": 150000,
"servicesData": [
{
"id": "SVC-001",
"code_service": "CONSULT-01",
"nom_service": "Consultation générale",
"nom_responsable": "Dr. Koffi",
"telephone_responsable": "+2250700000001",
"service": true,
"urgence": false,
"pharmacie": false,
"chirugie": false,
"imagerie": false,
"biologie": false,
"gratuit_enfant": false,
"gratuit_femme_enceinte": false,
"actesData": [
{
"id": "ACT-001",
"code_acte": "ACT-CONS-01",
"nom_acte": "Consultation adulte",
"montant_acte": 150000,
"montant_payer_patient": 150000,
"net_a_payer_patient": 150000,
"quantite_acte": 1,
"certificat": false,
"gratuit_enfant": false,
"gratuit_femme_enceinte": false
}
]
}
]
}
}
Tableau des champs
| Champ |
Type |
Obligatoire |
Description |
| recuData.id |
string |
Oui |
Identifiant unique du reçu |
| recuData.numero_recu |
string |
Oui |
Numéro du reçu de caisse |
| recuData.date_recu |
date |
Oui |
Date du reçu |
| recuData.montant_total |
numeric |
Oui |
Montant total du reçu |
| recuData.net_a_payer |
numeric |
Oui |
Montant net à payer par le patient |
| recuData.servicesData.*.id |
string |
Oui |
Identifiant unique du service |
| recuData.servicesData.*.code_service |
string |
Oui |
Code du service |
| recuData.servicesData.*.nom_service |
string |
Oui |
Nom du service |
| recuData.servicesData.*.nom_responsable |
string |
Non |
Nom du responsable du service |
| recuData.servicesData.*.telephone_responsable |
string |
Non |
Téléphone du responsable du service |
| recuData.servicesData.*.service |
boolean |
Oui |
Indique si c'est un service |
| recuData.servicesData.*.urgence |
boolean |
Oui |
Indique si le service est en urgence |
| recuData.servicesData.*.pharmacie |
boolean |
Oui |
Indique si le service implique la pharmacie |
| recuData.servicesData.*.chirugie |
boolean |
Oui |
Indique si le service est chirurgical |
| recuData.servicesData.*.imagerie |
boolean |
Oui |
Indique si le service inclut de l'imagerie |
| recuData.servicesData.*.biologie |
boolean |
Oui |
Indique si le service inclut de la biologie |
| recuData.servicesData.*.gratuit_enfant |
boolean |
Oui |
Indique si le service est gratuit pour les enfants |
| recuData.servicesData.*.gratuit_femme_enceinte |
boolean |
Oui |
Indique si le service est gratuit pour les femmes enceintes |
| recuData.servicesData.*.actesData.*.id |
string |
Oui |
Identifiant de l'acte |
| recuData.servicesData.*.actesData.*.code_acte |
string |
Oui |
Code de l'acte |
| recuData.servicesData.*.actesData.*.nom_acte |
string |
Oui |
Nom de l'acte |
| recuData.servicesData.*.actesData.*.montant_acte |
numeric |
Oui |
Montant de l'acte |
| recuData.servicesData.*.actesData.*.montant_payer_patient |
numeric |
Oui |
Montant payé par le patient pour cet acte |
| recuData.servicesData.*.actesData.*.net_a_payer_patient |
numeric |
Oui |
Montant net à payer par le patient |
| recuData.servicesData.*.actesData.*.quantite_acte |
numeric |
Oui |
Quantité de l'acte réalisé |
| recuData.servicesData.*.actesData.*.certificat |
boolean |
Oui |
Indique si un certificat est requis |
| recuData.servicesData.*.actesData.*.gratuit_enfant |
boolean |
Oui |
Indique si l'acte est gratuit pour les enfants |
| recuData.servicesData.*.actesData.*.gratuit_femme_enceinte |
boolean |
Oui |
Indique si l'acte est gratuit pour les femmes enceintes |
Réponse Succès (201)
{
"success": true,
"message": "Reçu de caisse enregistré avec succès.",
"data": {
"id": "REC-2026-001",
"numero_patient": "PAT-00125"
}
}
Mettre à Jour un Reçu de Caisse pour un Patient
Cet endpoint permet de mettre à jour un reçu de caisse existant pour un patient,
en remplaçant tous les services et actes associés.
PUT
/patients/{patientCode}/receipts/{receiptId}
https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts/REC-2026-001
Headers
Authorization: Bearer VOTRE_API_KEY
Content-Type: application/json
Accept: application/json
Paramètres d'URL
| Paramètre |
Type |
Obligatoire |
Description |
| patientCode |
string |
Oui |
Numéro du patient dont le reçu sera mis à jour |
| receiptId |
string |
Oui |
Identifiant du reçu à mettre à jour |
Body JSON
{
"recuData": {
"id": "REC-2026-001",
"numero_recu": "CAISSE-4587",
"date_recu": "2026-02-16",
"montant_total": 150000,
"net_a_payer": 150000,
"servicesData": [
{
"id": "SVC-001",
"code_service": "CONSULT-01",
"nom_service": "Consultation générale",
"nom_responsable": "Dr. Koffi",
"telephone_responsable": "+2250700000001",
"service": true,
"urgence": false,
"pharmacie": false,
"chirugie": false,
"imagerie": false,
"biologie": false,
"gratuit_enfant": false,
"gratuit_femme_enceinte": false,
"actesData": [
{
"id": "ACT-001",
"code_acte": "ACT-CONS-01",
"nom_acte": "Consultation adulte",
"montant_acte": 150000,
"montant_payer_patient": 150000,
"net_a_payer_patient": 150000,
"quantite_acte": 1,
"certificat": false,
"gratuit_enfant": false,
"gratuit_femme_enceinte": false
}
]
}
]
}
}
Tableau des champs
| Champ |
Type |
Obligatoire |
Description |
| recuData.id |
string |
Oui |
Identifiant unique du reçu |
| recuData.numero_recu |
string |
Oui |
Numéro du reçu de caisse |
| recuData.date_recu |
date |
Oui |
Date du reçu |
| recuData.montant_total |
numeric |
Oui |
Montant total du reçu |
| recuData.net_a_payer |
numeric |
Oui |
Montant net à payer par le patient |
| recuData.servicesData.*.id |
string |
Oui |
Identifiant unique du service |
| recuData.servicesData.*.code_service |
string |
Oui |
Code du service |
| recuData.servicesData.*.nom_service |
string |
Oui |
Nom du service |
| recuData.servicesData.*.nom_responsable |
string |
Non |
Nom du responsable du service |
| recuData.servicesData.*.telephone_responsable |
string |
Non |
Téléphone du responsable du service |
| recuData.servicesData.*.service |
boolean |
Oui |
Indique si c'est un service |
| recuData.servicesData.*.urgence |
boolean |
Oui |
Indique si le service est en urgence |
| recuData.servicesData.*.pharmacie |
boolean |
Oui |
Indique si le service implique la pharmacie |
| recuData.servicesData.*.chirugie |
boolean |
Oui |
Indique si le service est chirurgical |
| recuData.servicesData.*.imagerie |
boolean |
Oui |
Indique si le service inclut de l'imagerie |
| recuData.servicesData.*.biologie |
boolean |
Oui |
Indique si le service inclut de la biologie |
| recuData.servicesData.*.gratuit_enfant |
boolean |
Oui |
Indique si le service est gratuit pour les enfants |
| recuData.servicesData.*.gratuit_femme_enceinte |
boolean |
Oui |
Indique si le service est gratuit pour les femmes enceintes |
| recuData.servicesData.*.actesData.*.id |
string |
Oui |
Identifiant de l'acte |
| recuData.servicesData.*.actesData.*.code_acte |
string |
Oui |
Code de l'acte |
| recuData.servicesData.*.actesData.*.nom_acte |
string |
Oui |
Nom de l'acte |
| recuData.servicesData.*.actesData.*.montant_acte |
numeric |
Oui |
Montant de l'acte |
| recuData.servicesData.*.actesData.*.montant_payer_patient |
numeric |
Oui |
Montant payé par le patient pour cet acte |
| recuData.servicesData.*.actesData.*.net_a_payer_patient |
numeric |
Oui |
Montant net à payer par le patient |
| recuData.servicesData.*.actesData.*.quantite_acte |
numeric |
Oui |
Quantité de l'acte réalisé |
| recuData.servicesData.*.actesData.*.certificat |
boolean |
Oui |
Indique si un certificat est requis |
| recuData.servicesData.*.actesData.*.gratuit_enfant |
boolean |
Oui |
Indique si l'acte est gratuit pour les enfants |
| recuData.servicesData.*.actesData.*.gratuit_femme_enceinte |
boolean |
Oui |
Indique si l'acte est gratuit pour les femmes enceintes |
Réponse Succès (200)
{
"success": true,
"message": "Reçu mis à jour avec succès",
"data": {
"id": "REC-2026-001",
"numero_patient": "PAT-00125"
}
}
Lister les Reçus de Caisse
Cet endpoint permet de récupérer la liste paginée des reçus de caisse
associés au client API authentifié.
Les résultats sont paginés et peuvent être filtrés par numéro de reçu.
GET
/patients/receipts
https://api.usante.unitechnology.pro/v1/clients/patients/receipts?per_page=20&num_caiss=CAISSE-4587
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres Query
| Paramètre |
Type |
Obligatoire |
Description |
| per_page |
integer |
Non |
Nombre d'éléments par page (max 100, défaut 20) |
| num_caiss |
string |
Non |
Filtrer par numéro de reçu |
Structure des données retournées
| Champ |
Type |
Description |
| id |
string |
Identifiant du reçu (IDCAISSE) |
| numero_recu |
string |
Numéro du reçu de caisse |
| date_recu |
date |
Date du reçu |
| montant_total |
numeric |
Montant total du reçu |
| net_a_payer |
numeric |
Montant net à payer |
| services |
array |
Liste des services associés au reçu |
| services[].actes |
array |
Liste des actes liés au service |
Réponse Succès (200)
{
"success": true,
"message": "Liste paginée des reçus de caisse",
"data": [
{
"id": "REC-2026-001",
"numero_recu": "CAISSE-4587",
"date_recu": "2026-02-16",
"montant_total": 150000,
"net_a_payer": 150000,
"services": [
{
"id": "SVC-001",
"nom_service": "Consultation générale",
"code_service": "CONSULT-01",
"actes": [
{
"id": "ACT-001",
"nom_acte": "Consultation adulte",
"code_acte": "ACT-CONS-01",
"montant_acte": 150000,
"quantite_acte": 1,
"net_a_payer_patient": 150000,
"montant_payer_patient": 150000
}
]
}
]
}
],
"meta": {
"current_page": 1,
"last_page": 5,
"per_page": 20,
"total": 95
}
}
Lister les Reçus d’un Patient
Cet endpoint permet de récupérer la liste paginée des reçus de caisse
d’un patient spécifique identifié par son numero_patient.
GET
/patients/{patientCode}/receipts
https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts?per_page=20&num_caiss=CAISSE-4587
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres d'URL
| Paramètre |
Type |
Obligatoire |
Description |
| patientCode |
string |
Oui |
Numéro du patient dont on veut lister les reçus |
Paramètres Query
| Paramètre |
Type |
Obligatoire |
Description |
| per_page |
integer |
Non |
Nombre d’éléments par page (max 100, défaut 20) |
| num_caiss |
string |
Non |
Filtrer par numéro de reçu |
Structure des données retournées
| Champ |
Type |
Description |
| id |
string |
Identifiant du reçu (IDCAISSE) |
| numero_recu |
string |
Numéro du reçu |
| date_recu |
date |
Date du reçu |
| montant_total |
numeric |
Montant total du reçu |
| net_a_payer |
numeric |
Montant net à payer |
| services |
array |
Liste des services associés au reçu |
| services[].actes |
array |
Liste des actes associés au service |
Réponse Succès (200)
{
"success": true,
"message": "Liste paginée des reçus du patient",
"data": [
{
"id": "REC-2026-001",
"numero_recu": "CAISSE-4587",
"date_recu": "2026-02-16",
"montant_total": 150000,
"net_a_payer": 150000,
"services": [
{
"id": "SVC-001",
"nom_service": "Consultation générale",
"code_service": "CONSULT-01",
"actes": [
{
"id": "ACT-001",
"nom_acte": "Consultation adulte",
"code_acte": "ACT-CONS-01",
"montant_acte": 150000,
"quantite_acte": 1,
"net_a_payer_patient": 150000,
"montant_payer_patient": 150000
}
]
}
]
}
],
"meta": {
"current_page": 1,
"last_page": 3,
"per_page": 20,
"total": 45
}
}
Réponse Erreur (404)
{
"success": false,
"message": "Patient introuvable"
}
Afficher le Détail d’un Reçu d’un Patient
Cet endpoint permet de récupérer les informations détaillées
d’un reçu spécifique appartenant à un patient.
GET
/patients/{patientCode}/receipts/{receiptId}
https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts/REC-2026-001
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres d'URL
| Paramètre |
Type |
Obligatoire |
Description |
| patientCode |
string |
Oui |
Numéro du patient |
| receiptId |
string |
Oui |
Identifiant du reçu à afficher (IDCAISSE) |
Structure des données retournées
| Champ |
Type |
Description |
| id |
string |
Identifiant du reçu |
| numero_recu |
string |
Numéro du reçu |
| date_recu |
date |
Date du reçu |
| montant_total |
numeric |
Montant total |
| net_a_payer |
numeric |
Montant net à payer |
| services |
array |
Liste des services associés |
| services[].actes |
array |
Liste des actes liés au service |
Réponse Succès (200)
{
"success": true,
"message": "Détails du reçu",
"data": [
{
"id": "REC-2026-001",
"numero_recu": "CAISSE-4587",
"date_recu": "2026-02-16",
"montant_total": 150000,
"net_a_payer": 150000,
"services": [
{
"id": "SVC-001",
"nom_service": "Consultation générale",
"code_service": "CONSULT-01",
"actes": [
{
"id": "ACT-001",
"nom_acte": "Consultation adulte",
"code_acte": "ACT-CONS-01",
"montant_acte": 150000,
"quantite_acte": 1,
"net_a_payer_patient": 150000,
"montant_payer_patient": 150000
}
]
}
]
}
]
}
Réponse Erreur (404 - Patient)
{
"success": false,
"message": "Patient introuvable"
}
Réponse Erreur (404 - Reçu)
{
"success": false,
"message": "Reçu introuvable"
}
Enregistrer ou modifier les résultats d’examen d’un patient
Permet d’enregistrer un examen médical pour un patient.
Peut inclure un service, un acte, un reçu, un résultat,
un fichier PDF encodé en base64 et éventuellement
les données complètes d’une consultation.
POST
/patients/{patientCode}/exam-results
POST https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/exam-results
Headers
Authorization: Bearer VOTRE_API_KEY
Content-Type: application/json
Accept: application/json
Paramètre d'URL
| Paramètre |
Type |
Obligatoire |
Description |
| patientCode |
string |
Oui |
Le numéro du patient à afficher |
Body JSON Complet
{
"serviceData": {
"id": 4,
"code_service": "SRV004",
"nom_service": "Service Chirurgie",
"nom_responsable": "Dr. Laurent Petit",
"telephone_responsable": "0178564321",
"service": "Chirurgie",
"urgence": true,
"pharmacie": false,
"chirugie": true,
"imagerie": false,
"biologie": false,
"gratuit_enfant": false,
"gratuit_femme_enceinte": true
},
"acteData": {
"id": 13,
"code_acte": "ACT4004",
"nom_acte": "Petite intervention chirurgicale",
"montant_acte": 15000,
"montant_payer_patient": 15000,
"net_a_payer_patient": 15000,
"quantite_acte": 1,
"certificat": true,
"gratuit_enfant": false,
"gratuit_femme_enceinte": true
},
"recuData": {
"id": "4",
"numero_recu": "RC10042026-0004",
"date_recu": "2026-02-14",
"montant_total": 15000,
"net_a_payer": 15000
},
"examResultData": {
"id": 103,
"date_saisie": "2026-02-14",
"patient_id": 53
},
"pdfData": "JVBERi0xLjQKJcfsj6IKMSAwIG9iago=.....",
"isConsultaion": true,
"consultationData": {
"id": 202,
"date_consultation": "2026-02-14",
"date_debut_maladie": "2026-02-10",
"traitement_pris": "Antibiotiques",
"diagnostic": "Infection post-opératoire",
"motif_consultation": "Suivi post-chirurgie",
"resultat_consultation": "Amélioration",
"date_rendez_vous": "2026-02-20",
"nature_traitement": "Médicaments",
"symptomes_associes": "Douleur légère",
"commentaire_traitement": "Repos",
"type_de_visite": "Consultation",
"visite": "Suivi",
"nom_des_medecins_effectuant_la_visite": "Dr. Laurent Petit",
"type_consultation": "Standard",
"temperature": 37,
"tension_gauche": 13,
"tension_droite": 13,
"pouls": 82,
"poids": 72,
"bmi": 24,
"taille_patient": 178,
"commentaire": "Patient stable"
},
"constanteData": {
"id": 303,
"date_enregistrement": "2026-02-14",
"temperature": 37,
"tension_gauche": 13,
"tension_droite": 13,
"pouls": 82,
"poids": 72,
"taille_patient": 178,
"etat_general_du_patient": "Bon",
"valeur_imc": 24,
"glucemie_capillaire": 5.0,
"bandelette_urinaire": 1.8,
"saturation_sop2": 97
},
"medicamentConsultationData": {
"id_medicament_par_ordonnance": 402,
"medicament": "Amoxicilline",
"forme": "Comprimé",
"duree": 7,
"posologie": 1,
"indice_periode_duree": 2,
"indice_periode_posologie": 1,
"mode_prise_de_medicament": "Orale"
},
"ordonnanceExamenData": {
"id": 502
},
"infoPDFData": "JVBERi0xLjQKJcfs..."
}
Champs Racine Détails Complet
serviceData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Oui |
Identifiant du service |
| code_service |
string |
Oui |
Code unique du service |
| nom_service |
string |
Oui |
Nom du service |
| nom_responsable |
string |
Non |
Nom du responsable |
| telephone_responsable |
string |
Non |
Téléphone du responsable |
| service |
string |
Non |
Type de service |
| urgence |
boolean |
Non |
Service urgence |
| pharmacie |
boolean |
Non |
Présence pharmacie |
| chirugie |
boolean |
Non |
Service chirurgie |
| imagerie |
boolean |
Non |
Service imagerie |
| biologie |
boolean |
Non |
Service biologie |
| gratuit_enfant |
boolean |
Non |
Service gratuit pour enfant |
| gratuit_femme_enceinte |
boolean |
Non |
Service gratuit pour femme enceinte |
acteData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Oui |
Identifiant de l’acte |
| code_acte |
string |
Oui |
Code unique de l’acte |
| nom_acte |
string |
Oui |
Nom de l’acte |
| montant_acte |
numeric |
Oui |
Montant total de l’acte |
| montant_payer_patient |
numeric |
Oui |
Montant payé par le patient |
| net_a_payer_patient |
numeric |
Oui |
Net à payer par le patient |
| quantite_acte |
integer |
Oui |
Quantité de l’acte |
| certificat |
boolean |
Non |
Indique si certificat fourni |
| gratuit_enfant |
boolean |
Non |
Acte gratuit pour enfant |
| gratuit_femme_enceinte |
boolean |
Non |
Acte gratuit pour femme enceinte |
recuData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Oui |
Identifiant du reçu |
| numero_recu |
string |
Oui |
Numéro unique du reçu |
| date_recu |
date |
Oui |
Date du reçu |
| montant_total |
numeric |
Oui |
Montant total du reçu |
| net_a_payer |
numeric |
Oui |
Montant net à payer |
examResultData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Non |
Identifiant du résultat examen |
| date_saisie |
date |
Non |
Date de saisie du résultat |
| patient_id |
integer |
Oui |
Identifiant du patient |
pdfData
| Champ |
Type |
Obligatoire |
Description |
| pdfData |
string (base64) |
Non |
Fichier PDF encodé |
isConsultaion
| Champ |
Type |
Obligatoire |
Description |
| isConsultaion |
boolean |
Oui |
Boolean pour savoir si il y a une consultation ou non |
consultationData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Non |
Identifiant de la consultation |
| date_consultation |
date |
Non |
Date de la consultation |
| date_debut_maladie |
date |
Non |
Date de début de la maladie |
| traitement_pris |
string |
Non |
Traitement pris par le patient |
| diagnostic |
string |
Non |
Diagnostic médical |
| motif_consultation |
string |
Non |
Motif de la consultation |
| resultat_consultation |
string |
Non |
Résultat de la consultation |
| date_rendez_vous |
date |
Non |
Date du prochain rendez-vous |
| nature_traitement |
string |
Non |
Nature du traitement |
| symptomes_associes |
string |
Non |
Symptômes associés |
| commentaire_traitement |
string |
Non |
Commentaires sur le traitement |
| type_de_visite |
string |
Non |
Type de visite |
| visite |
string |
Non |
Objet de la visite |
| nom_des_medecins_effectuant_la_visite |
string |
Non |
Nom du médecin |
| type_consultation |
string |
Non |
Type de consultation |
| temperature |
integer |
Non |
Température du patient |
| tension_gauche |
integer |
Non |
Tension artérielle gauche |
| tension_droite |
integer |
Non |
Tension artérielle droite |
| pouls |
integer |
Non |
Fréquence cardiaque |
| poids |
integer |
Non |
Poids du patient |
| bmi |
integer |
Non |
Indice de masse corporelle |
| taille_patient |
integer |
Non |
Taille du patient |
| commentaire |
string |
Non |
Commentaire général |
constanteData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Non |
Identifiant des constantes |
| date_enregistrement |
date |
Non |
Date d’enregistrement |
| temperature |
numeric |
Non |
Température du patient |
| tension_gauche |
integer |
Non |
Tension artérielle gauche |
| tension_droite |
integer |
Non |
Tension artérielle droite |
| pouls |
integer |
Non |
Fréquence cardiaque |
| poids |
numeric |
Non |
Poids du patient |
| taille_patient |
numeric |
Non |
Taille du patient |
| etat_general_du_patient |
string |
Non |
État général |
| valeur_imc |
numeric |
Non |
Indice de masse corporelle |
| glucemie_capillaire |
numeric |
Non |
Glycémie capillaire |
| bandelette_urinaire |
numeric |
Non |
Résultat bandelette urinaire |
| saturation_sop2 |
numeric |
Non |
Saturation en O2 |
medicamentConsultationData
| Champ |
Type |
Obligatoire |
Description |
| id_medicament_par_ordonnance |
integer |
Non |
Identifiant du médicament par ordonnance |
| medicament |
string |
Non |
Nom du médicament |
| forme |
string |
Non |
Forme (comprimé, sirop…) |
| duree |
integer |
Non |
Durée du traitement |
| posologie |
integer |
Non |
Nombre de prises par période |
| indice_periode_duree |
integer |
Non |
Indice de période durée (jours, semaines…) |
| indice_periode_posologie |
integer |
Non |
Indice de période posologie |
| mode_prise_de_medicament |
string |
Non |
Mode de prise (orale, injection…) |
ordonnanceExamenData
| Champ |
Type |
Obligatoire |
Description |
| id |
integer |
Non |
Identifiant de l’ordonnance examen |
infoPDFData
| Champ |
Type |
Obligatoire |
Description |
| infoPDFData |
string (base64) |
Non |
Fichier PDF encodé des ordonnances |
Réponse Succès (201)
{
"success": true,
"message": "Résultat d'examen enregistré avec succès",
"data": {
"service": {...},
"acte": {...},
"recu": {...},
"examen": {...},
"consultation": {...}
}
}
Réponse Erreur (404)
{
"success": false,
"message": "Patient introuvable"
}
Réponse Erreur (500)
{
"success": false,
"message": "Erreur lors de l'enregistrement",
"error": "Message technique"
}
Lister Tous les Résultats d’Examens
Cet endpoint permet de récupérer tous les résultats d’examens liés aux patients d’un client API.
Chaque résultat peut inclure le fichier PDF de l’examen ainsi que le PDF associé à l’ordonnance
d’examen.
GET
/patients/exam-results
https://api.usante.unitechnology.pro/v1/clients/patients/exam-results
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres URL
Aucun paramètre spécifique pour cette route.
Réponse Succès (200)
{
"success": true,
"message": "Liste des examens récupérée avec succès.",
"data": [
{
"examens": {
"id": "RES-001",
"date_saisie": "2026-02-16",
"pdf": "https://api.usante.unitechnology.pro/storage/results/RES-001.pdf"
},
"ordonnanceExamen": {
"id": "ORD-001",
"pdf": "https://api.usante.unitechnology.pro/storage/results/ORD-001.pdf"
}
},
{
"examens": {
"id": "RES-002",
"date_saisie": "2026-02-17",
"pdf": null
},
"ordonnanceExamen": null
}
]
}
Réponse Erreur (401)
{
"success": false,
"message": "Client API introuvable.",
"data": []
}
Réponse Erreur (404)
{
"success": false,
"message": "Société associée au client API introuvable.",
"data": []
}
Réponse Erreur (500)
{
"success": false,
"message": "Une erreur est survenue : Message technique",
"data": []
}
Chaque élément de la liste contient :
- examens : Détails du résultat d’examen (ID, date de saisie et PDF).
- ordonnanceExamen : Détails du PDF de l’ordonnance associé au résultat
d’examen (si disponible).
Lister les résultats d’examens d’un patient
Cet endpoint permet de récupérer tous les résultats d’examens d’un patient spécifique,
identifiés par patientCode.
Chaque résultat peut inclure le fichier PDF de l’examen ainsi que le PDF associé à l’ordonnance
d’examen.
GET
/patients/{patientCode}/exam-results
https://api.usante.unitechnology.pro/v1/clients/patients/12345/exam-results
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres URL
- patientCode (string) : Code unique du patient fourni par le client API.
Réponse Succès (200)
{
"success": true,
"message": "Liste des examens du patient récupérée avec succès.",
"data": [
{
"examens": {
"id": "RES-001",
"date_saisie": "2026-02-16",
"pdf": "https://api.usante.unitechnology.pro/storage/results/RES-001.pdf"
},
"ordonnanceExamen": {
"id": "ORD-001",
"pdf": "https://api.usante.unitechnology.pro/storage/results/ORD-001.pdf"
}
},
{
"examens": {
"id": "RES-002",
"date_saisie": "2026-02-17",
"pdf": null
},
"ordonnanceExamen": null
}
]
}
Réponse Succès – aucun examen (200)
{
"success": true,
"message": "Aucun examen trouvé pour ce patient.",
"data": []
}
Réponse Erreur (401)
{
"success": false,
"message": "Client API introuvable.",
"data": []
}
Réponse Erreur (404)
{
"success": false,
"message": "Société associée au client API introuvable.",
"data": []
}
{
"success": false,
"message": "Patient introuvable.",
"data": []
}
Réponse Erreur (500)
{
"success": false,
"message": "Une erreur est survenue lors de la récupération des examens.",
"data": []
}
Chaque élément de la liste contient :
- examens : Détails du résultat d’examen (ID, date de saisie et PDF si
disponible).
- ordonnanceExamen : Détails du PDF de l’ordonnance associé au résultat
d’examen (si disponible).
Afficher un résultat d’examen d’un patient
Cet endpoint permet de récupérer un résultat d’examen spécifique d’un patient identifié par
patientCode et resultId.
Chaque résultat inclut le PDF de l’examen ainsi que le PDF associé à l’ordonnance si disponible.
GET
/patients/{patientCode}/exam-results/{resultId}
https://api.usante.unitechnology.pro/v1/clients/patients/12345/exam-results/RES-001
Headers
Authorization: Bearer VOTRE_API_KEY
Accept: application/json
Paramètres URL
- patientCode (string) : Code unique du patient fourni par le client API.
- resultId (string) : Identifiant unique du résultat d’examen.
Réponse Succès (200)
{
"success": true,
"message": "Résultat d'examen récupéré avec succès.",
"data": {
"examens": {
"id": "RES-001",
"date_saisie": "2026-02-16",
"pdf": "https://api.usante.unitechnology.pro/storage/results/RES-001.pdf"
},
"ordonnanceExamen": {
"id": "ORD-001",
"pdf": "https://api.usante.unitechnology.pro/storage/results/ORD-001.pdf"
}
}
}
Réponse Erreur (401)
{
"success": false,
"message": "Client API introuvable.",
"data": null
}
Réponse Erreur (404)
{
"success": false,
"message": "Société associée au client API introuvable.",
"data": null
}
{
"success": false,
"message": "Patient introuvable.",
"data": null
}
{
"success": false,
"message": "Résultat d'examen introuvable pour ce patient.",
"data": null
}
Réponse Erreur (500)
{
"success": false,
"message": "Une erreur est survenue lors de la récupération du résultat.",
"data": null
}
L’objet data contient :
- examens : Détails du résultat d’examen (ID, date de saisie et PDF si
disponible).
- ordonnanceExamen : PDF de l’ordonnance associé au résultat d’examen (si
disponible).
Codes erreurs HTTP
200 Succès
201 Créé
400 Mauvaise requête
401 Non autorisé
500 Erreur serveur