open-api
open-api copied to clipboard
[FEATURE]: Access to purchasing shipping
Is there an existing ticket for this?
- [X] I have searched the existing tickets
Is your feature request related to a problem? Please describe
I'm always frustrated when purchasing shipping through Etsy seller portal. It would be great if there was an API that all developers to purchase the shipping labels through the backend services instead of manually purchasing them in the portal. The reason for this is because of how manual the process is with purchasing, scheduling a pickup or creating a USPS scan sheet.
Describe the solution you'd like
There is already an API available with the website. The endpoint is:
https://www.etsy.com/api/v3/ajax/bespoke/shop/{{shopid}}/shipping-label/purchase-shipments
The body is:
{ "shipments": [ { "notification_message": "{{Seller notification message}}", "order_id": "{{order number}}", "ship_to": { "city": "", "country_id": 209, "first_line": "", "name": "", "phone": "", "second_line": "", "state": "", "verification_state": 2, "zip": "", "is_confirmed": true }, "ship_from": { "city": "", "country_id": 209, "first_line": "", "name": "", "phone": "", "second_line": "", "state": "", "verification_state": 0, "zip": "" }, "package": { "mail_class": "first_class", "package_type": "parcel", "weight_units": "oz", "dimension_units": "in", "customs_items": [], "mailing_date": 0, "signature_confirmation": false, "label_type": 0, "insurance_value": 0, "insurance_provider_id": 3, "height": "1", "length": "11", "width": "9", "weight": 5 }, "uuid": "be044476-0df9-49fb-9655-e706d0ec5895", "origin_zip": "", "carrier_id": 1, "sort_order": 1 } ] }
There is another API for creating a scan sheet:
https://www.etsy.com/api/v3/ajax/shop/{{shopId}}/shipping-labels/scan-form
The body is actually not JSON and instead it is form data.
There is another API that provides the ability to schedule a pickup:
https://www.etsy.com/api/v3/ajax/shop/{{shopId}}/shipping-labels/usps-pickup
The body is:
{ "address": { "name": "", "first_line": "", "second_line": "", "city": "", "state": "", "country_id": 209, "country_name": "", "zip": "", "phone": "" }, "requested_pickup_date": 1667059200, "package_location": "Front Door", "special_instructions": "In box labeled USPS First Class", "excluded_shipping_label_ids": [
]
}
Describe any alternatives you've considered
Purchasing the shipping labels outside of Etsy.
Additional context
While the portal works well for smaller shops, it is not designed for larger shops. This causes delays in our processing and results in our shop having to extend turn around time and turn customers away. Over the past two years, our shop stops accepting orders for Christmas deliveries because we do not have enough time to process more orders. If Etsy opened this up, it would improve our efficiency this holiday season so we could continue to take orders later into the year.