Crear nuevos pedidos

Crea uno o múltiples pedidos para una mesa o grupo específico.

Autenticación requerida: Este endpoint requiere autenticación Bearer Token. Usar el campo tokenCurrent obtenido del servicio de login (/login) en el header: Authorization: Bearer {tokenCurrent}

Proceso de creación:

  • Los pedidos se agrupan automáticamente por mesa/grupo
  • Se calculan totales incluyendo productos extras
  • Se actualiza inventario según configuración
  • Se notifica via WebSocket para actualizaciones en tiempo real

Limitaciones plan extracción: Los negocios en plan de extracción no pueden crear nuevos pedidos.

Ejemplos de Uso

1. Pedido simple para mesa

{
  "table": "507f1f77bcf86cd799439014",
  "group": "507f1f77bcf86cd799439015",
  "groupName": "Mesa 5 - Orden 1",
  "orders": [
    {
      "product": "507f1f77bcf86cd799439013",
      "quantity": 2,
      "unit_price": 15000,
      "notes": ["Sin cebolla", "Extra queso"]
    }
  ]
}

2. Pedido con productos extras

{
  "table": "507f1f77bcf86cd799439014",
  "group": "507f1f77bcf86cd799439015",
  "groupName": "Mesa 5 - Orden 2",
  "orders": [
    {
      "product": "507f1f77bcf86cd799439013",
      "quantity": 1,
      "unit_price": 15000,
      "productsExtra": [
        {
          "product": "507f1f77bcf86cd799439020",
          "quantity": 1,
          "price": 3000
        }
      ]
    }
  ]
}

3. Pedido cortesía (gratuito)

{
  "table": "507f1f77bcf86cd799439014",
  "group": "507f1f77bcf86cd799439015",
  "groupName": "Mesa 5 - Cortesía",
  "orders": [
    {
      "product": "507f1f77bcf86cd799439013",
      "quantity": 1,
      "complementary": {
        "isComplementary": true,
        "note": "Cortesía del chef"
      }
    }
  ]
}

4. Pedido para entrega (sin mesa)

{
  "group": "507f1f77bcf86cd799439015",
  "groupName": "Entrega - Cliente Juan",
  "seller": "507f1f77bcf86cd799439016",
  "orders": [
    {
      "product": "507f1f77bcf86cd799439013",
      "quantity": 1,
      "delivery": {
        "isDelivery": true,
        "deliveryProvider": "507f1f77bcf86cd799439017"
      }
    }
  ]
}

5. Múltiples pedidos en una sola petición

{
  "table": "507f1f77bcf86cd799439014",
  "group": "507f1f77bcf86cd799439015",
  "groupName": "Mesa 8 - Familia González",
  "orders": [
    {
      "product": "507f1f77bcf86cd799439013",
      "quantity": 2,
      "unit_price": 15000,
      "notes": ["Término medio", "Sin mostaza"]
    },
    {
      "product": "507f1f77bcf86cd799439021",
      "quantity": 3,
      "unit_price": 8000,
      "notes": ["Extra hielo"]
    },
    {
      "product": "507f1f77bcf86cd799439022",
      "quantity": 1,
      "unit_price": 12000,
      "productsExtra": [
        {
          "product": "507f1f77bcf86cd799439023",
          "quantity": 2,
          "price": 2000
        }
      ]
    },
    {
      "product": "507f1f77bcf86cd799439024",
      "quantity": 1,
      "complementary": {
        "isComplementary": true,
        "note": "Postre de cumpleaños"
      }
    }
  ]
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

ID de la mesa (requerido para negocios con mesas)

string
required

ID del grupo de pedidos

string
required

Nombre descriptivo del grupo

string

ID del vendedor/mesero (opcional, por defecto usuario autenticado)

boolean

Desactivar notificación WebSocket

orders
array of objects
required

Lista de pedidos a crear

orders*
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json