Editar un pedido

Configura la API para poder editar un pedido en el sistema.
BF
Escrito por Beeping Fulfilment SL
Actualizado hace 9 meses

Este método permite editar un pedido. Para acceder a este paso, debes realizar previamente la autenticación básica. Si lo que necesitas es crear un pedido, revisa este artículo.

IMPORTANTE: Solo se pueden actualizar pedidos en status 1 y 2, es decir, aquellos que estén en Pendiente y/o en Pendiente de stock.

Los datos que necesitas conocer son:

Método: PUT

Uri: api/order/{external_id}

Endpoint: https://app.gobeeping.com/api/order/61546594651467

Ejemplo de Curl

curl --location --request PUT 'https://app.gobeeping.com/api/order/615465984651465' \
--header 'Authorization: Basic XXXXXXXXXX’ \
--header 'Content-Type: application/json' \
--data-raw '{
    "data" : {
        "shipping_name":"Jarvin Gómez Updated"
    },
    "lines": [
      {
        "name": "Aspirador portátil 120W",
        "sga_product_id": 1230,
        "external_product_id": "6657388544090",
        "external_variant_id": "39645646848090",
        "amount": 19.99,
        "qty": 1,
        "sku": "8435411515089",
        "barcode": "4654646"
      },
      {
        "name": "Aspirador portátil 180W",
        "sga_product_id": 1231,
        "external_product_id": "6657388544090",
        "external_variant_id": "35645646848090",
        "amount": 19.99,
        "qty": 1,
        "sku": "8535411515089",
        "barcode": "4654646"
      }
    ]
}'

Para poder realizar el método put, necesitas identificar los siguientes elementos:

  • {external_id}: corresponde al ID del pedido de tu tienda. En el caso de Shopify, si entras al pedido que quieres marcar para enviar, encontrarás el número al final del enlace, por ejemplo:

  • 'Authorization: Basic XXXXXXXXXX' : aquí debes colocar la Basic Auth obtenida en el paso anterior: cómo hacer login.

Además, encontrarás los elementos divididos en dos bloques: data y lines

Por un lado, los elementos dentro de data hacen referencia a la información del pedido, y puedes identificar los siguientes: 

  • ref: Referencia interna del pedido. (String)
  • name: Nombre del pedido. (String)
  • shipping_name: Nombre del destinatario.
  • shipping_address_1: Dirección de envío.
  • shipping_address_2: Dirección de envío
  • shipping_zip: Código postal de envío.
  • shipping_city: Ciudad de envío.
  • shipping_province: Provincia de envío.
  • shipping_country: País de envío.
  • shipping_country_code: Código ISO del país de envío.
  • shipping_phone: Teléfono de contacto del envío.
  • email: Email de contacto del envío.

Por otro lado, los elementos dentro de lines hacen referencia a la información del producto que se ha adquirido en el pedido. Estos elementos son:

  • name: Nombre del producto.
  • sga_product_id: ID del producto en el sistema de Beeping.
  • external_product_id: ID del producto en Shopify.
  • external_variant_id: ID de la variante en Shopify.
  • amount: Precio del producto.
  • qty: Cantidad del producto.
  • sku: Referencia del producto.
  • barcode: Código de barras del producto.

Los parámetros admitidos son:

Parámetro Descripción
data

Json con los datos del pedido

‘ref’ = ‘string|max:255’,
‘name’ = ‘string|max:255’,
‘shipping_name’ = ‘string|max:255’,
‘shipping_address_1’ = ‘string|max:255’,
‘shipping_address_2’ = ‘string|max:255’,
‘shipping_zip’ = ‘string|max:255’,
‘shipping_city’ = ‘string|max:255’,
‘shipping_province’ = ‘string|max:255’,
‘shipping_country’ = ‘string|max:255’,
‘shipping_country_code’ = ‘string|max:255’,
‘shipping_phone’ = ‘string|max:255’,
‘email’ = ‘email|max:255’,
lines

Json con los datos de los productos. Debe ir siempre completa

‘name’ = ‘required|string|max:255’,
‘sga_product_id’ = ‘string|max:255’,
‘external_product_id’ = ‘required|max:255’,
‘external_variant_id’ = ‘string|max:255’,
‘amount’ = ‘required|numeric’,
‘qty’ = ‘required|numeric’,
‘sku’ = ‘required|string’,
‘barcode’ = ‘required|string|max:255’

En estos otros artículos puedes aprender a listar un pedido, consultar un pedido, marcar un pedido para enviar o cancelar un pedido.

¿Pudimos contestar tu pregunta?