Histórico da Página

...

Totvs custom tabs box

tabs	Dados integrados c/ Winthor, Gravação Pedido/Retorno
ids	passo1,passo2

A integração consiste em receber o pedido que será faturado.

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

API	Descrição	Coluna	Tipo	Obrigatório
situacaoPreVenda	0 = CANCELADA 1 = RECEBIDO 2 = DISPONIVEL 3 = RESGATADA 4 = FATURAMENTO		String	SIM
id	Identificação do pedido no PDV.	PCPEDC.NUMPEDHUBE	String	SIM
observacoes	Observações	PCPEDC.OBS
idOperadorRetaguarda	Matricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012.	PCPEDC.CODUSUR	long	NÃO
idLojaRetaguarda	Código da filial.			SIM
preVendaItens.*.quantidade	Deve ser maior que zero.	PCPEDI.QT	int	SIM
preVendaItens.*.preco	Deve ser maior que zero.	PCPEDI.PVENDA
preVendaItens.*.desconto	Valor de desconto.			NÃO
preVendaItens.*.descontoPercentual	Percentual de desconto.			NÃO
preVendaItens.*.idProdutoRetaguarda	Código auxiliar mais o código do produto. Ex: 123-1.	PCPEDI.CODPROD		SIM
preVendaItens.*.idVendedorRetaguarda	Matrícula do funcionário (quando id somente com números) ou código do RCA (quando id iniciado pelo texto "RCA-", os números em sequência representam o código do RCA). Quando recebida a matrícula do funcionário, o código do RCA informado no cadastro do funcionário será aplicado no item do pedido. O id do último item será utilizado para definir o RCA do Pedido.	PCPEDI.CODUSUR		NÃO
preVendaItens.*.entrega.idRetaguardaLojaEntrega	Código da filial retira.			NÃO
preVendaItens.*.itensKit	Array de Itens do KIT (Cesta Básica)			SIM
preVendaItens..itensKit..idProdutoRetaguarda	EAN-Código do Produto do item do KIT (Cesta Básica)	PCPEDICESTA.CODPRODMP		NÃO
preVendaItens..itensKit..sequencial	Sequencial do item do KIT (Cesta Básica)			SIM
preVendaItens..itensKit..preco	Preço do item do KIT (Cesta Básica)	PCPEDICESTA.PVENDA		SIM
preVendaItens..itensKit..quantidade	Quantidade do item do KIT (Cesta Básica)	PCPEDICESTA.QTMP		SIM
cliente	Caso não seja informado o cliente será usado o cliente consumidor final. Caso o cliente esteja com o cadastro completo, ele já será gravado na base do winthor .			NÃO
cliente.bairro	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque			NÃO
cliente.telefone	Caso não preenchido será usado o campo celular			NÃO
cliente.celular	Caso não preenchido será usado o campo telefone			NÃO
cliente.cep	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque			NÃO
cliente.cidade	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque			NÃO
cliente.complemento				NÃO
cliente.cpfCnpj	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque Caso já exista um cliente com mesmo CGC e o idRetaguarda não seja informado será usado o cliente mais antigo que contém o mesmo CGC			NÃO
cliente.email	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque			NÃO
cliente.endereco	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque			NÃO
cliente.estado	Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque			NÃO
cliente.idRetaguarda	Código cliente			NÃO

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Bloco de código

language	js
title	URI

method: 'POST',
url: '/winthor/varejo/matcon/v1/orders/pdvsync'

Bloco de código

language	js
title	Body Request

{
	"situacaoPreVenda": "FATURAMENTO",
	"modalidadeFrete": 0,
	"id": 10129,
	"idInquilino": "MATCONHML",
    "observacoes": "venda de teste",
    "idOperadorRetaguarda":"1",
	"idLojaRetaguarda": "2",
	"numero": "1003349",
	"situacao": 1,
	"tipoEntrega": 0,
    "descontoPercentualTotal":0.0,
    "acrescimoPercentualTotal": 0,
    "freteTotal":0.0,
    "fretePercentualTotal":0.0,
	"cliente": null,
    "preVendaItens":[
      {
        "desconto": 0,
        "frete": 0.0,
        "id": 7147,
        "acrescimoPercentual": 0.0,
        "idProdutoRetaguarda": "7896635100016-1048",
        "idVendedorRetaguarda": "5",
        "idProdutoEmbalagemRetaguarda": null,
        "descontoPercentual": 0,
        "quantidade": 1.0,
        "preco": 1.70,
        "situacao": 1,
        "entrega": {
            "dataEntrega": "2023-11-10T15:21:45.676387",
            "idLojaEntregaRetaguarda": "1",
            "tipoEntrega": 0
        }
      },
      {
        "desconto": 0,
        "frete": 0.0,
        "id": 7147,
        "acrescimoPercentual": 0.0,
        "idProdutoRetaguarda": "7896635100016-1048",
        "idVendedorRetaguarda": "5",
        "idProdutoEmbalagemRetaguarda": null,
        "descontoPercentual": 0,
        "quantidade": 1.0,
        "preco": 1.70,
        "situacao": 1,
        "entrega": {
            "dataEntrega": "2023-11-10T15:21:45.676387",
            "idLojaEntregaRetaguarda": "1",
            "tipoEntrega": 2
        }
      } 
    ],
	"vendaPagamentos": [
		{
			"id": 1880,
			"valorPago": 25.50,
			"valorLiquido":  25.50,
            "pagamentoCondicao": {
                "idRetaguarda": 1,
                "descricao": "A VISTA"
            },
			"pagamentoForma": {
				"idRetaguarda": "DH",
				"descricao": "DH - DINHEIRO EM TRANSITO"
			}
		}
	]
}

Bloco de código

language	js
title	Body Response

{
    "success": true,
    "hasNext": false,
    "message": "Pedido faturado no Winthor com sucesso."",
    "data": {
        "idPedidoRetaguarda": "5003037",
        "cliente": {
            "idRetaguarda": "1"
        }
    }
}

Páginas filhas

Versões comparadas

Versão antiga 19

Nova versão 20

Chave