INinvendor
Items

Bulk upsert items masterdata. Accepts a JSON array of items. Items are matched by `code` — existing items are updated, new ones are created. Items missing `code` or `name` are silently skipped; validate your payload before sending. Unit identifiers (`inventUnitId`, barcode `unit`) are normalised to lowercase and auto-created if they do not exist. The server processes large arrays in internal batches of 5 000 items. Endpoint timeout is 5 minutes.

Changed on

NEVER call this endpoint concurrently for the same tenant. Concurrent calls will interfere with each other and produce incorrect results. All requests must be strictly sequential — wait for a 200 OK before sending the next batch.

post/v1/Items/bulk

Request

  • Base URL
    https://api.invendor.com (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Authorization codehttps://identity.scanbro.com/connect/authorize
    Token URLhttps://identity.scanbro.com/connect/token
    Scopesio.common
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

serviceIdstring uuid

Optional service context. Omit if items are not scoped to a specific service.

forceOverwriteOwnerboolean
Accountunknown

Account

Request body

codestring nullable
namestring nullable
type0 | 1 | 2 | 3
inventUnitIdstring nullable
vendorstring nullable
ownerAccountCodestring nullable
imageUrlstring nullable
propertiesobject nullable

Response

Success

Changes

  • 7d45e211950dRevision changes
    • warning

      removed the request property / (media type: application/json-patch+json; x-api-version=1.0)

    • warning

      removed the request property / (media type: application/json; x-api-version=1.0)

    • warning

      removed the request property / (media type: text/json; x-api-version=1.0)

    • warning

      removed the request property / (media type: application/*+json; x-api-version=1.0)

    • warning

      removed the request property / (media type: application/json-patch+json; x-api-version=1.0)

    • warning

      removed the request property / (media type: application/json; x-api-version=1.0)

    • warning

      removed the request property / (media type: text/json; x-api-version=1.0)

    • warning

      removed the request property / (media type: application/*+json; x-api-version=1.0)