Para poder implementar nuestros webhook necesitas indicar una URL en donde recibirás la información. Esto lo podrás encontrar iniciando sesión en tu cuenta y luego ingresando al módulo de la API debes ir abajo a la sección Webhooks.
Nuestros webhooks te entregará dos resultados:
Envios:
-
POST: Cuando creas un pedido, el webhook responderá con POST y la información del package creado.
-
PUT: Cuando se actualiza la información del package. Por ejemplo: se asigna un número de seguimiento a tu envío o se actualizó el estado de pedido.
SKU
-
POST: Cuando el cliente ingresa un nuevo SKU en nuestra plataforma, el webhook responderá con POST y la información del SKU creado.
-
PUT: Cuando se actualiza la información del SKU. Por ejemplo: cuando se ingresa y descuenta stock
IMPORTANTE: A contar del día 15 de Mayo de 2019, el formato de respuestas de nuestros webhooks cambiara de URL-ENCODE a JSON es relevante comunicarte con tu desarrollador para actualizar la manera de obtener las respuestas de nuestros webhook, ya que, a contar de la fecha indicada sera deprecada la version URL-ENCONDE.
Tips para desarrolladores: ingresa a https://webhook.site para obtener la información del webhook configurado en shipit
Un ejemplo del nuevo formato sera entregado a continuación:
{
"id": 16,
"reference": "1",
"full_name": "mich tst ",
"email": "",
"items_count": 1,
"cellphone": "",
"is_payable": false,
"packing": "Sin Empaque",
"shipping_type": "Normal",
"destiny": "Domicilio",
"courier_for_client": null,
"tracking_number": null,
"approx_size": "Pequeño (10x10x10cm)",
"status": "in_preparation",
"courier_status": null,
"length": 10,
"width": 10,
"height": 10,
"weight": 1,
"delivery_time": null,
"created_at": "2019-04-27T16:30:00.000-04:00",
"updated_at": "2019-04-25T18:38:23.422-04:00",
"courier_url": "Sin tracking",
"old_ticket_url_courier": null,
"ticket_shipit_url": null,
"ticket_url": null,
"ticket_shipit_pdf_url": null,
"link": "http://example.org/v/packages/16",
"address": {
"street": "alonso de cordoba",
"number": "4499",
"complement": "alonso de cordoba 4499",
"commune": "PUDAHUEL",
"coords": {
"latitude": 0,
"longitude": 0
}
},
"inventory_activity": {
"inventory_activity_orders_attributes": [
{
"sku_id": 2,
"amount": 1,
"warehouse_id": 3
},
{
"sku_id": 3,
"amount": 2,
"warehouse_id": 3
}
]
},
"integration_reference": "1"
}
{
"id": 1,
"name": "Prueba de sku",
"company_id": 1,
"position": null,
"description": "Prueba de sku",
"created_at": "Wed, 06 Nov 2019 10:52:24 CLST -03:00",
"updated_at": "Wed, 06 Nov 2019 10:52:24 CLST -03:00",
"warehouse_id": 4,
"width": 15.0,
"length": 3.0,
"height": 23.0,
"weight": 0.3,
"barcode": "9789563606379",
"amount": 0,
"min_amount": 0,
"ftp_stock": 0,
"ftp_updated_at": 0,
"stock": {
"id": 1,
"received": 0,
"commited": 0,
"waste": 0,
"canceled": 0,
"available": 10,
"created_at": "Wed, 06 Nov 2019 10:52:24 CLST -03:00",
"updated_at": "Wed, 06 Nov 2019 10:52:24 CLST -03:00",
"ftp_stock": 0,
"ftp_updated_at": null,
"sku_id": 1,
"min_available": 3
}
}