{"info":{"_postman_id":"47abce88-2a88-4fa7-ac11-961e8f82f232","name":"Picup API Integration","description":"<html><head></head><body><p>Picup uses dedicated API tokens, passed over HTTP basic auth, to authenticate users.</p>\n<p>You'll find this set up in a global variable here for the ‘Integration Company’, a sandbox environment open for you to test in our QA environment.</p>\n<p>This is loaded as an API request header as follows:<br>Header Name: api-key<br>Header Value: business-7c8350fa-0393-4c58-ba0c-3e547bf8834f (or your sandbox api-key)</p>\n<p>You can use a variety of (desktop or web-based) tools to test the API. A quick way to do it is through the command-line tool cURL. For more information on using cURL to run these calls, please see <a href=\"https://www.baeldung.com/curl-rest\">using cURL</a>.</p>\n<p>Successfully created orders are viewable on the sandbox/QA dashboard.</p>\n<p>URL: <a href=\"https://staging.picup.co.za\">https://staging.picup.co.za</a><br>Email Address: <a href=\"https://mailto:integrator@picup.co.za\">integrator@picup.co.za</a><br>Password: integration!</p>\n<p>Your orders will be viewable in the menu on the left under the ‘Post Dispatch’ menu, or in 'Buckets'.</p>\n<p><strong>Tracking and Order Updates</strong><br>Tracking and order updates are to be sent via generic webhook structure.<br>Details can be found using the following link:</p>\n<p><a href=\"https://drive.google.com/file/d/12JdpCa-7LoQTLWeO83RjN-rSSIrCHrwL/view?usp=sharing\">Integration Document</a></p>\n<p>Should you have any questions, please don't hesitate to contact us at <a href=\"https://mailto:info@picup.co.za\">info@picup.co.za</a></p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"627616","collectionId":"47abce88-2a88-4fa7-ac11-961e8f82f232","publishedId":"RWTeW2ju","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-26T09:46:07.000Z"},"item":[{"name":"Business Details","event":[{"listen":"test","script":{"id":"9023a714-0407-475a-99a0-8ca5abefa901","exec":["pm.test(\"Status code is 200\", function () {","    pm.response.to.have.status(200);","});","","pm.test(\"Is Key Valid\", function () {","    var jsonData = pm.response.json();","    pm.expect(jsonData.is_key_valid).to.eql(true);","});"],"type":"text/javascript"}}],"id":"2a39bd31-036d-445c-b592-ac6c708ba0af","request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{business-id}}"}],"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/details","description":"<p>The Business Details call is a simple call, often useful to test your settings. When successful, this call will return your authorization request, as well as our standard <code>parcel sizes</code>.</p>\n<p>This can also be used to retrieve your <code>warehouse_id</code> after adding one in the Picup UI for your business. Our example business shows a <code>warehouse_name</code> and <code>warehouse_id</code>.</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{business-id}}","details"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"3e1ca969-92c0-4daf-a413-254707a3b44a","name":"Business Details","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{business-id}}"}],"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 27 Mar 2020 13:44:19 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_key_valid\": true,\n    \"is_key_valid_message\": \"Your key is valid\",\n    \"warehouses\": [\n        {\n            \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\",\n            \"warehouse_name\": \"Cape Town Depot\"\n        }\n    ],\n    \"parcel_sizes\": [\n        {\n            \"display_name\": \"Extra Large\",\n            \"parcel_id\": \"parcel-xlarge\",\n            \"dimensions\": {\n                \"height\": 300,\n                \"width\": 150,\n                \"length\": 280\n            },\n            \"weight\": 20\n        },\n        {\n            \"display_name\": \"Small\",\n            \"parcel_id\": \"parcel-small\",\n            \"dimensions\": {\n                \"height\": 30,\n                \"width\": 15,\n                \"length\": 35\n            },\n            \"weight\": 2\n        },\n        {\n            \"display_name\": \"Medium\",\n            \"parcel_id\": \"parcel-medium\",\n            \"dimensions\": {\n                \"height\": 100,\n                \"width\": 75,\n                \"length\": 100\n            },\n            \"weight\": 5\n        },\n        {\n            \"display_name\": \"Large\",\n            \"parcel_id\": \"parcel-large\",\n            \"dimensions\": {\n                \"height\": 150,\n                \"width\": 95,\n                \"length\": 180\n            },\n            \"weight\": 10\n        },\n        {\n            \"display_name\": \"A4 Envelope\",\n            \"parcel_id\": \"parcel-a4-envelope\",\n            \"dimensions\": {\n                \"height\": 6,\n                \"width\": 3,\n                \"length\": 8\n            },\n            \"weight\": 0\n        }\n    ]\n}"}],"_postman_id":"2a39bd31-036d-445c-b592-ac6c708ba0af"},{"name":"Quote One-to-Many","event":[{"listen":"test","script":{"id":"52b1c876-3820-4ac7-a3a9-6732917a59d4","exec":["pm.test(\"Status code is 200\", function () {","    pm.response.to.have.status(200);","});","","pm.test(\"Picup Quote Received\", function () {","    var jsonData = pm.response.json();","    pm.expect(jsonData.picup.service_types).length > 0;","});"],"type":"text/javascript"}}],"id":"51d9c32f-3808-41f4-9e84-4f4497701bf3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"api-key","type":"text","value":"business-7c8350fa-0393-4c58-ba0c-3e547bf8834f"}],"body":{"mode":"raw","raw":"{\n    \"customer_ref\": \"Quote Example New\",\n    \"is_for_contract_driver\": false,\n    \"scheduled_date\": \"2022-11-22T13:17:11.680476Z\",\n    \"courier_costing\": \"COL\",\n    \"sender\": {\n        \"address\": {\n            \"warehouse_id\": null,\n            \"unit_no\": null,\n            \"complex\": \"Picup Technologies\",\n            \"street_or_farm_no\": 6,\n            \"street_or_farm\": \"Beach Road, \",\n            \"suburb\": \"Woodstock\",\n            \"city\": \"Cape Town\",\n            \"postal_code\": \"7915\",\n            \"country\": \"South Africa\"\n        },\n        \"contact\": {\n            \"name\": \"Sender Contact Name\",\n            \"email\": \"quotetest@example.com\",\n            \"cellphone\": \"0211234567\"\n        },\n        \"special_instructions\": \"Use back door\"\n    },\n    \"receivers\": [\n        {\n            \"address\": {\n                \"unit_no\": null,\n                \"complex\": null,\n                \"street_or_farm_no\": null,\n                \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                \"suburb\": null,\n                \"city\": \"cape town\",\n                \"postal_code\": null,\n                \"country\": null,\n                \"latitude\": null,\n                \"longitude\": null\n            },\n            \"contact\": {\n                \"name\": \"Test\",\n                \"email\": \"123@email.com\",\n                \"cellphone\": \"0211111234\"\n            },\n            \"special_instructions\": \"Mind the dog\",\n            \"parcels\": [\n                {\n                    \"size\": \"parcel-small\",\n                    \"reference\": \"quote-ref\",\n                    \"tracking_number\": null\n                }\n            ]\n        }\n    ],\n    \"optimize_waypoints\": true\n}"},"url":"{{picup-url}}/{{picup-version}}/integration/quote/one-to-many","description":"<p>The <code>Quote One-to-Many</code> call takes in a sender object and an <code>array</code> of receivers, with a contact and address. The body of our example is a quote for a request from <em>6 Beach Rd, Woodstock, Cape Town, 7915, South Africa</em> to <em>62 Greatmore St, Woodstock, Cape Town, 7915, South Africa</em>. The response received from this example call includes: </p>\n<ul>\n<li>Request</li>\n<li>Picup</li>\n<li>Third Party</li>\n</ul>\n<p>The <em>Request</em> object returns the geocoded addresses for both the sender and receiver, as well as any contact details received. The trip details are included.</p>\n<p>The <em>Picup</em> object returns the various service types offered by Picup. This takes into account the sizes of the parcels and the valid vehicle type to be used, as well as the prices associated with each. </p>\n<p>Should your company use national deliveries and have integrated with Picup TMS, you will also have access to <em>Third Party</em> costings, showing the prices offered from our integrated courier partners.</p>\n","urlObject":{"path":["{{picup-version}}","integration","quote","one-to-many"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"19fc583c-f2fe-4129-9fd7-14b75a036931","name":"Quote One-to-Many","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"business-7c8350fa-0393-4c58-ba0c-3e547bf8834f","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"customer_ref\": \"Quote Example New\",\n    \"is_for_contract_driver\": false,\n    \"scheduled_date\": \"2022-11-22T13:17:11.680476Z\",\n    \"courier_costing\": \"ALL\",\n    \"sender\": {\n        \"address\": {\n            \"warehouse_id\": null,\n            \"unit_no\": null,\n            \"complex\": \"Picup Technologies\",\n            \"street_or_farm_no\": 6,\n            \"street_or_farm\": \"Beach Road, \",\n            \"suburb\": \"Woodstock\",\n            \"city\": \"Cape Town\",\n            \"postal_code\": \"7915\",\n            \"country\": \"South Africa\",\n            \"latitude\": -33.9247137,\n            \"longitude\": 18.4487146,\n            //formatted_address must be comma delimited with at least 2 parts\n            \"formatted_address\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\"\n        },\n        \"contact\": {\n            \"name\": \"Sender Contact Name\",\n            \"email\": \"quotetest@example.com\",\n            \"cellphone\": \"0211234567\"\n        },\n        \"special_instructions\": \"Use back door\"\n    },\n    \"receivers\": [\n        {\n            \"address\": {\n                \"unit_no\": null,\n                \"complex\": null,\n                \"street_or_farm_no\": null,\n                \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                \"suburb\": null,\n                \"city\": \"cape town\",\n                \"postal_code\": null,\n                \"country\": null,\n                \"latitude\": null,\n                \"longitude\": null\n            },\n            \"contact\": {\n                \"name\": \"Test\",\n                \"email\": \"123@email.com\",\n                \"cellphone\": \"0211111234\"\n            },\n            \"special_instructions\": \"Mind the dog\",\n            \"parcels\": [\n                {\n                    \"size\": \"parcel-small\",\n                    \"reference\": \"quote-ref\",\n                    \"tracking_number\": null\n                }\n            ]\n        }\n    ],\n    \"optimize_waypoints\": true\n}"},"url":"https://picupstaging-webapi.azurewebsites.net/v1/integration/quote/one-to-many"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 27 Mar 2020 14:48:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"request\": {\n        \"receivers\": [\n            {\n                \"parcels\": [\n                    {\n                        \"reference\": \"quote-ref\",\n                        \"size\": \"parcel-small\",\n                        \"length\": null,\n                        \"width\": null,\n                        \"height\": null,\n                        \"weight\": null\n                    }\n                ],\n                \"address\": {\n                    \"warehouse_id\": null,\n                    \"unit_no\": null,\n                    \"complex\": null,\n                    \"street_or_farm_no\": null,\n                    \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                    \"suburb\": null,\n                    \"city\": \"cape town\",\n                    \"postal_code\": null,\n                    \"country\": null,\n                    \"latitude\": -33.9292364,\n                    \"longitude\": 18.4545767,\n                    \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\"\n                },\n                \"contact\": {\n                    \"name\": \"Test\",\n                    \"email\": \"123@email.com\",\n                    \"telephone\": null,\n                    \"cellphone\": \"0211111234\"\n                },\n                \"special_instructions\": \"Mind the dog\"\n            }\n        ],\n        \"to_cancel_picup_ids\": null,\n        \"ApiMethod\": null,\n        \"business_id\": \"business-7c8350fa-0393-4c58-ba0c-3e547bf8834f\",\n        \"user_id\": null,\n        \"sender\": {\n            \"address\": {\n                \"warehouse_id\": null,\n                \"unit_no\": null,\n                \"complex\": \"Picup Technologies\",\n                \"street_or_farm_no\": \"6\",\n                \"street_or_farm\": \"Beach Road, \",\n                \"suburb\": \"Woodstock\",\n                \"city\": \"Cape Town\",\n                \"postal_code\": \"7915\",\n                \"country\": \"South Africa\",\n                \"latitude\": -33.9247137,\n                \"longitude\": 18.4487146,\n                \"formatted_address\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\"\n            },\n            \"contact\": {\n                \"name\": \"Sender Contact Name\",\n                \"email\": \"quotetest@example.com\",\n                \"telephone\": null,\n                \"cellphone\": \"0211234567\"\n            },\n            \"special_instructions\": \"Use back door\"\n        },\n        \"customer_ref\": \"Quote Example New\",\n        \"is_pre_assign_tracking_number\": false,\n        \"merchant_id\": \"merchant-d827f668-d434-4ce5-b853-878f874ae746\",\n        \"vehicle_id\": null,\n        \"is_for_contract_driver\": false,\n        \"is_round_trip\": false,\n        \"optimize_waypoints\": true,\n        \"scheduled_date\": \"2022-11-22T13:17:11.680476Z\",\n        \"courier_costing\": \"ALL\",\n        \"payment_type\": 4\n    },\n    \"picup\": {\n        \"valid\": true,\n        \"error\": null,\n        \"service_types\": [\n            {\n                \"description\": \"vehicle-motorcycle\",\n                \"price_incl_vat\": 66.23,\n                \"price_ex_vat\": 57.59,\n                \"distance\": 1.18,\n                \"duration\": \"00:13:20\"\n            },\n            {\n                \"description\": \"vehicle-car\",\n                \"price_incl_vat\": 87.37,\n                \"price_ex_vat\": 75.97,\n                \"distance\": 1.18,\n                \"duration\": \"00:13:20\"\n            }\n        ]\n    },\n    \"third_party\": {\n        \"valid\": true,\n        \"error\": null,\n        \"fullfillment_options\": [\n            {\n                \"description\": \"Cheapest\",\n                \"price_incl_vat\": 73.416,\n                \"price_ex_vat\": 63.84,\n                \"collected_before\": \"2022-11-22T13:17:11Z\",\n                \"delivered_before\": \"2022-11-23T14:00:00Z\",\n                \"collections\": [\n                    {\n                        \"collection\": {\n                            \"bucket_id\": null,\n                            \"collection_date\": \"2022-11-22T13:17:11Z\",\n                            \"collection_start_time\": \"00:00:00\",\n                            \"collection_end_time\": \"00:00:00\",\n                            \"delivery_date\": \"2022-11-23T14:00:00Z\",\n                            \"collection_reference\": \"Quote Example New\",\n                            \"business_id\": \"business-7c8350fa-0393-4c58-ba0c-3e547bf8834f\",\n                            \"user_id\": null,\n                            \"warehouse_id\": null,\n                            \"waybill\": {\n                                \"order_id\": null,\n                                \"waybill_number\": \"Quote Example New\",\n                                \"courier_order_id\": \"courierorder-46316a82-d265-4028-875d-e967a3e5092a\",\n                                \"customer_reference\": \"Quote Example New\",\n                                \"business_reference\": \"Quote Example New\",\n                                \"courier_code\": null,\n                                \"courier_service_type\": null,\n                                \"service_type\": null,\n                                \"price\": null,\n                                \"reconciled_price\": null,\n                                \"origin\": {\n                                    \"address_line_1\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\",\n                                    \"address_line_2\": null,\n                                    \"address_line_3\": null,\n                                    \"address_line_4\": null,\n                                    \"suburb\": \"Woodstock\",\n                                    \"postal_code\": \"7915\",\n                                    \"latitude\": -33.9247137,\n                                    \"longitude\": 18.4487146,\n                                    \"customer_name\": \"Sender Contact Name\",\n                                    \"customer_phone\": \"0211234567\",\n                                    \"customer_email\": \"quotetest@example.com\",\n                                    \"special_instructions\": \"Use back door\",\n                                    \"geocoded_address\": null\n                                },\n                                \"destination\": {\n                                    \"address_line_1\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                                    \"address_line_2\": null,\n                                    \"address_line_3\": null,\n                                    \"address_line_4\": null,\n                                    \"suburb\": \"cape town\",\n                                    \"postal_code\": null,\n                                    \"latitude\": -33.9292364,\n                                    \"longitude\": 18.4545767,\n                                    \"customer_name\": \"Test\",\n                                    \"customer_phone\": \"0211111234\",\n                                    \"customer_email\": \"123@email.com\",\n                                    \"special_instructions\": \"Mind the dog\",\n                                    \"geocoded_address\": null\n                                },\n                                \"parcels\": [\n                                    {\n                                        \"tracking_number\": null,\n                                        \"parcel_id\": null,\n                                        \"description\": \"quote-ref\",\n                                        \"length\": 20,\n                                        \"width\": 20,\n                                        \"height\": 20,\n                                        \"mass\": 2,\n                                        \"status\": null\n                                    }\n                                ]\n                            }\n                        },\n                        \"courier_code\": \"COL\",\n                        \"service_type\": \"1\"\n                    }\n                ],\n                \"fullfillment_breakdown\": [\n                    {\n                        \"parcel_references\": [\n                            \"quote-ref\"\n                        ],\n                        \"service_type\": \"1\",\n                        \"courier_code\": \"COL\",\n                        \"price_incl_vat\": 73.416,\n                        \"price_ex_vat\": 63.84,\n                        \"collected_before\": \"2022-11-22T13:17:11Z\",\n                        \"delivered_before\": \"2022-11-23T14:00:00Z\"\n                    }\n                ]\n            },\n            {\n                \"description\": \"Fastest\",\n                \"price_incl_vat\": 73.416,\n                \"price_ex_vat\": 63.84,\n                \"collected_before\": \"2022-11-22T13:17:11Z\",\n                \"delivered_before\": \"2022-11-23T14:00:00Z\",\n                \"collections\": [\n                    {\n                        \"collection\": {\n                            \"bucket_id\": null,\n                            \"collection_date\": \"2022-11-22T13:17:11Z\",\n                            \"collection_start_time\": \"00:00:00\",\n                            \"collection_end_time\": \"00:00:00\",\n                            \"delivery_date\": \"2022-11-23T14:00:00Z\",\n                            \"collection_reference\": \"Quote Example New\",\n                            \"business_id\": \"business-7c8350fa-0393-4c58-ba0c-3e547bf8834f\",\n                            \"user_id\": null,\n                            \"warehouse_id\": null,\n                            \"waybill\": {\n                                \"order_id\": null,\n                                \"waybill_number\": \"Quote Example New\",\n                                \"courier_order_id\": \"courierorder-46316a82-d265-4028-875d-e967a3e5092a\",\n                                \"customer_reference\": \"Quote Example New\",\n                                \"business_reference\": \"Quote Example New\",\n                                \"courier_code\": null,\n                                \"courier_service_type\": null,\n                                \"service_type\": null,\n                                \"price\": null,\n                                \"reconciled_price\": null,\n                                \"origin\": {\n                                    \"address_line_1\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\",\n                                    \"address_line_2\": null,\n                                    \"address_line_3\": null,\n                                    \"address_line_4\": null,\n                                    \"suburb\": \"Woodstock\",\n                                    \"postal_code\": \"7915\",\n                                    \"latitude\": -33.9247137,\n                                    \"longitude\": 18.4487146,\n                                    \"customer_name\": \"Sender Contact Name\",\n                                    \"customer_phone\": \"0211234567\",\n                                    \"customer_email\": \"quotetest@example.com\",\n                                    \"special_instructions\": \"Use back door\",\n                                    \"geocoded_address\": null\n                                },\n                                \"destination\": {\n                                    \"address_line_1\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                                    \"address_line_2\": null,\n                                    \"address_line_3\": null,\n                                    \"address_line_4\": null,\n                                    \"suburb\": \"cape town\",\n                                    \"postal_code\": null,\n                                    \"latitude\": -33.9292364,\n                                    \"longitude\": 18.4545767,\n                                    \"customer_name\": \"Test\",\n                                    \"customer_phone\": \"0211111234\",\n                                    \"customer_email\": \"123@email.com\",\n                                    \"special_instructions\": \"Mind the dog\",\n                                    \"geocoded_address\": null\n                                },\n                                \"parcels\": [\n                                    {\n                                        \"tracking_number\": null,\n                                        \"parcel_id\": null,\n                                        \"description\": \"quote-ref\",\n                                        \"length\": 20,\n                                        \"width\": 20,\n                                        \"height\": 20,\n                                        \"mass\": 2,\n                                        \"status\": null\n                                    }\n                                ]\n                            }\n                        },\n                        \"courier_code\": \"COL\",\n                        \"service_type\": \"1\"\n                    }\n                ],\n                \"fullfillment_breakdown\": [\n                    {\n                        \"parcel_references\": [\n                            \"quote-ref\"\n                        ],\n                        \"service_type\": \"1\",\n                        \"courier_code\": \"COL\",\n                        \"price_incl_vat\": 73.416,\n                        \"price_ex_vat\": 63.84,\n                        \"collected_before\": \"2022-11-22T13:17:11Z\",\n                        \"delivered_before\": \"2022-11-23T14:00:00Z\"\n                    }\n                ]\n            }\n        ],\n        \"all_collection_prices\": [\n            {\n                \"collection\": {\n                    \"bucket_id\": null,\n                    \"collection_date\": \"2022-11-22T13:17:11Z\",\n                    \"collection_start_time\": \"00:00:00\",\n                    \"collection_end_time\": \"00:00:00\",\n                    \"delivery_date\": \"2022-11-23T14:00:00Z\",\n                    \"collection_reference\": \"Quote Example New\",\n                    \"business_id\": \"business-7c8350fa-0393-4c58-ba0c-3e547bf8834f\",\n                    \"user_id\": null,\n                    \"warehouse_id\": null,\n                    \"waybill\": {\n                        \"order_id\": null,\n                        \"waybill_number\": \"Quote Example New\",\n                        \"courier_order_id\": \"courierorder-46316a82-d265-4028-875d-e967a3e5092a\",\n                        \"customer_reference\": \"Quote Example New\",\n                        \"business_reference\": \"Quote Example New\",\n                        \"courier_code\": null,\n                        \"courier_service_type\": null,\n                        \"service_type\": null,\n                        \"price\": null,\n                        \"reconciled_price\": null,\n                        \"origin\": {\n                            \"address_line_1\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\",\n                            \"address_line_2\": null,\n                            \"address_line_3\": null,\n                            \"address_line_4\": null,\n                            \"suburb\": \"Woodstock\",\n                            \"postal_code\": \"7915\",\n                            \"latitude\": -33.9247137,\n                            \"longitude\": 18.4487146,\n                            \"customer_name\": \"Sender Contact Name\",\n                            \"customer_phone\": \"0211234567\",\n                            \"customer_email\": \"quotetest@example.com\",\n                            \"special_instructions\": \"Use back door\",\n                            \"geocoded_address\": null\n                        },\n                        \"destination\": {\n                            \"address_line_1\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                            \"address_line_2\": null,\n                            \"address_line_3\": null,\n                            \"address_line_4\": null,\n                            \"suburb\": \"cape town\",\n                            \"postal_code\": null,\n                            \"latitude\": -33.9292364,\n                            \"longitude\": 18.4545767,\n                            \"customer_name\": \"Test\",\n                            \"customer_phone\": \"0211111234\",\n                            \"customer_email\": \"123@email.com\",\n                            \"special_instructions\": \"Mind the dog\",\n                            \"geocoded_address\": null\n                        },\n                        \"parcels\": [\n                            {\n                                \"tracking_number\": null,\n                                \"parcel_id\": null,\n                                \"description\": \"quote-ref\",\n                                \"length\": 20,\n                                \"width\": 20,\n                                \"height\": 20,\n                                \"mass\": 2,\n                                \"status\": null\n                            }\n                        ]\n                    }\n                },\n                \"couriers\": [\n                    {\n                        \"courier\": 3,\n                        \"courier_code\": \"CST\",\n                        \"courier_name\": \"CitiSprint\",\n                        \"service_prices\": null,\n                        \"total_quotes\": 0,\n                        \"success\": false,\n                        \"internal_error\": true,\n                        \"error\": \"Index was outside the bounds of the array.\"\n                    },\n                    {\n                        \"courier\": 4,\n                        \"courier_code\": \"COL\",\n                        \"courier_name\": \"MDS / Collivery\",\n                        \"service_prices\": [\n                            {\n                                \"service_type\": \"1\",\n                                \"service_type_description\": \"Overnight before 10:00\",\n                                \"ex_vat\": 63.84,\n                                \"vat\": 9.576,\n                                \"inc_vat\": 73.416,\n                                \"deliver_date\": \"2022-11-23T14:00:00Z\",\n                                \"time_indicator\": 10,\n                                \"collection_time_unix_epoch\": 1669123031,\n                                \"delivery_time_unix_epoch\": 1669212000,\n                                \"success\": true,\n                                \"internal_error\": false,\n                                \"error\": null\n                            },\n                            {\n                                \"service_type\": \"2\",\n                                \"service_type_description\": \"Overnight before 16:00\",\n                                \"ex_vat\": 63.84,\n                                \"vat\": 9.576,\n                                \"inc_vat\": 73.416,\n                                \"deliver_date\": \"2022-11-23T14:00:00Z\",\n                                \"time_indicator\": 20,\n                                \"collection_time_unix_epoch\": 1669123031,\n                                \"delivery_time_unix_epoch\": 1669212000,\n                                \"success\": true,\n                                \"internal_error\": false,\n                                \"error\": null\n                            },\n                            {\n                                \"service_type\": \"3\",\n                                \"service_type_description\": \"Road Freight\",\n                                \"ex_vat\": 63.84,\n                                \"vat\": 9.576,\n                                \"inc_vat\": 73.416,\n                                \"deliver_date\": \"2022-11-23T14:00:00Z\",\n                                \"time_indicator\": 100,\n                                \"collection_time_unix_epoch\": 1669123031,\n                                \"delivery_time_unix_epoch\": 1669212000,\n                                \"success\": true,\n                                \"internal_error\": false,\n                                \"error\": null\n                            },\n                            {\n                                \"service_type\": \"5\",\n                                \"service_type_description\": \"Road Freight Express\",\n                                \"ex_vat\": 63.84,\n                                \"vat\": 9.576,\n                                \"inc_vat\": 73.416,\n                                \"deliver_date\": \"2022-11-23T14:00:00Z\",\n                                \"time_indicator\": 50,\n                                \"collection_time_unix_epoch\": 1669123031,\n                                \"delivery_time_unix_epoch\": 1669212000,\n                                \"success\": true,\n                                \"internal_error\": false,\n                                \"error\": null\n                            }\n                        ],\n                        \"total_quotes\": 4,\n                        \"success\": true,\n                        \"internal_error\": false,\n                        \"error\": null\n                    },\n                    {\n                        \"courier\": 1,\n                        \"courier_code\": \"DNW\",\n                        \"courier_name\": \"Dawnwing\",\n                        \"service_prices\": null,\n                        \"total_quotes\": 0,\n                        \"success\": false,\n                        \"internal_error\": false,\n                        \"error\": \"Not integrated yet.\"\n                    }\n                ],\n                \"total_quotes\": 4\n            }\n        ]\n    },\n    \"nearby_drivers\": [\n        {\n            \"driver_id\": \"driver-d864e3ff-a166-42fc-aa8a-4a6c1809e9ce\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 22,\n            \"duration\": \"00:00:07\"\n        },\n        {\n            \"driver_id\": \"driver-8510ddfd-0a2d-409b-90e4-4a48043b0605\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 1567,\n            \"duration\": \"00:05:02\"\n        },\n        {\n            \"driver_id\": \"driver-b1b7994c-07c8-4822-82be-1bab4dd47a0a\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 2046,\n            \"duration\": \"00:05:57\"\n        },\n        {\n            \"driver_id\": \"driver-927b8bfd-18db-4d9a-b668-330bf6df713e\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 2350,\n            \"duration\": \"00:04:43\"\n        },\n        {\n            \"driver_id\": \"driver-40925355-58a2-4e87-b3b5-e48a80ec5b37\",\n            \"vehicle_id\": \"vehicle-motorcycle\",\n            \"distance_in_meters\": 3754,\n            \"duration\": \"00:06:27\"\n        },\n        {\n            \"driver_id\": \"driver-a97009e9-c970-4e4c-a68a-673dc954ff6b\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 4079,\n            \"duration\": \"00:10:54\"\n        },\n        {\n            \"driver_id\": \"driver-324d339e-18b8-47af-a973-b697a4ba6db4\",\n            \"vehicle_id\": \"vehicle-motorcycle\",\n            \"distance_in_meters\": 4622,\n            \"duration\": \"00:08:41\"\n        },\n        {\n            \"driver_id\": \"driver-0d1ecc07-2a66-4246-8ba6-67e12771d086\",\n            \"vehicle_id\": \"vehicle-motorcycle\",\n            \"distance_in_meters\": 4809,\n            \"duration\": \"00:10:02\"\n        },\n        {\n            \"driver_id\": \"driver-869ca37e-6345-4ddd-bd67-26dc41769280\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 5024,\n            \"duration\": \"00:13:33\"\n        },\n        {\n            \"driver_id\": \"driver-94f93fbb-dc37-45b0-bcb4-2e314fd40828\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 5034,\n            \"duration\": \"00:13:11\"\n        },\n        {\n            \"driver_id\": \"driver-716045c0-14f8-475e-8252-40570f6f50de\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 5692,\n            \"duration\": \"00:10:46\"\n        },\n        {\n            \"driver_id\": \"driver-d864e3ff-a166-42fc-aa8a-4a6c1809e9ce\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 22,\n            \"duration\": \"00:00:07\"\n        },\n        {\n            \"driver_id\": \"driver-8510ddfd-0a2d-409b-90e4-4a48043b0605\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 1567,\n            \"duration\": \"00:05:02\"\n        },\n        {\n            \"driver_id\": \"driver-b1b7994c-07c8-4822-82be-1bab4dd47a0a\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 2046,\n            \"duration\": \"00:05:57\"\n        },\n        {\n            \"driver_id\": \"driver-927b8bfd-18db-4d9a-b668-330bf6df713e\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 2350,\n            \"duration\": \"00:04:43\"\n        },\n        {\n            \"driver_id\": \"driver-a97009e9-c970-4e4c-a68a-673dc954ff6b\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 4079,\n            \"duration\": \"00:10:54\"\n        },\n        {\n            \"driver_id\": \"driver-869ca37e-6345-4ddd-bd67-26dc41769280\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 5024,\n            \"duration\": \"00:13:33\"\n        },\n        {\n            \"driver_id\": \"driver-94f93fbb-dc37-45b0-bcb4-2e314fd40828\",\n            \"vehicle_id\": \"vehicle-small-van\",\n            \"distance_in_meters\": 5034,\n            \"duration\": \"00:13:11\"\n        },\n        {\n            \"driver_id\": \"driver-716045c0-14f8-475e-8252-40570f6f50de\",\n            \"vehicle_id\": \"vehicle-car\",\n            \"distance_in_meters\": 5692,\n            \"duration\": \"00:10:46\"\n        }\n    ]\n}"}],"_postman_id":"51d9c32f-3808-41f4-9e84-4f4497701bf3"},{"name":"Create One-to-Many (New)","event":[{"listen":"test","script":{"id":"ce60a14e-09a0-401b-97b1-3b9d21d99dc4","exec":["pm.test(\"Status code is 200\", function () {","    pm.response.to.have.status(200);","});","","pm.test(\"Body is correct\", function () {","    pm.expect(pm.response.text()).to.include(\"order_id\");","});","","pm.test(\"All parcels have valid business_reference\", () => pm.expect(pm.response.json().parcels.every(p => p.business_reference == \"unknown\")).to.be.false);","","pm.test(\"All parcels have valid customer_reference\", () => pm.expect(pm.response.json().parcels.every(p => p.customer_reference == \"unknown\")).to.be.false);","","","","","","",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"34edec96-d158-4319-8ec6-b0fc95543e7f","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"55b488af-e48d-437e-93d3-37b61ec5cd15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"<value>"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"receivers\": [\n        {\n            \"parcels\": [\n                {\n                    \"reference\": \"quote-ref\",\n                    \"size\": \"parcel-small\",\n                    \"length\": null,\n                    \"width\": null,\n                    \"height\": null,\n                    \"weight\": null\n                }\n            ],\n            \"address\": {\n                \"warehouse_id\": null,\n                \"unit_no\": null,\n                \"complex\": null,\n                \"street_or_farm_no\": null,\n                \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                \"suburb\": null,\n                \"city\": \"cape town\",\n                \"postal_code\": null,\n                \"country\": null,\n                \"latitude\": -33.9292364,\n                \"longitude\": 18.4545767,\n                //formatted_address must be comma delimited with at least 2 parts\n                \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\"\n            },\n            \"contact\": {\n                \"name\": \"Test\",\n                \"email\": \"123@em12ail.com\",\n                \"cellphone\": \"0211111234\"\n            },\n            \"special_instructions\": \"Mind the dog\"\n        }\n    ],\n    \"sender\": {\n        \"warehouse_id\": null,\n        \"address\": {\n            \"unit_no\": null,\n            \"complex\": \"Picup Technologies\",\n            \"street_or_farm_no\": 6,\n            \"street_or_farm\": \"Beach Road, \",\n            \"suburb\": \"Woodstock\",\n            \"city\": \"Cape Town\",\n            \"postal_code\": \"7915\",\n            \"country\": \"South Africa\",\n            \"latitude\": -33.9247137,\n            \"longitude\": 18.4487146,\n            //formatted_address must be comma delimited with at least 2 parts\n            \"formatted_address\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\"\n        },\n        \"contact\": {\n            \"name\": \"Sender Contact Name\",\n            \"email\": \"quotetest@example.com\",\n            \"cellphone\": \"0211234567\"\n        },\n        \"special_instructions\": \"Use back door\"\n    },\n    \"customer_ref\": \"Quote Example132\",\n    \"vehicle_id\": \"vehicle-car\",\n    \"is_for_contract_driver\": false,\n    \"scheduled_date\": \"2020-08-22T13:17:11.680476Z\"\n}"},"url":"https://karooooodev-orderingestion.azurewebsites.net/legacy/one-to-many","description":"<p>The <code>Create One-to-Many</code> call will create a picup trip. The following example takes the same sender and receiver from our previous quote, and creates the picup as quoted for the <code>vehicle-id</code> provided. In this case, we've selected <code>vehicle-motorcycle</code>. A customer reference is also provided to help with the tracking, as well as any communication provided. When successful, you'll receive a <code>request_id</code> back from our API.</p>\n<p>The <em>Request</em> body of the quote becomes the body of the create call, this can be used to create a picup after having quoted for it. </p>\n<p>Once created, the picup's will be available for viewing at <a href=\"http://staging.picup.co.za/dashboard/post-dispatch\">http://staging.picup.co.za/dashboard/post-dispatch</a>. This will also add the addresses created to the Geocoder module.</p>\n","urlObject":{"protocol":"https","path":["legacy","one-to-many"],"host":["karooooodev-orderingestion","azurewebsites","net"],"query":[],"variable":[]}},"response":[{"id":"d42f6953-0b4c-4bab-98ad-1b4b3686e37d","name":"Create One-to-Many (New)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"receivers\": [\n        {\n            \"parcels\": [\n                {\n                    \"reference\": \"quote-ref\",\n                    \"size\": \"parcel-small\",\n                    \"length\": null,\n                    \"width\": null,\n                    \"height\": null,\n                    \"weight\": null\n                }\n            ],\n            \"address\": {\n                \"warehouse_id\": null,\n                \"unit_no\": null,\n                \"complex\": null,\n                \"street_or_farm_no\": null,\n                \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                \"suburb\": null,\n                \"city\": \"cape town\",\n                \"postal_code\": null,\n                \"country\": null,\n                \"latitude\": -33.9292364,\n                \"longitude\": 18.4545767,\n                //formatted_address must be comma delimited with at least 2 parts\n                \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\"\n            },\n            \"contact\": {\n                \"name\": \"Test\",\n                \"email\": \"123@em12ail.com\",\n                \"cellphone\": \"0211111234\"\n            },\n            \"special_instructions\": \"Mind the dog\"\n        }\n    ],\n    \"sender\": {\n        \"warehouse_id\": null,\n        \"address\": {\n            \"unit_no\": null,\n            \"complex\": \"Picup Technologies\",\n            \"street_or_farm_no\": 6,\n            \"street_or_farm\": \"Beach Road, \",\n            \"suburb\": \"Woodstock\",\n            \"city\": \"Cape Town\",\n            \"postal_code\": \"7915\",\n            \"country\": \"South Africa\",\n            \"latitude\": -33.9247137,\n            \"longitude\": 18.4487146,\n            //formatted_address must be comma delimited with at least 2 parts\n            \"formatted_address\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\"\n        },\n        \"contact\": {\n            \"name\": \"Sender Contact Name\",\n            \"email\": \"quotetest@example.com\",\n            \"cellphone\": \"0211234567\"\n        },\n        \"special_instructions\": \"Use back door\"\n    },\n    \"customer_ref\": \"Quote Example132\",\n    \"vehicle_id\": \"vehicle-car\",\n    \"is_for_contract_driver\": false,\n    \"scheduled_date\": \"2020-08-22T13:17:11.680476Z\"\n}","options":{"raw":{"language":"json"}}},"url":"https://karoooooprod-apimanagementservice.azure-api.net"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 08 Jan 2020 07:28:03 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"request_id\": 67,\n    \"picup_id\": \"picup-8c6c870a-7bd2-461d-9513-e246b713ca96\"\n}"}],"_postman_id":"55b488af-e48d-437e-93d3-37b61ec5cd15"},{"name":"Create One-to-Many (Current)","event":[{"listen":"test","script":{"id":"ce60a14e-09a0-401b-97b1-3b9d21d99dc4","exec":["pm.test(\"Status code is 200\", function () {","    pm.response.to.have.status(200);","});","","pm.test(\"Body is correct\", function () {","    pm.expect(pm.response.text()).to.include(\"picup_id\");","});"],"type":"text/javascript","packages":{}}}],"id":"ce552bb6-4acc-42ab-b8e6-5a226c969911","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"<value>"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"receivers\": [\n        {\n            \"parcels\": [\n                {\n                    \"reference\": \"quote-ref\",\n                    \"size\": \"parcel-small\",\n                    \"length\": null,\n                    \"width\": null,\n                    \"height\": null,\n                    \"weight\": null\n                }\n            ],\n            \"address\": {\n                \"warehouse_id\": null,\n                \"unit_no\": null,\n                \"complex\": null,\n                \"street_or_farm_no\": null,\n                \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                \"suburb\": null,\n                \"city\": \"cape town\",\n                \"postal_code\": null,\n                \"country\": null,\n                \"latitude\": -33.9292364,\n                \"longitude\": 18.4545767,\n                //formatted_address must be comma delimited with at least 2 parts\n                \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\"\n            },\n            \"contact\": {\n                \"name\": \"Test\",\n                \"email\": \"123@em12ail.com\",\n                \"cellphone\": \"0211111234\"\n            },\n            \"special_instructions\": \"Mind the dog\"\n        }\n    ],\n    \"sender\": {\n        \"warehouse_id\": null,\n        \"address\": {\n            \"unit_no\": null,\n            \"complex\": \"Picup Technologies\",\n            \"street_or_farm_no\": 6,\n            \"street_or_farm\": \"Beach Road, \",\n            \"suburb\": \"Woodstock\",\n            \"city\": \"Cape Town\",\n            \"postal_code\": \"7915\",\n            \"country\": \"South Africa\",\n            \"latitude\": -33.9247137,\n            \"longitude\": 18.4487146,\n            //formatted_address must be comma delimited with at least 2 parts\n            \"formatted_address\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\"\n        },\n        \"contact\": {\n            \"name\": \"Sender Contact Name\",\n            \"email\": \"quotetest@example.com\",\n            \"cellphone\": \"0211234567\"\n        },\n        \"special_instructions\": \"Use back door\"\n    },\n    \"customer_ref\": \"Quote Example132\",\n    \"vehicle_id\": \"vehicle-car\",\n    \"is_for_contract_driver\": false,\n    \"scheduled_date\": \"2020-08-22T13:17:11.680476Z\"\n}"},"url":"{{picup-url}}/{{picup-version}}/integration/create/one-to-many","description":"<p>The <code>Create One-to-Many</code> call will create a picup trip. The following example takes the same sender and receiver from our previous quote, and creates the picup as quoted for the <code>vehicle-id</code> provided. In this case, we've selected <code>vehicle-motorcycle</code>. A customer reference is also provided to help with the tracking, as well as any communication provided. When successful, you'll receive a <code>request_id</code> back from our API.</p>\n<p>The <em>Request</em> body of the quote becomes the body of the create call, this can be used to create a picup after having quoted for it.</p>\n<p>Once created, the picup's will be available for viewing at <a href=\"http://staging.picup.co.za/dashboard/post-dispatch\">http://staging.picup.co.za/dashboard/post-dispatch</a>. This will also add the addresses created to the Geocoder module.</p>\n","urlObject":{"path":["{{picup-version}}","integration","create","one-to-many"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"41da63cd-5460-4311-a909-7c98488d0a8b","name":"Create One-to-Many (Deprecated)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"receivers\": [\n        {\n            \"parcels\": [\n                {\n                    \"reference\": \"quote-ref\",\n                    \"size\": \"parcel-small\",\n                    \"length\": null,\n                    \"width\": null,\n                    \"height\": null,\n                    \"weight\": null\n                }\n            ],\n            \"address\": {\n                \"warehouse_id\": null,\n                \"unit_no\": null,\n                \"complex\": null,\n                \"street_or_farm_no\": null,\n                \"street_or_farm\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n                \"suburb\": null,\n                \"city\": \"cape town\",\n                \"postal_code\": null,\n                \"country\": null,\n                \"latitude\": -33.9292364,\n                \"longitude\": 18.4545767,\n                //formatted_address must be comma delimited with at least 2 parts\n                \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\"\n            },\n            \"contact\": {\n                \"name\": \"Test\",\n                \"email\": \"123@em12ail.com\",\n                \"cellphone\": \"0211111234\"\n            },\n            \"special_instructions\": \"Mind the dog\"\n        }\n    ],\n    \"sender\": {\n        \"warehouse_id\": null,\n        \"address\": {\n            \"unit_no\": null,\n            \"complex\": \"Picup Technologies\",\n            \"street_or_farm_no\": 6,\n            \"street_or_farm\": \"Beach Road, \",\n            \"suburb\": \"Woodstock\",\n            \"city\": \"Cape Town\",\n            \"postal_code\": \"7915\",\n            \"country\": \"South Africa\",\n            \"latitude\": -33.9247137,\n            \"longitude\": 18.4487146,\n            //formatted_address must be comma delimited with at least 2 parts\n            \"formatted_address\": \"6 Beach Rd, Woodstock, Cape Town, 7915, South Africa\"\n        },\n        \"contact\": {\n            \"name\": \"Sender Contact Name\",\n            \"email\": \"quotetest@example.com\",\n            \"cellphone\": \"0211234567\"\n        },\n        \"special_instructions\": \"Use back door\"\n    },\n    \"customer_ref\": \"Quote Example132\",\n    \"vehicle_id\": \"vehicle-car\",\n    \"is_for_contract_driver\": false,\n    \"scheduled_date\": \"2020-08-22T13:17:11.680476Z\"\n}"},"url":"https://picupstaging-webapi.azurewebsites.net/v1/integration/create/one-to-many"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 08 Jan 2020 07:28:03 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"request_id\": 67,\n    \"picup_id\": \"picup-8c6c870a-7bd2-461d-9513-e246b713ca96\"\n}"}],"_postman_id":"ce552bb6-4acc-42ab-b8e6-5a226c969911"},{"name":"Get Buckets","id":"2163bba2-02ff-4fc7-81d7-3a8c28125ca0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"warehouse_id\": \"warehouse-9a4145af-f5b5-423c-ab38-d0ad870604ff\",\r\n    \"from\": \"2020-04-13T13:41:36.292Z\",\r\n    \"to\": \"2020-08-13T13:41:36.292Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/get-buckets","description":"<p>The <code>get-buckets</code> call will return a list of buckets for a given time frame and given warehouse_id. \nThe returning object is an array of all buckets that match the criteria, with a state as well as any relevant counts.</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{business-id}}","get-buckets"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"af5dfe89-8f1a-427d-b81f-33a3215f6e7d","name":"Get Buckets","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"warehouse_id\": \"warehouse-9a4145af-f5b5-423c-ab38-d0ad870604ff\",\r\n    \"from\":\"2020-04-13T13:41:36.292Z\",\r\n    \"to\": \"2020-08-13T13:41:36.292Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/get-buckets"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"266"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"Request-Context","value":"appId=cid-v1:6fc40a28-ded9-474d-9431-194206b95549"},{"key":"Access-Control-Expose-Headers","value":"Request-Context"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 13 Jul 2020 13:48:02 GMT"}],"cookie":[],"responseTime":null,"body":"[\n    {\n        \"bucket_id\": 219,\n        \"warehouse_id\": \"warehouse-9a4145af-f5b5-423c-ab38-d0ad870604ff\",\n        \"warehouse\": \"PIcup Office 2\",\n        \"order_count\": 3,\n        \"current_state\": \"PreRouteManagement\",\n        \"trip_count\": 0,\n        \"courier_count\": 0\n    }\n]"}],"_postman_id":"2163bba2-02ff-4fc7-81d7-3a8c28125ca0"},{"name":"Add to Bucket","event":[{"listen":"test","script":{"id":"2677e782-9c6f-4d37-b079-bcbf18eac074","exec":["pm.test(\"Status code is 200\", function () {","    pm.response.to.have.status(200);","});","",""],"type":"text/javascript","packages":{}}}],"id":"581f048c-0309-4d51-80cb-09c4810771b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"bucket_details\": {\n    \"delivery_date\": \"2020-06-10\",\n    \"shift_start\": \"09:00\",\n    \"shift_end\": \"17:00\",\n    \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\"\n  },\n  \"shipments\": [\n  \t{\n    \"consignment\": \"First Suburb\",\n    \"business_reference\": \"Order Number 7\",\n    \"address\": {\n    \t\"address_line_1\": \"1\",\n    \t\"address_line_2\": \"2\",\n    \t\"address_line_3\": \"3\",\n    \t\"address_line_4\": \"4\",\n      //formatted_address must be comma delimited with at least 2 parts\n      \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n        \"latitude\": -33.9292364,\n        \"longitude\": 18.45457669999996,\n        \"street_or_farm_no\": \"62\",\n        \"street_or_farm\": \"Greatmore St\",\n        \"suburb\": \"Woodstock\",\n        \"city\": \"Cape Town\",\n        \"country\": \"South Africa\",\n        \"postal_code\": \"7915\"\n    },\n    \"contact\": {\n      \"customer_name\": \"Delivery Contact 1\",\n      \"customer_phone\": \"0821112223\",\n      \"email_address\": \"integrator@picup.co.za\",\n      \"special_instructions\": \"Special Instructions go here\"\n    },\n    \"parcels\": [\n      {\n        \"size\": \"parcel-small\",\n        \"tracking_number\": \"777-888-999\",\n        \"parcel_reference\": \"Parcel Number 1\",\n        \"description\": \"This is the first parcel\"\n      }\n     ]\n  \t}\n    ]\n  }\n"},"url":"{{picup-url}}/{{picup-version}}/integration/add-to-bucket","description":"<p>Picup Enterprise is able to group multiple orders for a delivery into a \"bucket\" for processing. A bucket allows for multiple confirgurations of picup routes to be set, preferences and scheduling. Orders can be added to a bucket through a CSV upload or by using the <code>Add to Bucket</code> API. Each order requires a unique <code>Business Reference</code>. If the bucket details vary, a new bucket will be created. The <code>warehouse_id</code> corresponds to the collection warehouse which will be set up during the enterprise business creation. </p>\n<p>Buckets can be dispatched when ready, after processing, costing and routing. Created buckets are available for viewing at: <a href=\"http://staging.picup.co.za/dashboard/buckets\">http://staging.picup.co.za/dashboard/buckets</a></p>\n<p>A correct response will return a <code>200 OK</code> and return the <code>bucket_id</code>.</p>\n","urlObject":{"path":["{{picup-version}}","integration","add-to-bucket"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"71ee041f-bff7-40db-acfb-642ae92d3a7d","name":"Add to Bucket","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"bucket_details\": {\n    \"delivery_date\": \"2020-06-10\",\n    \"shift_start\": \"09:00\",\n    \"shift_end\": \"17:00\",\n    \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\"\n  },\n  \"shipments\": [\n  \t{\n    \"consignment\": \"First Suburb\",\n    \"business_reference\": \"Order Number 7\",\n    \"address\": {\n    \t\"address_line_1\": \"1\",\n    \t\"address_line_2\": \"2\",\n    \t\"address_line_3\": \"3\",\n    \t\"address_line_4\": \"4\",\n      //formatted_address must be comma delimited with at least 2 parts\n      \"formatted_address\": \"62 Greatmore St, Woodstock, Cape Town, 7915, South Africa\",\n        \"latitude\": -33.9292364,\n        \"longitude\": 18.45457669999996,\n        \"street_or_farm_no\": \"62\",\n        \"street_or_farm\": \"Greatmore St\",\n        \"suburb\": \"Woodstock\",\n        \"city\": \"Cape Town\",\n        \"country\": \"South Africa\",\n        \"postal_code\": \"7915\"\n    },\n    \"contact\": {\n      \"customer_name\": \"Delivery Contact 1\",\n      \"customer_phone\": \"0821112223\",\n      \"email_address\": \"integrator@picup.co.za\",\n      \"special_instructions\": \"Special Instructions go here\"\n    },\n    \"parcels\": [\n      {\n        \"size\": \"parcel-small\",\n        \"tracking_number\": \"777-888-999\",\n        \"parcel_reference\": \"Parcel Number 1\",\n        \"description\": \"This is the first parcel\"\n      }\n     ]\n  \t}\n    ]\n  }\n"},"url":"https://picupstaging-webapi.azurewebsites.net/v1/integration/add-to-bucket"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 08 Jan 2020 07:37:23 GMT"}],"cookie":[],"responseTime":null,"body":"[\n    1590\n]"}],"_postman_id":"581f048c-0309-4d51-80cb-09c4810771b1"},{"name":"Get Manifest By Bucket ID","id":"7607fef4-7a57-4ba2-a173-d866d176c661","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"bucket_id\":  219\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/get-manifest-by-bucket-id","description":"<p>Once retrieving our <code>bucket_id</code>, we can use the <code>get-manifest-by-bucket-id</code> call to retrieve any orders relating to the specified bucket. \nThe call returns an array of all orders within the bucket. This includes: </p>\n<ul>\n<li>Customer Information</li>\n<li>Tracking Numbers</li>\n<li>Reference Numbers</li>\n</ul>\n<p>Please note, information received may be null, depending on the state of the bucket. For example, <code>trip_id</code> will return as <code>null</code> if the bucket has not yet proceeded through trip selection.</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{business-id}}","get-manifest-by-bucket-id"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"5517a40b-ef1d-4f18-98a9-0d2160b194e8","name":"Get Manifest By Bucket ID","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"bucket_id\":  219\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/get-manifest-by-bucket-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"567"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"Request-Context","value":"appId=cid-v1:6fc40a28-ded9-474d-9431-194206b95549"},{"key":"Access-Control-Expose-Headers","value":"Request-Context"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 13 Jul 2020 13:53:53 GMT"}],"cookie":[],"responseTime":null,"body":"[\n    {\n        \"bucket_id\": 219,\n        \"trip_id\": null,\n        \"sequence\": null,\n        \"business_reference\": \"20200710-181012-ADC002-c\",\n        \"tracking_number\": \"12711d03-6a0f-477f-a640-f3f6812f6abc\",\n        \"description\": null,\n        \"delivery_date\": \"2020-07-16T00:00:00\",\n        \"shift_start\": \"06:30:00\",\n        \"shift_end\": \"17:00:00\",\n        \"special_instructions\": null,\n        \"customer_name\": \"Aato DC S2S\",\n        \"customer_phone\": null,\n        \"trip_type\": null,\n        \"courier_code\": null\n    },\n    {\n        \"bucket_id\": 219,\n        \"trip_id\": null,\n        \"sequence\": null,\n        \"business_reference\": \"20200710-10000142-GBR020-c\",\n        \"tracking_number\": \"af21c6ce-a654-4384-8ab3-989bfda41364\",\n        \"description\": null,\n        \"delivery_date\": \"2020-07-16T00:00:00\",\n        \"shift_start\": \"06:30:00\",\n        \"shift_end\": \"17:00:00\",\n        \"special_instructions\": null,\n        \"customer_name\": \"152 on Main S2S\",\n        \"customer_phone\": \"0828511798\",\n        \"trip_type\": null,\n        \"courier_code\": null\n    },\n    {\n        \"bucket_id\": 219,\n        \"trip_id\": null,\n        \"sequence\": null,\n        \"business_reference\": \"20200710-180831-ABC831-c\",\n        \"tracking_number\": \"c58251a1-b13d-4167-af5a-24b0752f9f97\",\n        \"description\": null,\n        \"delivery_date\": \"2020-07-16T00:00:00\",\n        \"shift_start\": \"06:30:00\",\n        \"shift_end\": \"17:00:00\",\n        \"special_instructions\": null,\n        \"customer_name\": \"Alfred de Bruyn Prepaid Services S2S\",\n        \"customer_phone\": null,\n        \"trip_type\": null,\n        \"courier_code\": null\n    }\n]"}],"_postman_id":"7607fef4-7a57-4ba2-a173-d866d176c661"},{"name":"Delete Order From Bucket","id":"a7e4bad1-6338-4b36-adc3-0cf7da8d2012","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"bucket_id\": 123,\r\n    \"business_references\": [\r\n        \"BusinessReference\"\r\n    ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/delete-order","description":"<p>Picup Enterprise is able to group multiple orders for a delivery into a \"bucket\" for processing. A bucket allows for multiple confirgurations of picup routes to be set, preferences and scheduling.</p>\n<p>Orders can be deleted from a bucket using this API. Each order (upon ingestion) as a unique <code>Business Reference</code>. Passing in this reference, along with the BucketId, will result in the order being deleted from the system.</p>\n<p>Buckets can be seen at: <a href=\"http://staging.picup.co.za/dashboard/buckets\">http://staging.picup.co.za/dashboard/buckets</a></p>\n<p>A successfull request will return a <code>200 OK.</code></p>\n<p>An important note here, is that only orders that <em>have not yet been dispatched</em> should be deleted.</p>\n","urlObject":{"path":["{{picup-version}}","integration","delete-order"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"577154ab-d697-4c29-ab67-fad7b16da557","name":"Delete Order From Bucket","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"text/plain","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n    \"bucket_id\": 123,\r\n    \"business_references\": [\r\n        \"BusinessReference\"\r\n    ]\r\n}","options":{"raw":{"language":"text"}}},"url":"{{picup-url}}/{{picup-version}}/integration/delete-order"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"a7e4bad1-6338-4b36-adc3-0cf7da8d2012"},{"name":"Stage-Order","id":"62d0de8f-f5b0-4a72-ab4a-2aab3d880ebc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"api-key","type":"text","value":"{{business-id}}"}],"body":{"mode":"raw","raw":"{\n  \"warehouse_id\": \"warehouse-ba02d3f5-2b62-4327-8cf1-71a9b4c4dd5b\",\n  \"shipments\": [\n    {\n      \"business_reference\": \"INV002.1\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -28.632746799225856,\n        \"longitude\": 23.1591796875\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.1.1\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.2\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -21.432616864477335,\n        \"longitude\": 24.49951171875\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"string\"\n        },\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"string\"\n        },\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.2.1\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.3\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -28.246327971048842,\n        \"longitude\": 34.25537109375\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.3.1\"\n        },\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"string2\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.4\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -36.33282808737917,\n        \"longitude\": 23.752441406249996\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.4.1\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.5\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -29.171348850951507,\n        \"longitude\": 14.78759765625\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.5.1\"\n        }\n      ]\n    }\n  ]\n}"},"url":"{{picup-url}}/{{picup-version}}/integration/stage-order","description":"<p>The <code>Stage Order</code> call allows for orders to be loaded onto the system without being added to a bucket. Perhaps you would like to add orders as you receive them on your client side, and only process them into a bucket after a certain amount or after a specified time. You can <em>stage</em> orders, view or update them, and then process them into a bucket as you like. </p>\n<p>When providing an order to stage, we take in a <code>warehouse_id</code> as this will need to be known. With this, the shipments array can contain multiple order objects. We match these on unique <code>business_reference</code> identifiers. If you use the same <code>business_reference</code>, we will update the current order with the new details. </p>\n<p>In the example provided, we show 5 shipments to be added to the staging orders.\nThe first shipment was correctly added, the next 4 show various validation errors, including duplicate <code>parcel_references</code>, as well as <code>latitude</code> and <code>longitude</code> outside of our service areas. </p>\n<p>The <code>action</code> response will show <code>insert</code> for new orders, and <code>update</code> for orders with existing <code>business_references</code> when updating. </p>\n<p>Correctly added orders can be viewed at:\n<a href=\"https://staging.picup.co.za/dashboard/staged-orders\">https://staging.picup.co.za/dashboard/staged-orders</a></p>\n","urlObject":{"path":["{{picup-version}}","integration","stage-order"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"1aa6b5d2-67e2-4e29-a210-4f4ab0844fca","name":"Stage-Order","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"api-key","type":"text","value":"{{business-id}}"}],"body":{"mode":"raw","raw":"{\n  \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\",\n  \"shipments\": [\n    {\n      \"business_reference\": \"INV002.1\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -28.632746799225856,\n        \"longitude\": 23.1591796875\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.1.1\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.2\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -21.432616864477335,\n        \"longitude\": 24.49951171875\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"string\"\n        },\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"string\"\n        },\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.2.1\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.3\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -28.246327971048842,\n        \"longitude\": 34.25537109375\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.3.1\"\n        },\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"string2\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.4\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -36.33282808737917,\n        \"longitude\": 23.752441406249996\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.4.1\"\n        }\n      ]\n    },\n    {\n      \"business_reference\": \"INV001.5\",\n      \"visit_type\": \"DELIVERY\",\n      \"address\": {\n        \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n        \"latitude\": -29.171348850951507,\n        \"longitude\": 14.78759765625\n      },\n      \"contact\": {\n        \"customer_name\": \"customer\",\n        \"customer_phone\": \"phone\",\n        \"email_address\": \" email  \",\n        \"special_instructions\": \"Give to Mpho at Reception\",\n        \"delivery_window_start\": \"10:00\",\n        \"delivery_window_end\": \"12:00\"\n      },\n      \"parcels\": [\n        {\n          \"size\": \"parcel-a4-envelope\",\n          \"parcel_reference\": \"INV001.5.1\"\n        }\n      ]\n    }\n  ]\n}"},"url":"{{picup-url}}/{{picup-version}}/integration/stage-order"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Tue, 07 Jan 2020 09:19:28 GMT"}],"cookie":[],"responseTime":null,"body":"[\n    {\n        \"index\": 0,\n        \"business_reference\": \"INV002.1\",\n        \"staging_id\": 7,\n        \"errors\": null,\n        \"action\": \"insert\"\n    },\n    {\n        \"index\": 1,\n        \"business_reference\": \"INV001.2\",\n        \"staging_id\": null,\n        \"errors\": [\n            \"Duplicate parcel_reference 'string'\",\n            \"Doesn't fit in bounds\"\n        ],\n        \"action\": \"none\"\n    },\n    {\n        \"index\": 2,\n        \"business_reference\": \"INV001.3\",\n        \"staging_id\": null,\n        \"errors\": [\n            \"Doesn't fit in bounds\"\n        ],\n        \"action\": \"none\"\n    },\n    {\n        \"index\": 3,\n        \"business_reference\": \"INV001.4\",\n        \"staging_id\": null,\n        \"errors\": [\n            \"Doesn't fit in bounds\"\n        ],\n        \"action\": \"none\"\n    },\n    {\n        \"index\": 4,\n        \"business_reference\": \"INV001.5\",\n        \"staging_id\": null,\n        \"errors\": [\n            \"Doesn't fit in bounds\"\n        ],\n        \"action\": \"none\"\n    }\n]"}],"_postman_id":"62d0de8f-f5b0-4a72-ab4a-2aab3d880ebc"},{"name":"Get Staged Orders","id":"c225ca21-88f4-43ae-bf67-7c4dd0230034","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"api-key","type":"text","value":"{{business-id}}"}],"body":{"mode":"raw","raw":"{\n\t\"from\": \"2019-12-01\",\n\t\"to\": \"2020-12-30\"\n}"},"url":"{{picup-url}}/{{picup-version}}/integration/get-staged-orders","description":"<p>The <code>get-staged-orders</code> call can be used to return the orders currently in <em>staging</em>.</p>\n<p>The body takes in a to and from parameter, referring to the date the order was <em>created</em>.</p>\n<p>The response example shows the various orders as well as all of the information provided when the order was created or updated.</p>\n","urlObject":{"path":["{{picup-version}}","integration","get-staged-orders"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"5cb59a7b-ecd3-40de-a851-b6b889c04c28","name":"Get Staged Orders","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","type":"text","value":"{{business-id}}"}],"body":{"mode":"raw","raw":"{\n    \"from\": \"2019-12-01\",\n    \"to\": \"2020-12-30\"\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/get-staged-orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 08 Jan 2020 07:33:01 GMT"}],"cookie":[],"responseTime":null,"body":"[\n    {\n        \"staging_id\": 7,\n        \"date_created\": \"2020-01-07T11:19:28\",\n        \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\",\n        \"business_reference\": \"INV002.1\",\n        \"visit_type\": \"DELIVERY\",\n        \"address\": {\n            \"address\": \"Picup Technologies, 6 Beach Road, Woodstock, Cape Town, South Africa\",\n            \"latitude\": -28.63274,\n            \"longitude\": 23.15917\n        },\n        \"contact\": {\n            \"customer_name\": \"customer\",\n            \"customer_phone\": \"phone\",\n            \"email_address\": \" email  \",\n            \"special_instructions\": null,\n            \"delivery_window_start\": null,\n            \"delivery_window_end\": null\n        },\n        \"parcels\": [\n            {\n                \"size\": \"parcel-a4-envelope\",\n                \"parcel_reference\": \"INV001.1.1\"\n            }\n        ]\n    }\n]"}],"_postman_id":"c225ca21-88f4-43ae-bf67-7c4dd0230034"},{"name":"Re-Schedule Order","id":"9488b5cd-1c94-4cb5-81b4-7aa64402d2aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n  \"scheduled_date\": \"2023-07-05T06:59:22.852Z\",\r\n  \"fleet_allocation\": \"Picup\", //Picup or Contractor\r\n  \"reset_lottery_attempts\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{orderId}}/schedule-order","description":"<p>This call can be made to cancel a order that has been created and reschedule.</p>\n<p>Should the order already have been collected, we will failed the delivery with the reason \"order-cancelled\" and mark it off to be returned to the origin by default.</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{orderId}}","schedule-order"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"f4a83be6-8701-49ac-b5a8-880a306f843e","name":"Re-Schedule Order","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"text/plain","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n  \"scheduled_date\": \"2023-07-05T06:59:22.852Z\",\r\n  \"fleet_allocation\": \"Picup\", //Picup or Contractor\r\n  \"reset_lottery_attempts\": true\r\n}","options":{"raw":{"language":"text"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/update-warehouse"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"9488b5cd-1c94-4cb5-81b4-7aa64402d2aa"},{"name":"Cancel Picup","event":[{"listen":"test","script":{"id":"b2cce5ee-786a-4c72-92aa-3262e541d51b","exec":["pm.test(\"Status code is 200\", function () {\r","    pm.response.to.have.status(200);\r","});"],"type":"text/javascript"}}],"id":"6c9b6036-bade-45ab-8e3d-cea8e584235b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"api-key","value":"{{business-id}}","type":"text"}],"url":"{{picup-url}}/{{picup-version}}/integration/{{picup-id}}/cancel","description":"<p>This call can be made to cancel a picup that has been created. It takes in the picup ID and returns a 200 OK</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{picup-id}}","cancel"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"a6d8ec0c-5b3a-44a1-91a2-ea129c5f2940","name":"Cancel Picup","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{business-id}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/javascript","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"javascript"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{picup-id}}/cancel"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"Server","value":"Microsoft-IIS/8.5"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 02 Sep 2020 13:32:21 GMT"},{"key":"Content-Length","value":"0"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"6c9b6036-bade-45ab-8e3d-cea8e584235b"},{"name":"Get Order by Business Reference","id":"f952b0d0-9940-40b8-aac9-117d4ba6d94e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{picup-url}}/{{picup-version}}/integration/order-by-business-reference/20200710-180831-ABC831-c","description":"<p>Should you need to look up an order on our system, you can lookup using the <code>business-reference</code>. </p>\n<p><code>order-by-business-reference</code> call returns the order object, shwoing any details you might need, as well as the bucket for that order.</p>\n<p>This response includes the order's <code>waybill_number</code> which can be used for tracking</p>\n","urlObject":{"path":["{{picup-version}}","integration","order-by-business-reference","20200710-180831-ABC831-c"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"3896ad8e-7b6b-4b99-9059-6531368469a5","name":"Get Order by Business Reference","originalRequest":{"method":"GET","header":[],"url":"{{picup-url}}/{{picup-version}}/integration/order-by-business-reference/20200710-180831-ABC831-c"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"501"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"Request-Context","value":"appId=cid-v1:6fc40a28-ded9-474d-9431-194206b95549"},{"key":"Access-Control-Expose-Headers","value":"Request-Context"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 13 Jul 2020 14:31:48 GMT"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": 4427,\n    \"consignment\": null,\n    \"invoice_number\": \"20200710-180831-ABC831-c\",\n    \"customer_name\": \"Alfred de Bruyn Prepaid Services S2S\",\n    \"customer_phone\": null,\n    \"flagged_reason\": null,\n    \"delivery_window_start\": null,\n    \"delivery_window_end\": null,\n    \"trip_id\": null,\n    \"waybill_number\": \"PCW000019558\",\n    \"parcels\": {\n        \"parcel-a4-envelope\": 1,\n        \"parcel-small\": 0,\n        \"parcel-medium\": 0,\n        \"parcel-large\": 0,\n        \"parcel-xlarge\": 0\n    },\n    \"bucket\": {\n        \"bucket_id\": 219,\n        \"delivery_date\": \"2020-07-16T00:00:00\",\n        \"shift_start\": \"06:30:00\",\n        \"shift_end\": \"17:00:00\",\n        \"warehouse_id\": \"warehouse-9a4145af-f5b5-423c-ab38-d0ad870604ff\",\n        \"warehouse_name\": \"PIcup Office 2\"\n    }\n}"}],"_postman_id":"f952b0d0-9940-40b8-aac9-117d4ba6d94e"},{"name":"Create Warehouse","id":"90ab2052-fcf8-4048-aed0-8b40aaa1ad08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n  \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\",\r\n  \"warehouse_code\": \"WH001\",\r\n  \"name\": \"Woodstock Warehouse\",\r\n  \"email\": \"warehouse@picup.co.za\",\r\n  \"address\": \"62 Greatmore St, Woodstock, Cape Town, 7915\",\r\n  \"phone\": \"0821112223\",\r\n  \"suburb\": \"Woodstock\",\r\n  \"country\": \"South Africa\",\r\n  \"country_short_code\": \"ZA\",\r\n  \"postal_code\": \"7915\",\r\n  \"latitude\": -33.9292364,\r\n  \"longitude\": 18.45457669999996,\r\n  \"is_eligible_for_da_consolidation\": true,\r\n  \"allow_business_consolidation\": false,\r\n  \"default_special_instructions\": \"Special Instructions go here\",\r\n  \"operating_hours\": [\r\n    {\r\n      \"day_of_week\": \"Monday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Tuesday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Wednesday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Thursday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Friday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    }\r\n  ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/create-warehouse","description":"<p>The Create Warehouse call is used to create Warehouses on the system.</p>\n<p>Warehouse details are specified in the request body as a json object.</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{business-id}}","create-warehouse"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"ce96d2c0-58fe-4455-a8d6-5a4aab2ddc8b","name":"Create Warehouse","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"text/plain","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n  \"warehouse_id\": \"warehouse-9cc07864-0255-4f84-b3f2-5697e21529e9\",\r\n  \"warehouse_code\": \"WH001\",\r\n  \"name\": \"Woodstock Warehouse\",\r\n  \"email\": \"warehouse@picup.co.za\",\r\n  \"address\": \"62 Greatmore St, Woodstock, Cape Town, 7915\",\r\n  \"phone\": \"0821112223\",\r\n  \"suburb\": \"Woodstock\",\r\n  \"country\": \"South Africa\",\r\n  \"country_short_code\": \"ZA\",\r\n  \"postal_code\": \"7915\",\r\n  \"latitude\": -33.9292364,\r\n  \"longitude\": 18.45457669999996,\r\n  \"is_eligible_for_da_consolidation\": true,\r\n  \"allow_business_consolidation\": false,\r\n  \"default_special_instructions\": \"Special Instructions go here\",\r\n  \"operating_hours\": [\r\n    {\r\n      \"day_of_week\": \"Monday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Tuesday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Wednesday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Thursday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    },\r\n    {\r\n      \"day_of_week\": \"Friday\",\r\n      \"opening_time\": \"09:00:00\",\r\n      \"closing_time\": \"17:00:00\"\r\n    }\r\n  ]\r\n}","options":{"raw":{"language":"text"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/create-warehouse"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"90ab2052-fcf8-4048-aed0-8b40aaa1ad08"},{"name":"Update Warehouse","id":"6854d00a-2db4-4d95-8538-7563ce43773f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n    \"warehouse_details\": {\r\n        \"name\": \"Example Warehouse\",\r\n        \"email\": \"warehousemanager@exampe.com\",\r\n        \"address\": \"2 Fir Street, Observatory, Cape Town, South Africa\",\r\n        \"warehouse_code\": \"PIC01\", //optional\r\n        \"phone\": \"0216850212\",\r\n        \"suburb\": \"Observatory\",\r\n        \"postal_code\": \"7920\",\r\n        \"latitude\": -33.935389,\r\n        \"longitude\": 18.469159,\r\n        \"country\": \"South Africa\",\r\n        \"country_short_code\": \"ZA\",\r\n        \"is_eligible_for_da_consolidation\": false,\r\n        \"allow_business_consolidation\": false,\r\n        \"default_special_instructions\": \"Example Special Instructions\"\r\n    }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/update-warehouse","description":"<p>The Update Warehouse call is used to update Warehouses on the system.</p>\n<p>Warehouse details are specified in the request body as a json object.</p>\n","urlObject":{"path":["{{picup-version}}","integration","{{business-id}}","update-warehouse"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"aafa6cc5-9620-459c-8e44-d93b279ada6e","name":"Update Warehouse","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"text/plain","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n    \"warehouse_details\": {\r\n        \"name\": \"Example Warehouse\",\r\n        \"email\": \"warehousemanager@exampe.com\",\r\n        \"address\": \"2 Fir Street, Observatory, Cape Town, South Africa\",\r\n        \"warehouse_code\": \"PIC01\", //optional\r\n        \"phone\": \"0216850212\",\r\n        \"suburb\": \"Observatory\",\r\n        \"postal_code\": \"7920\",\r\n        \"latitude\": -33.935389,\r\n        \"longitude\": 18.469159,\r\n        \"country\": \"South Africa\",\r\n        \"country_short_code\": \"ZA\",\r\n        \"is_eligible_for_da_consolidation\": false,\r\n        \"allow_business_consolidation\": false,\r\n        \"default_special_instructions\": \"Example Special Instructions\"\r\n    }\r\n}","options":{"raw":{"language":"text"}}},"url":"{{picup-url}}/{{picup-version}}/integration/{{business-id}}/update-warehouse"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"6854d00a-2db4-4d95-8538-7563ce43773f"},{"name":"Download Waybill PDF","id":"a39fa79c-3dc3-4449-b166-42c33b520b91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"{{business-id}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"[\"PCW0000001\"]","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/download-waybills","description":"<p>Passing through the Picup order waybill number will generate a PDF waybill set for all parcels attached to this order. This is returned as a PDF blob.</p>\n","urlObject":{"path":["{{picup-version}}","integration","download-waybills"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"6b75617c-5d66-4178-8bb6-275be415fe64","name":"Download Waybill PDF","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"text/plain","type":"text"},{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"[\"PCW0000001\"]","options":{"raw":{"language":"text"}}},"url":"{{picup-url}}/{{picup-version}}/integration/download-waybills"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"a39fa79c-3dc3-4449-b166-42c33b520b91"},{"name":"Reconcile Parcels","id":"dadd0835-0e0e-4310-8d9d-db33595d0ce9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n    \"reconcile_parcels\": [\r\n        {\r\n            \"parcel_waybill\": \"PCW000100000_1\",\r\n            \"result\": \"Deliver\"\r\n        },\r\n        {\r\n            \"parcel_waybill\": \"PCW000100000_3\",\r\n            \"result\": \"FailDelivery\"\r\n        }\r\n    ],\r\n    \"reconcile_reason\": \"Reconcile parcels reason.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/reconcile-parcels","description":"<p>This endpoint allows parcels to be reconciled to a specified final state based on the parcel waybill.</p>\n<p>Valid values for \"result\" - which is the final state being reconciled to:</p>\n<ul>\n<li><p><code>StartFragmentCollect</code></p>\n</li>\n<li><p><code>FailCollection</code></p>\n</li>\n<li><p><code>Deliver</code></p>\n</li>\n<li><p><code>FailDelivery</code></p>\n</li>\n<li><p><code>Return</code></p>\n</li>\n<li><p><code>FailFinalCollectionEndFragment</code></p>\n</li>\n</ul>\n<blockquote>\n<p>NB: THE PARCELS PROVIDED CAN BE FROM SEPARATE/INDIVIDUAL ORDERS, AS THE RECON IS ON THE PARCEL LEVEL - THEY WILL HOWEVER SHARE THE SAME REASON PROVIDED.</p>\n</blockquote>\n","urlObject":{"path":["{{picup-version}}","integration","reconcile-parcels"],"host":["{{picup-url}}"],"query":[],"variable":[]}},"response":[{"id":"71322a7c-e037-4f9b-8bc1-5b96b01be317","name":"Reconcile Parcels","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{business-id}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n    \"reconcile_parcels\": [\r\n        {\r\n            \"parcel_waybill\": \"PCW000100000_1\",\r\n            \"result\": \"Deliver\"\r\n        },\r\n        {\r\n            \"parcel_waybill\": \"PCW000100000_3\",\r\n            \"result\": \"FailDelivery\"\r\n        }\r\n    ],\r\n    \"reconcile_reason\": \"Reconcile parcels reason.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{picup-url}}/{{picup-version}}/integration/reconcile-parcels"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":""}],"_postman_id":"dadd0835-0e0e-4310-8d9d-db33595d0ce9"},{"name":"Change Bucket","id":"3d97bb84-7e0b-45f4-91e7-c77ec04fc85e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"3d97bb84-7e0b-45f4-91e7-c77ec04fc85e"}],"event":[{"listen":"prerequest","script":{"id":"56f82baa-016e-439e-94f9-30bcbed80ed3","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2233ec63-4606-45fc-b776-ab46c31e6aa4","type":"text/javascript","exec":[""]}}]}