Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt

Use this file to discover all available pages before exploring further.

Agrega un producto al carrito del customer para el website. Todas las llamadas usan Authorization: Bearer <token> con scope orderingApi.

​
Endpoint

POST /v3/ordering/customers/{externalCustomerId}/websites/{domain}/cart/items

​
Path parameters

​
Body

​
Response

​
success
boolean
required
Indica si la llamada fue procesada correctamente.
​
data
OrderingCartItemMutation
required
Item agregado y estado actualizado del carrito.

​
Data object

​
OrderingCartItemMutation

Resultado de una mutación de item de carrito.
​
item
OrderingCartItem
Ver OrderingCartItem.
​
state
OrderingCartState
Ver OrderingCartState.

​
OrderingCartItem

Item del carrito.
​
_id
string
ID del item del carrito.
​
productId
string
ID del producto.
​
menuId
string | null
ID del menú.
​
amount
number
Cantidad del producto.
​
quantity
number
Cantidad del producto en flujos v2.
​
comment
string | null
Comentario del item.
​
modifiers
object[]
Modificadores seleccionados.
​
product
object
Producto asociado al item.
​
unitPrice
number
Precio unitario.
​
totalPrice
number
Precio total del item.

​
OrderingCartState

Estado completo del carrito y checkout.
​
preference
OrderingCartPreference
Ver OrderingCartPreference.
​
address
OrderingAddress | null
Ver OrderingAddress.
​
store
OrderingStore | null
Ver OrderingStore.
​
timeOptions
OrderingTimeOption[]
Horarios disponibles.
​
availablePaymentMethods
OrderingPaymentMethod[]
Medios de pago disponibles.
​
cart
OrderingCart | null
Ver OrderingCart.

​
OrderingCartPreference

Preferencias activas del carrito.
​
websiteId
string
ID del website.
​
userId
string
ID del usuario sintético.
​
deviceId
string
Device ID usado por Ordering API.
​
storeId
string | null
ID del local seleccionado.
​
menuId
string | null
ID del menú seleccionado.
​
placeId
string | null
Place ID seleccionado.
​
deliveryType
delivery | go | serve | null
Tipo de entrega.
​
paymentType
string | null
Medio de pago seleccionado.
​
otherPaymentType
string | null
Subtipo de pago, si aplica.
​
couponCode
string | null
Código de cupón aplicado.
​
time
string | null
Hora seleccionada. Usa now para pedidos inmediatos.
​
timeLabel
string | null
Texto visible de la hora seleccionada.
​
dropOffType
string | null
Tipo de entrega en destino.
​
tableName
string | null
Mesa o identificador de consumo en local.
​
cashAmount
number | null
Monto declarado para pago en efectivo.
​
cardId
string | null
ID de tarjeta guardada.
​
justoCoinsToSpend
number | null
Justo Coins a usar.
​
websiteCoinsToSpend
number | null
Website Coins a usar.

​
OrderingAddress

Dirección guardada por el customer de Ordering API.
​
_id
string
ID de la dirección.
​
placeId
string
Place ID usado por Justo para calcular cobertura y despacho.
​
address
string
Dirección principal.
​
addressLine2
string | null
Departamento, oficina u otra información secundaria.
​
addressSecondary
string | null
Texto secundario de comuna, ciudad o referencia.
​
location
OrderingLocation
Ver OrderingLocation.
​
acceptsNoLine2
boolean
Indica si el customer confirmó que no tiene línea 2.
​
comment
string | null
Comentario o instrucciones de entrega.
​
userId
string
ID del usuario sintético dueño de la dirección.
​
deviceId
string | null
Device ID usado al crear la dirección.
​
streetAddress
string | null
Calle y numeración normalizada.
​
locality
string | null
Localidad o comuna.
​
subLocality
string | null
Sub-localidad.
​
region
string | null
Región o estado.
​
postalCode
string | null
Código postal.
​
countryCode
string | null
Código de país ISO 3166-1 alpha-2.
​
countryName
string | null
Nombre del país.
​
createdAt
string
Fecha de creación.

​
OrderingStore

Local disponible para operar pedidos.
​
_id
string
ID del local.
​
websiteId
string
ID del website al que pertenece el local.
​
name
string
Nombre del local.
​
timezone
string
Zona horaria del local.
​
acceptDelivery
boolean
Indica si acepta despacho.
​
acceptGo
boolean
Indica si acepta retiro.
​
acceptServe
boolean
Indica si acepta consumo en local.
​
acceptReservations
boolean
Indica si acepta reservas.
​
acceptWaitingList
boolean
Indica si acepta lista de espera.
​
minimumAnticipationDays
number
Días mínimos de anticipación para pedidos programados.
​
hideTip
boolean
Indica si se oculta la propina.
​
forceHideDeliveryTip
boolean
Indica si se fuerza ocultar propina de delivery.
​
defaultsManagedDelivery
boolean
Indica si el local usa despacho gestionado por defecto.
​
deliveryCostType
string
Tipo de cálculo de costo de despacho.
​
cityId
string
ID de la ciudad marketplace.
​
address
OrderingStoreAddress
Ver OrderingStoreAddress.
​
humanSchedule
OrderingHumanSchedule[]
Horario de atención legible.
​
reservationsHumanSchedule
OrderingHumanSchedule[]
Horario de reservas legible.
​
zones
object[]
Zonas de despacho del local.
​
availablePaymentMethodInfo
OrderingPaymentMethod[]
Medios de pago disponibles para el local.
​
supportOptions
object
Canales de soporte del local.

​
OrderingTimeOption

Opción de horario disponible.
​
value
string
Valor que debe enviarse como time.
​
label
string
Texto visible del horario.
​
disabled
boolean
Indica si la opción no está disponible.

​
OrderingPaymentMethod

Medio de pago disponible.
​
paymentMethod
string
Código del medio de pago.
​
label
string
Nombre visible del medio de pago.
​
canDeliver
boolean
Indica si permite despacho.
​
isIntegration
boolean
Indica si el pago depende de una integración externa.
​
allowedDeliveryTypes
delivery | go | serve[]
Tipos de entrega permitidos para este medio de pago.
​
requiresRoundTrip
boolean
Indica si requiere viaje ida y vuelta.
​
isAvailableInV3
boolean
Indica si está disponible para API v3.
​
isSecure
boolean
Indica si requiere validaciones seguras adicionales.

​
OrderingCart

Carrito calculado.
​
websiteId
string
ID del website.
​
menuId
string | null
ID del menú.
​
storeId
string | null
ID del local.
​
deliveryType
delivery | go | serve | null
Tipo de entrega.
​
placeId
string | null
Place ID seleccionado.
​
couponCode
string | null
Cupón aplicado.
​
paymentType
string | null
Medio de pago seleccionado.
​
otherPaymentType
string | null
Subtipo de pago, si aplica.
​
tipAmount
number | null
Monto de propina seleccionado.
​
tipPercentage
number | null
Porcentaje de propina seleccionado.
​
calculatedTipAmount
number | null
Propina calculada por defecto.
​
justoCoinsToSpend
number | null
Justo Coins a usar.
​
websiteCoinsToSpend
number | null
Website Coins a usar.
​
items
OrderingCartItem[]
Items del carrito.
​
acceptsTip
boolean
Indica si el carrito acepta propina.
​
couponStatus
object | null
Estado del cupón aplicado.
​
benefits
object[]
Beneficios o promociones aplicadas.
​
deliveryFee
number
Costo de despacho.
​
deliveryFeeWithoutDiscount
number
Costo de despacho antes de descuentos.
​
itemsPrice
number
Precio de productos.
​
itemsPriceWithoutDiscount
number
Precio de productos antes de descuentos.
​
serviceFee
number
Cargo de servicio.
​
totalPrice
number
Total sin propina.
​
amountToPay
number
Total a pagar.

​
OrderingLocation

Coordenadas geográficas.
​
lat
number
Latitud.
​
lng
number
Longitud.

​
OrderingStoreAddress

Dirección pública de un local.
​
placeId
string
Place ID del local.
​
streetAddress
string
Dirección principal.
​
extendedAddress
string | null
Dirección extendida.
​
location
OrderingLocation
Ver OrderingLocation.
​
locality
string | null
Localidad o comuna.
​
countryName
string | null
País.

​
OrderingHumanSchedule

Bloque de horario legible.
​
days
string
Días a los que aplica el horario.
​
schedule
string
Horario legible.