Fulfilment Request

Fulfilment

Fulfilment is when you notify us that the order has successfully been delivered to the customer.

You can automate the task so that the fulfilment API request is generated to mark both in-store and online applications as fulfilled, without the need to log into Backoffice.

When should you send a fulfilment request?
You should send a fulfilment only when the status of the credit application is VERIFIED and the order has successfully been delivered to the customer.

You can observe this via the Backoffice application.

How to send a fulfilment request
The request elements:

Method: POST
Fields (they must be provided as form data via the request body)

Request Fields

POST Field	Type	Required	Notes
cr_id	INTEGER	Yes	The Deko ID for this credit application which you want to fulfil
new_state	STRING	Yes	This should be ‘fulfilled’ in lower case
fulfilment_ref	STRING	Yes	Fulfilment note for the order
api_key	STRING	Yes	Your unique account identifier

Examples of Responses

Example Successful Response

<?xml version="1.0"?>
<p4l>
  <result>success</result>
</p4l>

Example Error Response (when api_key not correct)

<?xml version="1.0"?>
<p4l>
    <ERROR>Not authorized: credentials do not match</ERROR>
</p4l>

Example Error Response (when cr_id is not correct)

<?xml version="1.0"?>
<p4l>
   <ERROR>Credit request cannot be fulfilled</ERROR>
</p4l>

📘
When to mark the credit application as "Fulfilled"
When the response to the fulfilment request is successful, the status of the credit application should move to FULFILLED.