---
title: "Pedido creado"
method: POST
path: "/ecommerce.order.created"
---

# Pedido creado

`POST /ecommerce.order.created`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- object
  - `type` 'ecommerce.order.created': El tipo de webhook.
  - `data` object
    - `order` ApiOrder: Pedido de ecommerce.
      - `_id` string: ID del pedido.
      - `orderStatus` 'pending' | 'waiting' | 'preparing' | 'delivering' | 'done' | 'cancelled': Estado operacional del pedido.
      - `paymentStatus` 'pending' | 'done' | 'error' | 'blocked' | 'inReview' | 'waitingForAdditionalPayment': Estado del pago del pedido.
      - `isScheduled` boolean: Indica si el pedido es programado.
      - `isConfirmed` boolean: Indica si el pedido programado fue confirmado.
      - `websiteId` string: ID de la marca.
      - `storeId` string: ID del local.
      - `code` string: Código único del pedido en Justo.
      - `fullCode` string: Código del pedido con el correlativo diario de la marca.
      - `userId` string: ID del usuario que creó el pedido.
      - `createdAt` string, date-time: Fecha de creación del pedido.
      - `address` ApiOrderAddress: Dirección de entrega del pedido.
        - `_id` string: ID de la dirección.
        - `placeId` string: ID del lugar asociado a la dirección.
        - `address` string: Dirección principal en formato legacy.
        - `addressLine2` string: Departamento, oficina u otra información complementaria.
        - `addressSecondary` string: Comuna, ciudad o referencia secundaria de la dirección.
        - `location` object: Coordenadas geográficas.
          - `lat` number: Latitud.
          - `lng` number: Longitud.
      - `menuId` string: ID del menú desde el que se creó el pedido.
      - `deliveryType` 'delivery' | 'go' | 'serve': Tipo de entrega del pedido.
      - `deliverAt` string, date-time: Fecha en que el pedido debe ser entregado o retirado.
      - `timeText` string: Texto legible con la ventana estimada de entrega.
      - `paymentType` string: Medio de pago seleccionado.
      - `paymentTypeLabel` string: Nombre legible del medio de pago.
      - `paymentTypeIsIntegration` boolean: Indica si el medio de pago viene de una integración.
      - `tipAmount` number: Monto de propina.
      - `amountToPay` number: Monto total a pagar por el cliente, incluyendo propina.
      - `deliveryFee` number: Precio del despacho cobrado al cliente.
      - `deliveryFeeWithoutDiscount` number: Precio original del despacho antes de descuentos aplicados sobre el costo de entrega. Es un campo opcional de compatibilidad y solo se informa para integraciones legacy específicas.
      - `serviceFee` number: Cargo de servicio cobrado al cliente.
      - `itemsPrice` number: Precio de los productos, sin propina ni despacho.
      - `totalPrice` number: Monto del pedido sin propina.
      - `baseItemsPrice` number: Precio original de los productos antes de descuentos de producto, promociones, cupón, puntos o Justo Coins. Corresponde a la suma de amount * baseUnitPrice de los items.
      - `baseTotalPrice` number: Total original del pedido antes de descuentos, sin propina. Se calcula como baseItemsPrice + deliveryFee + serviceFee, usando el deliveryFee ya neto si el cupón descontó el despacho.
      - `itemsPriceBeforeDiscountsAfterProductDiscount` number: Precio de los productos después de descuentos propios del producto o promociones de producto, pero antes de cupón, puntos, Justo Coins y otros descuentos posteriores.
      - `totalPriceBeforeDiscountsAfterProductDiscount` number: Total del pedido después de descuentos propios del producto o promociones de producto, pero antes de cupón, puntos, Justo Coins y otros descuentos posteriores. Se calcula como itemsPriceBeforeDiscountsAfterProductDiscount + deliveryFee + serviceFee.
      - `discountedAmountAfterProductDiscount` number: Monto descontado después de aplicar descuentos propios del producto o promociones de producto y antes de separar quién financia el descuento. Se calcula como totalPriceBeforeDiscountsAfterProductDiscount - totalPrice e incluye descuentos posteriores como cupón, puntos de la marca y Justo Coins.
      - `justoCoinsDiscount` number: Monto descontado usando Justo Coins. Se limita al precio disponible del carrito después de cupón y otros descuentos aplicables, para evitar descontar más que el saldo pagable.
      - `websiteCoinsDiscount` number: Monto descontado usando puntos o coins del programa de fidelidad de la marca. Se limita al precio disponible del carrito después de cupón, Justo Coins y otros descuentos aplicables.
      - `totalDiscount` number: Monto total descontado del pedido frente al precio base. Es un campo derivado y se calcula como baseTotalPrice - totalPrice.
      - `amountFinancedByWebsite` number: Parte del descuento total financiada por la marca. Se calcula desde discountedAmountAfterProductDiscount restando la parte financiada por Justo.
      - `amountFinancedByJusto` number: Parte del descuento total financiada por Justo. Incluye Justo Coins y la porción del cupón financiada por Justo cuando aplica.
      - `expectedPreparationDuration` number: Tiempo estimado de preparación en minutos.
      - `deliveryDuration` number: Tiempo estimado de despacho en minutos.
      - `cashAmount` number: Monto que el cliente declara pagar si el medio de pago es efectivo.
      - `source` string: Origen del pedido.
      - `buyerName` string: Nombre del cliente.
      - `phone` string: Teléfono del cliente.
      - `email` string: Email del cliente.
      - `couponId` string: ID del cupón usado.
      - `couponName` string: Nombre del cupón usado.
      - `couponCode` string: Código del cupón usado.
      - `couponExternalId` string: ID externo del cupón usado, si el cupón lo tiene configurado.
      - `couponDiscount` number: Monto descontado por cupón. Puede incluir descuento sobre productos y, según el tipo de cupón, descuento sobre el despacho.
      - `couponPercentageOff` number: Porcentaje de descuento configurado en el cupón, cuando el cupón es porcentual.
      - `couponType` string: Tipo de cupón usado para calcular el descuento.
      - `promotionDiscount` number: Monto total descontado por promociones aplicadas a productos del pedido. Se calcula sumando items[].promotionDiscount.
      - `promotionIds` string[]: IDs únicos de las promociones aplicadas a los items del pedido.
      - `flagColor` string: Color de la bandera del pedido en POS.
      - `items` ApiOrderItem[]: Detalle de los productos vendidos en el pedido.
        - `_id` string: ID del item del pedido.
        - `product` object: Producto asociado al item.
          - `_id` string: ID Justo del producto.
          - `name` string: Nombre del producto al momento de la compra
          - `externalId` string: ID externo del producto configurado por la marca.
          - `metadata` object: Metadata del producto escrita por API v3.
          - `priceMetadata` object: Metadata del precio/disponibilidad escrita por API v3.
        - `unitPrice` number: Precio unitario con descuento, sin incluir descuento de cupón.
        - `baseUnitPrice` number: Precio unitario original antes de descuentos.
        - `productPrice` number: Precio del producto con descuento.
        - `baseProductPrice` number: Precio original del producto antes de descuentos.
        - `amount` number: Cantidad de este producto en el pedido.
        - `isReward` boolean: Indica si el item es una yapa (premio): un producto gratis que el cliente agregó al alcanzar el monto mínimo del pedido. Su precio siempre es 0.
        - `comment` string: Instrucciones adicionales para este producto.
        - `description` string: Resumen en texto de los modificadores e instrucciones del item.
        - `promotionId` string: ID de la promoción aplicada al item.
        - `promotionDiscount` number: Monto descontado por promoción en el item.
        - `promotionType` string: Tipo de promoción aplicada al item.
        - `promotionLabel` string: Etiqueta visible de la promoción aplicada al item.
        - `modifiers` ApiOrderItemModifier[]: Modificadores seleccionados para el item.
          - `modifierId` string: ID Justo del modificador.
          - `externalId` string: ID externo del modificador configurado por la marca.
          - `name` string: Nombre del modificador.
          - `shortName` string: Nombre corto del modificador.
          - `metadata` object: Metadata del modificador escrita por API v3.
          - `description` string: Resumen en texto de las opciones seleccionadas.
          - `countById` object: Cantidad seleccionada por ID Justo de opción.
          - `countByExternalId` object: Cantidad seleccionada por ID externo de opción.
          - `options` object[]: Opciones seleccionadas para este modificador.
            - `optionId` string: ID Justo de la opción.
            - `name` string: Nombre de la opción.
            - `price` number: Precio pagado por la opción.
            - `externalId` string: ID externo de la opción configurado por la marca.
            - `metadata` object: Metadata de la opción escrita por API v3.
            - `priceMetadata` object: Metadata del precio/disponibilidad escrita por API v3.
      - `transaction` ApiOrderTransaction: Transacción de pago asociada al pedido.
        - `_id` string: ID de la transacción.
        - `totalPrice` number: Monto total de la transacción.
        - `paymentType` string: Medio de pago usado en la transacción.
        - `cardType` string: Tipo de tarjeta usada, si aplica.
        - `cardLast4` string: Últimos cuatro dígitos de la tarjeta, si aplica.
        - `status` string: Estado de la transacción.
      - `deliveries` ApiOrderDelivery[]: Despachos asociados al pedido.
        - `_id` string: ID del despacho.
        - `price` number: Precio del despacho.
        - `status` 'active' | 'canceled' | 'cancelled' | 'done' | 'error' | 'pending' | 'scheduled' | 'delivering' | 'waiting' | 'unconfirmed': Estado del despacho.
        - `placeName` string: Nombre del lugar de destino.
        - `isCash` boolean: Indica si el despacho se paga en efectivo.
        - `instructions` string: Instrucciones para el despacho.
        - `driverPassword` string: Código que debe presentar el repartidor al retirar el pedido.
        - `fromLocation` object: Coordenadas geográficas.
          - `lat` number: Latitud.
          - `lng` number: Longitud.
        - `toLocation` object: Coordenadas geográficas.
          - `lat` number: Latitud.
          - `lng` number: Longitud.
        - `trackingURL` string: URL de seguimiento del despacho.
        - `orderId` string: ID del pedido asociado al despacho.
        - `activatesAt` string, date-time: Fecha en que se activa el despacho.
        - `createdAt` string, date-time: Fecha de creación del despacho.
        - `forDate` string, date-time: Fecha objetivo del despacho.
        - `nearStoreAt` string, date-time: Fecha en que el repartidor llegó cerca del local.
        - `pickupAt` string, date-time: Fecha de retiro del pedido.
        - `nearClientAt` string, date-time: Fecha en que el repartidor llegó cerca del cliente.
        - `completedAt` string, date-time: Fecha en que se completó el despacho.
        - `canceledAt` string, date-time: Fecha de cancelación del despacho.
        - `deliveryExpectedAt` string, date-time: Fecha estimada de entrega.
        - `estimatedArrivalAtStoreAt` string, date-time: Fecha estimada de llegada del driver al local.
        - `driverReceivedAt` string, date-time: Fecha en que el driver recibió el pedido, si aplica.
        - `driverInformation` object: Información del driver asignado, si está disponible.
        - `deliveryInformation` object: Información adicional del despacho, si está disponible.
        - `externalId` string: ID externo del despacho, si existe.
        - `specialCode` string: Código externo o especial del despacho, si existe.
      - `orderParams` object: Parámetros adicionales del pedido.
      - `hasManagedDelivery` boolean: Indica si el despacho es gestionado por Justo.
      - `gift` object: Información de regalo, si el pedido fue marcado como regalo.
      - `billing` object: Información de facturación del cliente.
      - `cancellationInfo` object: Información de cancelación del pedido.
      - `deliveryZoneName` string: Nombre de la zona de despacho aplicada al pedido.
  - `websiteId` string: ID de la marca.
  - `storeId` string: ID del local.
  - `date` string, date-time: Fecha en que se generó el evento.
  - `eventId` string: ID único del evento.

## Response `200`

OK

## Changes

- **2026-10-31** `6105f2d38376`: 1 info
  - added the new optional request property `data/order/items/items/isReward`
- **2026-06-17** `925923c4bb71`: 6 warning
  - removed the request property `data/order/deliveries/items/driverInformation/categoryId`
  - removed the request property `data/order/deliveries/items/driverInformation/code`
  - removed the request property `data/order/deliveries/items/driverInformation/image`
  - removed the request property `data/order/deliveries/items/driverInformation/name`
  - …2 more
- **2026-06-11** `bc52b02a4014`: 6 info
  - added the new optional request property `data/order/deliveries/items/driverInformation/categoryId`
  - added the new optional request property `data/order/deliveries/items/driverInformation/code`
  - added the new optional request property `data/order/deliveries/items/driverInformation/image`
  - added the new optional request property `data/order/deliveries/items/driverInformation/name`
  - …2 more
- **2026-06-05** `09dca7098250`: 15 info
  - added the new optional request property `data/order/amountFinancedByJusto`
  - added the new optional request property `data/order/amountFinancedByWebsite`
  - added the new optional request property `data/order/baseItemsPrice`
  - added the new optional request property `data/order/baseTotalPrice`
  - …11 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/getjusto/apis/justo-api-webhooks/changes/ecommerce.order.created/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api-webhooks.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api-webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api-webhooks/revisions/8be0f7fe4407?raw)
