Devis
Les soins proposés au patient avant de les faire, avec leurs parts estimées. Accepté, un devis devient une facture.
Le cycle de vie et les pièges : Devis et ententes préalables.
Événements : quote.*.
Routes
| Route | Effet |
|---|---|
POST /v1/quotes | Ouvrir un devis |
GET /v1/quotes/{quote} | Lire un devis |
PATCH /v1/quotes/{quote} | Modifier un brouillon de devis |
GET /v1/quotes | Lister les devis |
POST /v1/quotes/{quote}/finalize | Remettre un devis au patient |
POST /v1/quotes/{quote}/accept | Le patient accepte le devis |
POST /v1/quotes/{quote}/decline | Le patient refuse le devis |
POST /v1/quotes/{quote}/cancel | Annuler un devis |
POST /v1/quotes/{quote}/invoice | Facturer un devis accepté |
L’objet
idtexteL'identifiant de l'objet, préfixé par son type.
objecttexteLe nom du type d'objet.
statusénumérationdraftopenaccepteddeclinedexpiredinvoicedcanceledpractitionertextepractice_situationtexteou nullpatienttextecoveragetexteou nullLa lecture de droits qui a servi à estimer les parts.
insurance_natureénumérationsicknessmaternitywork_accidentfree_medical_carethird_party_amobooléenthird_party_amcbooléencontextobjetLe contexte de la facture à venir, mêmes champs qu'une facture.
complementaryobjetou nullChamps de complementary
conventiontexteou nullcoverage_responseobjetou null
valid_untiltexteLe dernier jour où le patient peut accepter le devis.
linestableau de objetChamps de lines
idtexteobligatoireL'identifiant de l'objet, préfixé par son type.
objecttexteobligatoireLe nom du type d'objet.
nomenclatureénumérationobligatoirengapccamlppbiologymedicationcodetexteobligatoireservice_datetexteobligatoireLa date prévue des soins, qui donne le tarif. La facture prendra celle du soin.
quantityentierobligatoirecoefficienttexteobligatoireLe coefficient de l'acte, en chaîne décimale.
modifierstableau de texteobligatoireprescriberobjetobligatoireou nulldetailsobjetobligatoireLes détails d'une ligne de facture que la ligne porte déjà : lieu, établissement, forfait technique, extension documentaire.
unit_price_centsentierobligatoireou nullLe prix unitaire demandé, en centimes. Null : le tarif s'applique.
base_unit_centsentierobligatoireou nullLe prix unitaire retenu à la date prévue, en centimes.
amount_centsentierobligatoireou nullLe montant proposé, en centimes.
base_amount_centsentierobligatoireou nullLa base de remboursement estimée, en centimes.
amo_amount_centsentierobligatoireou nullLa part obligatoire estimée, en centimes. Null : pas encore calculable.
amc_amount_centsentierobligatoireou nullLa part complémentaire estimée, en centimes. Zéro sans part complémentaire, null quand elle reste inconnue.
reimbursement_rateentierobligatoireou nullexemption_codetexteobligatoireou nullpricing_stepstableau de objetobligatoireLes étapes de l'estimation, chacune avec la règle qui l'a produite.
Champs de pricing_steps
ruletexteobligatoiresteptexteobligatoirevalueobjetobligatoire
livemodebooléenobligatoiretrueen production,falseen mode test.
amount_centsentierou nullLe total proposé, en centimes.
base_amount_centsentierou nullLa base de remboursement estimée, en centimes.
amo_amount_centsentierou nullLa part obligatoire estimée, en centimes. Null : pas encore calculable, par exemple sans code situation.
amc_amount_centsentierou nullLa part complémentaire estimée, en centimes. Zéro sans part complémentaire, null quand elle reste inconnue :
amc_pricingdit pourquoi.amc_pricingobjetou nullL'explication de la part complémentaire, comme sur une facture.
Champs de amc_pricing
statusénumérationobligatoirecomputednot_applicableunknownreasontexteobligatoireruletexteobligatoireou null
patient_amount_centsentierou nullLe reste à charge estimé de l'assuré, en centimes.
referential_versionsobjetou nullRéférentiel => version retenue pour l'estimation.
claimtexteou nullLa facture née du devis,
clm_…, une fois facturé.finalized_atentierou nullaccepted_atentierou nulldeclined_atentierou nullexpired_atentierou nullinvoiced_atentierou nullcanceled_atentierou nulllivemodebooléentrueen production,falseen mode test.createdentierou nullLa création de l'objet, en secondes Unix.
updatedentierou nullLa dernière modification, en secondes Unix.
{
"id": "obj_…",
"object": "quote",
"status": "draft",
"practitioner": "…",
"practice_situation": null,
"patient": "…",
"coverage": null,
"insurance_nature": "sickness",
"third_party_amo": true,
"third_party_amc": true,
"context": {},
"complementary": null,
"valid_until": "…",
"lines": [
{
"id": "obj_…",
"object": "quote_line",
"nomenclature": "ngap",
"code": "…",
"service_date": "…",
"quantity": 0,
"coefficient": "…",
"modifiers": [
"…"
],
"prescriber": null,
"details": {},
"unit_price_cents": 0,
"base_unit_cents": 0,
"amount_cents": 0,
"base_amount_cents": 0,
"amo_amount_cents": 0,
"amc_amount_cents": 0,
"reimbursement_rate": null,
"exemption_code": null,
"pricing_steps": [
{
"rule": "…",
"step": "…",
"value": {}
}
],
"livemode": false
}
],
"amount_cents": 0,
"base_amount_cents": 0,
"amo_amount_cents": 0,
"amc_amount_cents": 0,
"amc_pricing": null,
"patient_amount_cents": 0,
"referential_versions": null,
"claim": null,
"finalized_at": null,
"accepted_at": null,
"declined_at": null,
"expired_at": null,
"invoiced_at": null,
"canceled_at": null,
"livemode": false,
"created": 1793970000,
"updated": null
}