Histórico da Página

CONTEÚDO

Visão Geral
Endpoint
Dicionário
Links

01. VISÃO GERAL
Âncora
ver_geral
ver_geral

Este Esse endpoint é utilizado para realizar pedidosenviar requisições de novos pedidos de mesa via barramento na API Order, focado em consumo no local. Ele permite gerenciar pedidos associados a mesas específicas, incluindo informações de itens, descontos, extras, métodos de pagamento, e identificação de mesa e/ou cartão consumo.

...

02. ENDPOINT
Âncora
endpoint
endpoint

Método	URL	Ambiente
POST	https://api-barramento.meuelevestage.com/order/newOrder	Homogação
POST	https://api-barramento.meueleve.com.br/order/newOrder	Produção

...

03

...

. DICIONÁRIO
Âncora
dicionario
dicionario

Estrutura newOrder:

Campo	Valor	Descrição
integrationHubServiceId *	string	Identificador único da integração
data *	array	Dados necessário para o pedido

Tabela de auxiliares e enumerações:

Estrutura newOrder (dentro de data):

Campo	Valor	Descrição
id *	string	O identificador exclusivo do pedido. O ID do pedido é gerado pelo Aplicativo de Pedidos
type *	enum	Tipo de pedido (veja na tabela type)
displayId *	string	ID do pedido mostrado na interface do aplicativo de pedidos do cliente
sourceAppId	string	Este campo deverá ser preenchido com o AppId do Aplicativo de Pedido que originou o pedido. Este campo serve para auxiliar as aplicações que funcionarão como Hub, intermediando as solicitações da Aplicação de Pedido com o Serviço de Software
salesChannel	string	Você pode indicar por qual canal de vendas este pedido foi originado
createdAt *	string	Data e hora de criação do pedido (data e hora UTC no formato de carimbo de data/hora ISO). **
lastEvent	string	O último evento válido pesquisado (reconhecido ou não) ou enviado via webhook.** (veja na tabela lastEvent)
orderTiming *	string	Tempo do pedido. Indica se o PEDIDO terá entrega imediata ou programada (veja na tabela orderTiming)
preparationStartDateTime *	string	Sugestão de horário de início da preparação após a criação do Pedido. Isso pode ser usado pelo Aplicativo de Pedidos para informar o estabelecimento comercial sobre o atraso no início da preparação por qualquer motivo. O padrão é o mesmo horário de criação do pedido
merchant *	string	Informações do comerciante (veja na merchant)
items	array	Encomendar itens (veja na tabela items)
otherFees	array	Outras taxas que podem ser aplicadas (veja na tabela otherFees)
discounts	array	Quaisquer descontos que possam ser aplicados (veja na tabela discounts)
total	array	Conjunto de campos com a soma dos valores descritos anteriormente no pedido (veja na tabela total)
payments	string	Toda a descrição do pagamento, como formas, pré-pagamentos, troco, etc. (veja na tabela payments)
customer	string	Informações relacionadas ao cliente. OBRIGATÓRIO se o tipo escolhido for DELIVERY (veja na tabela customer)
schedule	string	Informações para pedidos agendados. OBRIGATÓRIO se orderTiming estiver AGENDADO (veja na tabela schedule)
delivery	string	Informações para pedidos DELIVERY. OBRIGATÓRIO se o tipo escolhido for DELIVERY (veja na tabela delivery)
takeout	string	Informações para pedidos TAKEOUT. OBRIGATÓRIO se o tipo escolhido for TAKEOUT (veja na tabela takeout)
indoor	string	Informações para pedidos INDOOR. OBRIGATÓRIO se o tipo escolhido for INTERIOR (veja na tabela indoor)
table	string	Informações para pedidos de TABLE. OBRIGATÓRIO se o tipo escolhido for TABLE (veja na tabela table)
card	string	Informações para pedidos CARD. OBRIGATÓRIO se o tipo escolhido for CARTÃO (vejna na tabela card)
sendDelivered	boolean	Este campo indica se é necessário que o Serviço de Software faça uma solicitação ao terminal para indicar ao Aplicativo de Pedido que o pedido foi entregue ao cliente. true: Indica que o Aplicativo de Pedido está aguardando uma solicitação. falso: ou não informado: Não é obrigatório fazer solicitação.
sendTracking	boolean	Este campo indica se é necessário que o Serviço de Software faça uma solicitação ao terminal para informar o Aplicativo de Pedido sobre atualizações de entrega. true: Indica que o Aplicativo de Pedido está aguardando uma solicitação. falso: ou não informado: Não é obrigatório fazer solicitação.
extraInfo	string	Informações extras, se necessário

Estrutura Data (dentro de type):
Âncora
table_type
table_type

Enum	Valor	Descrição
DELIVERY	DELIVERY	Para pedidos que serão entregues no endereço do cliente.
TAKEOUT	TAKEOUT	Pedidos que serão retirados no estabelecimento pelo cliente.
INDOOR	INDOOR	Pedidos que serão consumidos dentro do estabelecimento.
TABLE	TABLE	Pedidos que serão consumidos à mesa.
CARD	CARD	Pedidos que terão seu consumo alocado no cartão do estabelecimento.
COUNTER	COUNTER	Pedidos que serão atendidos no balcão do estabelecimento.*

Estrutura Enumeração lastEvent (dentro de data):
Âncora
table_lastEvent
table_lastEvent

Enum	Value	Descrição
CREATED	CREATED	Criado o pedido foi criado no sistema
CONFIRMED	CONFIRMED	Confirmado o pedido foi confirmado pelo estabelecimento
DISPATCHED	DISPATCHED	Despachado o pedido foi enviado para entrega
READY_FOR_PICKUP	READY_FOR_PICKUP	Pronto para Retirada o pedido está pronto para ser retirado
PICKUP_AREA_ASSIGNED	PICKUP_AREA_ASSIGNED	Área de Retirada Atribuída uma área específica para retirada foi designada para o pedido
DELIVERED	DELIVERED	Entregue o pedido foi entregue ao cliente
CONCLUDED	CONCLUDED	Concluído o pedido foi totalmente processado e finalizado
CANCELLATION_REQUESTED	CANCELLATION_REQUESTED	Cancelamento Solicitado um pedido de cancelamento foi feito
CANCELLATION_REQUEST_DENIED	CANCELLATION_REQUEST_DENIED	Solicitação de Cancelamento Negada o pedido de cancelamento foi negado
CANCELLED	CANCELLED	Cancelado: o pedido foi cancelado
ORDER_CANCELLATION_REQUEST	ORDER_CANCELLATION_REQUEST	Solicitação de Cancelamento de Pedido uma solicitação de cancelamento do pedido foi enviada
CANCELLED_DENIED	CANCELLED_DENIED	Cancelamento Negado o cancelamento do pedido foi negado

Estrutura Enumeração orderTiming (dentro de data):
Âncora
table_orderTiming
table_orderTiming

Enum	Value	Descrição
INSTANT	INSTANT	Instantâneo pedido será processado e entregue imediatamente
SCHEDULED	SCHEDULED	Agendado pedido foi programado para ser entregue em um horário específico no futuro

Estrutura Data (dentro de merchant):
Âncora
table_merchant
table_merchant

Campo	Valor	Descrição
id	string	Identificador Único. Identifica o estabelecimento comercial nos diferentes sistemas com os quais o estabelecimento comercial irá se comunicar. Este ID deve ser gerado pelo Software Service do comerciante. Para evitar duplicatas entre diferentes comerciantes, é recomendado que o software crie o MerchantId usando: Documento do comerciante + UUID. Se isso não for possível, recomenda-se usar pelo menos um UUID.
name	string	Nome público do comerciante

Estrutura Data (dentro de items):
Âncora
table_items
table_items

Campo	Valor	Descrição
id	string	Identificador único do item
index	string	Posição do item (opcional)
name	string	Nome do produto
externalCode	string	Código externo do produto (opcional)
unit	string	Unidade de medida do item (veja na tabela unit)
ean	string	Código de barras EAN do item (opcional)
quantity	number	Quantidade de itens
specialInstructions	string	Instruções especiais sobre o item (opcional)
unitPrice	array	Preço por unidade, considerando 4 casas decimais (veja tabela de unitPrice)
originalPrice	array	Preço original do produto (opcional) (veja tabela de originalPrice)
optionsPrice	array	Preço total das opções (opcional) (veja tabela de optionsPrice)
totalPrice	number	Preço total do item (veja tabela de totalPrice)
options	array	Extras opcionais escolhidos pelo consumidor. (veja na tabela de options)
productionPoint	string	Ponto de produção do produto

Estrutura Enumeração Consumption - items (dentro de unit):
Âncora
table_unit
table_unit

Enum	Valor	Descrição
UN	UN	Unidade de medida simples
KG	KG	Quilograma
L	L	Litro
OZ	OZ	Onça
LB	LB	Libra
GAL	GAL	Galão

Estrutura Consumption - items (dentro de unitPrice):
Âncora
table_unitPrice
table_unitPrice

Campo	Valor	Descrição
value	number	Valor do preço
currency	string	Código da moeda ISO 4217

Estrutura Consumption - items (dentro de originalPrice):
Âncora
table_originalPrice
table_originalPrice

Campo	Valor	Descrição
value	number	Valor do preço
currency	string	Código da moeda ISO 4217

Estrutura Consumption - items (dentro de optionsPrice):
Âncora
table_optionsPrice
table_optionsPrice

Campo	Valor	Descrição
value	number	Valor do preço
currency	string	Código da moeda ISO 4217

Estrutura Consumption - items (dentro de totalPrice):
Âncora
table_totalPrice
table_totalPrice

Campo	Valor	Descrição
value	number	Valor do preço
currency	string	Código da moeda ISO 4217

Estrutura Data - items (dentro de options):
Âncora
table_options
table_options

Campo	Valor	Descrição
index	string	Posição da opção (opcional)
id	string	Identificador único da opção
name	string	Nome da opção
externalCode	string	Código do produto externo
unit	enum	Unidade de medida da opção (veja na tabela unit)
ean	string	EAN é o padrão de código de barras usado nos itens.
quantity	number	Quantidade de itens opcionais
unitPrice	array	Preço por unidade, considerando 4 casas decimais (veja tabela de unitPrice).
originalPrice	array	Preço original do produto (opcional) (veja tabela de originalPrice).
totalPrice	array	Preço total da opção (veja tabela de totalPrice)
specialInstructions	string	Instruções especiais sobre a opção (opcional)
productionPoint	string	Ponto de produção da opção (opcional)

Estrutura Data (dentro de otherFees):
Âncora
table_otherFees
table_otherFees

Campo	Valor	Descrição
name	string	Nome relacionado às taxas
type	enum	Tipo da taxa (veja na tabela type)
receivedBy	enum	Pedido recebido por (veja na tabela receivedBy)
receiverDocument	string	Documento do receptor de outras taxas
price	array	Preço da taxa(veja tabela de price).
observation	string	Observação de outras taxas. Quaisquer comentários extras

Estrutura Enumeração Data - otherFees (dentro de type):
Âncora
table_OrderFeesType
table_OrderFeesType

Enum	Valor	Descrição
DELIVERY_FEE	DELIVERY_FEE	Taxa de entrega
SERVICE_FEE	SERVICE_FEE	Taxa de serviço
TIP	TIP	Gorjeta

Estrutura Enumeração Data - otherFees (dentro de receivedBy):
Âncora
table_receivedBy
table_receivedBy

Enum	Valor	Descrição
MARKETPLACE	MARKETPLACE	Entidade que recebeu o pedido é o marketplace
MERCHANT	MERCHANT	Entidade que recebeu o pedido é o comerciante
LOGISTIC_SERVICES	LOGISTIC_SERVICES	Entidade que recebeu o pedido é a logística

Estrutura Data - otherFees (dentro de price):
Âncora
table_price
table_price

Campo	Valor	Descrição
value	number	Valor do preço
currency	string	Código da moeda ISO 4217

Estrutura Data (dentro de discounts):
Âncora
table_discounts
table_discounts

Campo	Valor	Descrição
value	number	Valor do desconto
target	enum	Destino do desconto (vejna na tabela de cart)
targetId	string	Identificador do alvo (obrigatório quando target = ITEM).
sponsorshipValues	array	Valores patrocinados por qualquer uma das partes. A soma dos valores listados neste atributo deverá corresponder ao valor informado no atributo valor acima (veja na tabela sponsorshipValues)

Estrutura Data - discounts - (dentro de target):
Âncora
table_price
table_price

Enum	Valor	Descrição
CART	CART	Carrinho o desconto aplica-se ao valor total do carrinho
DELIVERY_FEE	DELIVERY_FEE	Taxa de entrega o desconto aplica-se ao valor da taxa de entrega. Código da moeda ISO 4217
ITEM	ITEM	Item o desconto aplica-se a um item específico do pedido. Obrigatório apenas para target = ITEM

Estrutura Enumeração Data - discounts(dentro de sponsorshipValues):
Âncora
table_sponsorshipValues
table_sponsorshipValues

Enum	Valor	Descrição
MARKETPLACE	MARKETPLACE	Entidade responsável pela entrega é o marketplace
MERCHANT	MERCHANT	Entidade responsável pela entrega é o comerciante

Estrutura Data (dentro de total):
Âncora
table_total
table_total

Campo	Valor	Descrição
items	number	Soma do preço total dos itens listados no atributo itens
otherFees	number	Soma do valor total das demais taxas listadas no atributo otherFees. Se não houver, use 0
discount	number	Soma de quaisquer descontos que possam estar listados no atributo descontos. Se não houver, use 0
orderAmount	number	O valor final da encomenda (itens + outrasTaxas +Taxas adicionais +Taxa de entrega - descontos)
additionalFees	number	Soma do valor total das taxas adicionais listadas no atributo adicionalFees. Se não houver, use 0
deliveryFee	number	Soma do valor total da taxa de entrega listada no atributo deliveryFee. Se não houver, use 0

Estrutura Data (dentro de payment):
Âncora
table_payments
table_payments

Campo	Valor	Descrição
prepaid	number	Valor pago antecipadamente
pending	number	Valor que ainda será pago
methods	array	A forma de pagamento utilizada. Seja online, na entrega, cartão de crédito, voucher, dinheiro, etc. (veja tabela methods)

Estrutura Enumeração Data - payment (dentro de methodos):
Âncora
table_methods
table_methods

Enum	Valor	Descrição
CREDIT	CREDIT	Crédito pagamento realizado com cartão de crédito
DEBIT	DEBIT	Débito pagamento realizado com cartão de débito
MEAL_VOUCHER	MEAL_VOUCHER	Vale-refeição pagamento realizado com um vale-refeição
FOOD_VOUCHER	FOOD_VOUCHER	Vale-alimentação pagamento realizado com um vale-alimentação
DIGITAL_WALLET	DIGITAL_WALLET	Carteira digital pagamento realizado via uma carteira digital.
PIX	PIX	Pix pagamento realizado via o sistema de pagamento instantâneo Pix
CASH	CASH	Dinheiro pagamento realizado em espécie
CREDIT_DEBIT	CREDIT_DEBIT	Crédito/Débito combinação de cartão de crédito e débito
COUPON	COUPON	Cupom pagamento realizado com um cupom de desconto
REDEEM	REDEEM	Resgatar pagamento feito através de um programa de recompensas
PREPAID_REDEEM	PREPAID_REDEEM	Resgatar pré-pago pagamento feito com valores pré-pagos em um programa de recompensas
OTHER	OTHER	Outro pagamento realizado com outro método que não está listado

Estrutura Data (dentro de customer):
Âncora
table_customer
table_customer

Campo	Valor	Descrição
id	string	Um identificador exclusivo relacionado ao consumidor. Caso o Aplicativo de Pedidos não possua um Id para o cliente, este Id poderá ser gerado no momento da criação do pedido
name	string	Nome do cliente
document	string	Documento do cliente. Este documento poderá ser enviado para tratar de questões tributárias
phone	string	Telefone do cliente. Aqui você pode inserir diretamente o número de telefone do cliente (desde que o cliente tenha dado permissão para que esses dados sejam compartilhados, de acordo com as políticas locais) ou outro número de telefone (como o número de telefone da central de atendimento do aplicativo de pedidos) onde o comerciante possa se comunicar sobre problemas do pedido que afetam o cliente (como problemas de saúde) (veja tabela phone)
email	string	E-mail do cliente. Este documento poderá ser enviado para tratar de questões tributárias
ordersCountOnMerchant	string	Número total de pedidos que o cliente já fez no estabelecimento

Estrutura Data - customer (dentro de phone):
Âncora
table_phone
table_phone

Campo	Valor	Descrição
number	string	Número de telefone do cliente do pedido
extension	string	Solicitar extensão de telefone do cliente

Estrutura Data (dentro de schedule):
Âncora
table_schedule
table_schedule

Campo	Valor	Descrição
scheduledDateTimeStart	string	Data e hora em que o pedido estará pronto. Pode ser calculado pelo Aplicativo de Pedidos utilizando o tempo médio de preparo dos pratos. O padrão é o mesmo horário de criação do pedido
scheduledDateTimeEnd	string	Data e hora em que o pedido estará pronto. Pode ser calculado pelo Aplicativo de Pedidos utilizando o tempo médio de preparo dos pratos. O padrão é o mesmo horário de criação do pedido

Estrutura Data (dentro de delevery):
Âncora
table_delivery
table_delivery

Campo	Valor	Descrição
deliveredBy	enum	Solicitar entrega por (veja na tabela de deliveredBy)
deliveryAddress	array	O endereço onde o pedido será entregue (veja na tabela deliveryAddress)
estimatedDeliveryDateTime	string	Data e hora estimada de entrega. A mesma data mostrada ao cliente, na interface do Aplicativo de Pedidos
deliveryDateTime	string	Data de entrega. A data e hora em que a entrega realmente ocorreu.

Estrutura Enumeração Data - delivery (dentro de deliveredBy):
Âncora
table_deliveredBy
table_deliveredBy

Enum	Valor	Descrição
MARKETPLACE	MARKETPLACE	Entidade responsável pela entrega é o marketplace
MERCHANT	MERCHANT	Entidade responsável pela entrega é o comerciante

Estrutura Data - delivery (dentro de deliveryAddress):
Âncora
table_deliveryAddress
table_deliveryAddress

Campo	Valor	Descição
country	string	Tipo de pedido País do endereço de entrega. *Código de país ISO 3166-1 alfa-2 de duas letras.
state	string	Subdivisão de estado ou país. É recomendado (mas não obrigatório) que você use a representação ISO 3166-2
city	string	Nome da cidade
district	string	Bairro ou Distrito
street	string	Nome da rua
number	string	Número da rua
complement	string	Complemento de endereço
reference	string	Referência de endereço
formattedAddress	string	Texto de endereço totalmente formatado
postalCode	string	Código postal
coordinates	array	Tipo de pedido Endereço de entrega Coordenadas latitude (veja na tabela coordinates)

Estrutura Data - delivery - deliveryAddress (dentro de coordinates):
Âncora
table_coordinates
table_coordinates

Campo	Valor	Descrição
latitude	number	Latitude em graus. Os valores estão restritos ao intervalo [[-90, 90]]
longitude	number	Longitude em graus. Os valores estão restritos ao intervalo [[-180, 180]]

Estrutura Data (dentro de takeout):
Âncora
table_takeout
table_takeout

Campo	Valor	Descrição
mode	enum	Modo de pedido para viagem
takeoutDateTime	string	Data e hora em que o pedido estará pronto. Pode ser calculado pelo Aplicativo de Pedidos utilizando o tempo médio de preparo dos pratos. O padrão é o mesmo horário de criação do pedido

Estrutura Data (dentro de indoor):
Âncora
table_indoor
table_indoor

Campo	Valor	Descrição
mode	enum	Modo de pedido para viagem
indoorDateTime	string	Data e hora em que o pedido estará pronto. Pode ser calculado pelo Aplicativo de Pedidos utilizando o tempo médio de preparo dos pratos. O padrão é o mesmo horário de criação do pedido
place	string	O identificador do local (obrigatório se o modo for PLACE)
tab	string	A guia ou identificador do cartão de controle (obrigatório se o modo for TAB)

Estrutura Enumeração Data - indoor (dentro de mode):

Enum	Valor	Descrição
DEFAULT	DEFAULT	Padrão isado para pedidos feitos no Aplicativo de Pedido para serem consumidos dentro do estabelecimento sem uma localização específica
PLACE	PLACE	Lugar usado para pedidos feitos no Aplicativo de Pedido para serem consumidos dentro do estabelecimento em uma localização específica já informada, como uma mesa ou balcão
TAB	TAB	Comanda usado para estabelecimentos que controlam pedidos por meio de comandas ou cartões de controle (pode ser usado junto com o campo de localização)

Estrutura Consumption (dentro de table):
Âncora
table_table
table_table

Campo	Valor	Descrição
waiterCode	number	O identificador do garçom
tableNumber	number	O identificador da tabela
chairNumber	number	O identificador do presidente

Estrutura Consumption (dentro de card):
Âncora
table_card
table_card

Campo	Valor	Descrição
waiterCode	number	O identificador do garçom
tableNumber	number	O identificador da tabela
deliveryTableNumber	number	O identificador da mesa

Dica

title	Campos obrigatórios

Campos marcaos com o * (asteristico) o seu preenchimento é obrigatório

...

04. LINKS
Âncora
links
links

04. LINKS

API Order Mesa - Get Status
API Order Mesa - Status
API Order Mesa - Get Consumption
API Order Mesa - Consumption

API Order Mesa - Payment


API Order Mesa - Payment

Result


API Order Mesa - Get Cancelled Items
API Order Mesa - Cancelled Items

Dica

title	Saiba mais!

Para obter detalhes técnicos sobre o envio de requisições ao endpoint newOrder, incluindo a estrutura do corpo da requisição para itens com valor integral acesse a documentação clicando aqui.

Dica

title	Saiba mais!

Para obter detalhes técnicos sobre o envio de requisições ao endpoint newOrder, incluindo a estrutura do corpo da requisição para itens fracionando acesse a documentação clicando aqui.

Dica

title	Saiba mais!

Para obter detalhes técnicos sobre o envio de requisições ao endpoint newOrder, incluindo a estrutura do corpo da requisição para varios itens acesse a documentação clicando aqui.

Templatedocumentos

Páginas filhas

Versões comparadas

Versão antiga 9

Nova versão Atual

Chave

01. VISÃO GERAL
Âncora
ver_geral
ver_geral

02. ENDPOINT
Âncora
endpoint
endpoint

03

. DICIONÁRIO
Âncora
dicionario
dicionario

04. LINKS
Âncora
links
links

04. LINKS

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 9

Nova versão Atual

Chave

01. VISÃO GERAL Âncoraver_geralver_geral

02. ENDPOINT Âncoraendpointendpoint

03

. DICIONÁRIO Âncoradicionariodicionario

04. LINKS Âncoralinkslinks

04. LINKS

01. VISÃO GERAL
Âncora
ver_geral
ver_geral

02. ENDPOINT
Âncora
endpoint
endpoint

. DICIONÁRIO
Âncora
dicionario
dicionario

04. LINKS
Âncora
links
links