Este método te permite crear un pedido en el sistema. Para acceder a este paso, debes realizar previamente la autenticación básica. Los datos que necesitas conocer para entrar a tu software son:

Método: post

Uri: api/order/

Endpoint: http://app.gobeeping.com/api/order/

Ejemplo de Curl

curl --location --request POST 'https://app.gobeeping.com/api/order' \
--header 'Authorization: Basic ------' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data" : {
        "ref": "#69546",
        "name": "#69546",
        "external_id": 6154654651465,
        "payment_method_id":1,
        "status": 1,
        "amount":29.99,
        "total_discount":0,
        "total_shipping":0,
        "shipping_name":"jarvin David Gómez cueva",
        "shipping_address_1":"calle monte  #37 1...2",
        "shipping_zip":"08904",
        "shipping_city":"hospitalet de Llobregat",
        "shipping_province":"Barcelona",
        "shipping_country":"Spain Peninsula",
        "shipping_country_code":"ES",
        "shipping_phone":"+34637360082",
        "email":"test@test.com",
        "shop_id":24
    },
    "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": null
      },
      {
        "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": null
      }
    ]
}'

Para poder realizar el método post, necesitas identificar una serie de elementos, empezando por la Basic Auth:

• '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)
• external_id: Corresponde al ID del pedido de tu tienda. En el caso de Shopify, si entras al pedido que quieres crear en el sistema, encontrarás el número al final del enlace, por ejemplo:

• payment_method_id: Método de pago utilizado en el pedido.
• status: Estado del pedido. Los status que se pueden poner en un pedido son:
  • 1 - Pendiente.
  • 6 - Por confirmar (hay que confirmarlo manualmente en el sistema o con el endpoint "mark-to-send" para que salga).
• amount: Importe del pedido.
• total_discount: Importe del descuento aplicado en el pedido.
• total_shipping: Importe del envío.
• shipping_name: Nombre del destinatario.
• shipping_address_1: 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.
• shop_id: ID de la tienda. (endpoint shops)

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.

Si quieres saber cómo listar los pedidos del sistema, puedes hacerlo entrando en este artículo.

Y si necesitas saber cómo marcar los pedidos para enviar, aquí te mostramos cómo hacerlo.