Insert/Update deposits

Deprecated

POST

/api

Last modified:2024-08-14 15:24:56

To insert/update one or more deposit, the web service endpoint is the same for the sales insertion/update, with the difference that these fields must also be present in the goodssection of each goodsRecords array entry:

documentType: code of the DEPOSIT document type

deposit: deposit amount

depositCompany: deposit amount

Refer to the Insert/Update Sales for any other information about the request

Notes

There's a limit of 100 calls for this API.

Request

Query Params

Header Params

Body Params application/json

Example

{
  "goodsRecords": [
    {
      "goods": {
        "cardBarcode": "11714",
        "documentDate": "2013-07-05 00:00:00:000",
        "movementDate": "2013-07-05 00:00:00:000",
        "result": "INTERFACE",
        "receiptBarcode": null,
        "taxFreeNumber": null,
        "refDocument": "1-10",
        "causal": "SALE",
        "actionType": "ACCONTO",
        "actionStatus": "A",
        "totalAmountCompany": "200.00",
        "currency": "EUR",
        "entityCode": "1",
        "system": "SHOP",
        "customerCode": "11714",
        "totalAmount": "200",
        "card": "11714",
        "year": "2013",
        "documentType": "ACCONTO",
        "deposit": "200",
        "depositCompany": "200.00"
      },
      "payments": [
        {
          "paymentValue": "200",
          "paymentType": "24"
        }
      ],
      "costs": [
        {
          "convertionRateCompany": "1",
          "taxRate": "21",
          "listPrice": "200",
          "salePriceCompany": "200.00",
          "barcode": "",
          "salePrice": "200",
          "quantity": "",
          "rowNumber": "10270",
          "convertionRateSite": "1",
          "salePriceSite": "200.00",
          "itemCode": "PRSER_6"
        }
      ]
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api?cmd=insertSales_v3&appId=KEEPIT&applicationId=KEEPIT' \
--header 'username: {{USERNAME}}' \
--header 'password: {{PASSWORD}}' \
--header 'companyId: {{COMPANY_ID}}' \
--header 'siteId: {{SITE_ID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "goodsRecords": [
    {
      "goods": {
        "cardBarcode": "11714",
        "documentDate": "2013-07-05 00:00:00:000",
        "movementDate": "2013-07-05 00:00:00:000",
        "result": "INTERFACE",
        "receiptBarcode": null,
        "taxFreeNumber": null,
        "refDocument": "1-10",
        "causal": "SALE",
        "actionType": "ACCONTO",
        "actionStatus": "A",
        "totalAmountCompany": "200.00",
        "currency": "EUR",
        "entityCode": "1",
        "system": "SHOP",
        "customerCode": "11714",
        "totalAmount": "200",
        "card": "11714",
        "year": "2013",
        "documentType": "ACCONTO",
        "deposit": "200",
        "depositCompany": "200.00"
      },
      "payments": [
        {
          "paymentValue": "200",
          "paymentType": "24"
        }
      ],
      "costs": [
        {
          "convertionRateCompany": "1",
          "taxRate": "21",
          "listPrice": "200",
          "salePriceCompany": "200.00",
          "barcode": "",
          "salePrice": "200",
          "quantity": "",
          "rowNumber": "10270",
          "convertionRateSite": "1",
          "salePriceSite": "200.00",
          "itemCode": "PRSER_6"
        }
      ]
    }
  ]
}'

Responses

🟢200Success

application/json

Body

Example

{}

🟠422Unique constraint error

Modified at 2024-08-14 15:24:56

Upload printer sales archive

Insert/Update services