Batches Mutations

CreateBatchNumber

Creates a new batch number.

Parameters:

ParameterTypeDescription
inputBatchNumberInput!Batch data.

Example Query:

mutation CreateBatchNumber($input: BatchNumberInput!) {
  CreateBatchNumber(input: $input) {
    id
    label
    barcode
  }
}

Example Variables:

{
  "input": {
    "label": "BATCH-A001",
    "barcode": "1234567890",
    "expiry_date": "2026-12-31",
    "variant": { "id": 5001 }
  }
}

CreateBatchNumbers

Creates multiple batch numbers at once.

Parameters:

ParameterTypeDescription
input[BatchNumberInput]!List of batch data.

UpdateBatchNumber

Updates an existing batch number.

Parameters:

ParameterTypeDescription
idInt!ID of the batch number.
inputBatchNumberInput!Updated data.

Example Query:

mutation UpdateBatchNumber($id: ID!, $input: BatchNumberInput!) {
  UpdateBatchNumber(id: $id, input: $input) {
    id
    label
  }
}

UpdateBatchNumbers

Updates multiple batch numbers.

Parameters:

ParameterTypeDescription
input[BatchNumberInput]!List of updated batch data.

DeleteBatchNumber

Deletes a batch number.

Parameters:

ParameterTypeDescription
idInt!ID of the batch number to delete.

AllocateBatchNumber

Allocates batch numbers to specific stock levels (locations/bins).

Parameters:

ParameterTypeDescription
input[BatchNumberStockLevelInput]Allocation data.

ImportProductsBatchNumbers

Imports batch numbers from a CSV file.

Parameters:

ParameterTypeDescription
fileTmpBucketFileInput!Pre-signed file upload data.

Example Query:

mutation ImportProductsBatchNumbers($file: TmpBucketFileInput!) {
  ImportProductsBatchNumbers(file: $file)
}
Return TypeDescription
JSONImport result with success/error details.

Input Data Types

BatchNumberInput

FieldTypeDescription
idIntID.
labelStringBatch/Lot number name.
barcodeStringAssociated barcode.
expiry_dateDateExpiration date of the batch.
variantVariantInputLinked product variant.