Páginas filhas
  • API Order Mesa - Cancelled Items

Versões comparadas

Chave

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

...

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


...

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

3.1 -Request - Corpo  Envio da requisição para consultar obter o cancelamento status de um pedido específico item cancelado no PDV: Essa requisição é enviada para verificar se os itens de um pedido cancelado em um PDV específico foram transmitidos com sucesso.
Ao enviar a requisição para este endpoint, o sistema processa a solicitação e retorna o status atualizado de um item cancelado no PDV. O corpo da requisição deve conter os dados obtidos no endpoint getCancelledItems, e a resposta fornecerá as informações detalhadas sobre o cancelamento solicitado.

Âncora
todos_status
todos_status

Bloco de código
Bloco de código
titleCorpo da requisição no JSON
linenumberstrue
{
	"success": true,
	"error": null,
	"integrationHubServiceId": "5ffec6b8-1c55-4a7d-985f-12d13685b553",
	"orderKeyType": "TABLE",
	"orderKey": ["22"],
	"lastestUpdatedStatus": "2024-07-18 09:26:47",
	"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"
		}
	]
}

...

3.2. Request - Corpo da requisição para consultar o cancelamento de vários pedidos no PDV específico:

Essa requisição é enviada para verificar se os itens de vários pedidos cancelados em um PDV específico foram transmitidos com sucesso. 

Âncora
multiplos
multiplos

...

Informações sobre o campos da request da API cancelledItems, é utilizada para retornar os dados do(s) pedido(s) cancelado(s).

  • Detalhamento dos campos da requisiçãoEstrutura cancelledItems:
CampoValorDescrição
success *booleanIndica se a operação foi bem-sucedida
errorobjetoContém informações sobre erros, se houver (veja na tabela de error)
integrationHubServiceId *stringChave de identificação de integração
orderKeyType
"TABLE", "CARD", "ORDER_ID"
*enumTipo da chave do pedido (
neste caso "TABLE", "CARD" ou "ORDER_ID"
veja na tabela orderKeyType)
orderKey *arrayLista de identificadores de pedidos (números de mesa, cartão, ou ID de pedido)
lastestUpdatedStatus *string (data e hora)Data e hora da última atualização do status dos pedidos
items *arrayLista de itens cancelados


  • Enumerações para orderKeyType:
    Âncora
    table_orderKeyType
    table_orderKeyType

Enum

Valor

Descrição

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 cancelledItems (dentro de item)Detalhamento dos campos da lista de itens cancelados:
CampoValorDescrição
id *stringIdentificador do produto no lançamento.
index *stringPosição do produto no lançamento.
name *stringNome do item/produto.
externalCode *stringCódigo do produto no PDV integrado.
quantity *númeroQuantidade do item cancelado.
cancellationAgent *stringOperador responsável pelo cancelamento.
cancellationDateTime *string (data e hora)Data e hora do cancelamento.
cancellationReason *stringMotivo do cancelamento.
tableCardNumber *stringNúmero da mesa ou cartão associado ao item cancelado
productionPoint *stringPonto de produção relacionado ao item
  • Exemplo de retorno em caso de erro:


  • Estrutura Error:
    Âncora
    table_error
    table_error
EnumValorDescrição
code *código do erroIdentifica o código do erro
message *messagem do erroDescrição detalhada do erro ocorrido, ex: "body.orderKeyType must be one of [ORDER_ID
, TABLE, CARD]"
, TABLE, CARD]"
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:

...

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.:


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. JSON enviando faltando um ou mais camposIsso ocorre quando a estrutura JSON contém erros de sintaxe, como chaves ou colchetes incorretos.

Bloco de código
titleCorpo da requisição no JSON faltando campos
linenumberstrue
{
	"integrationHubServiceId": "5ffec6b8-1c55-4a7d-985f-12d13685b553",
	"orderKeyType": "TABLE",
	"orderKey": [
		"22",
		"23"
	],
	"lastestUpdatedStatus": "2024-07-18 09:48:03",
	"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"
		},
		{
			"id": "3973594011",
			"index": "19",
			"name": "MARACUJA",
			"externalCode": "58",
			"quantity": 1,
			"cancellationAgent": "ALBINO",
			"cancellationDateTime": "2024-07-17 16:04:27",
			"cancellationReason": " 55596;",
			"tableCardNumber": "23",
			"productionPoint": "NENHUM"
		}
	]
}
Bloco de código
titleResposta do JSON da requisição
linenumberstrue
{
	"errors": [
		{
			"key": "success",
			"message": "body.success is required"
		}
	]
}


...


4.2 . Formando inválido do JSON esperado- 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
{
	"success": true,
	"error": null,
	"integrationHubServiceId": "5ffec6b8-1c55-4a7d-985f-12d13685b553",
	"orderKeyType": "String",
	"orderKey": [
		"22",
		"23"
	],
	"lastestUpdatedStatus": "2024-07-18 09:48:03",
	"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"
		},
		{
			"id": "3973594011",
			"index": "19",
			"name": "MARACUJA",
			"externalCode": "58",
			"quantity": 1,
			"cancellationAgent": "ALBINO",
			"cancellationDateTime": "2024-07-17 16:04:27",
			"cancellationReason": " 55596;",
			"tableCardNumber": "23",
			"productionPoint": "NENHUM"
		}
	]
}

...