open-api icon indicating copy to clipboard operation
open-api copied to clipboard

[FEATURE]: Access to purchasing shipping

Open chrisrogala opened this issue 2 years ago • 0 comments

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.

chrisrogala avatar Oct 28 '22 21:10 chrisrogala