POST /cleemy-procurement/api/purchases HTTPS/2Host:example.ilucca.netAuthorization:lucca application={API_KEY}Content-Type:application/json{ "ownerId": 35, // Identifier of the user this purchase belongs to. "natureId": 1, // Identifier of the nature of this purchase. "costCenterId": 3,// Cost center identifier "establishmentId": 1, // Identifier of the business-establishment. Usually the one the owner of this purchase works in. "departmentId": 14, // Identifier of the department. Usually the one the owner of this purchase works in. "supplier": { "id": 6, "name": "Amazon", "territoryId": "FR" }, "title": "Purchase entry test", "axisSectionIds": [361] // Optional, depends on client configuration.}
Success is indicated by a 201 response status code. If so, the response contains a purchaseId which is the identifier of the created Purchase object.
Pleas note a Commitment can be of type “one-time” (i.e. OneTimeCommitment) or “recurring” (i.e. SubscriptionCommitment). In which case the payload changes slightly.
POST /cleemy-procurement/api/purchases/{purchaseId}/commitment HTTPS/2Host:example.ilucca.netAuthorization:lucca application={API_KEY}Content-Type:application/json{ "costDate": "2025-04-14", // delivery date "invoiceDate": "2025-04-14", // invoice date "amountIncludingTaxes": { // amount, with an excluding taxes part and taxes (array by rate) "excludingTaxes": { "value": 120, "currency": "EUR" }, "taxes": [] }, "type": "OneTimeCommitment", // purchase type, detailed below. "attachmentIds": [], // file attached to the purchase request detailed in the annex "state": "Created", "comment": "Comment", "paymentMethod": null // payment method: can be left empty.}
You may retrieve a list of all VAT rates applicable to a given territory at a given date via the tax management service. You will need it to set up the correct VAT rate when creating a Commitment.
GET /cleemy-procurement/taxes/api/rates?date={date}&territoryId=FR HTTPS/2Host:example.ilucca.netAuthorization:lucca application={API_KEY}Accept:application/json
Success is indicated by a 201 response status code. If so, the response contains a commitmentId which is the identifier of the created Commitment object.
POST /cleemy-procurement/api/commitments/{commitmentId}/requests HTTPS/2Host:example.ilucca.netAuthorization:lucca application={API_KEY}Content-Length:0
The request body is expected to be empty.
The system will configure auto-approval of requests so that the order is automatically created at the end of the workflow.
You may need to cancel or delete a Purchase that was previously created.
Please note that strictly speaking, a Purchase cannot be deleted (HTTP DELETE requests are not supported), but it can be “closed”. A Purchase may only be closed once all invoices related to it have been approved and paid (or just cancelled).
POST /cleemy-procurement/api/requests/{requestId}/cancellations HTTPS/2Host:example.ilucca.netAuthorization:lucca application={API_KEY}Content-Type:application/json{ "comment": "Comment"}
