Exibir origem

01. DADOS GERAIS

Produto:
Linha de Produto:
Segmento:
Módulo:	Vendas
Função:	API B2C
País:	Brasil
Requisito/Story/Issue (informe o requisito relacionado) :	DDVENDAS-57183

02. SITUAÇÃO/REQUISITO

Havia a necessidade de permitir que a API B2C recebesse e gravasse os dados do consumidor final na tabela PCVENDACONSUM, vinculando essas informações ao mesmo número de pedido (NUMPED) gerado pela própria API durante o processo de integração.

03. SOLUÇÃO

Foi implementado um novo grupo opcional no payload de entrada da API B2C, denominado listconsumerData.

A solução permite a persistência de diversos campos (como CPF, Endereço, Bairro, Telefone, Email, entre outros) diretamente na tabela PCVENDACONSUM. O sistema garante que:

As informações sejam gravadas utilizando o mesmo NUMPED do pedido gerado.
A integridade dos tipos de dados seja validada conforme a estrutura da tabela (ex: campos numéricos não aceitam texto).
O envio do grupo e de seus campos seja totalmente opcional, permitindo o envio parcial de dados (ex: apenas o CPF).

Para a utilização correta desta funcionalidade, certifique-se de que o ambiente esteja atualizado com as seguintes versões mínimas:

Serviço: winthor-pedido-venda - Versão 1.38.6.11 ou superior

Realize a autenticação na API (WTA) para obter o token de acesso.
Monte o payload de inclusão de pedido para o endpoint da API B2C.
Adicione o objeto JSON listconsumerData ao corpo da requisição. Este grupo é opcional e aceita os seguintes campos :
- CLIENTE (String)
- CGCENT (String - CPF/CNPJ)
- ENDERENT (String - Endereço)
- BAIRROENT (String - Bairro)
- TELENT (String - Telefone)
- MUNICENT (String - Município)
- ESTENT (String - Estado)
- CEPENT (Number - CEP)
- IEENT (String - Inscrição Estadual)
- OBS (String - Observação)
- NOMECONTATO (String)
- TELEFONECONTATO (String)
- OBSCONTATO (String)
- CODCIDADE (Number - Código da Cidade)
- EMAIL (String)
- NUMEROENT (Number - Número do endereço)
- RG (String)
- DTNASC (Date)
- IDENTIFICACAO_ESTRANGEIRO (String)
- CONSUMIDORFINAL (String)
- CONTRIBUINTE (String)
Envie a requisição.
Após o sucesso (Status 200), o sistema persistirá os dados enviados na tabela PCVENDACONSUM com o número do pedido gerado.

04. DEMAIS INFORMAÇÕES

Caso algum campo seja enviado com tipo incompatível (ex: String em campo Numérico), a API retornará erro.
Campos não enviados no payload permanecerão nulos na base de dados.
Não existem validações de integridade relacional entre os campos deste grupo, apenas validação de tipo de dado.

Importante!

As versões estarão disponíveis para download no CCW.

https://centraldecontrole.pcinformatica.com.br/

Mantenha suas rotinas sempre atualizadas!

05. ASSUNTOS RELACIONADOS

DDVENDAS-57182 DT - Gravar pedido Balcão Reserva como Montado na API B2C