Páginas filhas
  • API - Pedidos Online: Balcão

Versões comparadas

Chave

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

...

Verifica o status atual do pedido, os possíveis status de um pedido estão descritos na tabela abaixo.


Aviso
titleIMPORTANTE

Os campos para informações do TEF e a forma de pagamento PIX estão disponíveis a partir da versão 3.2406.0001 do PDV 


URL do Serviço:

POST: http://{url_do_servidor}/BalcaoService.svc/StatusPedido

...

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 truncado em 2 casas conforme exemplo abaixo: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,2728



Pagamentos


Tipo
: deve respeitar a tabela abaixo.

Forma de Pagamento

Código

Cartão de Credito

2

Cartão de Debito

3

Pix

20

CodigoReferencia: informar o código de cartões/operada (ex: Visa Electron) da aplicação integrada, através deste código é feita correspondência com o cadastro de cartões/operadoras do TOTVS Chef

...

Total Itens

70,00

Valor Total Pedido

70,00

...

PagamentoTEF: Informações de retorno de uma transação TEF, quando for uma transação TEF todos os campos são obrigatórios, exceto EndToEndId que se refere ao PIX

EndToEndId: Chave de retorno de transação PIX

Código Terminal

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

Bloco de código
titleJson de Publicação para ExecAuto
{
	"parametros": {
		"Pedido": {
			"CodigoExternoPedido": "16",
			"CodigoExternoPedidoReduzido": null,
			"CodigoTerminal": "52",
			"CupomIntegradora": "",
			"Cliente": {
				"Id": null,
				"NomeCompleto": "Totvs Chef",
				"TipoPessoa": 0,
				"Sexo": 0,
				"CpfCnpj": "08291225249",
				"Endereco": null,
				"EnderecoEntrega": null,
				"ConheceuComo": null,
				"RgIE": null
			},
			"Troco": 0,
			"Desconto": 0,
			"DescontoTaxaEntrega": 0,
			"ValorTotal": 70,
			"Pagamentos": [
				{
					"Tipo": 2,
					"Valor": 70,
					"CodigoReferencia": "3",
					"PagoOnline": false
					"PagamentoTEF": {
                        "NsuTef": "",
                        "NsuHost": "",
                        "CodigoAutorizadora": "",
                        "CodigoBandeira": "",
                        "CnpjAutorizadora": "",
                        "DescricaoBandeira": "",
                        "DescricaoAutorizadora": "",
                        "CodigoAutorizacao": "" 
                        "EndToEndId": "",                      
					}
			     }
			],
			"IncluirCPFNaNota": true,
			"ObservacaoPedido": null,
			"AceitaPedidoAutomaticamente": false,
			"MinutosRejeitaAutomaticamente": 0,
			"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": 10,
							"Acrescimo": 0,
							"Desconto": 0,
							"MotivoAcrescimoDesconto": null,
							"AcrescimoDiferencaFracionada": 0,
							"Observacao": null,
							"ItensFracao": null,
							"ItensAdicionais": null,
							"ValorTotal": 50,
							"ValorDescontoItem": 0,
							"ValorServicoItem": 0,
							"ValorDescontoComboItem": 0,
							"ValorAcrescimoItem": 0,
							"TipoOperacao": 0
						}
					],
					"ValorTotal": 20,
					"ValorDescontoItem": 0,
					"ValorServicoItem": 0,
					"ValorDescontoComboItem": 0,
					"ValorAcrescimoItem": 0,
					"TipoOperacao": 0
				}
			]
		},
		"CodigoEstabelecimento": "96700001PC13",
		"CodigoIntegracao": 99,
		"RequestID": null,
		"TipoServico": null
	}
}

...


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.

Código externo do pedido inválido.

Duplicidade de pedido por código externo.

Total do pedido difere do somatório dos itens.

O pedido deve conter um cliente.

Cliente sem CPF ou CPNJ.

Cliente com nome 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.

O pedido deve conter no mínimo uma forma de pagamento.

Formas de pagamento com valor inválido.

Somatório das formas de pagamento difere do total do pedido.

Erro ao salvar pedido no sistema.

Cliente com CPF ou CPNJ inválido.

Erro ao consultar status do 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}".

Forma de pagamento não permitido.

TEF Informado para pagamento {0}, informe todos os campos TEF