Páginas filhas
  • API Order Mesa - Get Cancelled Items

Versões comparadas

Chave

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

...

02. ENDPOINT
Âncora
endpoint
endpoint


MétodoURLAmbiente
POSThttps://api-barramento.meuelevestage.com/order/cancelledItemsHomologação
POSThttps://api-barramento.meueleve.com.br/order/
getCancelledItens
cancelledItemsProdução


...

03. EXEMPLO DE UTILIZAÇÃO
Âncora
utilizar
utilizar

013.1 - Request - Enviando o pedido para requisição do a solicitação para o cancelamento de um pedido especifico: Âncoratodos_statustodos_statusespecífico: Ao fazer essa requisição, o sistema processa a solicitação de cancelamento do pedido indicado.

Bloco de código
Bloco de código
titleCorpo da requisição no JSON
linenumberstrue
{
  "integrationHubServiceId": "7056c970-cb11-400f-9d4f-9f30253f3b0b",
  "orderKeyType": "TABLE",
  "orderKey": ["22"]
}
Nota
titleNota: HTTP Status Code = 202 Accepted

A solicitação foi aceita, mas ainda não foi processada. É necessário aguardar alguns momentos e, em seguida, entrar em contato no mesmo endereço para obter o status do pedido solicitado.


...


3.2 - Request - Ao reenviar a solicitação, a resposta retornada será a seguinte: Após reenviar a requisição, você receberá uma resposta detalhando o status atualizado do processamento do pedido.

Bloco de código
titleJSON de resposta do retorno - HTTP Status Code = 208
linenumberstrue
{
	"errors": [
		{
			"key": "orderKeyType_orderKey",
			"message": "Order cancelled itens request already exists: TABLE_22"
		}
	]
}
Nota
titleNota: HTTP Status Code = 208 Already Reported

A solicitação Seu pedido já foi enviada. É necessário aguardar alguns momentos e, em seguida, entrar em contato no mesmo endereço para obter o status do pedido solicitadoenviado, aguarde alguns instantes e entre em contato com o mesmo endereço para obter os itens cancelados solicitados.


...


3.3 - Request - Ao enviar novamente a solicitação, o processamento será realizado conforme a seguinte resposta: Reenviando a requisição, o sistema processará o pedido e retornará uma resposta que reflete o status do processamento realizado.

Bloco de código
titleJSON de resposta do retorno - Status Code = 226
linenumberstrue
{
	"success": true,
	"error": null,
	"integrationHubServiceId": "7056c970-cb11-400f-9d4f-9f30253f3b0b",
	"orderKeyType": "TABLE",
	"orderKey": ["22"],
	"lastestUpdatedStatus": "2024-07-17 14:21:24",
	"items": [
		{
			"id": "39735945",
			"index": "5",
			"name": "MARACUJA",
			"externalCode": "58",
			"quantity": 1,
			"cancellationAgent": "ALBINO",
			"cancellationDateTime": "2024-07-17 14:19:33",
			"cancellationReason": " 55596;",
			"tableCardNumber": "22",
			"productionPoint": "NENHUM"
		}
	]
}

...

Nota
titleNota: HTTP Status Code = 226 IM Used

A solicitação foi processada com sucesso e o resultado foi retornado conforme esperado.conforme esperado.


...


Informações
titleInformações dos campos:

Neste exemplo, os dados retornados incluem:

  • integrationHubServiceId: Chave de identificação de integração que é utilizada para identificar de forma única a integração dentro do hub.

  • orderKeyType: O tipo da chave do pedido, podendo ser um dos seguintes valores:

    • TABLE: Chave que representa o número da mesa.
    • CARD: Chave que representa um cartão.
    • ORDER_ID: Chave que representa o identificador do pedido.
  • orderKey: Uma lista que contém os identificadores dos pedidos, conforme especificado no campo orderKeyType.


Dicionário da Requisição:

  • orderKeyType: Deve respeita a tabela abaixo:
CampoValor
TABLETABLE
CARDCARD
ORDERD_IDORDER_ID
Informações
titleNotaInformações dos dados retornados:

Neste exemplo, os dados retornados incluem:

  • success: Indica se a operação foi bem-sucedida.
  • error: Contém informações sobre erros, se houver.
  • integrationHubServiceId: O identificador do serviço de integração.
  • orderKeyType: O tipo da chave do pedido (neste caso, "TABLE").
  • orderKey: Uma lista de identificadores de pedidos (neste caso, números de mesa).
  • lastestUpdatedStatus: A data e hora da última atualização do status dos pedidos.
  • items: Uma lista de itens cancelados, onde cada item inclui:
    • id: O identificador do item.
    • index: O índice do item.
    • name: O nome do item.
    • externalCode: O código externo do item.
    • quantity: A quantidade do item cancelado.
    • cancellationAgent: O agente que realizou o cancelamento.
    • cancellationDateTime: Data e hora do cancelamento.
    • cancellationReason: O motivo do cancelamento.
    • tableCardNumber: O número da mesa ou do cartão associado ao item cancelado.
    • productionPoint: O ponto de produção associado ao item.
Dica
titleObservação:
Para o correto funcionamento desse endpoint, o respectivo pedido deverá ter sido previamente cancelado no PDV para a API retornar a resposta do pedido cancelado


...

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:

...

O código de status HTTP 400, conhecido como "Bad Request" (Requisição Inválida), indica que o servidor não pôde processar a requisição do cliente devido a uma sintaxe inválida, estrutura malformada ou dados inválidos presentes na requisição.

014.1. Formando inválido do JSON esperado.

...

Bloco de código
titleJSON Resposta
linenumberstrue
{
	"errors": [
		{
			"key": "orderKeyType",
			"message": "body.orderKeyType must be one of [ORDER_ID, TABLE, CARD]"
		}
	]
}


...

024.2. JSON enviando faltando um ou mais campos.

...

Bloco de código
titleJSON Resposta
linenumberstrue
{
	"errors": [
		{
			"key": "orderKeyType",
			"message": "body.orderKeyType is required"
		},
		{
			"key": "orderKey",
			"message": "body.orderKey is required"
		}
	]
}


...

034.3. GUID incorreto 

Bloco de código
titleJSON com o GUID inválido
linenumberstrue
{
    "integrationHubServiceId": "9a1cf326-c962-456f-8c49-c1bb2f340fc6A",
	  "orderKeyType": "TABLE",
	  "orderKey": []
}
Bloco de código
titleJSON Inválido GUID incorreto
linenumberstrue
{
	"errors": [
		{
			"key": "integrationHubServiceId",
			"message": "body.integrationHubServiceId must be a valid GUID"
		}
	]
}


...

044.4. Enviando uma requisição sem informar o código da orderKey corretamente

...