CreateJob. fields required?

In CreateJob service, we see

pickUp.accesCode.code, pickUp.accesCode.type dropoff.accesCode.code and dropoff.accesCode.tpye are required,
but in your example we dont see this field.

Why? is required ? and What value do we have to put in those fields?

Example:

Request

{
“job”: {
“assignment_code”: “ACC861MM”,
“pickups”: [
{
“address”: “12 rue rivoli, 75001 Paris”,
“comment”: “Ask Bobby”,
“contact”: {
“firstname”: “Bobby”,
“lastname”: “Brown”,
“phone”: “+33610101010”,
“email”: “email”,
“company”: “Pizza Hut”
}
}
],
“dropoffs”: [
{
“package_type”: “small”,
“package_description”: “The blue one.”,
“client_reference”: “Order_ID#1234_1”,
“address”: “42 rue rivoli, 75001 Paris”,
“comment”: “2nd floor on the left”,
“contact”: {
“firstname”: “Dany”,
“lastname”: “Dan”,
“phone”: “+33611112222”,
“email”: “email”,
“company”: “Sample Company Inc.”
}
},
{
“package_type”: “large”,
“package_description”: “The red one.”,
“client_reference”: “Order_ID#1234_2”,
“address”: “6 Place des Vosges, 75004 Paris”,
“contact”: {
“firstname”: “John”,
“lastname”: “Doe”,
“phone”: “+33611111111”,
“email”: “email”,
“company”: “Sample Company Inc.”
}
},
{
“package_type”: “xlarge”,
“package_description”: “The yellow one.”,
“client_reference”: “Order_ID#1234_3”,
“address”: “6 Passage Thiéré, 75011 Paris”,
“comment”: “3nd floor on the right”,
“contact”: {
“firstname”: “Julia”,
“lastname”: “Moore”,
“phone”: “+33712222222”,
“email”: “email”,
“company”: “Sample Company Inc.”
}
}
]
}
}

Response

{
“id”: 108477,
“created_at”: “2018-08-29T11:11:54.075+02:00”,
“status”: “searching”,
“package_type”: “xlarge”,
“transport_type”: null,
“assignment_code”: “ACC861MM”,
“dropoff_at”: null,
“pickup_at”: null,
“ended_at”: null,
“comment”: null,
“distance”: 3.966,
“duration”: 18,
“traveled_time”: 0,
“traveled_distance”: 0,
“deliveries”: [
{
“id”: 108598,
“status”: “pending”,
“picked_at”: null,
“delivered_at”: null,
“tracking_url”: “XXXX”,
“client_reference”: “Order_ID#1234_1”,
“package_description”: “The blue one.”,
“package_type”: “small”,
“package_image_url”: null,
“pickup”: {
“id”: 1303367,
“latitude”: 48.8556174,
“longitude”: 2.3600226,
“comment”: “Ask Bobby”,
“address”: {
“street”: “12 Rue de Rivoli”,
“postcode”: “75004”,
“city”: “Paris”,
“zone”: “paris”,
“country”: “France”,
“formatted_address”: “12 Rue de Rivoli, 75004, Paris, France”
},
“contact”: {
“firstname”: “Bobby”,
“lastname”: “Brown”,
“company_name”: “Pizza Hut”,
“phone”: “+33610101010”,
“email”: “email”
},
“access_codes”: []
},
“dropoff”: {
“id”: 1303368,
“latitude”: 48.8566201,
“longitude”: 2.3558751,
“comment”: “2nd floor on the left”,
“address”: {
“street”: “42 Rue de Rivoli”,
“postcode”: “75004”,
“city”: “Paris”,
“zone”: “paris”,
“country”: “France”,
“formatted_address”: “42 Rue de Rivoli, 75004, Paris, France”
},
“contact”: {
“firstname”: “Dany”,
“lastname”: “Dan”,
“company_name”: “Sample Company Inc.”,
“phone”: “+33611112222”,
“email”: “email”
},
“access_codes”: []
},
“cancellation”: {
“canceled_by”: null,
“reason_key”: null,
“comment”: null
},
“eta”: {
“pickup”: null,
“dropoff”: null
},
“proof”: {
“signature_url”: null
}
},
{
“id”: 108599,
“status”: “pending”,
“picked_at”: null,
“delivered_at”: null,
“tracking_url”: “url”,
“client_reference”: “Order_ID#1234_2”,
“package_description”: “The red one.”,
“package_type”: “large”,
“package_image_url”: null,
“pickup”: {
“id”: 1303367,
“latitude”: 48.8556174,
“longitude”: 2.3600226,
“comment”: “Ask Bobby”,
“address”: {
“street”: “12 Rue de Rivoli”,
“postcode”: “75004”,
“city”: “Paris”,
“zone”: “paris”,
“country”: “France”,
“formatted_address”: “12 Rue de Rivoli, 75004, Paris, France”
},
“contact”: {
“firstname”: “Bobby”,
“lastname”: “Brown”,
“company_name”: “Pizza Hut”,
“phone”: “+33610101010”,
“email”: “email”
},
“access_codes”: []
},
“dropoff”: {
“id”: 1303369,
“latitude”: 48.8548288,
“longitude”: 2.3660836,
“comment”: null,
“address”: {
“street”: “6 Place des Vosges”,
“postcode”: “75004”,
“city”: “Paris”,
“zone”: “paris”,
“country”: “France”,
“formatted_address”: “6 Place des Vosges, 75004, Paris, France”
},
“contact”: {
“firstname”: “John”,
“lastname”: “Doe”,
“company_name”: “Sample Company Inc.”,
“phone”: “+33611111111”,
“email”: “email”
},
“access_codes”: []
},
“cancellation”: {
“canceled_by”: null,
“reason_key”: null,
“comment”: null
},
“eta”: {
“pickup”: null,
“dropoff”: null
},
“proof”: {
“signature_url”: null
}
},
{
“id”: 108600,
“status”: “pending”,
“picked_at”: null,
“delivered_at”: null,
“tracking_url”: “url”,
“client_reference”: “Order_ID#1234_3”,
“package_description”: “The yellow one.”,
“package_type”: “xlarge”,
“package_image_url”: null,
“pickup”: {
“id”: 1303367,
“latitude”: 48.8556174,
“longitude”: 2.3600226,
“comment”: “Ask Bobby”,
“address”: {
“street”: “12 Rue de Rivoli”,
“postcode”: “75004”,
“city”: “Paris”,
“zone”: “paris”,
“country”: “France”,
“formatted_address”: “12 Rue de Rivoli, 75004, Paris, France”
},
“contact”: {
“firstname”: “Bobby”,
“lastname”: “Brown”,
“company_name”: “Pizza Hut”,
“phone”: “+33610101010”,
“email”: “email”
},
“access_codes”: []
},
“dropoff”: {
“id”: 1303370,
“latitude”: 48.8535609,
“longitude”: 2.3747677,
“comment”: “3nd floor on the right”,
“address”: {
“street”: “6 Passage Thiéré”,
“postcode”: “75011”,
“city”: “Paris”,
“zone”: “paris”,
“country”: “France”,
“formatted_address”: “6 Passage Thiéré, 75011, Paris, France”
},
“contact”: {
“firstname”: “Julia”,
“lastname”: “Moore”,
“company_name”: “Sample Company Inc.”,
“phone”: “+33712222222”,
“email”: “email”
},
“access_codes”: []
},
“cancellation”: {
“canceled_by”: null,
“reason_key”: null,
“comment”: null
},
“eta”: {
“pickup”: null,
“dropoff”: null
},
“proof”: {
“signature_url”: null
}
}
],
“driver”: null,
“pricing”: {
“currency”: “EUR”,
“tax_percentage”: 0.2,
“price_tax_included”: 41.88,
“price_tax_excluded”: 34.9,
“tax_amount”: 6.98,
“invoice_url”: null
},
“rating”: null
}

Hey Carlos,

access_codes is an optional field, as documented here.

access_codes is an array, that is optional as you can see here :point_up:. code and type are required only if you decide to specify access_codes.

Best