Overview:
The JSON structure outlined in this doc can be used to ingest customer defined item lists as part of a full survey or inventory of a move. This can include both furniture and packing materials. This doc outlines the necessary data structure that must be adhered to in order to properly ingest this. This is an addendum to the main Developer API endpoint and the Developer API - Add Survey payloads.
Prerequisites:
Developer API Endpoint:
- The Developer API must be configured. Please see main Developer API Endpoint for more details.
- Payloads must have lead information and survey information, you can not submit survey information alone to this endpoint.
Developer API - Add Survey Endpoint:
- The Developer API - Add Survey Endpoint must be configured in the lead provider portal. Please see Developer API - Add Survey Endpoint for more details.
- Payload must have project_uuid or customer_email within the payload.
How to Debug Survey Processing:
Please see Debugging Inbound Leads - Link. Survey processing logs will be surfaced within the associated endpoints.
Overall Survey Structure:
"survey":[
{
"name": "Living Room",
"description": "Large room with fireplace.",
"items": [
{
"name": "Dishpack",
"description": "PBO Dishpack. This is a example packing material cost",
"take_count": 2,
"weight": 400,
"volume": 57,
"price": 1150
},
{
"name": "Yellow Chair",
"description": "Very scratched up.",
"take_count": 2,
"volume": 2000
},
{
"name": "Media Console",
"description": "Mid Mod",
"take_count": 1
}
]
},
{
"name": "Master Bedroom",
"description": "Straight back on the right",
"items": [
{
"name": "King bed frame",
"description": "from IKEA",
"take_count": 1
},
{
"name": "dressers",
"description": "from IKEA",
"take_count": 2
}
]
}
]
| Property | Data Type | Description |
|---|---|---|
| "survey" | array of collection objects | Required - A collection is synonymous with a room and contains details about each location. Please see blow section for more details. |
Collection Object:
{
"name": "Living Room",
"description": "Large room with fireplace.",
"items": [
{
"name": "Dishpack",
"description": "PBO Dishpack. This is a example packing material cost",
"take_count": 2,
"weight": 400,
"volume": 57,
"price": 1150
},
{
"name": "Yellow Chair",
"description": "Very scratched up.",
"take_count": 2,
"volume": 2000
},
{
"name": "Media Console",
"description": "Mid Mod",
"take_count": 1
}
]
},| Property | Data Type | Description |
|---|---|---|
| "name" | string | Required - Each collection must have a name. |
| "description" | string | Required - Please provide a description of the room or type of collection. |
| "items" | array of item objects | Important - Must have at least 1 item in each collection object. |
Item Object:
{
"name": "Dishpack",
"description": "PBO Dishpack. This is a example packing material cost",
"take_count": 2,
"weight": 400,
"volume": 57,
"price": 1150
}| Property | Data Type | Description |
|---|---|---|
| "name" | string | Required - Each item must have a name. The name can describe the piece of furniture, an item, OR a packing material. If a packing material is added, please ensure take_count and price are added in order to calculate the the material costs as part of the final bill. |
| "description" | string | Details on the item itself. |
| "take_count" | integer | Important - The number of these items being moved or utilized. This is used to as the quantity of materials for calculating the final cost of on a bill. |
| "weight" | integer | The associated weight of the item. Will be used to calculate the weight of the move across all items in the survey. |
| "volume" | integer | The estimated volume of the item. Will be used to calculate the volume of the move based on all items in the total survey. |
| "price" | integer | Important - The cost of the material being supplied. Any item with associated price and take_count will automatically be added to the bill when using this survey to calculate material costs. |
Comments
0 comments
Please sign in to leave a comment.