Envio de pedidos para o Cartão via API PedidosOnline
URL do Serviço:
POST: http://{url_do_servidor}/CartaoService.svc/EnviarPedido |
---|
Request
Método de envio de pedido para os estabelecimentos.
CodigoEstabelecimento
: É o código do estabelecimento no cadastro do TOTVS Chef, este código deve ser vinculado ao cadastro de loja da aplicação integrada. Não é necessário informar em ambiente intranet
CodigoIntegracao
: códigos inválidos ou inativados são rejeitados. Respeitar tabela de integração.
Itens
1-Tipos de Item
TipoItem
: Indica se o item é individual (Normal) ou uma composição de frações de 2 ou mais produtos (Fracionado). Deve respeitar a tabela abaixo
Tipo Item | Código |
Normal | 0 |
Fracionado | 1 |
Item normal não aceita Subitens no atributo ItensFracao
, exemplo de item do tipo Normal:
{ "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 } ] }
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:
{{ "Itens": [ { "TipoItem": 0, "Produto": { "Codigo": "61", "Descricao": "ESFIHA DE CARNE", "PrecoVenda": 2.0, "PrecoOriginal": 0, "PrecoPromocional": 0, "Pesavel": false, "Processado": false, "ProdutoComposto": false, "BaixarEstoqueOnline": false, "QuantidadeEstoque": 0, "Composicoes": null }, "Quantidade": 10, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [ { "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": null, "ItensFracao": null, "ItensAdicionais": null, "ValorTotal": 5, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ], "ValorTotal": 20, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ] }
O ValorTotal do item não deve conter o somatório dos adicionais.
Item fracionado deve conter 2 ou mais itens de composição de fração, exemplo de item do tipo Fracionado:
{ "Itens": [ { "CodigoExterno": null, "TipoItem": 1, "Produto": null, "Quantidade": 0, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": null, "ItensFracao": [ { "CodigoExterno": "54077055", "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 }, { "CodigoExterno": "468713429", "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 } ] }
IMPORTANTE
A soma das quantidades de todos ItensFracao
deve formar 1 inteiro, sendo aceito apenas as frações 1/2 (0,5 + 0,5), 1/3 (0,333 + 0,333 + 0,334) ou 1/4 (0,25 + 0,25 + 0,25 + 0,25).
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:
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 |
{ "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 } ] }
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 |
{ "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.333, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [], "ValorTotal": 17.98, "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.333, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [], "ValorTotal": 25.97, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 }, { "TipoItem": 0, "Produto": { "Codigo": "160", "Descricao": "QUATRO QUEIJOS", "PrecoVenda": 50.14, "PrecoOriginal": 0, "PrecoPromocional": 0, "Pesavel": true, "Processado": false, "ProdutoComposto": false, "BaixarEstoqueOnline": false, "QuantidadeEstoque": 0, "Composicoes": null }, "Quantidade": 0.334, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [], "ValorTotal": 16.74, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ], "ItensAdicionais": null, "ValorTotal": 60.69, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 }
Neste caso o ValorTotal
do Item deve ser a igual a soma do ValorTotal
de todos ItensFracao
.
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 |
{ "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 } ] }
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 |
{ "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.333, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [], "ValorTotal": 17.98, "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.333, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [], "ValorTotal": 25.97, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 }, { "TipoItem": 0, "Produto": { "Codigo": "160", "Descricao": "QUATRO QUEIJOS", "PrecoVenda": 50.14, "PrecoOriginal": 0, "PrecoPromocional": 0, "Pesavel": true, "Processado": false, "ProdutoComposto": false, "BaixarEstoqueOnline": false, "QuantidadeEstoque": 0, "Composicoes": null }, "Quantidade": 0.334, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [], "ValorTotal": 16.74, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ], "ItensAdicionais": null, "ValorTotal": 78.0, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ] }
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.
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.
{ "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": [ { "TipoItem": 0, "Produto": { "Codigo": "4", "Descricao": "HEINEKEN LONG NECK", "PrecoVenda": 2.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": null, "ItensFracao": null, "ItensAdicionais": null, "ValorTotal": 2, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ], "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": [ { "TipoItem": 0, "Produto": { "Codigo": "3", "Descricao": "SKOL LONG NECK", "PrecoVenda": 10.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": null, "ItensFracao": null, "ItensAdicionais": null, "ValorTotal": 10, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ], "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 } ] }
O ValorTotal
do item não deve conter o somatório dos adicionais.
Apenas produtos com a configuração PermitirVendaFracionado
habilitada aceitam quantidade com casas decimais(Q), demais produtos aceitam apenas quantidades inteiras(N).
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 |
Quando o cálculo de ValorTotal
do item tiver mais do que 2 casas decimais este resultado deve ser truncado em 2 casas conforme exemplo abaixo:
Produto | Preço | Quantidade | Valor Total | Valor Final |
Presunto Seara | 4,25 | 2,654 | 11,2795 | 11,27 |
Poderá ser enviado o código terminal por parte da integradora de ate 50 caracteres.
{ "parametros": { "Pedido": { "NumeroCartao": 999, "NumeroMesaEntrega": 10, "CodigoTerminal": "52", "CodigoGarcom": 0, "Itens": [ { "CodigoExterno": "931864388", "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 }, { "CodigoExterno": "1370008605", "TipoItem": 0, "Produto": { "Codigo": "61", "Descricao": "ESFIHA DE CARNE", "PrecoVenda": 2.0, "PrecoOriginal": 0, "PrecoPromocional": 0, "Pesavel": false, "Processado": false, "ProdutoComposto": false, "BaixarEstoqueOnline": false, "QuantidadeEstoque": 0, "Composicoes": null }, "Quantidade": 1, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": "", "ItensFracao": null, "ItensAdicionais": [ { "CodigoExterno": "1454689182", "TipoItem": 0, "Produto": { "Codigo": "6", "Descricao": "FANTA LARANJA", "PrecoVenda": 5.5, "PrecoOriginal": 0, "PrecoPromocional": 0, "Pesavel": false, "Processado": false, "ProdutoComposto": false, "BaixarEstoqueOnline": false, "QuantidadeEstoque": 0, "Composicoes": null }, "Quantidade": 1, "Acrescimo": 0, "Desconto": 0, "MotivoAcrescimoDesconto": null, "AcrescimoDiferencaFracionada": 0, "Observacao": null, "ItensFracao": null, "ItensAdicionais": null, "ValorTotal": 5.5, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ], "ValorTotal": 2, "ValorDescontoItem": 0, "ValorServicoItem": 0, "ValorDescontoComboItem": 0, "ValorAcrescimoItem": 0, "TipoOperacao": 0 } ] }, "CodigoEstabelecimento": "96700001PC1", "CodigoIntegracao": 99, "RequestID": null, "TipoServico": null } }
Response
O serviço retorna um JSON no formato abaixo:
Sucesso
Sucesso
= true indica que o pedido foi registrado corretamente.
{ "EnviarPedidoResult": { "Erros": [], "CodigosItens": [ { "CodigoControle": "2378", "CodigoExterno": "1380600833" }, { "CodigoControle": "2379", "CodigoExterno": "2109087502" }, { "CodigoControle": "2380", "CodigoExterno": "301533263" } ], "Sucesso": true } }
Erro
Sucesso
= false indica que o pedido não foi registrado no sistema, no atributo Erros encontra a lista de motivos/problemas que ocorreram.
{ "EnviarPedidoResult": { "Erros": [ "Produto "FRANGO COM CATUPIRY" com quantidade zero.", "Produto "BORDA CATUPIRY" com quantidade zero.", "Código externo do item inválido." ], "CodigosItens": null, "Sucesso": false } }
A tabela abaixo tem a relação completa de possíveis erros e validações que devem ser tratados pelo aplicado integrado.
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. |
URL do Serviço:
POST: http://{url_do_servidor}/CartaoService.svc/ConsultarCartoesAbertos |
---|
Request
{ "parametros": { "CodigoEstabelecimento": "96700001PC1", "CodigoIntegracao": 99, "RequestID": null, "TipoServico": null } }
Response
{ "ConsultarMesasAbertasResult": { "Erros": null, "Mesas": [ { "NumeroCartao": 789, "StatusCartao": 1 }, { "NumeroCartao": 11, "StatusCartao": 2 } ] } }
StatusCartao
retorna o status conforme tabela abaixo.
Status | Código |
Disponivel | 0 |
Aberto | 1 |
EmDigitacao | 2 |
Fechado | 3 |
URL do Serviço:
POST: http://{url_do_servidor}/CartaoService.svc/ConsultarMovimentacaoCartao |
---|
Request
{ "parametros": { "CodigoEstabelecimento": "96700001PC1", "CodigoIntegracao": 99, "NumeroCartao": 8890 "RequestID": null, "TipoServico": null } }
Response
{ ConsultarMovimentacaoCartaoResult: { Erros: null, Itens: [ { Acrescimo: 0, AcrescimoDiferencaFracionada: 0, Desconto: 0, ItensAdicionais: [ { Acrescimo: 0, AcrescimoDiferencaFracionada: 0, Desconto: 0, ItensAdicionais: null, ItensFracao: null, Observacao: "", Produto: { Codigo: "10011006", Descricao: "BORDA CATUPIRY", PrecoVenda: 6.4 }, Quantidade: 1, TipoItem: 0, ValorTotal: 6.4, CodigoControle: "28160", CodigoExterno: "1906432659" }, { Acrescimo: 0, AcrescimoDiferencaFracionada: 0, Desconto: 0, ItensAdicionais: null, ItensFracao: null, Observacao: "", Produto: { Codigo: "10011008", Descricao: "BACON", PrecoVenda: 10.59 }, Quantidade: 1, TipoItem: 0, ValorTotal: 10.59, CodigoControle: "28161", CodigoExterno: "550138083" } ], ItensFracao: null, Observacao: "", Produto: { Codigo: "10011002", Descricao: "FRANGO COM CATUPIRY", PrecoVenda: 35.65 }, Quantidade: 1, TipoItem: 0, ValorTotal: 35.65, CodigoControle: "28159", CodigoExterno: "1963160123" }, { Acrescimo: 0, AcrescimoDiferencaFracionada: 0, Desconto: 0, ItensAdicionais: [], ItensFracao: null, Observacao: "COM GELO E LIMAO", Produto: { Codigo: "10011001", Descricao: "COCA COLA LT", PrecoVenda: 2.5 }, Quantidade: 1, TipoItem: 0, ValorTotal: 5, CodigoControle: "28158", CodigoExterno: "1096751580" } ], StatusCartao: 1, Totais: { Desconto: 0, Servico: 5.51, Subtotal: 55.14, TotalConta: 60.65 } } }
URL do Serviço:
POST: http://{url_do_servidor}/CartaoService.svc/ConsultarTransferenciasItens |
---|
Request
{ "parametros": { "CodigoEstabelecimento": "96700001PC1", "CodigoIntegracao": 99, "RequestID": null, "TipoServico": null } }
Response
{ "ConsultarTransferenciasItensResult": { "Erros": null, "Transferencias": [ { "CartaoAtual": 10, "CartaoOriginal": 789, "CodigoControle": "2378", "CodigoExterno": "1380600833", "Quantidade": 1 }, { "CartaoAtual": 15, "CartaoOriginal": 789, "CodigoControle": "2380", "CodigoExterno": "301533263", "Quantidade": 1 } ] } }
URL do Serviço:
POST: http://{url_do_servidor}/CartaoService.svc/ConsultarItensCanceladosCartao |
---|
Request
{ "parametros": { "CodigoEstabelecimento": "96700001PC1", "CodigoIntegracao": 99, "NumeroCartao": 60, "RequestID": null, "TipoServico": null } }
Response
{ ConsultarItensCanceladosCartaoResult: { Erros: null, Itens: [ { Acrescimo: 0, AcrescimoDiferencaFracionada: 0, Desconto: 0, ItensAdicionais: null, ItensFracao: null, Observacao: "", Produto: { Codigo: "10011006", Descricao: "BORDA CATUPIRY", PrecoVenda: 6.4 }, Quantidade: 1, TipoItem: 0, ValorTotal: 6.4, CodigoControle: null, CodigoExterno: null } ] } }
URL do Serviço:
POST: http://{url_do_servidor}/MesaService.svc/SolicitarGarcom |
---|
Request
{ "parametros": { "NumeroMesa": 1, "CodigoEstabelecimento": "96700001PC13", "CodigoIntegracao": 99, "RequestID": null, "TipoServico": null } }
Response
{ "SolicitarGarcomResult": { "Erros": null, "Sucesso": true } }
URL do Serviço:
POST: http://{url_do_servidor}/CartaoService.svc/FecharConta |
---|
Request
{ "parametros": { "Conta": { "NumeroCartao": 100, "NumeroMesaEntrega": 1, "QuantidadePessoas": 4, "TirarServico": false, "Desconto": 0 }, "CodigoEstabelecimento": "96700001PC1", "CodigoIntegracao": 99, "RequestID": null, "TipoServico": null } }
Response
O serviço retorna um JSON no formato abaixo:
Sucesso
{ "FecharContaResult": { "Erros": [], "Sucesso": true } }
Erro
{ "FecharContaResult": { "Erros": [ "Cartao sem movimentação." ], "Sucesso": false } }
A tabela abaixo tem a relação completa de possíveis erros e validações que devem ser tratados pelo aplicado integrado.
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. |