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_ID
Modo 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
Identifica o pedido por um ID exclusivo


  • Estrutura Consumption (dentro de type table):
    Âncora
    table_typetable
    table_typetable
CampoValorDescrição
value

waiterCode *

number
Valor
O identificador do
preço
garçom
currency

tableNumber *

string
number
Código da moeda ISO 4217
O identificador da tabela

chairNumber *

numberO identificador do presidente


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

waiterCode *

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

tableNumber *

numberO identificador da tabela

deliveryTableNumber *

numberO identificador da mesa


  • Estrutura ErrorEstrutura Consumption - items (dentro de unitPrice):
    Âncora
    table_unitPriceerror
    table_unitPriceerror
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 originalPrice):
    Âncora
    table_originalPriceorderKeyType
    table_originalPriceorderKeyType
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 optionsPrice):
    Âncora
    table_optionsPricetype
    table_optionsPricetype
CampoValorDescrição
valuenumberValor do preço
currencystringCódigo da moeda ISO 4217


  • Estrutura  Enumeração Consumption - items (dentro de unit):
    Âncora
    table_unit
    table_unit
EnumValorDescrição
UNUNUnidade de medida simples
KGKGQuilograma
LLLitro
OZOZOnça
LBLBLibra
GALGALGalão


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


  • Estrutura Enumeração  Consumption - otherFees items (dentro de typeoriginalPrice):
    Âncora
    table_OrderFeesTypeoriginalPrice
    table_OrderFeesTypeoriginalPrice
Enum
CampoValorDescrição
DELIVERY_FEEDELIVERY_FEETaxa de entregaSERVICE_FEESERVICE_FEETaxa de serviçoTIPTIPGorjeta
value *numberValor do preço
currency *stringCódigo da moeda ISO 4217


  • Estrutura Consumption - items Estrutura Enumeração Consumption - otherFees (dentro de receivedByoptionsPrice):
    Âncora
    table_receivedByoptionsPrice
    table_receivedByoptionsPrice
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 totalPriceEstrutura Enumeração Consumption - delivery (dentro de deliveredBy):
    Âncora
    table_deliveredBytotalPrice
    table_deliveredBytotalPrice
Enum
CampoValorDescriçã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 Enumeração Estrutura Consumption - otherFees (dentro de pricetype):
    Âncora
    table_priceOrderFeesType
    table_priceOrderFeesType
Campo
EnumValorDescrição
valuenumberValor do preçocurrencystringCódigo da moeda ISO 4217
DELIVERY_FEEDELIVERY_FEETaxa de entrega
SERVICE_FEESERVICE_FEETaxa de serviço
TIPTIPGorjeta


  • Estrutura Enumeração Consumption - discountsotherFees (dentro de sponsorshipValuesreceivedBy):
    Âncora
    table_sponsorshipValuesreceivedBy
    table_sponsorshipValuesreceivedBy
EnumValorDescrição
MARKETPLACEMARKETPLACEEntidade
responsável pela entrega
que recebeu o pedido é o marketplace
MERCHANTMERCHANTEntidade
responsável pela entrega
que recebeu o pedido é o comerciante
LOGISTIC_SERVICESLOGISTIC_SERVICESEntidade que recebeu o pedido é a logística


  • Estrutura Enumeração Estrutura Consumption - delivery (dentro de deliveryAddress deliveredBy):
    Âncora
    table_deliveryAddressdeliveredBy
    table_deliveryAddressdeliveredBy
Campo
EnumValor
Descição
Descrição
country
MARKETPLACE
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)
MARKETPLACEEntidade responsável pela entrega é o marketplace
MERCHANTMERCHANTEntidade responsável pela entrega é o comerciante


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


  • Estrutura Enumeração Consumption - discounts(dentro de sponsorshipValuesEstrutura Consumption - delivery - deliveryAddress (dentro de coordinates):
    Âncora
    table_coordinatessponsorshipValues
    table_coordinatessponsorshipValues
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 responsável pela entrega é o marketplace
MERCHANTMERCHANTEntidade responsável pela entrega é o comerciante


  • Estrutura Consumption - delivery (dentro de deliveryAddressEstrutura Consumption (dentro de takeout):
    Âncora
    table_takeoutdeliveryAddress
    table_takeoutdeliveryAddress
CampoValor
Descrição
Descição
mode

country *

enum
string
Modo 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

...

Tipo 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)


  • Estrutura Consumption - delivery - deliveryAddress (dentro de coordinates)

...

waiterCode

...

tableNumber

...

chairNumber

...

waiterCode

...

tableNumber

...

deliveryTableNumber

...

  • Estrutura Error:
    Âncora
    table_errorcoordinates
    table_errorcoordinates
CampoValorDescrição
codestring
Código de erro
messagestringMensagem de erro

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:

...