Create sale

Description

The call is used when your client has purchased a product, and it is located with one of the warehouse owners in our system

WARNING

If there are many product items in the order, for each of them its own Sale object is created with the same externalId

Calling

POST /sales

Parameters

{
  "qwqerId": "string",
  "storageId": "string",
  "itemExternalId": "string",
  "quantity": 0,
  "externalId": "string",

  //delivery info section
  "country": "string",
  "city": "string",
  "address": "string",
  "longitude": 0,
  "latitude": 0,
  //client info section
  "buyer" : {
    "name": "string",
    "surname": "string",
    "phone": "string"
  }
}

TIP

All fields in this request is required

Parameter Key Name	Description
qwqerId	Marketplace UUID
storageId	UUID of the storage where contains the required product item To find the necessary storage use Get storage list by item API
itemExternalId	Unique identifier of product item in your system that is located in the selected storage storageId. If this product is not in the storage, there will be an error 404 { "message": "Item not found" }
quantity	Quantity of required product item. If the selected storage does not have the required quantity, there will be an error 400 { "message": "Wrong quantity value" }
externalId	Unique identifier of order in your system

//delivery info section - Full information about the delivery point of the product item to the client

Example

{
    "country" : "Latvia",
    "city" : "Rīga",
    "address" : "Doma laukums 8a, Centra rajons",
    "longitude" : 24.105183,
    "latitude" : 56.949641
}

//client info section - Client information

{
  "buyer" : {
    "name": "Test",         // First name of client
    "surname": "Test",      // Last name of client
    "phone": "+3712345678"  // Phone number of client in international format
  }
}

Response

200 - Successful request

{
  "saleId": "string" // UUID of created Sale
}

INFO

After creating a Sale, it will have the status new

400 - Invalid request

{
  "message": "string"
}