Integrating with Dropp involves modifying your online store to allow the customer to choose a Dropp location and making a POST request to our API in to create the order in our system.
\nIn order to make requests to the API, a secret API key must be provided. The following API endpoints are intended for server-to-server communication only, and authorization is requested by adding an Authorization: Basic YOUR-TOKEN header to requests.
\nTo get started on production environment you can get your API key here: https://dropp.is/stofna-adgang
\nTo get API key and storeid for staging environment, please contact dropp@dropp.is
\nStaging environment: https://stage.dropp.is
Production environment: https://api.dropp.is
Get all Dropp locations for a given store.
\nFunctions that returns two arrays of zip codes and info.
\n \"status\": 0,\n \"message\": \"\",\n \"codes\": [\n {\n \"code\": 101,\n \"town\": \"Reykjavík\",\n \"capital\": true\n },\n {\n \"code\": 102,\n \"town\": \"Reykjavík\",\n \"capital\": true\n },\n...\n ],\n\"flytjandicodes\": [\n {\n \"code\": 190,\n \"town\": \"Vogum\"\n },\n {\n \"code\": 191,\n \"town\": \"Vogum\"\n },\n...\n ]\n}\n\nÞið getið séð hvernig þetta lítur út á www.elko.is, www.literalstreetart.com og www.hurrareykjavik.is.
Við getum stillt litina á kortinu þannig að þeir passi við síðuna ykkar (þetta er t.d. blátt hjá Elko og
svart hjá Húrra Reykjavík).
Það þarf að setja þetta script inn á heimasíðuna:
\n< script type=\"application/javascript\" src=\"//app.dropp.is/dropp-
locations.min.js\" data-store-id=\"...þið fáið store-id í tölvupósti þegar þið stofnið aðgang á dropp.is...&data-env=stage\" async>< /script>
&data-env=stage er aðeins inni á meðan stage er notað, það er svo tekið út þegar talað er við raun kerfi
\nSvo þarf að setja takka, t.d. \"Velja afhendingarstað\", og kalla í þetta fall þegar ýtt er á takkann:
chooseDroppLocation()
.then(location => {
// location is either null (if the user dismissed the modal),
// or a location object with an UUID as its id.
})
.catch(error => {
// The modal may throw errors, for example if it cannot display locations.
});
Fallið skilar svo location-id sem þarf að vista og senda með pöntuninni í gegnum vefþjónustuna
svo þið vitið hvaða staður var valinn.
Generates new unique barcode that can be used for orders in POST call
\nExample response:\n{\n \"barcode\": \"DR-57EHFMCEh\"\n}
\n","urlObject":{"protocol":"https","path":["dropp","api","v1","orders","barcode",""],"host":["stage","dropp","is"],"query":[],"variable":[]}},"response":[],"_postman_id":"22011202-294a-4f33-94e6-8f7db7136623"},{"name":"POST new order to Dropp","id":"b6d150cb-2be5-4374-bc8a-3b9d03b5700a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Basic {YOUR-TOKEN}"},{"key":"Content-Type","value":"application/json;charset=UTF-8"}],"body":{"mode":"raw","raw":"{\n\t\"locationId\": \"d0b62bfe-b8c4-49b4-9b68-a1b3abf2b4a6\",\n\t\"barcode\": \"DR1234567890\",\n \"value\": 10000.0,\n\t\"products\": [{\n\t\t\"name\": \"Atgeir\",\n\t\t\"barcode\": \"A123\"\n\t}],\n\t\"customer\": {\n\t\t\"name\": \"Egill Skallagrímsson\",\n\t\t\"emailAddress\": \"egill@skallagrimsson.is\",\n\t\t\"socialSecurityNumber\": \"010101-0101\",\n\t\t\"address\": \"Borg á Mýrum\",\n\t\t\"phoneNumber\": \"777 7777\",\n\t\t\"zipcode\":310,\n\t\t\"town\":\"Borgarnes\"\n\t}\n}"},"url":"https://stage.dropp.is/dropp/api/v1/orders/","description":"Creates an order and associated product(s) in the Dropp system, returning the created order and its product(s). All product and customer attributes are required. The locationId is the location selected by your customer. barcode is a unique order Id, printed on the package. Returns an order with the provided attributes, in addition to an id for the order in our systems, and the order's status, which can be \"initial\" (order created & ready to be picked up), \"transit\" (package in transit to delivery location), \"consignment\" (package at delivery location), \"delivered\" (customer has picked up the package), \"cancelled\" (The order has been cancelled) or \"lost\" (The order is marked lost by customer service).
\nAuthorization is required.
\nRequired parameters:
\nlocationId – The location selected by your customer.
\nbarcode – A unique order Id printed on the package, used by us to identify the package. This is not an individual product's barcode. Should only contain strings and number. If null a barcode is generated and returned in the response
\nproducts (array of objects) – Product names and unique product barcodes. Optional parameter is quantity (int) number of each item.
\nname
\nbarcode
\nvalue - The total price including VAT (used for claims management). Excluding delivery fee
\nOptional parameters:
\ncustomer (object)
name
emailAddress (optional)
socialSecurityNumber (optional)
address
phoneNumber
zipcode
town
Example response:
{
\"id\": \"de3128aa-acf6-42c8-a5f3-3501eb23133e\",
\"barcode\": \"ORDERAB123\",
\"locationId\": \"d0b62bfe-b8c4-49b4-9b68-a1b3abf2b4a6\",
\"products\": [{\"name\": \"Atgeir\", \"barcode\": \"A123\"}],
\"customer\": {\"name\": \"Egill Skallagrímsson\", \"emailAddress\": \"egill@skallagrimsson.is\", \"socialSecurityNumber\": \"010101-0101\", \"address\": \"Borg á Mýrum\", \"phoneNumber\": \"777 7777\",\"zipcode\":310,\"town\":\"Borgarnes\"},
\"status\": \"initial\",
\"createdAt\": \"2019-06-01T00:00:00.000Z\",
\"updatedAt\": \"2019-06-01T00:00:00.000Z\"
}
Returns an order and its product(s).
\nAuthorization is required.
No parameters required.
Example response:
{
\"id\": \"de3128aa-acf6-42c8-a5f3-3501eb23133e\",
\"barcode\": \"ORDERAB123\",
\"locationId\": \"d0b62bfe-b8c4-49b4-9b68-a1b3abf2b4a6\",
\"products\": [{\"name\": \"Atgeir\", \"barcode\": \"A123\"}],
\"customer\": {\"name\": \"Egill Skallagrímsson\", \"emailAddress\": \"egill@skallagrimsson.is\", \"socialSecurityNumber\": \"010101-0101\", \"address\": \"Borg á Mýrum\", \"phoneNumber\": \"777 7777\"},
\"status\": \"initial\",
\"createdAt\": \"2019-06-01T00:00:00.000Z\",
\"updatedAt\": \"2019-06-01T00:00:00.000Z\"
}
Updates an order and returns an empty response. Please note that the order may only be updated while its status is \"initial\".
\nAuthorization is required.
\nAllowed parameters (at least one required):\n -barcode\n -locationId\n -customer\n -products
\nExample response:\n{}
\n","urlObject":{"protocol":"https","path":["dropp","api","v1","orders",":orderId"],"host":["stage","dropp","is"],"query":[],"variable":[{"type":"string","value":"","key":"orderId"}]}},"response":[],"_postman_id":"e8be8cd6-3ff4-4f37-a47f-4f86d0508370"},{"name":"DELETE order","id":"03d51c46-e998-4261-abcb-3d0c9f536120","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Auth","value":"Basic {YOUR-TOKEN}","type":"text"}],"url":"https://stage.dropp.is/dropp/api/v1/orders/:orderId","description":"Deletes an order and returns an empty response. Can only be performed before collection, after this the order must be recalled.
\nExample response:\n{}
\n","urlObject":{"protocol":"https","path":["dropp","api","v1","orders",":orderId"],"host":["stage","dropp","is"],"query":[],"variable":[{"type":"string","value":"","key":"orderId"}]}},"response":[],"_postman_id":"03d51c46-e998-4261-abcb-3d0c9f536120"},{"name":"Get PDF","id":"32718e87-34c3-4b68-8e66-ef6149e4f5e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Basic {YOUR-TOKEN}","type":"text"}],"url":"https://stage.dropp.is/dropp/api/v1/orders/pdf/:orderid","description":"Returns byte[] with pdf for order
\n","urlObject":{"protocol":"https","path":["dropp","api","v1","orders","pdf",":orderid"],"host":["stage","dropp","is"],"query":[],"variable":[{"type":"any","value":null,"key":"orderid"}]}},"response":[],"_postman_id":"32718e87-34c3-4b68-8e66-ef6149e4f5e7"},{"name":"Get PDF for return order","id":"71ca3536-21fe-4584-84a3-da4cea0e1805","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Basic {YOUR-TOKEN}","type":"text"}],"url":"https://stage.dropp.is/dropp/api/v1/orders/returnpdf/:barcode","description":"Returns byte[] with pdf for return order
\n","urlObject":{"protocol":"https","path":["dropp","api","v1","orders","returnpdf",":barcode"],"host":["stage","dropp","is"],"query":[],"variable":[{"type":"any","value":null,"key":"barcode"}]}},"response":[],"_postman_id":"71ca3536-21fe-4584-84a3-da4cea0e1805"},{"name":"Add extra barcode","id":"cc0cafd2-11d1-4508-beba-617ba42c96c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Basic {YOUR-TOKEN}","type":"text"}],"url":"https://stage.dropp.is/dropp/api/v1/orders/extrapdf/:orderid","description":"If a shipment contains more than one package each package needs a unique barcode.
\nThis function returns byte[] with pdf for the extra barcode.
\n","urlObject":{"protocol":"https","path":["dropp","api","v1","orders","extrapdf",":orderid"],"host":["stage","dropp","is"],"query":[],"variable":[{"type":"any","value":null,"key":"orderid"}]}},"response":[],"_postman_id":"cc0cafd2-11d1-4508-beba-617ba42c96c0"},{"name":"Delete extra order","id":"a37fdf40-a16c-41cf-882f-16ba809c14db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Basic {YOUR-TOKEN}","type":"text"}],"url":"https://stage.dropp.is/dropp/api/v1/orders/deleteextraorder/:orderid/:barcode/","description":"To delete an extra order that has already been created.
\nReturns json of tracking of the order, latest object first.
\nSame result as on www.dropp.is where customer can track orders
\n