TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • DDVENDAS-57183 DT - Gravar dados do consumidor (incluindo CPF) na PCVENDACONSUM pela API B2C.


01. DADOS GERAIS

Produto:

TOTVS Distribuição e Varejo

Linha de Produto:

Linha Winthor

Segmento:

Distribuição

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