Skip to content

Changelog and versions

The Shop API is versioned, in the path: /v1/shop/…. The widget carries no version — the Neocarts CDN always serves the current, backward-compatible build.

  • A breaking change (a field removed or renamed, a rule tightened, a response reshaped) ships as a new major version. The previous version keeps working for six months after the new one is announced.
  • Additive changes (a new optional field, a new endpoint, a new value in a response) land in the current version without a number change. An integration should ignore unknown fields in responses.
  • The text of error messages is not part of the contract: it may change at any time. Key logic off statuses and field keys — see Errors.

Every release — a new major as well as an additive one in the current version — is recorded in the table below with its date; the six months of support for the previous version count from that entry.

Version Date Change
v1 2026-10-14 Webhooks: in delivery.data the directory ids are expanded into city, branch, parcel_locker, street objects — { id, external_id, name }, external_id being the carrier’s own reference. Before, only our city_id/branch_id came through, which cannot make a waybill. Webhooks are not versioned; a handler that read *_id has to be updated
v1 2026-10 Additive: webhooks — signed POSTs to the shop’s server about orders, subscriptions and payments; configured in the panel, «Integration»
v1 2026-09 First release: products (PUT /v1/shop/products/{external_id}, PUT …/price), order creation (POST /v1/shop/orders/create), items replacement (PUT /v1/shop/orders/{order}/items)