This section provide some detailed information the use of the forms

List all the available forms

using the endpoint https://api.medicys-conventionnel.fr/api/form/GetAll (for the sandbox, use https://staging-api.medicys-conventionnel.fr/api/form/GetAll), you can list all the available form. Here is an example of the response you could get :

[ { "code": "NeighborhoodConflict", "rank": 13, "id": "0ac9768c-bc1c-4ca6-b494-f7fa409cb51b", "caption": "Litiges de voisinage" }, { "code": "CustomerSeller", "rank": 14, "id": "9e433d4a-4e2b-4426-833c-dcf886a64c13", "caption": "Litiges commercial" }, { "code": "TenantOwner", "rank": 15, "id": "6ac41de6-83f1-49cf-a33c-7a9865393423", "caption": "Litige locatif" }, { "code": "Family", "rank": 16, "id": "937c33a4-c36e-4b00-ba8b-c3fe89dc3efc", "caption": "Litige familial" }, { "code": "EmployerEmploye", "rank": 17, "id": "a52e528d-8c55-41a6-9144-3235e6fd3bca", "caption": "Litige en entreprise" }, { "code": "Other", "rank": 18, "id": "fbce11c5-7e00-4251-864b-b27665841d3a", "caption": "Autre" } ]

From here, you would pick a form that would best describe your case. Let's go with "Litige familial". Note the corresponding FormId (in our case "937c33a4-c36e-4b00-ba8b-c3fe89dc3efc").

List the option of a specific form

Once you have a FormId, you can list the different options available via https://api.medicys-conventionnel.fr/api/form/GetDescription (for the sandbox, use https://staging-api.medicys-conventionnel.fr/api/form/GetDescription). Here is an example of the response you could get :

{ "sections": [ { "id": "cba19ad0-09f5-4740-bd91-c5c597487fca", "caption": "Le litige concerne", "help": null, "rank": 0, "options": [ { "id": "944f12e0-c6b4-4804-83e4-82972f010213", "caption": "Les créneaux de garde d’enfants", "captionComplement": null, "help": null, "rank": 0, "complementType": 0, "complementLength": 0 }, { "id": "17d78ce3-963e-46d7-8e64-d1f272aebcb8", "caption": "Le paiement de pension alimentaire", "captionComplement": null, "help": null, "rank": 1, "complementType": 0, "complementLength": 0 }, { "id": "ff13ad22-aa87-4438-9295-ee871eb940a7", "caption": "Le paiement de prestation compensatoire", "captionComplement": null, "help": null, "rank": 2, "complementType": 0, "complementLength": 0 }, { "id": "edaf6f0a-dc8c-4b2f-95f2-487c7b09dc4c", "caption": "La répartition du patrimoine", "captionComplement": null, "help": null, "rank": 3, "complementType": 0, "complementLength": 0 }, { "id": "58a8946d-3487-45d0-afa6-84de9158e0dd", "caption": "Un comportement d’un des membres de la famille", "captionComplement": null, "help": null, "rank": 4, "complementType": 0, "complementLength": 0 }, { "id": "a3d46ef9-53b6-4fb6-b866-db3c9f6a62e3", "caption": "Autre", "captionComplement": null, "help": null, "rank": 5, "complementType": 0, "complementLength": 0 } ] } ], "id": "937c33a4-c36e-4b00-ba8b-c3fe89dc3efc", "caption": "Litige familial" }

In the first section, you will see a list of options for that specific form. Pick the ones that best suits your case. Lets go with : "Le paiement de pension alimentaire". Note the corresponding option Id (in our case "17d78ce3-963e-46d7-8e64-d1f272aebcb8")

Creating a description

When creating a description, you would use the FormId and the OptionId previously mentioned as parameters of the request to the endpoints https://api.medicys-conventionnel.fr/api/form/CreateDescription (for the sandbox, use https://staging-api.medicys-conventionnel.fr/api/form/CreateDescription). Like so :

{ "FileId": "27FF7826-0DED-4101-9FB4-81991117B656", "FormId": "937c33a4-c36e-4b00-ba8b-c3fe89dc3efc", "PartyId": "4B2D72C1-5B55-441F-BA03-3F4383219DCC", "AdditionalInformation": "Mon litige 2", "AnswerOptions": { "17d78ce3-963e-46d7-8e64-d1f272aebcb8": "Le paiement de pension alimentaire" } }

List the proposal of a specific form

Once you have a FormId, you can list the different proposal available via https://api.medicys-conventionnel.fr/api/form/GetProposition (for the sandbox, use https://staging-api.medicys-conventionnel.fr/api/form/GetProposition). Here is an example of the response you could get :

{ "sections": [ { "id": "e87db8b2-1f8c-46dd-9117-a08e0b30c78e", "caption": "Financièrement", "help": null, "rank": 0, "options": [ { "id": "e0cd0617-cda3-455a-bc62-4afd73daf2f7", "caption": "Un paiement en une seule fois", "captionComplement": null, "help": null, "rank": 0, "complementType": 0, "complementLength": 0 }, { "id": "7c70e97a-a1d0-4a6a-8afd-ae2df45d19e9", "caption": "Un paiement mensualisé", "captionComplement": null, "help": null, "rank": 1, "complementType": 0, "complementLength": 0 }, { "id": "b4d14b52-189c-4e10-9bcc-ca6bfdc1220b", "caption": "Une annulation de tout ou partie de la dette", "captionComplement": null, "help": null, "rank": 2, "complementType": 0, "complementLength": 0 } ] }, { "id": "d8cdd409-1a9f-4c78-9ed3-b0e86d16680e", "caption": "Matériellement", "help": null, "rank": 1, "options": [ { "id": "1dd7941c-6274-4329-8173-8342ff7389ac", "caption": "Une livraison de bien", "captionComplement": null, "help": null, "rank": 0, "complementType": 0, "complementLength": 0 }, { "id": "c0eed10c-a09f-4638-903e-a4836fc4440d", "caption": "Une fourniture de service", "captionComplement": null, "help": null, "rank": 1, "complementType": 0, "complementLength": 0 }, { "id": "00361997-df35-49c2-b19a-26f600dc2b89", "caption": "Un retour de bien", "captionComplement": null, "help": null, "rank": 2, "complementType": 0, "complementLength": 0 }, { "id": "1e7c5ac9-0a5e-4dc0-bafd-212e8b543ce5", "caption": "Un échange ou remplacement du bien", "captionComplement": null, "help": null, "rank": 3, "complementType": 0, "complementLength": 0 } ] }, { "id": "7211670c-93fa-4fe1-9bc5-5c5b949b40dd", "caption": "Factuellement", "help": null, "rank": 2, "options": [ { "id": "4ada6672-5208-46b6-9226-ce43be20b988", "caption": "Un changement de comportement/d’habitude", "captionComplement": null, "help": null, "rank": 0, "complementType": 0, "complementLength": 0 }, { "id": "229340c0-c56c-43cf-971c-8153e881c2e4", "caption": "Une mise à disposition des informations demandées", "captionComplement": null, "help": null, "rank": 1, "complementType": 0, "complementLength": 0 } ] } ], "id": "937c33a4-c36e-4b00-ba8b-c3fe89dc3efc", "caption": "Litige familial" }

In the first section, you will see a list of proposal, with different options for that specific form. Pick the options that best suits your case. Lets go with : "Un paiement en une seule fois". Note the corresponding Id (in our case "e0cd0617-cda3-455a-bc62-4afd73daf2f7")

Create a proposal

When creating a proposal, you would use the FormId and the OptionId previously mentioned as parameters of the request to the endpoints https://api.medicys-conventionnel.fr/api/form/CreateProposition (for the sandbox, use https://staging-api.medicys-conventionnel.fr/api/form/CreateProposition). Like so :

{ "FileId": "27FF7826-0DED-4101-9FB4-81991117B656", "FormId": "937c33a4-c36e-4b00-ba8b-c3fe89dc3efc", "PartyId": "4B2D72C1-5B55-441F-BA03-3F4383219DCC", "PartyType": "Party1", "AdditionalInformation": "Additional info", "ProposalReason": "Mes raisons", "ModifiedDate": "2020-05-29T16:50:20.879Z", "AnswerOptions": { "e0cd0617-cda3-455a-bc62-4afd73daf2f7": "Un paiement en une seule fois" } }