PartnerReferencesBulkResponse

  • errors
    Type: array string[]

    Per-row error messages (empty on full success). Each entry corresponds to a failed item and includes the code when available for correlation.

  • references
    Type: array object[] · PartnerReference[]

    Successfully processed references with Consentio IDs assigned.

    A reference represents one article in the buyer's master data. All logistics units for that code are grouped under logistics_units[].

    Matched by code for idempotency: resubmitting the same code updates the existing reference and its nested collections.

    • code
      Type: string
      max length:  
      256
      required

      Unique partner identifier; idempotency key.

    • name
      Type: string
      max length:  
      256
      required

      Reference display name.

    • product_kinds
      Type: array object[] · PartnerReferenceProductKind[] 1…
      required

      The reference's category hierarchy as an ordered array, root → leaf. Each entry is resolved against product_kind.external_id within the target workspace; the reference is linked to the leaf node. The order is part of the contract and must always be the same.

    • attributes
      Type: array object[] · PartnerReferenceAttribute[]

      EAV attributes attached to the reference.

    • deleted_at
      Type: string | null Format: date-time

      Optional RFC 3339 timestamp, a per-row soft-delete signal. Applies only to the (code, logistics-unit) rows in this request. Once the timestamp has passed, the row is treated as inactive.

      • Past-dated values are immediately effective (the row reads as inactive on the next call).
      • Future values keep the row active until the timestamp passes.
      • Omitting the field on a later POST clears any previously stored value.
    • description
      Type: string

      Free-text description. Always a string, empty ("") when no value, never null.

    • logistics_units
      Type: array object[] · PartnerReferenceLogisticsUnit[]

      All logistics units for this reference. One entry per logistics unit. At least one logistics unit is expected for sellable references.

      One logistics unit. Server-side, each entry produces its own references row keyed by <outer reference.code>-<code> (joined with a -), plus a reference_box_types junction row resolving box_type_code against the shared box_types dictionary.

    • metadata
      Type: object

      Partner-specific traceability payload. Stored as-is by Consentio. Open-ended object; partners send whatever keys are relevant.

    • organic
      Type: boolean

      Whether the reference is organic-certified.

    • status
      Type: string enum

      On create: defaults to inactive, any value other than active results in inactive. On update: set to the value provided (active/inactive); if omitted, left unchanged. inactive is a soft delete (the row is kept but hidden from active results).

      values
      • active
      • inactive