The Create Partner Client and Revenue Claims endpoint is used to send anonymised Partner Client data which liberis will use to synchronously create a Liberis Partner Client
Valid state
Values
state
ValuesThere are several statuses that the state
property can be:
- Duplicate : The associated
data
item has been deemed a duplicate - Conflict : The associated
data
item has been deemed a conflict with anotherdata
item in the original request - Failed : The associated
data
item has failed validation - Completed : The associated
data
item has passed validation and was saved to our data store
Failure Statuses
Any data
item which has a state
of Duplicate, Conflict or Failed will not be saved to our data stores.
Duplicate
When a state
has a value of Duplicate, it indicates one of two conditions has been met:
- The associated
data
item is a perfect duplicate of another item in the original request, the first item in the original request was processed as unique and will provide its ownstate
to indicate if Completed successfully and saved - The associated
data
item is a duplicate of a record we have already seen and saved to our data store
The validation_errors
property will contain a string error which describes which one of the above conditions was met.
Conflict
When a state
has a value of Conflict, it indicates:
The associated
data
item is a duplicate of anotherdata
item in the original request by the unique keypartner_client_id
- however the data differs in the duplicates.
When this condition is met, those data
items that are deemed duplicates by unique key partner_client_id
will all have a state
of Conflict as we are unable to determine which one is valid to process and save.
Failed
When a state
has a value of Failed, it indicates:
The associated
data
item failed our validation routines and was not saved.
The validation_errors
property will contain a string error which describes which one of the above conditions was met.
It is recommended a client logs this information as it could indicate the data in the data
item contains malformed values and as such invalid.
A retry of the failed data
item can be actioned once the validation_errors
have been addressed.