Help Needed with ShipHero Integration (Warehouse ID,Webhooks, Basic Auth)

Devs Needed & Available
1

Hi ShipHero Team,

I’m working on integrating ShipHero with Salesforce and encountered a few challenges. I’d appreciate your guidance on the following issues:

  1. How to get the warehouse Id from ShipHero.
  2. How to map products in ShipHero to warehouse or do a dataload.
  3. While trying to create a webhook mutation, we are getting an error that says “URLField is not valid for field URL.”
  4. Also, we need to understand how to configure the Basic Authentication for mulesoft endpoint, including how to pass the username and password.
  5. How to customise the webhooks.

Any assistance or guidance on these issues would be greatly appreciated!
Thanks in advance!

2

Hello @Vishnu welcome to the API Community!

I have started reviewing your inquiries, and I will get you an answer for each as soon as possible.

Have a great day!

3

Hi @tomasfd ,

Thank you for the warm welcome and for taking the time to review my inquiries! I really appreciate it and look forward to your insights.

Have a great day as well!

4

Hello @Vishnu

  1. To get the different warehouse IDs your account has access to, you can use the following query:
query {
  account(analyze: false) {
    request_id
    data {
      legacy_id
      id
      warehouses {
        id
        legacy_id
        identifier
        profile
        account_id
        address {
          name
          country
          state
          city
        }
      }
    }
  }
}
  1. If you mean adding products to another warehouse you own, as long as the product already exists you can use the product_add_to_warehouse mutation: https://developer.shiphero.com/wp-content/uploads/spectaql/#mutation-product_add_to_warehouse.
  2. I will need an example for this one, a request_id you for back from sending the mutation is enough.
  3. I’m not familiar with Mulesoft. If they have an integration with ShipHero, please contact them, as they will know better how they are authenticating with us.
  4. Our webhooks are not customizable.

Have a great day!

5

Hi @tomasfd,

Thanks for your response
I’ll test the suggested solution. However, I need assistance with 3 and 4. Specifically, I need to set up a webhook in ShipHero and will provide an endpoint URL in the mutation. My endpoint requires basic authentication with a username and password. How can I configure ShipHero to include these credentials so that only ShipHero’s webhooks can access my endpoint and send shipment updates?

6

Hi @Vishnu, currently, our webhooks don’t have those authentication options. You can use the API secret you get to verify it. More info: Webhooks – Developer Resources | ShipHero
Have a nice day!

7

Hi @tomasfd can I assign my API client ID and client secret in the Authorize.net API Credentials
so the webhook can access my endpoint to transfer data from shiphero to my system?

8

Hi @Vishnu, I am not familiar with how that platform works, so I cannot provide you a final answer on it.

9

Hi @tomasfd
Ok, can you tell me how to trigger the shipment update webhooks so that I can test them?

10

Hello Vishnu,
Once you have created an order with SKUs with available stock, you should be able to fulfill it following this guide: How to Pack Orders – ShipHero. Fulfilling the order triggers the webhook. You can use a generic label if you don’t have any carriers connected.

Have a great day!

11

Hi @tomasfd

Thank you for your response. I will check it out!

1 Like
12

Hi @tomasfd
my order is ready to ship Yes but I cant find the Ship button in the Action. Is there any permission for that?
Ship button is not there in Action

13

Hi @Vishnu

You are probably with a user from a “3PL client only” type of account.

You need to use a token from a 3PL, brand or small-business type of account to view the ship button.

Have a nice day!

14

Hi @tomasfd
you mentioned the API secret to verify it right?
but in the header, I didn’t get the “x-shiphero-hmac-sha256” header.
can you help with this?

15

Hey Vishnu,

Can you share what type of webhook and for which object id it did not work as expected? As I don’t know which webhook you ar using I am not sure if the object should be a shipment id, SKU, purchase order id, etc. But let me know one according to the type of webhook you are finding this issue for.

16

Hi @tomasfd
Currently, the Cancel Order webhook doesn’t include the header. Could you also help me understand how to trigger the Shipment Update webhook in ShipHero?

17

Hello Vishnu,

To trigger the webhook, you need to fulfill and order following this process: How to Pack Orders – ShipHero

I will investigate the issues with the cancel webhook and let you know as soon as I progress.

Kind regards,

18

Hi @tomasfd

Thanks for your response!
I also have a question about the Shipment Update webhooks: if the Fulfillment Status changes from the “default” value to the “Fulfilled,” value means it should trigger the webhook correct?

19

Hi @tomasfd
Do you have any updates on this? Additionally, could you guide me through the process involved in order fulfillment? I’d also like to retrieve shipment updates, such as the tracking number and label printed status. Can you assist me with this?
Thanks!

20

Hello @vishnu!

Fulfilling an order, not changing its status, triggers the webhook. If you fulfill the order from the UI, as explained in the link I shared previously, you will trigger the webhook.

The shipment webhook is the only shipment update. After this shipments don’t change anymore, if you need to update anything you will need to void the shipment and ship the order again.