...
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
...
Aviso |
---|
|
Quando não houver preenchimento do campo codRca, nossas APIs retornará todos os vendedores para a filial solicitada. |
Aviso |
---|
|
Quando não houver preenchimento do campo DATA, exemplo (data de cadastro, data de alteração), nossas APIs retornarão, por padrão, a informação "1900-01-01T00:00:00". Caso necessário, realizar o ajuste nos cadastros para que a API apresente a data desejada. |
Integração
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 winthorCó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áriovendedor | 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áriovendedor (vinculo na PCSUPERV) | NUMBER(4,0) | 3 | nomesupervisor | pcsuperv.nomesupervisor | Nome do supervisor | VARCHAR2(40) | 3 | status | pcusuari.status | status do | usuáriovendedor | 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 | DATEpara 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 |
---|
| {
"success": true,
"hasNextfirst": false,
"message": "",
"data": {
"contentitems": [
{
"codFilial": "1",
"codigousur": 1100,
"nome": "FISCALTESTE RCA",
"tipoVenda": "I",
"tipoPessoa": "F",
"cpfCnpj": "1148727280499999999999",
"areaAtuacao": "ATACADONAO_DEFINIDO",
"codigoSupervisor": 1,
"nomeSupervisor": "SUPERVISOR",
"status": "NORMAL",
"dtCadastroSupervisor": "1900-01-0101T00:00:00",
"dtCadastroRca": "20041900-06-0801-01T00:00:00",
"dtAlteracao": "20162024-08-2306-10T10:44:26"
}
],
"last": true,
"totalElements": 1,
"totalPages": 1,
"size": 10,
"number": 0,
"first": true,
"numberOfElements": 1
}
} hasNext": false
} |
{ "success": false, "message": "(WT-IM-000048) -> RCA Não Localizado { [] }" } |
|
...