...
02. ENDPOINT
Método | URL | Ambiente |
---|
POST | https://api-barramento.meuelevestage.com/order/cancelledItems | Homologação |
POST | https://api-barramento.meueleve.com.br/order/ |
getCancelledItens
...
03. EXEMPLO DE UTILIZAÇÃO
013.1 - Request - Enviando o pedido para requisição do a solicitação para o cancelamento de um pedido especifico: Âncora |
---|
todos_status | todos_status | especí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 |
---|
title | Corpo da requisição no JSON |
---|
linenumbers | true |
---|
|
{
"integrationHubServiceId": "7056c970-cb11-400f-9d4f-9f30253f3b0b",
"orderKeyType": "TABLE",
"orderKey": ["22"]
} |
Nota |
---|
title | Nota: 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 |
---|
title | JSON de resposta do retorno - HTTP Status Code = 208 |
---|
linenumbers | true |
---|
|
{
"errors": [
{
"key": "orderKeyType_orderKey",
"message": "Order cancelled itens request already exists: TABLE_22"
}
]
} |
Nota |
---|
title | Nota: 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 |
---|
title | JSON de resposta do retorno - Status Code = 226 |
---|
linenumbers | true |
---|
|
{
"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 |
---|
title | Nota: HTTP Status Code = 226 IM Used |
---|
|
A solicitação foi processada com sucesso e o resultado foi retornado conforme esperado.conforme esperado. |
...
Informações |
---|
title | Informaçõ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:
Campo | Valor |
---|
TABLE | TABLE |
CARD | CARD |
ORDERD_ID | ORDER_ID |
Informações |
---|
title | NotaInformaçõ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 |
---|
|
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
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 |
---|
title | JSON Resposta |
---|
linenumbers | true |
---|
|
{
"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 |
---|
title | JSON Resposta |
---|
linenumbers | true |
---|
|
{
"errors": [
{
"key": "orderKeyType",
"message": "body.orderKeyType is required"
},
{
"key": "orderKey",
"message": "body.orderKey is required"
}
]
} |
...
034.3. GUID incorreto
Bloco de código |
---|
title | JSON com o GUID inválido |
---|
linenumbers | true |
---|
|
{
"integrationHubServiceId": "9a1cf326-c962-456f-8c49-c1bb2f340fc6A",
"orderKeyType": "TABLE",
"orderKey": []
} |
Bloco de código |
---|
title | JSON Inválido GUID incorreto |
---|
linenumbers | true |
---|
|
{
"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
...