Histórico da Página
Introdução
| draw.io Diagram | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Sistemas Envolvidos
TPR:
- TOTVS Planejamento de Rotas
Sistema Externo:
- Todos os ERPs que se conectam ou pretendem se conectar com os produtos de planejamento logístico TOTVS.
Integração
- Formato de entrada/saída: JSON
Escopo
- "hand shake" entre o TPR eo sistema externo, resulta na criação de token de acesso para o cliente, que após validade via e-mail liberará o acesso ao sistema via trial de acordo com o fluxo:
| draw.io Diagram | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Pré-requisitos instalação/implantação/utilização
- Para clientes Protheus versão xxxxxx;
- Para clientes Datasul versão xxxxxx;
- Para todos os clientes, contratação do trial via TOTVS Store;
Layout de Requisição
TPRTokenIntegration: Integração rest, sincrona Path: .../v1/tpr-token-creation, Método: POST | ||||||
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| dateCall | Date Time | Sim | Data da criação da chamada no sistema externo | Formato ISO | 2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD | |
| system | String | Não | 4096 | Identificador do sistema que fez a chamada | Texto Livre | Protheus |
| version | String | Não | 4096 | Versão do sistema externo | Texto Livre | 12.36.1 |
| qualifiers | Object | Não | 4096 | String chave valor | Formato Json | {"Usuário": "Pedro de Alcântara", "Perfil": "Analista"} |
| identifierType | String | Sim | Tipos de identificadores possíveis | CNPJ \ CPF | "CNPJ" | |
| identifier | String | Sim | 4096 | Identificador único do cliente, CNPJ ou CPF | CNPJ válido; CPF válido; Precisa ser único na base; | "53.113.791/0001-22" |
| name | String | Sim | 4096 | Nome de identificação do cliente | Texto Livre | "Neolog Consultoria e Sistemas S&A" |
| shortName | String | Não | 4096 | Como o cliente gostaria de ser chamado | Texto Livre | "Neolog" |
| String | Sim | 4096 | E-mail para validação do token e futuras interações com o cliente | E-mail válido [email protected] | "neolog@neolog.com.br" | |
Layout de Resposta
| TPRTokenResponse: Integração rest, sincrona; | ||||||
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| dateResponse | Date Time | Sim | Data do envio da resposta no TPR | Formato ISO | 2021-01-21T10:01:00.0-03:00 YYYY-MM-DDThh:mm:ss.sTZD | |
| version | String | Sim | 4096 | Versão do TPR que executou a resposta | - | 0.0.0.1 |
| success | Boolean | Sim | True se sucesso, False se falha | - | True | |
| key | String | Não | 4096 | Chave bloqueada | - | |
| message | TPRMessage[] | Sim | Campo que deve ser exibido pelo sistema externo para o usuário | - | Tabela abaixo | |
| Âncora | ||||
|---|---|---|---|---|
|
| TPRMessage: Tipo de dado utilizado nas integrações do TPR | ||||||
| Campo | Tipo | Obrigatório | Tamanho | Descrição | Validações | Exemplos |
| messageCode | String | Sim | 4096 | Código de identificação da mensagem | Código existente e valido | TPR0001 |
| message | String | Sim | 4096 | Mensagem escrita | Texto Livre | "Para finalizar o cadastro acesse seu e-mail e valide o Token" |
| Âncora | ||||
|---|---|---|---|---|
|
Catalogo de Mensagens
| Código | Mensagem | Descrição |
| TPRTK0000 | Sucesso | Retorno indicando sucesso da operação |
| TPRTK0001 | Erro ao conectar com o firestore | Retorno de erro de conexão com o banco de dados |
| TPRTK0004 | Data da criação de chamada no sistema externo é obrigatório | Retorno inválido para a validação do campo dateCall, já que se encontra nulo ou vazio |
| TPRTK0005 | Tipo de identificador é obrigatório | Retorno inválido para a validação do campo identifierType, já que se encontra nulo ou vazio |
| TPRTK0006 | Identificador é obrigatório | Retorno inválido para a validação do campo identifier, já que se encontra nulo ou vazio |
| TPRTK0007 | CNPJ está inválido | Retorno inválido para a validação do campo identifier, já que está diferente do formato esperado dos CNPJs |
| TPRTK0008 | CNPJ já está em uso para outro token | Retorno inválido para a validação do campo identifier, já que está sendo usado em outro registro |
| TPRTK0009 | CPF está inválido | Retorno inválido para a validação do campo identifier, já que está diferente do formato esperado dos CPFs |
| TPRTK0010 | CPF já está em uso para outro token | Retorno inválido para a validação do campo identifier, já que está sendo usado em outro registro |
| TPRTK0011 | Nome é obrigatório | Retorno inválido para a validação do campo name, já que se encontra nulo ou vazio |
| TPRTK0012 | E-mail é obrigatório | Retorno inválido para a validação do campo email, já que se encontra nulo ou vazio |
| TPRTK0013 | E-mail está inválido | Retorno inválido para a validação do campo email, já que está diferente do formato esperado de um e-mail ([email protected]) |
| TPRTK0014 | Qualifiers não estão em um formato JSON válido | Retorno inválido para a validação do campo qualifiers, já que está diferente do formato esperado de um objeto JSON em texto |
| TPRTK0017 | Formato inválido | Retorno indicando que a mensagem está diferente do contrato indicado acima, logo se encontra num formato inválido |
Anexos
| Anexos |
|---|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas