Receive Goods In Advice (GIA)

Process goods in advice (GIA) notifications to prepare the warehouse for incoming inventory.

Direction External System → WMS

HTTP Method POST

Path /inbound/receiveGia

Request Body

{
  "giaReference": "GIA-2024-001234",
  "supplierReference": "SUP-REF-5678",
  "supplierId": "SUPPLIER-001",
  "expectedDeliveryDate": "2024-01-25T09:00:00Z",
  "priority": "STANDARD",
  "warehouseId": "WH-001",
  "stockOwner": "STOCK-OWNER-001",
  "giaLines": [
    {
      "lineNumber": 1,
      "productId": "PROD-ABC123",
      "sku": "COFFEE-BEANS-1KG",
      "expectedQuantity": 500,
      "unitOfMeasure": "EACH",
      "costPrice": 12.50,
      "currency": "GBP",
      "batchRequired": true,
      "expiryRequired": true,
      "storageType": "AMBIENT"
    },
    {
      "lineNumber": 2,
      "productId": "PROD-DEF456",
      "sku": "TEA-BAGS-100CT",
      "expectedQuantity": 200,
      "unitOfMeasure": "EACH",
      "costPrice": 8.75,
      "currency": "GBP",
      "batchRequired": false,
      "expiryRequired": true,
      "storageType": "AMBIENT"
    }
  ],
  "specialInstructions": "Handle with care - fragile packaging",
  "requiredDocuments": [
    "INVOICE",
    "PACKING_LIST",
    "CERTIFICATE_OF_ORIGIN"
  ]
}

Response Codes

200: GIA successfully processed

400: Invalid GIA data

401: Authentication required

409: GIA already exists

422: Validation failed

Success Response (200)

{
  "success": true,
  "message": "Goods In Advice successfully processed",
  "giaId": "67890",
  "giaReference": "GIA-2024-001234",
  "status": "PENDING",
  "processedAt": "2024-01-20T15:30:00Z",
  "processedLines": 2,
  "totalExpectedQuantity": 700,
  "estimatedReceiptWindow": {
    "startDate": "2024-01-24T08:00:00Z",
    "endDate": "2024-01-26T18:00:00Z"
  }
}

Error Response (400)

{
  "success": false,
  "error": "INVALID_GIA_DATA",
  "message": "GIA data validation failed",
  "details": [
    {
      "field": "giaReference",
      "message": "GIA reference is required"
    },
    {
      "field": "giaLines",
      "message": "At least one GIA line is required"
    },
    {
      "field": "giaLines[0].expectedQuantity",
      "message": "Expected quantity must be greater than 0"
    }
  ]
}

Error Response (409)

{
  "success": false,
  "error": "GIA_EXISTS",
  "message": "GIA with this reference already exists",
  "existingGia": {
    "giaId": "67890",
    "giaReference": "GIA-2024-001234",
    "status": "PENDING"
  }
}

GIA Status Flow

1. PENDING - GIA received and validated, awaiting delivery
2. IN_PROGRESS - Goods are being received
3. PARTIALLY_RECEIVED - Some items received, others pending
4. COMPLETED - All expected goods received
5. CANCELLED - GIA cancelled before completion