Páginas filhas
  • API Pedidos Online - Mesa

Versões comparadas

Chave

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

 Pedido Mesa

Índice
maxLevel10
minLevel2
excludeÍNDICE
stylecircle

...

Tipo Item

Código

Normal

0

Fracionado

1


Item inteiro

Item normal não aceita Subitens no atributo ItensFracao, exemplo de item do tipo Normal:

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"Itens": [
		{
			"TipoItem": 0,
			"Produto": {
				"Codigo": "5",
				"Descricao": "COCA COLA",
				"PrecoVenda": 5.0,
				"PrecoOriginal": 0,
				"PrecoPromocional": 0,
				"Pesavel": true,
				"Processado": false,
				"ProdutoComposto": false,
				"BaixarEstoqueOnline": false,
				"QuantidadeEstoque": 0,
				"Composicoes": null
			},
			"Quantidade": 1,
			"Acrescimo": 0,
			"Desconto": 0,
			"MotivoAcrescimoDesconto": null,
			"AcrescimoDiferencaFracionada": 0,
			"Observacao": "",
			"ItensFracao": null,
			"ItensAdicionais": [],
			"ValorTotal": 5,
			"ValorDescontoItem": 0,
			"ValorServicoItem": 0,
			"ValorDescontoComboItem": 0,
			"ValorAcrescimoItem": 0,
			"TipoOperacao": 0
		}
	]
}


Item inteiro com adicional

Produtos adicionais são produtos que só devem ser vendidos associado a outro produto, um exemplo é a "Coca Cola". Os adicionais devem respeitar o relacionamento retornado no serviço "ObterCardapio". Exemplo de item com adicional:  

...

ValorTotal do item não deve conter o somatório dos adicionais.


Item fracionado

Item fracionado deve conter 2 ou mais itens de composição de fração, exemplo de item do tipo Fracionado:

...

Um item do tipo fracionado pode ser cobrado pelo valor proporcional de cada fração ou pelo preço do produto de maior valor entre os itens da fração, esta configuração é individual de cada estabelecimento, exemplos:


Item fracionado (1/2) - Valor Proprocional


Produto

Preço

Quantidade

Valor Total

A MODA DA CASA

54,00

0,5

R$ 27,00

MODA LIGHT

78,00

0,5

R$ 39,00

Total



R$ 66,00

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"Itens": [
		{
			"TipoItem": 1,
			"Produto": null,
			"Quantidade": 0,
			"Acrescimo": 0,
			"Desconto": 0,
			"MotivoAcrescimoDesconto": null,
			"AcrescimoDiferencaFracionada": 0,
			"Observacao": null,
			"ItensFracao": [
				{
					"TipoItem": 0,
					"Produto": {
						"Codigo": "13",
						"Descricao": "A MODA DA CASA",
						"PrecoVenda": 54.0,
						"PrecoOriginal": 0,
						"PrecoPromocional": 0,
						"Pesavel": true,
						"Processado": false,
						"ProdutoComposto": false,
						"BaixarEstoqueOnline": false,
						"QuantidadeEstoque": 0,
						"Composicoes": null
					},
					"Quantidade": 0.5,
					"Acrescimo": 0,
					"Desconto": 0,
					"MotivoAcrescimoDesconto": null,
					"AcrescimoDiferencaFracionada": 0,
					"Observacao": "",
					"ItensFracao": null,
					"ItensAdicionais": [],
					"ValorTotal": 27,
					"ValorDescontoItem": 0,
					"ValorServicoItem": 0,
					"ValorDescontoComboItem": 0,
					"ValorAcrescimoItem": 0,
					"TipoOperacao": 0
				},
				{
					"TipoItem": 0,
					"Produto": {
						"Codigo": "14",
						"Descricao": "MODA LIGHT",
						"PrecoVenda": 78.0,
						"PrecoOriginal": 0,
						"PrecoPromocional": 0,
						"Pesavel": true,
						"Processado": false,
						"ProdutoComposto": false,
						"BaixarEstoqueOnline": false,
						"QuantidadeEstoque": 0,
						"Composicoes": null
					},
					"Quantidade": 0.5,
					"Acrescimo": 0,
					"Desconto": 0,
					"MotivoAcrescimoDesconto": null,
					"AcrescimoDiferencaFracionada": 0,
					"Observacao": "",
					"ItensFracao": null,
					"ItensAdicionais": [],
					"ValorTotal": 39,
					"ValorDescontoItem": 0,
					"ValorServicoItem": 0,
					"ValorDescontoComboItem": 0,
					"ValorAcrescimoItem": 0,
					"TipoOperacao": 0
				}
			],
			"ItensAdicionais": null,
			"ValorTotal": 66,
			"ValorDescontoItem": 0,
			"ValorServicoItem": 0,
			"ValorDescontoComboItem": 0,
			"ValorAcrescimoItem": 0,
			"TipoOperacao": 0
		}
	]
}


Item fracionado (1/3) - Valor Proprocional


Produto

Preço

Quantidade

Valor Total

A MODA DA CASA

54,00

0,333

R$ 17,98

MODA LIGHT

78,00

0,333

R$ 25,97

QUATRO QUEIJOS

50,14

0,334

R$ 16,74

Total



R$ 60,69

...

Neste caso o ValorTotal do Item deve ser a igual a soma do ValorTotal de todos ItensFracao.


Item fracionado (1/2) - Produto de Maior Valor


Produto

Preço

Quantidade

Valor Total

A MODA DA CASA

54,00

0,5

R$ 27,00

MODA LIGHT

78,00

0,5

R$ 39,00

Total



R$ 78,00

Bloco de código
titleJson de Publicação para ExecAuto
{
	"Itens": [
		{
			"TipoItem": 1,
			"Produto": null,
			"Quantidade": 0,
			"Acrescimo": 0,
			"Desconto": 0,
			"MotivoAcrescimoDesconto": null,
			"AcrescimoDiferencaFracionada": 0,
			"Observacao": null,
			"ItensFracao": [
				{
					"TipoItem": 0,
					"Produto": {
						"Codigo": "13",
						"Descricao": "A MODA DA CASA",
						"PrecoVenda": 54.0,
						"PrecoOriginal": 0,
						"PrecoPromocional": 0,
						"Pesavel": true,
						"Processado": false,
						"ProdutoComposto": false,
						"BaixarEstoqueOnline": false,
						"QuantidadeEstoque": 0,
						"Composicoes": null
					},
					"Quantidade": 0.5,
					"Acrescimo": 0,
					"Desconto": 0,
					"MotivoAcrescimoDesconto": null,
					"AcrescimoDiferencaFracionada": 0,
					"Observacao": "",
					"ItensFracao": null,
					"ItensAdicionais": [],
					"ValorTotal": 27,
					"ValorDescontoItem": 0,
					"ValorServicoItem": 0,
					"ValorDescontoComboItem": 0,
					"ValorAcrescimoItem": 0,
					"TipoOperacao": 0
				},
				{
					"TipoItem": 0,
					"Produto": {
						"Codigo": "14",
						"Descricao": "MODA LIGHT",
						"PrecoVenda": 78.0,
						"PrecoOriginal": 0,
						"PrecoPromocional": 0,
						"Pesavel": true,
						"Processado": false,
						"ProdutoComposto": false,
						"BaixarEstoqueOnline": false,
						"QuantidadeEstoque": 0,
						"Composicoes": null
					},
					"Quantidade": 0.5,
					"Acrescimo": 0,
					"Desconto": 0,
					"MotivoAcrescimoDesconto": null,
					"AcrescimoDiferencaFracionada": 0,
					"Observacao": "",
					"ItensFracao": null,
					"ItensAdicionais": [],
					"ValorTotal": 39,
					"ValorDescontoItem": 0,
					"ValorServicoItem": 0,
					"ValorDescontoComboItem": 0,
					"ValorAcrescimoItem": 0,
					"TipoOperacao": 0
				}
			],
			"ItensAdicionais": null,
			"ValorTotal": 78,
			"ValorDescontoItem": 0,
			"ValorServicoItem": 0,
			"ValorDescontoComboItem": 0,
			"ValorAcrescimoItem": 0,
			"TipoOperacao": 0
		}
	]
}



Item fracionado (1/3) - Produto de Maior Valor


Produto

Preço

Quantidade

Valor Total

A MODA DA CASA

54,00

0,333

R$ 17,98

MODA LIGHT

78,00

0,333

R$ 25,97

QUATRO QUEIJOS

50,14

0,334

R$ 16,74

Total



R$ 78,00

...

Neste caso o ValorTotal do item é igual ao valor ao maior preço entre os ItensFracao, a soma dos totais dos itens da fração difere do valor total, mas com esta configuração o importante é o valor total do item apenas e não das frações.


Item fracionado com Adicionais

Produtos adicionais são produtos que só devem ser vendidos associado a outro produto. Os adicionais devem respeitar o relacionamento retornado no serviço ObterCardapio.

...

ValorTotal do item não deve conter o somatório dos adicionais.


Item com quantidade fracionada

Apenas produtos com a configuração PermitirVendaFracionado habilitada aceitam quantidade com casas decimais(Q), demais produtos aceitam apenas quantidades inteiras(N).


Casas Decimais

A tabela abaixo indica a limitação de casa decimais de acordo com cada atributo:

...

Campo

Decimais

Quantidade

3

Desconto

2

Troco

2

Forma de valor

2

Valor Total Item

2

Valor Total Pedido

2


Arredondamento

Quando o cálculo de ValorTotal do item tiver mais do que 2 casas decimais este resultado deve ser arredondado de acordo com o padrão ABNT

...

Produto

Preço

Quantidade

Valor Total

Valor Final

Presunto Seara

4,25

2,654

11,2795

11,28

Código Terminal

Poderá ser enviado o código terminal por parte da integradora de ate 50 caracteres

...

Mensagem de erro

Erro interno de processamento da requisição.

Erro ao enviar pedido.

Não foi possível estabelecer uma conexão com a loja.

Pedido inválido.

Código integração inválido.

O pedido deve conter no mínimo 1 item.

Item inválido.

Produto "{0}" com quantidade zero.

O valor total do item "{0}" difere do cálculo do sistema.

Produto "{0}" não permite fração.

Produto "{0}" inválido.

Produto "{0}" com preço desatualizado.

Produto "{0}" sem preço de venda.

Erro ao salvar pedido no sistema.

Erro ao consultar status do estabelecimento.

O valor total do pedido deve ser igual ou superior a R$ 0,01.

Quantidade do item é inválida para uma venda fracionada (1/2, 1/3 ou 1/4).

A soma dos itens da venda fracionada deve completar 1 inteiro.

O valor total do item fracionado deve ser igual ao preço do item de maior valor.

Item fracionado deve conter no mínimo 2 frações (itens).

O valor total do item deve ser truncado em 2 casas decimais.

A quantidade do item deve conter no máximo 3 casas decimais.

O valor total do item fracionado deve ser igual à soma dos valores das frações (itens).

Item do tipo "normal" não aceita itens fração.

Os itens da fração devem ser do tipo "normal".

Os itens adicionais devem ser do tipo "normal".

Produto "{0}" não é um adicional do produto "{1}".

Quantidade do item "{0}" superior ao máximo permitido.

Quantidade de adicionais do item "{0}" superior ao máximo permitido.

Quantidade de adicionais do item "{0}" inferior ao mínimo permitido.

Item do tipo fracionado não pode conter adicionais.

Erro ao baixar estoque dos itens vendidos.

Mesa em digitação em outro terminal.

Erro ao imprimir pedidos na impressora de boqueta.

Erro ao imprimir monitor

Erro ao imprimir

Erro ao consultar movimentação da mesa.

Erro ao consultar mesas em aberto.

Erro ao consultar transferências de itens.

Erro ao consultar itens cancelados da mesa.

Erro ao solicitar garçom.

Número mesa invalido.

Mesa fechada.

Código externo {0} duplicado na lista de itens do pedido.

Código externo do item inválido.

Código externo {0} duplicado.


Consultar Mesas em Aberto


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/ConsultarMesasAbertas

...

Status

Código

Disponivel

0

Aberta

1

EmDigitacao

2

Fechada

3


Reservas de Mesas

Verifica o status das mesas e em que fase elas se encontram (Entrada, Prota Principal, Sobremesa, Café ou Conta)

...

FaseDescrição
AENTRADA
BPRATO PRINCIPAL
CSOBREMESA
DCAFÉ
ECONTA

Consultar Cupom Mesa


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/ConsultarCupomMesa

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"ConsultarMovimentacaoMesaResult": {
		"Erros": null,
		"Itens": [
			{
				"Acrescimo": 0,
				"AcrescimoDiferencaFracionada": 0,
				"Desconto": 0,
				"ItensAdicionais": [],
				"ItensFracao": null,
				"MotivoAcrescimoDesconto": null,
				"Observacao": "",
				"Produto": {
					"BaixarEstoqueOnline": false,
					"Codigo": "5",
					"Composicoes": null,
					"Descricao": "COCA COLA LATA",
					"Pesavel": false,
					"PrecoOriginal": 0,
					"PrecoPromocional": 0,
					"PrecoVenda": 5.0,
					"Processado": false,
					"ProdutoComposto": false,
					"QuantidadeEstoque": 0,
					"PrecoVendaAMaiorFracionado": 0
				},
				"Quantidade": 1,
				"TipoItem": 0,
				"TipoOperacao": 0,
				"ValorAcrescimoItem": 0,
				"ValorDescontoComboItem": 0,
				"ValorDescontoItem": 0,
				"ValorServicoItem": 0,
				"ValorTotal": 5.0,
				"CodigoControle": "2378",
				"CodigoExterno": "1380600833"
			},
			{
				"Acrescimo": 0,
				"AcrescimoDiferencaFracionada": 0,
				"Desconto": 0,
				"ItensAdicionais": [],
				"ItensFracao": null,
				"MotivoAcrescimoDesconto": null,
				"Observacao": "",
				"Produto": {
					"BaixarEstoqueOnline": false,
					"Codigo": "42",
					"Composicoes": null,
					"Descricao": "CAFE EXPRESSO",
					"Pesavel": false,
					"PrecoOriginal": 0,
					"PrecoPromocional": 0,
					"PrecoVenda": 5.0,
					"Processado": false,
					"ProdutoComposto": false,
					"QuantidadeEstoque": 0,
					"PrecoVendaAMaiorFracionado": 0
				},
				"Quantidade": 1,
				"TipoItem": 0,
				"TipoOperacao": 0,
				"ValorAcrescimoItem": 0,
				"ValorDescontoComboItem": 0,
				"ValorDescontoItem": 0,
				"ValorServicoItem": 0,
				"ValorTotal": 5.0,
				"CodigoControle": "2379",
				"CodigoExterno": "2109087502"
			},
			{
				"Acrescimo": 0,
				"AcrescimoDiferencaFracionada": 0,
				"Desconto": 0,
				"ItensAdicionais": [],
				"ItensFracao": null,
				"MotivoAcrescimoDesconto": null,
				"Observacao": "",
				"Produto": {
					"BaixarEstoqueOnline": false,
					"Codigo": "61",
					"Composicoes": null,
					"Descricao": "ESFIHA DE CARNE",
					"Pesavel": false,
					"PrecoOriginal": 0,
					"PrecoPromocional": 0,
					"PrecoVenda": 2.0,
					"Processado": false,
					"ProdutoComposto": false,
					"QuantidadeEstoque": 0,
					"PrecoVendaAMaiorFracionado": 0
				},
				"Quantidade": 1,
				"TipoItem": 0,
				"TipoOperacao": 0,
				"ValorAcrescimoItem": 0,
				"ValorDescontoComboItem": 0,
				"ValorDescontoItem": 0,
				"ValorServicoItem": 0,
				"ValorTotal": 2.0,
				"CodigoControle": "2380",
				"CodigoExterno": "301533263"
			}
		],
		"StatusMesa": 1,
		"Totais": {
			"Desconto": 0.0,
			"Servico": 1.8,
			"Subtotal": 12.0,
			"TotalConta": 13.8
		}
	}
}


Consultar Transferências de Itens


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/ConsultarTransferenciasItens

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"ConsultarTransferenciasItensResult": {
		"Erros": null,
		"Transferencias": [
			{
				"CodigoControle": "2378",
				"CodigoExterno": "1380600833",
				"MesaAtual": 10,
				"MesaOriginal": 789,
				"Quantidade": 1
			},
			{
				"CodigoControle": "2380",
				"CodigoExterno": "301533263",
				"MesaAtual": 15,
				"MesaOriginal": 789,
				"Quantidade": 1
			}
		]
	}
}


Consultar Itens Cancelados


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/ConsultarItensCanceladosMesa

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"ConsultarItensCanceladosMesaResult": {
		"Erros": null,
		"Itens": [
			{
				"Acrescimo": 0,
				"AcrescimoDiferencaFracionada": 0,
				"Desconto": 0,
				"ItensAdicionais": null,
				"ItensFracao": null,
				"MotivoAcrescimoDesconto": null,
				"Observacao": "",
				"Produto": {
					"BaixarEstoqueOnline": false,
					"Codigo": "3",
					"Composicoes": null,
					"Descricao": "SKOL LONG NECK",
					"Pesavel": false,
					"PrecoOriginal": 0,
					"PrecoPromocional": 0,
					"PrecoVenda": 10.0,
					"Processado": false,
					"ProdutoComposto": false,
					"QuantidadeEstoque": 0,
					"PrecoVendaAMaiorFracionado": 0
				},
				"Quantidade": 1,
				"TipoItem": 0,
				"TipoOperacao": 0,
				"ValorAcrescimoItem": 0,
				"ValorDescontoComboItem": 0,
				"ValorDescontoItem": 0,
				"ValorServicoItem": 0,
				"ValorTotal": 10,
				"CodigoControle": null,
				"CodigoExterno": null
			}
		]
	}
}


Solicitar Garçom


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/SolicitarGarcom

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"SolicitarGarcomResult": {
		"Erros": null,
		"Sucesso": true
	}
}

Transferir Itens entre Cadeira


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/TransferirItensCadeira

...

Bloco de código
titleJson de Publicação para ExecAuto
{
	"TransferirItensCadeiraResult": {
		"Erros": [],
		"Sucesso": true
	}
}


Fechar Conta


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/FecharConta

...

Mensagem de erro

Erro interno de processamento da requisição.

Número mesa invalido.

Mesa sem movimentação.

Mesa em digitação em outro terminal.

Mesa fechada.

Configure o G-ECF para utilizar esta função.

G-ECF Inativo.

Erro ao calcular taxa de serviço.

O valor de desconto deve ser inferior ao total da conta.

Erro ao fechar conta.

Erro ao imprimir conta.


Consultar Movimentação de Cadeiras da Mesa


URL do Serviço:

POST: http://{url_do_servidor}/ConsultarMovimentacaoCadeiraMesa

...

Mensagem de erro

Numero de mesa inválido.

Erro ao consultar movimentação de cadeiras.


Efetuar Pagamento


URL do Serviço:

POST: http://{url_do_servidor}/MesaService.svc/EfetuarPagamento

...