Páginas filhas
  • APIs Integrações - RCA

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Aviso
titleImportante

Quando não houver preenchimento do campo codRca, nossas APIs retornará todos os vendedores para a filial solicitada.

Aviso
titleImportante

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
tabsDados integrados com Winthor, Envio Parâmetros/Resposta da Requisição, Listar Dados Cliente
idspasso1,passo2,passo3

A integração consiste em realizar a consulta de informações.

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

CampoTabela.campoDescrição CamposDescrição Tabelas

codfilial

pcusuari.codfilial

Filial cadastrada no winthorVARCHAR2(2)

codusur

pcusuari.codusurCódigo usuário da tabela PCUSUARINUMBER(4,0)

nome

pcusuari.nomeNome do usuárioVARCHAR2(40)

tipovend

pcusuari.tipovendTipo venda da CODUSUARIVARCHAR2(2)

tipopessoa

pcusuari.tipopessoaTipo pessoaVARCHAR2(1)

cpfcnpj


pcusuari.cpfcnpjCPFCNPJ a critério do tipo PessoaVARCHAR2(20)

areaatuacao


pcareaatuacao.areaatuacao

área de atuação definida no cadastroVARCHAR2(40)

codsupervisor


pcusuari.codsupervisorCódigo do supervisor do usuárioNUMBER(4,0)

nomesupervisor


pcsuperv.nomesupervisor

Nome do supervisorVARCHAR2(40)

status


pcusuari.status


status do usuárioVARCHAR2(10)

dtcadastrosuperv


pcsuperv.dtcadastrosuperv

Data de cadastro do supervisorDATE

dtcadastrorca


pcusuari.dtcadastrorca

Data de cadastro do vendedor RCADATE

dataalteracao


pcusuari.dataalteracao

data de ultima alteração do RCADATE
Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo JSON do envio da requisição e dados do retorno:

Bloco de código
languagejs
titleURI - Cadastrar Cliente
method: 'GET',
url: '/winthor/varejo/matcon/v1/rca/consulta?branchId=?'
Bloco de código
languagejs
titleBody
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
languagejs
titleBody Response
{
    "success": true,
    "hasNext"first": false,
    "message": "",
    "data": {
        "content": [
 items": [
           {
                "codFilial": "1",
                "codigousur": 1100,
                "nome": "FISCALTESTE CADASTRO",
                "tipoVenda": "I",
                "tipoPessoa": "F",
                "cpfCnpj": "1148727280486263725079",
                "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"
            }
        ],
        "lasthasNext": true,
        "totalElements": 1,
        "totalPages": 1,
        "size": 10,
        "number": 0,
        "first": true,
        "numberOfElements": 1
    }
} false
}


{
    "success": false,
    "message": "(WT-IM-000048) -> RCA Não Localizado  { [] }"
}



...