Páginas filhas
  • API Order Cartão - Consumption

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • Estrutura OrderConsumption:
CampoValorDescrição
integrationHubServiceId *stringIdentificador único da integração
orderKeyType *enum Tipo de chave do pedido (veja na tabela orderKeyType)
orderKey *arrayChave do pedido correspondente 
success *booleanIndica se a operação foi bem-sucedida
consumptionsarrayDetalhes dos consumos relacionados ao pedido. (veja na tabela consumptios)
errorarrayo erro é necessário quando o sucesso é falso. (veja na tabela de error)


  • Estrutura Consumption (dentro de consumptions):
    Âncora
    table_consuptions
    table_consuptions
CampoValorDescrição
type *enumTipo do consumo (veja na tabela type)
createdAt *string (data e hora)Data e hora da criação do pedidos
customerName *stringNome do cliente
items *arrayItens do pedido (veja na tabela de items)
ortherFessarrayOutras taxas que podem ser aplicadas (veja na tabela otherFees)
discountsarrayQuaisquer descontos que possam ser aplicados (veja na tabela discounts)
total *arrayConjunto de campos com a soma dos valores descritos anteriormente no pedido (veja na tabela total)
deliveryarrayInformações para pedidos DELIVERY. OBRIGATÓRIO se o tipo escolhido for DELIVERY. (veja tabela delivery)
takeoutarrayInformações para pedidos TAKEOUT. OBRIGATÓRIO se o tipo escolhido for TAKEOUT (veja na tabela takeout)
tablearrayInformações para pedidos de TABLE. OBRIGATÓRIO se o tipo escolhido for TABLE (veja na tabela table)
cardarrayInformações para pedidos CARD. OBRIGATÓRIO se o tipo escolhido for CARTÃO (veja na tabela de card)


  • Estrutura Consumption (dentro de items):
    Âncora
    table_items
    table_items
optionsPricearrayPreço total das opções (opcional) (veja tabela de optionsPrice)totalPricenumber
CampoValorDescrição
id *stringIdentificador único do item
indexstringPosição do item (opcional)
name *stringNome do produto
externalCode *stringCódigo externo do produto (opcional)
unit *stringUnidade de medida do item. Utilize valores fracionários para quantidades menores que a unidade de medida: Exemplo: 500 gramas = 0,5 KG (veja na tabela unit)
eanstringCódigo de barras EAN do item (opcional)
quantity *numberQuantidade de itens
specialInstructionsstringInstruções especiais sobre o item (opcional)
unitPrice *arrayPreço por unidade, considerando 4 casas decimais (veja tabela de unitPrice)
originalPricearrayPreço original do produto
(opcional) (veja tabela de originalPrice)
. Este preço é meramente informativo e deve ser utilizado para informar o preço de um item antes de aplicar descontos no preço de tabela.
Descontos aplicados durante o pedido, como cupons e vouchers, não devem ser considerados aqui. Estes devem ser informados no objeto descontos.
ESTE PREÇO NÃO SERÁ CONSIDERADO PARA CÁLCULOS DE TOTAIS DO PEDIDO. (opcional) (veja tabela de originalPrice)
optionsPricearrayPreço total das opções (opcional) (veja tabela de optionsPrice)
totalPrice *number
Preço total do item (veja tabela de totalPrice)
optionsarrayExtras opcionais escolhidos pelo consumidor. (veja na tabela de options)
productionPoint *stringPonto de produção do produto


  • Estrutura Consumption - items (dentro de options):
    Âncora
    table_options
    table_options
CampoValorDescrição
indexstringPosição da opção (opcional)
id *stringIdentificador único da opção
name *stringNome da opção

externalCode *

stringCódigo do produto externo
unit *enumUnidade de medida da opção (veja na tabela unit)
eanstringEAN é o padrão de código de barras usado nos itens.
quantity *numberQuantidade de itens opcionais
unitPrice *arrayPreço por unidade, considerando 4 casas decimais (veja tabela de unitPrice).

originalPrice

arrayPreço original do produto (opcional) (veja tabela de originalPrice).
totalPrice *arrayPreço total da opção (veja tabela de totalPrice)
specialInstructionsstringInstruções especiais sobre a opção (opcional)
productionPoint *stringPonto de produção da opção (opcional)


  • Estrutura Consumption (dentro de otherFees):
    Âncora
    table_otherFees
    table_otherFees
CampoValorDescrição
name *stringNome relacionado às taxas
type *enumTipo da taxa (veja na tabela type)
receivedBy *enumPedido recebido por (veja na tabela receivedBy)
receiverDocumentstringDocumento do receptor de outras taxas
price *arrayPreço da taxa(veja tabela de price).
observationstringObservação de outras taxas. Quaisquer comentários extras


  • Estrutura Consumption (dentro de discounts):
    Âncora
    table_discounts
    table_discounts
CampoValorDescrição
value *numberValor do desconto
target *enumDestino do desconto (vejna na tabela de cart)
targetIdstring

Identificador do alvo (obrigatório quando target = ITEM).

sponsorshipValues *

arrayValores 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 Consumption (dentro de total):
    Âncora
    table_total
    table_total
CampoValorDescrição
items *numberSoma do preço total dos itens listados no atributo itens
otherFeesnumberSoma do valor total das demais taxas listadas no atributo otherFees. Se não houver, use 0
discountnumberSoma de quaisquer descontos que possam estar listados no atributo descontos. Se não houver, use 0
orderAmount *numberO valor final da encomenda (itens + outrasTaxas +Taxas adicionais +Taxa de entrega - descontos)
additionalFeesnumberSoma do valor total das taxas adicionais listadas no atributo adicionalFees. Se não houver, use 0
deliveryFeenumberSoma do valor total da taxa de entrega listada no atributo deliveryFee. Se não houver, use 0


  • Estrutura Consumption (dentro de delevery):
    Âncora
    table_delivery
    table_delivery
CampoValorDescrição

deliveredBy *

enumSolicitar entrega por (veja na tabela de deliveredBy)

deliveryAddress *

arrayO endereço onde o pedido será entregue (veja na tabela deliveryAddress)

estimatedDeliveryDateTime *

stringData e hora estimada de entrega. A mesma data mostrada ao cliente, na interface do Aplicativo de Pedidos

deliveryDateTime

stringData de entrega. A data e hora em que a entrega realmente ocorreu.

Tabela de auxiliares e enumerações



  • Estrutura Consumption (dentro de takeout):
    Âncora
    table_takeout
    Estrutura Enumeração orderKeyType
    Âncora
    table_orderKeyType
    table_orderKeyTypetakeout
Enum
CampoValorDescrição
TABLE
mode *
TABLE
enum
Identifica o pedido pelo número da mesaCARDCARDIdentifica o pedido pelo número do cartãoORDER_IDORDER_IDIdentifica o pedido por um ID exclusivo
Modo de pedido para viagem (veja na tabela mode)

takeoutDateTime *

stringData 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 Enumeração Consumption - takeout (dentro de modeEstrutura Consumption (dentro de type):
    Âncora
    table_takeout_typemode
    table_takeout_typemode
CampoValorDescrição
value
DEFAULT*
numberValor do preçocurrencystringCódigo da moeda ISO 4217
DEFAULTIndica que o pedido será retirado pelo cliente sem um local específico de coleta, ou seja, de maneira padrão no estabelecimento

PICKUP_AREA*

PICKUP_AREAIndica que o pedido será retirado em uma área de coleta designada dentro do estabelecimento


  • Estrutura Consumption (dentro de tableEstrutura Enumeração Consumption - items (dentro de unit):
    Âncora
    table_unittable
    table_unittable
Enum
CampoValorDescrição
UN

waiterCode *

UNUnidade de medida simplesKGKGQuilogramaLLLitroOZOZOnçaLBLBLibraGALGALGalão
numberO identificador do garçom

tableNumber *

numberO identificador da tabela

chairNumber *

numberO identificador do presidente


  • Estrutura Consumption (dentro de cardEstrutura Consumption - items (dentro de unitPrice):
    Âncora
    table_unitPricecard
    table_unitPricecard
CampoValorDescrição
value

waiterCode *

number
Valor do preçocurrencystringCódigo da moeda ISO 4217
O identificador do garçom

tableNumber *

numberO identificador da tabela

deliveryTableNumber *

numberO identificador da mesa


  • Estrutura ErrorEstrutura Consumption - items (dentro de originalPrice):
    Âncora
    table_originalPriceerror
    table_originalPriceerror
CampoValorDescrição
value
code *
numberValor do preçocurrencystringCódigo da moeda ISO 4217
string
Código de erro
message *string
Mensagem de erro


Tabela de auxiliares e enumerações

  • Estrutura Enumeração orderKeyTypeEstrutura Consumption - items (dentro de optionsPrice):
    Âncora
    table_optionsPriceorderKeyType
    table_optionsPriceorderKeyType
Campo
EnumValorDescrição
valuenumberValor do preçocurrencystringCódigo da moeda ISO 4217
TABLETABLEIdentifica o pedido pelo número da mesa
CARDCARDIdentifica o pedido pelo número do cartão
ORDER_IDORDER_IDIdentifica o pedido por um ID exclusivo


  • Estrutura Consumption (dentro de typeEstrutura Consumption - items (dentro de totalPrice):
    Âncora
    table_totalPricetype
    table_totalPricetype
CampoValorDescrição
valuenumberValor do preço
currencystringCódigo da moeda ISO 4217


  • Estrutura Enumeração Consumption - otherFees items (dentro de typeunit):
    Âncora
    table_OrderFeesTypeunit
    table_OrderFeesTypeunit
EnumValorDescrição
DELIVERY_FEEDELIVERY_FEETaxa de entregaSERVICE_FEESERVICE_FEETaxa de serviçoTIPTIPGorjeta
UNUNUnidade de medida simples
KGKGQuilograma
LLLitro
OZOZOnça
LBLBLibra
GALGALGalão


  • Estrutura Consumption - items (dentro de unitPriceEstrutura Enumeração Consumption - otherFees (dentro de receivedBy):
    Âncora
    table_receivedByunitPrice
    table_receivedByunitPrice
Enum
CampoValorDescrição
MARKETPLACE
value *
MARKETPLACEEntidade que recebeu o pedido é o marketplaceMERCHANTMERCHANTEntidade que recebeu o pedido é o comercianteLOGISTIC_SERVICESLOGISTIC_SERVICESEntidade que recebeu o pedido é a logística

...

numberValor do preço
currency *stringCódigo da moeda ISO 4217


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

...

Enum
ValorDescrição
MARKETPLACE
value *
MARKETPLACEEntidade responsável pela entrega é o marketplaceMERCHANTMERCHANTEntidade responsável pela entrega é o comerciante
numberValor do preço
currency *stringCódigo da moeda ISO 4217


  • Estrutura Consumption - items Estrutura Consumption - otherFees (dentro de priceoptionsPrice):
    Âncora
    table_priceoptionsPrice
    table_priceoptionsPrice
CampoValorDescrição
value *numberValor do preço
currency *stringCódigo da moeda ISO 4217


  • Estrutura Enumeração  Consumption - discountsitems (dentro de sponsorshipValuestotalPrice):
    Âncora
    table_sponsorshipValuestotalPrice
    table_sponsorshipValuestotalPrice
Enum
CampoValorDescrição
MARKETPLACEMARKETPLACEEntidade responsável pela entrega é o marketplaceMERCHANTMERCHANTEntidade responsável pela entrega é o comerciante
value *numberValor do preço
currency *stringCódigo da moeda ISO 4217


  • Estrutura Enumeração Consumption - otherFees (dentro de typeEstrutura Consumption - delivery (dentro de deliveryAddress):
    Âncora
    table_deliveryAddressOrderFeesType
    table_deliveryAddressOrderFeesType
Campo
EnumValor
Descição
Descrição

country

stringTipo de pedido País do endereço de entrega. *Código de país ISO 3166-1 alfa-2 de duas letras.

state

stringSubdivisão de estado ou país. É recomendado (mas não obrigatório) que você use a representação ISO 3166-2

city

stringNome da cidade

district

stringBairro ou Distrito

street

stringNome da rua

number

stringNúmero da rua

complement

stringComplemento de endereço

reference

stringReferência de endereço

formattedAddress

stringTexto de endereço totalmente formatado

postalCode

stringCódigo postal

coordinates

arrayTipo de pedido Endereço de entrega Coordenadas latitude (veja na tabela coordinates)
DELIVERY_FEEDELIVERY_FEETaxa de entrega
SERVICE_FEESERVICE_FEETaxa de serviço
TIPTIPGorjeta


  • Estrutura Enumeração Consumption - otherFees (dentro de receivedByEstrutura Consumption - delivery - deliveryAddress (dentro de coordinates):
    Âncora
    table_coordinatesreceivedBy
    table_coordinatesreceivedBy
Campo
EnumValorDescrição
latitude
MARKETPLACE
numberLatitude em graus. Os valores estão restritos ao intervalo [[-90, 90]]

longitude

numberLongitude em graus. Os valores estão restritos ao intervalo [[-180, 180]]
MARKETPLACEEntidade que recebeu o pedido é o marketplace
MERCHANTMERCHANTEntidade que recebeu o pedido é o comerciante
LOGISTIC_SERVICESLOGISTIC_SERVICESEntidade que recebeu o pedido é a logística


  • Estrutura Enumeração Consumption - delivery (dentro de deliveredByEstrutura Consumption (dentro de takeout):
    Âncora
    table_takeoutdeliveredBy
    table_takeoutdeliveredBy
Campo
EnumValorDescrição
mode
MARKETPLACE
enumModo de pedido para viagem

takeoutDateTime

stringData 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
MARKETPLACEEntidade responsável pela entrega é o marketplace
MERCHANTMERCHANTEntidade responsável pela entrega é o comerciante


  • Estrutura Consumption - otherFees (dentro de priceEstrutura Consumption (dentro de table):
    Âncora
    table_tableprice
    table_tableprice
CampoValorDescrição
waiterCode
value *number
O identificador
Valor do
garçom
preço
tableNumber
currency *
number
string
O identificador da tabela

chairNumber

numberO identificador do presidente
Código da moeda ISO 4217


  • Estrutura Enumeração Consumption - discountsEstrutura Consumption (dentro de card sponsorshipValues):
    Âncora
    table_cardsponsorshipValues
    table_cardsponsorshipValues
Campo
EnumValorDescrição
waiterCode
MARKETPLACE
numberO identificador do garçom

tableNumber

numberO identificador da tabela

deliveryTableNumber

numberO identificador da mesa
MARKETPLACEEntidade responsável pela entrega é o marketplace
MERCHANTMERCHANTEntidade responsável pela entrega é o comerciante


  • Estrutura Consumption - delivery (dentro de deliveryAddress)Estrutura Error:
    Âncora
    table_errordeliveryAddress
    table_errordeliveryAddress
CampoValor
Descrição
Descição
code

country *

string
Código de erro
message
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
Mensagem de erro
Subdivisão de estado ou país. É recomendado (mas não obrigatório) que você use a representação ISO 3166-2

city *

stringNome da cidade

district *

stringBairro ou Distrito

street *

stringNome da rua

number *

stringNúmero da rua

complement

stringComplemento de endereço

reference

stringReferência de endereço

formattedAddress *

stringTexto de endereço totalmente formatado

postalCode *

stringCódigo postal

coordinates *

arrayTipo de pedido Endereço de entrega Coordenadas latitude (veja na tabela coordinates)


  • Estrutura Consumption - delivery - deliveryAddress (dentro de coordinates):
    Âncora
    table_coordinates
    table_coordinates
CampoValorDescrição

latitude *

numberLatitude em graus. Os valores estão restritos ao intervalo [[-90, 90]]

longitude *

numberLongitude em graus. Os valores estão restritos ao intervalo [[-180, 180]]
Dica
titleCampos obrigatórios

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


...

04. ERROS
Âncora
erros
erros

A seguir, alguns dos erros comuns que podem ser apresentados ao lidar com requisições HTTP e suas respectivas respostas:

...