Issue Delivery

Creates and issues a delivery document in the investglass system.

Endpoint

POST /2.0/delivery/issue

Authentication

This endpoint requires OAuth 2.0 authentication. Include your access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Request Headers

Header	Value
`Content-Type`	`application/json`
`Accept`	`application/json`
`Authorization`	`Bearer YOUR_ACCESS_TOKEN`

Request Body

The request body should contain the delivery information:

{
  "delivery_id": "integer",
  "contact_id": "integer", 
  "delivery_date": "string (date)",
  "items": [
    {
      "item_id": "integer",
      "quantity": "number",
      "unit_price": "number"
    }
  ]
}

Parameters

Parameter	Type	Required	Description
`delivery_id`	integer	Yes	The ID of the delivery to issue
`contact_id`	integer	Yes	The contact/customer ID
`delivery_date`	string	No	Date of delivery (ISO 8601 format)
`items`	array	Yes	Array of delivery items

Response

Success Response (200 OK)

{
  "id": 123,
  "delivery_nr": "DEL-2024-001",
  "contact_id": 456,
  "delivery_date": "2024-01-15",
  "status": "issued",
  "total_amount": 1500.00,
  "items": [
    {
      "id": 789,
      "item_id": 101,
      "quantity": 2,
      "unit_price": 750.00,
      "total": 1500.00
    }
  ],
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Error Responses

400 Bad Request

{
  "error": "invalid_request",
  "message": "Missing required parameter: contact_id"
}

401 Unauthorized

{
  "error": "unauthorized",
  "message": "Invalid or expired access token"
}

404 Not Found

{
  "error": "not_found", 
  "message": "Delivery with ID 123 not found"
}

Example Usage

cURL

curl -X POST "https://api.investglass.com/2.0/delivery/issue" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "delivery_id": 123,
    "contact_id": 456,
    "delivery_date": "2024-01-15",
    "items": [
      {
        "item_id": 101,
        "quantity": 2,
        "unit_price": 750.00
      }
    ]
  }'

JavaScript

const response = await fetch('https://api.investglass.com/2.0/delivery/issue', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    delivery_id: 123,
    contact_id: 456,
    delivery_date: '2024-01-15',
    items: [
      {
        item_id: 101,
        quantity: 2,
        unit_price: 750.00
      }
    ]
  })
});

const delivery = await response.json();

Notes

Delivery documents must be created before they can be issued
Once issued, the delivery status changes and becomes immutable
The API uses OAuth 2.0 for authentication - see the Authentication Guide for setup instructions
Base URL: `https://api.investglass.com/
All dates should be in ISO 8601 format (YYYY-MM-DD)
Amounts are in the account's default currency

Related Endpoints

Create Delivery - Create a new delivery document
Get Delivery - Retrieve delivery details
List Deliveries - Get all deliveries
Update Delivery - Modify delivery before issuing