Update Sale Line | NaviPartner | NP Retail API Documentation

import requests
url = "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./pos/sale/0d200aa6-aacd-4b78-b673-c4fb7461f5ea/saleline/8408f65c-3a3f-4a62-a459-a94fd6ff9063"
payload = { "quantity": 3 }
headers = {
    "x-np-api-key": "<NaviPartner API Key>",
    "Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.json())

{
  "saleId": "bcc8ec51-906b-4a57-9680-1d120dd55b01",
  "receiptNo": "12345678",
  "posUnit": "QR_FOOD_APP",
  "posStore": "STORE01",
  "date": "2024-01-01",
  "startTime": "2024-01-01T17:00:00Z",
  "customerNo": "C12345",
  "salespersonCode": "SP001",
  "vatBusinessPostingGroup": "DOMESTIC",
  "refreshedSaleLines": [
    {
      "id": "8408f65c-3a3f-4a62-a459-a94fd6ff9063",
      "sortKey": 10000,
      "type": "Item",
      "code": "ITEM-001",
      "variantCode": "",
      "description": "Premium Widget",
      "quantity": 2,
      "unitPrice": 50,
      "discountPct": 0,
      "discountAmount": 0,
      "vatPercent": 25,
      "amountInclVat": 125,
      "amount": 100,
      "unitOfMeasure": "PCS",
      "isAddon": false
    }
  ],
  "refreshedPaymentLines": [],
  "deletedSaleLines": [],
  "deletedPaymentLines": [],
  "totalSalesAmountInclVat": 125,
  "totalPaymentAmount": 0
}

Updates an existing sale line (e.g., change quantity or price). Returns the saleId and a refresh object with SystemIds of updated entities and totals.

Authentication

x-np-api-keystring

API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

saleIdUUIDRequired

The id of a POS sale. This can be provided by the API consumer when creating a new sale.

saleLineIdUUIDRequired

The id of a sale line within a POS sale.

Request

This endpoint expects an object.

quantitydoubleOptional

discountAmountdoubleOptional

descriptionstringOptional

Response

This endpoint returns an object.

saleIdUUID

The id of a POS sale. This can be provided by the API consumer when creating a new sale.

receiptNostring

posUnitstring

posStorestring

datedate

startTimedatetime

customerNostring

salespersonCodestring

vatBusinessPostingGroupstring

refreshedSaleLineslist of objects

Full objects for all sale lines that were created or modified

refreshedPaymentLineslist of objects

Full objects for all payment lines that were created or modified

deletedSaleLineslist of strings

Array of SystemIds (UUIDs) for sale lines that were deleted

deletedPaymentLineslist of strings

Array of SystemIds (UUIDs) for payment lines that were deleted

totalSalesAmountInclVatdouble

Total amount of all sale lines including VAT

totalPaymentAmountdouble

Total amount of all payment lines

Authentication

Path parameters

Headers

Request

Response