Send purchase

Send a final closed bill to CareCloud. The bill is recorded and processed by the loyalty engine.

What happens when a purchase is sent

  • A purchase record is created and its server-generated purchase_id is returned.
  • The customer's points balance is updated according to the purchase items, applied rewards, and configured loyalty rules.
  • Vouchers selected at bill closure are marked as used.
  • A marketing-automation event is triggered.
  • The customer's status may be recalculated afterwards based on total purchase amount and other configured criteria.

Related operations

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

ID of the store.

integer
required

Number of the cash-desk in store.

string

The customer card number.

string

ID of the customer that made the purchase. You can search customers by plenty parameter in the resource customers.

bill
object
required

Final bill structure.

Headers
string
Defaults to cs, en-gb;q=0.8

The unique ID of the language code by ISO 639-1.

Responses

error.error_data.invalid_params[] array lists the parameters that caused the failure, each carrying a reason code. See the BadRequestErrorBody schema for the generic reason taxonomy. Operations with domain-specific business rules document additional reasons at the operation level.

429

Too many requests - more than the resource limit.

503

Temporary state when the service is temporarily unavailable, overloaded or there is a maintenance window.

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json