Páginas filhas
  • API Pedidos Online - Cartão

Versões comparadas

Chave

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

Pedido Cartão

Í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


Truncamento

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


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 Cartões em Aberto


URL do Serviço:

POST: http://{url_do_servidor}/CartaoService.svc/ConsultarCartoesAbertos

...

Status

Código

Disponivel

0

Aberto

1

EmDigitacao

2

Fechado

3


Consultar Movimentação Cartão


URL do Serviço:

POST: http://{url_do_servidor}/CartaoService.svc/ConsultarMovimentacaoCartao

...

Bloco de código
titleJson de Publicação para ExecAuto
{
   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
      }
   }
}    

Consultar Transferências de Itens


URL do Serviço:

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

...

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


Consultar Itens Cancelados


URL do Serviço:

POST: http://{url_do_servidor}/CartaoService.svc/ConsultarItensCanceladosCartao

...

Bloco de código
titleJson de Publicação para ExecAuto
{
   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
         }
      ]
   }
}


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
	}
}

Fechar Conta


URL do Serviço:

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

...