Documentation
API Documentation
API Documentation
  • General Overview
    • Introduction
      • Before you start
      • Environments
      • Integration
    • Objects and IDs
      • Shipments Requests (Bookings)
      • Shipments
      • Tracking Points
      • Addresses
    • 📖Glossary
  • I am a shipper
    • Webhooks
      • Set up my webhooks
      • Payloads for Shipper
    • Documents
      • Download Documents
      • Upload Documents
  • I am a carrier
    • Bookings
      • Set up my webhooks
      • Payloads for Carrier
    • Trackings
    • Documents
      • Download Documents
      • Upload Documents
  • Full API
    • Swagger API Endpoints
Powered by GitBook
On this page
  1. I am a carrier
  2. Bookings

Payloads for Carrier

5 available Payloads for carriers

PreviousSet up my webhooksNextTrackings

Last updated 1 year ago

{
"event_type": "freight_unit_create_shipment",
"shipment_id": 0,
"freight_units": [{
	"id": 1,
	"name": null,
	"internal_ref": "string",
	"contents": [{
		"id": 0,
		"type_id": 0,
		"spec_id": null,
		"product_type_id": null,
		"quantity": 1,
		"length": 0,
		"width": 0,
		"height": 0,
		"weight": 0,
		"comment": null,
		"internal_ref": null,
		"is_dangerous": false,
		"is_stacked": false,
		"onu_code": null,
		"is_controlled_temperature": false,
		"from_address": {
			"id": 0,
			"type": "string",
			"name": "string",
			"country": "string",
			"city": "string",
			"address_1": "string",
			"address_2": "",
			"recipient": "",
			"zipcode": "string",
			"state": "string",
			"phone_number": "string",
			"email": null,
			"instructions": "",
			"country_code_alpha2": "FR",
			"internal_ref": "string"
		},
		"dest_address": {
			"id": 0,
			"type": "head_office",
			"name": "string",
			"country": "France",
			"city": "string",
			"address_1": "string",
			"address_2": null,
			"recipient": "string",
			"zipcode": "string",
			"state": null,
			"phone_number": "string",
			"email": null,
			"instructions": null,
			"country_code_alpha2": "FR",
			"internal_ref": null
		},
		"type": {
			"id": 0,
			"name": "Palette 100*120",
			"is_container": false
		},
		"freight_unit_key": null,
		"product_type_name": null,
		"spec_name": null
	}]
},{
	"id": 2,
	"name": null,
	"internal_ref": "FU key2",
	"contents": [{
		"id": 0,
		"type_id": 0,
		"spec_id": null,
		"product_type_id": null,
		"quantity": 2,
		"length": 0,
		"width": 0,
		"height": 0,
		"weight": 0,
		"comment": null,
		"internal_ref": null,
		"is_dangerous": false,
		"is_stacked": false,
		"onu_code": null,
		"is_controlled_temperature": false,
		"from_address": null,
		"dest_address": null,
		"type": {
			"id": 0,
			"name": "Box 60 30 30",
			"is_container": false
		},
		"freight_unit_key": null,
		"product_type_name": null,
		"spec_name": null
	}]
}],
"timestamp": 1652950379,
"signature": "225fb4f836606ffe44c449a8c06a35fda29526434eb476967cdbf51f97e4643d",
"token": "f62c3148f4bcbb146e653eed27ce8e29166986e34b1c6e498d90ebe2bc590531542c5de4043a97809f9aed9370ad8cc99006"
}
{
"event_type": "freight_unit_update_shipment_contents",
"shipment_id": 49981,
"added_freight_units": [
    {
        "id": 3,
        "name": null,
        "internal_ref": "string",
        "contents": [
            {
                "id": 0,
                "type_id": 0,
                "spec_id": 0,
                "product_type_id": 0,
                "quantity": 1,
                "length": 60,
                "width": 30,
                "height": 30,
                "weight": 0,
                "comment": "",
                "internal_ref": null,
                "is_dangerous": false,
                "is_stacked": false,
                "onu_code": null,
                "is_controlled_temperature": false,
                "from_address": null,
                "dest_address": null,
                "type": {
                    "id": 7,
                    "name": "Box 60 30 30",
                    "is_container": false
                },
                "freight_unit_key": null,
                "product_type_name": null,
                "spec_name": null
            }
        ]
    }
],
"changed_freight_units": [
    {
        "id": 1,
        "name": null,
        "internal_ref": "FU key1",
        "contents": [
            {
                "id": 0,
                "type_id": 0,
                "spec_id": 0,
                "product_type_id": 0,
                "quantity": 1,
                "length": 0,
                "width": 0,
                "height": 0,
                "weight": 0,
                "comment": "",
                "internal_ref": null,
                "is_dangerous": false,
                "is_stacked": false,
                "onu_code": null,
                "is_controlled_temperature": false,
                "from_address": null,
                "dest_address": null,
                    "type": {
                        "id": 6,
                        "name": "Others",
                        "is_container": false
                    },
                "freight_unit_key": null,
                "product_type_name": null,
                "spec_name": null
            },
            {
                "id": 0,
                "type_id": 0,
                "spec_id": 0,
                "product_type_id": 0,
                "quantity": 5,
                "length": 120,
                "width": 100,
                "height": 0,
                "weight": 0,
                "comment": null,
                "internal_ref": null,
                "is_dangerous": false,
                "is_stacked": false,
                "onu_code": null,
                "is_controlled_temperature": false,
                "from_address": {
                    "id": 0,
                    "type": "string",
                    "name": "string",
                    "country": "France",
                    "city": "Nantes",
                    "address_1": "133 Rue de coulmiers",
                    "address_2": "",
                    "recipient": "",
                    "zipcode": "44000",
                    "state": "string",
                    "phone_number": "string",
                    "email": null,
                    "instructions": "",
                    "country_code_alpha2": "FR",
                    "internal_ref": "string"
                },
                "dest_address": {
                    "id": 38746,
                    "type": "head_office",
                    "name": "string",
                    "country": "France",
                    "city": "Bonneville",
                    "address_1": "string",
                    "address_2": null,
                    "recipient": "string",
                    "zipcode": "74130",
                    "state": null,
                    "phone_number": "string",
                    "email": null,
                    "instructions": null,
                    "country_code_alpha2": "FR",
                    "internal_ref": null
                },
                "type": {
                    "id": 15,
                    "name": "Palette 100*120",
                    "is_container": false
                },
                "freight_unit_key": null,
                "product_type_name": null,
                "spec_name": null
            }
        ]
    }
],
"deleted_freight_units": [
    {
        "id": 0,
        "name": null,
        "internal_ref": "FU key7"
    }
],
"timestamp": 1652959319,
"signature": "e7508892bb794be510ec899f162f08a0c335cc8ed976bf0551a4205a925843c0",
"token": "26987558a6c6640e8260a9fa7f8bf0ecff92ac99703e759493e9444572073bb5108e2e4fb8302e4750deaf1454a0cd237cd5"
}
{
"event_type": "freight_unit_update_tracking",
"shipment_id": 0,
"updated_tracking_point_id": 0,
"freight_units": [{
    "id": 1,
    "name": null,
    "internal_ref": "FU key1",
    "contents": [{
        "id": 0,
        "type_id": 15,
        "spec_id": null,
        "product_type_id": null,
        "quantity": 1,
        "length": 120,
        "width": 100,
        "height": 0,
        "weight": 0,
        "comment": null,
        "internal_ref": null,
        "is_dangerous": false,
        "is_stacked": false,
        "onu_code": null,
        "is_controlled_temperature": false,
        "from_address": {
            "id": 0,
            "type": "other",
            "name": "STY",
            "country": "France",
            "city": "Nantes",
            "address_1": "133 Rue de Coulmiers",
            "address_2": "",
            "recipient": "",
            "zipcode": "44000",
            "state": "string",
            "phone_number": "string",
            "email": null,
            "instructions": "",
            "country_code_alpha2": "FR",
            "internal_ref": "string"
        },
        "dest_address": {
            "id": 0,
            "type": "head_office",
            "name": "STY Logistique Internationale",
            "country": "France",
            "city": "Bonneville",
            "address_1": "string",
            "address_2": null,
            "recipient": "STY Logistique Internationale",
            "zipcode": "74130",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        },
        "type": {
            "id": 0,
            "name": "Palette 100*120",
            "is_container": false
        },
        "freight_unit_key": null,
        "product_type_name": null,
        "spec_name": null
    }]
},{
    "id": 2,
    "name": null,
    "internal_ref": "FU key2",
    "contents": [{
        "id": 0,
        "type_id": 0,
        "spec_id": null,
        "product_type_id": null,
        "quantity": 2,
        "length": 60,
        "width": 30,
        "height": 30,
        "weight": 0,
        "comment": null,
        "internal_ref": null,
        "is_dangerous": false,
        "is_stacked": false,
        "onu_code": null,
        "is_controlled_temperature": false,
        "from_address": null,
        "dest_address": null,
        "type": {
            "id": 0,
            "name": "Box 60 30 30",
            "is_container": false
        },
        "freight_unit_key": null,
        "product_type_name": null,
        "spec_name": null
    }]
}],
"tracking_details": {
    "id": 0,
    "position": 1,
    "type": "departure",
    "comment": "",
    "incident": null,
    "planned_date": "2022-05-19",
    "real_date": "2022-05-19",
    "planned_time": "11:45:00",
    "real_time": "09:53:00",
    "code": "STY0000",
    "address": {
        "id": 0,
        "type": "store",
        "name": "Paris STY",
        "country": "France",
        "city": "Paris",
        "address_1": "string",
        "address_2": null,
        "recipient": null,
        "zipcode": "75002",
        "state": "string",
        "phone_number": "+335291112233",
        "email": "test @ shiptify.com",
        "instructions": null,
        "country_code_alpha2": "FR",
        "internal_ref": null
    }
},
"timestamp": 1652950424,
"signature": "016bf8d82132c438f98b7e1faa8bce606b57d329ff991b0040a7fd95848088af",
"token": "0db5f2f676f5557bf0b753068fa49f0778fe0fb7a9bbf9f43086a2f4bb8c83b3718d45666813f596b1b65553668ab58d2141"
}
{
  "id": 0,
  "name": "string",
  "comment": "string",
  "internal_ref": null,
  "departure_date": "2023-02-15",
  "departure_time": "16:30:00",
  "arrival_date": "2023-02-17",
  "arrival_time": "18:00:00",
  "from_address": {
    "id": 0,
    "type": "head_office",
    "name": "Shiptify | Nantes",
    "country": "France",
    "city": "Nantes",
    "address_1": "string",
    "address_2": null,
    "recipient": "string",
    "zipcode": "string",
    "state": null,
    "phone_number": null,
    "email": null,
    "instructions": null,
    "country_code_alpha2": "FR",
    "internal_ref": null
  },
  "dest_address": {
    "id": 112762,
    "type": "other",
    "name": "string",
    "country": "France",
    "city": "Nantes",
    "address_1": "string",
    "address_2": null,
    "recipient": "string",
    "zipcode": "44000",
    "state": null,
    "phone_number": "string",
    "email": null,
    "instructions": null,
    "country_code_alpha2": "FR",
    "internal_ref": null
  },
  "pre_shipments": [
    {
      "id": 0,
      "name": "string",
      "shipping_date_from": "2023-02-15",
      "shipping_time_from": "16:30:00",
      "arrival_date_from": "2023-02-17",
      "arrival_time_from": "18:00:00",
      "total_volume": 0,
      "total_weight": 0,
      "total_linear_meters": 0,
      "from_address": {
        "id": 0,
        "type": "string",
        "name": "string",
        "country": "France",
        "city": "Nantes",
        "address_1": "string",
        "address_2": null,
        "recipient": "string",
        "zipcode": "44200",
        "state": null,
        "phone_number": null,
        "email": null,
        "instructions": null,
        "country_code_alpha2": "FR",
        "internal_ref": null
      },
      "dest_address": {
        "id": 0,
        "type": "other",
        "name": "string",
        "country": "France",
        "city": "Nantes",
        "address_1": "string",
        "address_2": null,
        "recipient": "string",
        "zipcode": "44000",
        "state": null,
        "phone_number": "string",
        "email": null,
        "instructions": null,
        "country_code_alpha2": "FR",
        "internal_ref": null
      },
      "purchase": "",
      "sales": ""
    }
  ],
  "quote_requests": [
    {
      "currency": "EUR",
      "mode": { "id": 3, "name": "Road" },
      "price_details": [
        { "name": "string", "price": 0 },
        { "name": "string", "price": 0 },
        { "name": "string", "price": 0 },
      ]
    }
  ],
  "shipper": { "id": 0, "name": "string" },
  "event_type": "create_shipment_request",
  "timestamp": 1676019951,
  "signature": "string",
  "token": "string"
}
{
    "id": 0,
    "shipper_id": 0,
    "carrier_id": 0,
    "status": "planned",
    "tracking_code": null,
    "name": "string",
    "container_name": null,
    "quote_request_id": 0,
    "estimated_departure": "2022-01-27T02:00:00.000Z",
    "real_departure": null,
    "is_full_day_departure": false,
    "estimated_arrival": "2021-12-15T23:00:00.000Z",
    "real_arrival": null,
    "is_full_day_arrival": false,
    "total_volume": 0,
    "total_weight": 0,
    "total_linear_meters": 0,
    "from_address": {
        "id": 0,
        "type": "string",
        "name": "string",
        "country": "string",
        "city": "string",
        "address_1": "string",
        "address_2": null,
        "recipient": "string",
        "zipcode": "string",
        "state": null,
        "phone_number": "string",
        "email": null,
        "instructions": null,
        "country_code_alpha2": "FR",
        "internal_ref": null
    },
    "dest_address": {
        "id": 0,
        "type": "string",
        "name": "string",
        "country": "string",
        "city": "string",
        "address_1": "string",
        "address_2": null,
        "recipient": "string",
        "zipcode": "string",
        "state": null,
        "phone_number": "string",
        "email": null,
        "instructions": null,
        "country_code_alpha2": "FR",
        "internal_ref": null
    },
    "contents": [{
        "id": 0,
        "type_id": 0,
        "spec_id": 0,
        "product_type_id": 0,
        "quantity": 0,
        "length": 0,
        "width": 0,
        "height": 0,
        "weight": 0,
        "comment": "string",
        "internal_ref": null,
        "is_dangerous": true,
        "is_stacked": true,
        "onu_code": null,
        "is_controlled_temperature": false,
        "from_address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": null,
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": null,
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        },
        "dest_address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": "string",
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": "string"
        },
        "type": {
            "id": 0,
            "name": "string",
            "is_container": false
        },
        "freight_unit_key": "string",
        "product_type_name": "string",
        "spec_name": "string"
    }],
    "incoterms": {
        "purchase": "",
        "sales": ""
    },
    "routing_details": [],
    "shipment_request": {
        "id": 0,
        "name": "string",
        "comment": "",
        "internal_ref": null,
        "departure_date": "2022-01-21",
        "departure_time": "12:30:00",
        "arrival_date": "2022-01-28",
        "arrival_time": "13:00:00",
        "from_address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        },
        "dest_address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        }
    },
    "shipment_mode": {
        "id": 3,
        "name": "Road"
    },
    "tracking_points": [{
        "id": 0,
        "position": 10000,
        "type": "arrival",
        "comment": null,
        "incident": null,
        "planned_date": "2021-12-15",
        "real_date": null,
        "planned_time": "23:00:00",
        "real_time": null,
        "code": "STY9999",
        "address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        }
    }, {
        "id": 0,
        "position": 0,
        "type": "departure",
        "comment": "",
        "incident": null,
        "planned_date": "2022-01-27",
        "real_date": null,
        "planned_time": "02:00:00",
        "real_time": "13:32:00",
        "code": "STY0000",
        "address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        }
    }],
    "shipper": {
        "id": 0,
        "name":  "string"
    },
    "event_type": "create_shipment",
    "timestamp": 1643117545594,
    "signature": "string",
    "token": "string"
}
{
    "id": 0,
    "shipper_id": 0,
    "carrier_id": 0,
    "status": "planned",
    "tracking_code": null,
    "name": "string",
    "container_name": null,
    "quote_request_id": 0,
    "estimated_departure": "2022-01-27T02:00:00.000Z",
    "real_departure": null,
    "is_full_day_departure": false,
    "estimated_arrival": "2021-12-15T23:00:00.000Z",
    "real_arrival": null,
    "is_full_day_arrival": false,
    "shipment_mode": {
        "id": 3,
        "name": "Road"
    },
    "updated_tracking_point_id": 0,
    "tracking_points": [{
        "id": 0,
        "position": 10000,
        "type": "arrival",
        "comment": null,
        "incident": null,
        "planned_date": "2021-12-15",
        "real_date": null,
        "planned_time": "23:00:00",
        "real_time": null,
        "code": "STY9999",
        "address": {
            "id": 0,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        }
    }, {
        "id": 0,
        "position": 0,
        "type": "departure",
        "comment": "",
        "incident": null,
        "planned_date": "2022-01-27",
        "real_date": null,
        "planned_time": "02:00:00",
        "real_time": "13:32:00",
        "code": "STY0000",
        "address": {
            "id": 42920,
            "type": "string",
            "name": "string",
            "country": "string",
            "city": "string",
            "address_1": "string",
            "address_2": null,
            "recipient": "string",
            "zipcode": "string",
            "state": null,
            "phone_number": "string",
            "email": null,
            "instructions": null,
            "country_code_alpha2": "FR",
            "internal_ref": null
        }
    }],
    "shipper": {
        "id": 0,
        "name": "string"
    },
    "event_type": "update_tracking",
    "timestamp": 1643117544684,
    "signature": "string",
    "token": "string"
}
{
  "shipment_id": 123456,
  "sh_request_id": 45678,
  "attachment_id": 12345,
  "doc_type": "proof_of_delivery",
  "file_name": "XXXXXXXXXX",
  "status": "active",
  "event_type": "upload_shipment_attachment",
  "timestamp": 1694503397,
  "signature": "string",
  "token": "string"
}
Freight Unit Carrier Payload
Freight Unit Update Carrier Payload
Freight Unit Tracking Carrier Payload
Shipment Request Carrier Payload
Shipment Carrier Payload
Tracking Carrier Payload
Document Carrier Payload