Páginas filhas
  • API Order Mesa - Get Consumption

Versões comparadas

Chave

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

...

Nota
titleNota: HTTP Status Code = 226 IM Used

Sua solicitação foi retornada com sucesso.


Dicionário de Requisição


O endpoint Consumption permite consultar os dados de consumo de uma mesa ou várias mesas. Ele retorna informações detalhadas sobre os itens pedidos, preços e outros dados relevantes, facilitando o gerenciamento dos consumos em ambientes de atendimento.

...

  • Estrutura OrderConsumption:
CampoValorDescrição
integrationHubServiceIdstringIdentificador único da integração
orderKeyTypestringTipo de chave do pedido
orderKeystringChave do pedido correspondente
successbooleanIndica se a operação foi bem-sucedidaconsumptionsarrayDetalhes dos consumos relacionados ao pedido. Cada consumption inclui:
  • Estrutura Consumption (dentro de consumptions):

...

  • Estrutura OrderItems (dentro de items):

...


  • Estrutura OrderItemsOptions (dentro de options):

...

  • Estrutura OtherFees:

...

  • Estrutura Discounts:

...

  • Estrutura Total:

...

  • Estrutura Delivery:

...

Tabela de Enumerações

  • Enumerações para unit:

...

  • Enumerações para orderKeyType:

...

  • Enumerações para type (OtherFees):

...

  • Enumerações para target (Discounts)Enumerações para orderKeyType:
EnumDescrição
CARTAplicável ao total do carrinhoDELIVERY_FEEAplicável à taxa de entregaITEMAplicável a um item específico
  • Enumerações para receivedBy

...

TABLEIdentifica o pedido pelo número da mesa
CARDIdentifica o pedido pelo número do cartão
ORDER_IDIdentifica o pedido por um ID exclusivo

,

  • Enumerações para deliveredBy
EnumDescriçãoMARKETPLACEEntidade responsável pela entrega é o marketplaceMERCHANTEntidade responsável pela entrega é o comerciante


...

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:

...

4.1 - Formato inválido do JSON esperado:

A requisição foi enviada com um JSON malformado ou inválido, o que impede o sistema de interpretá-la corretamente. Isso ocorre quando a estrutura JSON contém erros de sintaxe, como chaves ou colchetes incorretos.

Bloco de código
titleJSON Inválido
linenumberstrue
{
    "integrationHubServiceId": "a9cad639-5775-4f8a-917b-2ae0f2d284d8",
	  "orderKeyType": "string",
	   "orderKey": ["string"]
}

...

4.2 - JSON enviado com a ausência de um ou mais campos obrigatórios:

Se a requisição estiver faltando um ou mais campos obrigatórios, o servidor responderá com um erro 400. Cada campo requerido deve estar presente para que a operação seja processada corretamente.

Bloco de código
titleJSON Inválido
linenumberstrue
{
    "integrationHubServiceId": "a5c4e135-aacd-49c1-b051-160a78a83b56"
}
Bloco de código
titleJSON Resposta
linenumberstrue
{
	"errors": [
		{
			"key": "orderKeyType",
			"message": "body.orderKeyType is required"
		},
		{
			"key": "orderKey",
			"message": "body.orderKey is required"
		}
	]
}


...


4.3 -  GUID incorreto:

O GUID (Identificador Globalmente Único) enviado na requisição está incorreto ou malformado, o que pode resultar em um erro. Um GUID é uma sequência específica que deve seguir o padrão correto.

 

Bloco de código
titleJSON com o GUID inválido
linenumberstrue
{
    "integrationHubServiceId": "9a1cf326-c962-456f-8c49-c1bb2f340fc6A",
	  "orderKeyType": "TABLE",
	  "orderKey": []
}

...

4.4 - Requisição enviada sem informar o orderKey corretamente:

Caso a requisição seja enviada sem o campo orderKey ou com o valor incorreto, o sistema não conseguirá identificar o pedido, resultando em um erro 400. O orderKey deve estar corretamente preenchido e de acordo com o orderKeyType informado.

Bloco de código
titleJSON com sem informar o código da orderKey
linenumberstrue
{
    "integrationHubServiceId": "808c143d-d6d4-4b95-8c37-efa3a934f222",
	  "orderKeyType": "TABLE",
	  "orderKey": [""]
}

...