...
Este documento tem como objetivo explicar o funcionamento da integração da Consulta de Vendedor/ RCA (Representante Comercial Autônomo).
Pré-Requisitos e Restrições
...
| Totvs custom tabs box |
|---|
| tabs | Dados integrados com Winthor, Envio Parâmetros/Resposta da Requisição, Listar Dados Cliente |
|---|
| ids | passo1,passo2,passo3 |
|---|
|
A integração consiste em realizar a consulta de informações. | Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Os dados integrados são: | Campo | Tabela.campo | Descrição Campos | Descrição Tabelas | Referência das imagens abaixo (517) | codfilial | pcusuari.codfilial |
Filial cadastrada no winthor| Código da filial do WinThor | VARCHAR2(2) | 4 | codusur | pcusuari.codusur | Código |
usuário | vendedor da tabela PCUSUARI | NUMBER(4,0) | 1 | nome | pcusuari.nome | Nome do |
usuário| vendedor | VARCHAR2(40) | 2 | tipovend | pcusuari.tipovend | Tipo venda |
da CODUSUARI| : I - Interno | E - Externo | R - Representante | P - Profissional | VARCHAR2(2) | 10 | tipopessoa | pcusuari.tipopessoa | Tipo pessoa | VARCHAR2(1) | 7 | cpfcnpj | pcusuari.cpfcnpj | CPFCNPJ a critério do tipo Pessoa | VARCHAR2(20) | 6 | areaatuacao | pcareaatuacao.areaatuacao |
área | Área de atuação definida no cadastro da 517 | VARCHAR2(40) | 5 | codsupervisor | pcusuari.codsupervisor | Código do supervisor do |
usuário| vendedor (vinculo na PCSUPERV) | NUMBER(4,0) | 3 | nomesupervisor | pcsuperv.nomesupervisor | Nome do supervisor | VARCHAR2(40) | 3 | status | pcusuari.status | status do |
usuário| vendedor | VARCHAR2(10) | 8 | dtcadastrosuperv | pcsuperv.dtcadastrosuperv | Data de cadastro do supervisor | DATE |
| dtcadastrorca | pcusuari.dtcadastrorca | Data de cadastro do vendedor RCA | DATE |
| dataalteracao | pcusuari.dataalteracao | data de ultima alteração do vendedor | DATE |
|
|
| Exportar RCA |
DATE| para o Auto Serviço | VARCHAR2(1) | 9 |
 Image Added
 Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Exemplo JSON do envio da requisição e dados do retorno: | Bloco de código |
|---|
| language | js |
|---|
| title | URI - Cadastrar Cliente |
|---|
| method: 'GET',
url: '/winthor/varejo/matcon/v1/rca/consulta?branchId=?' |
| Bloco de código |
|---|
| Requisição por Params, conforme exemplo abaixo:
/winthor/varejo/matcon/v1/rca/consulta?branchId=1&codRca=1&page=2&pagesize=2
Params:
- branchId (Obrigatório) - String (Filial a ser buscado o vendedor RCA)
- codRca - String ( Código do usuário para busca de um único vendedor RCA)
- page - int (Numero da pagina conforme resultados)
- pagesize - int (Numero de itens por pagina)
- lastChange - String (Data de ultima alteração do RCA) |
Exemplo JSON da resposta: | Bloco de código |
|---|
| language | js |
|---|
| title | Body Response |
|---|
| {
"first": false,
"items": [
{
"codFilial": "1",
"codigousur": 100,
"nome": "TESTE CADASTRORCA",
"tipoVenda": "I",
"tipoPessoa": "F",
"cpfCnpj": "8626372507999999999999",
"areaAtuacao": "NAO_DEFINIDO",
"codigoSupervisor": 1,
"nomeSupervisor": "SUPERVISOR",
"status": "NORMAL",
"dtCadastroSupervisor": "1900-01-01T00:00:00",
"dtCadastroRca": "1900-01-01T00:00:00",
"dtAlteracao": "2024-06-10T10:44:26"
}
],
"hasNext": false
} |
{
"success": false,
"message": "(WT-IM-000048) -> RCA Não Localizado { [] }"
} |
|
...
