How to Manifest via the MachShip API
## Current Content
This article has been moved to our developer handbook and can be found here:
For detailed information on the `pickupAlreadyBooked` field and its impact on pickup notifications, see the companion documentation below.
### pickupAlreadyBooked Field Behavior
The `pickupAlreadyBooked` field controls whether MachShip sends pickup booking notifications to carriers when consignments are manifested. This field is essential for implementing location-based pickup strategies where different locations may require different notification approaches.
#### Field Behavior
- **When `pickupAlreadyBooked` is set to `false`**: MachShip will send an individual pickup booking notification to the carrier upon manifest. Use this setting when a location requires per-consignment pickup notifications.
- **When `pickupAlreadyBooked` is set to `true` or omitted (default)**: MachShip will NOT send a per-consignment pickup notification. Use this setting for locations that use daily standing collections or have pickups already arranged.
#### Use Cases
This field is particularly useful for location-based pickup strategies where:
- Some locations use daily standing collections (set `pickupAlreadyBooked` to `true` or omit the field)
- Other locations require individual per-consignment pickup notifications (set `pickupAlreadyBooked` to `false`)
#### Example JSON Payloads
**Scenario 1: Per-consignment pickup notification required**
```json
{
"consignmentNumber": "CONS123456",
"pickupAlreadyBooked": false,
"carrier": "BorderExpress",
"location": "Moorebank"
}
```
In this scenario, MachShip will send an individual pickup booking notification to Border Express upon manifest.
**Scenario 2: Daily standing collection (no per-consignment notification)**
```json
{
"consignmentNumber": "CONS123457",
"pickupAlreadyBooked": true,
"carrier": "BorderExpress",
"location": "Sydney"
}
```
In this scenario, MachShip will NOT send a per-consignment pickup notification, as the pickup is already arranged through a standing collection agreement.