A rotina 2660 permite atualizar datas de registros que estejam nulas (data de atualização, data de cadastro, etc). O intuito é preencher as datas dos registros que estejam nulas com uma data fixa (01/01/1900) ou com uma data especificada, afim de otimizar a carga de dados feita via WSH. | Aviso |
|---|
| - Para utilizar a rotina 2660, é necessário instalar o serviço winthor-integracao-2660 na rotina 801 do WTA.
- Para conseguir acessar a rotina 2660, é necessário habilitar na rotina 530 do WinThor a opção "1 - Permite controlar opção 'Atualização de dados para Integração'";
|
| Totvs custom tabs box |
|---|
| tabs | 1 - Inicio, 2 - Temas, 3 - Tabelas, 4 - Colunas, 5 - Detalhes, 6 - Revisão |
|---|
| ids | item1-2660,item2-2660,item3-2660,item4-2660,item5-2660,item6-2660 |
|---|
| | Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | item1-2660 |
|---|
| O envio da requisição de eventos deverá ser realizado no seguinte endpoint: - winthor/integracao/fulfillment/v1/evento método POST;
O JSON deverá respeitar a seguinte estrutura: | Bloco de código |
|---|
| {
"origem": "ORIGEM",
"codigoOrigem": "CODIGOORIGEM",
"token": "bf602066-d434-47c6-9930-37fcd6891300",
"codigoProcesso": 1,
"descricaoProcesso": "DESCRICAO",
"observacao":"OBSERVACAO"
} |
| Campo | Tipo | Descrição | Obrigatório |
|---|
| origem | String (50) | Origem do evento. | Sim | | codigoOrigem | String (100) | Código de identificação da origem do evento | Sim | | token | String | Token de identificação da requisição; | Não | | codigoProcesso | Long (10) | Código do processo referente ao evento. | Sim | | descricaoProcesso | String (200) | Descrição do processo referente ao evento. | Não | | observacao | String | Observação sobre o evento. | Não | O objetivo da API é armazenar essa informação enviada no request na tabela PCINTEGRACAOEVENTORECEBIDO. - Nesta etapa será apresentada uma descrição da funcionalidade. É importante ler atentamente e entender o funcionamento da ferramenta.
 Image Added
- Feita a leitura, basta clicar no botão "Iniciar", e em seguida "Confirmar" conforme imagem abaixo:
 Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item2-2660 |
|---|
| - Nesta etapa serão apresentados em tela os temas principais presentes nas integrações realizadas pelo WSH. A escolha do tema definirá quais as tabelas que deverão ser listadas no passo seguinte.
 Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item2item3-2660 |
|---|
| Casa respeitados os campos de envio da requisição, o response deverá apresentar a seguinte estrutura: - HttpStatusCode 201 CREATED;
- Um objeto contendo o evento inserido;
Ex: | Bloco de código |
|---|
| {
"origem": "ORIGEM",
"codigoOrigem": "CODIGOORIGEM",
"token": "bf602066-d434-47c6-9930-37fcd6891300",
"descricaoProcesso": "DESCRICAO",
"observacao": "OBSERVACAO",
"codigoProcesso": 1,
"dataCriacao": "2024-04-24T15:31:10.482",
"dataAlteracao": "2024-04-24T15:31:10.482",
"processado": false
} |
 Image Removed
Do contrário, caso algum campo obrigatório não tenha sido informado, o response irá informar HttpStatusCode 400 BAD REQUEST e o seguinte erro: | Bloco de código |
|---|
| {
"code": "WT-CONFIG-000032",
"message": "Erro ao receber evento",
"detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
"details": []
} |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item3-2660 |
|---|
| Casa respeitados os campos de envio da requisição, o response deverá apresentar a seguinte estrutura: - HttpStatusCode 201 CREATED;
- Um objeto contendo o evento inserido;
Ex: | Bloco de código |
|---|
| {
"origem": "ORIGEM",
"codigoOrigem": "CODIGOORIGEM",
"token": "bf602066-d434-47c6-9930-37fcd6891300",
"descricaoProcesso": "DESCRICAO",
"observacao": "OBSERVACAO",
"codigoProcesso": 1,
"dataCriacao": "2024-04-24T15:31:10.482",
"dataAlteracao": "2024-04-24T15:31:10.482",
"processado": false
} |
Image Removed Do contrário, caso algum campo obrigatório não tenha sido informado, o response irá informar HttpStatusCode 400 BAD REQUEST e o seguinte erro: | Bloco de código |
|---|
| {
"code": "WT-CONFIG-000032",
"message": "Erro ao receber evento",
"detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
"details": []
} |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item4-2660 |
|---|
| Casa respeitados os campos de envio da requisição, o response deverá apresentar a seguinte estrutura: - HttpStatusCode 201 CREATED;
- Um objeto contendo o evento inserido;
Ex: | Bloco de código |
|---|
| {
"origem": "ORIGEM",
"codigoOrigem": "CODIGOORIGEM",
"token": "bf602066-d434-47c6-9930-37fcd6891300",
"descricaoProcesso": "DESCRICAO",
"observacao": "OBSERVACAO",
"codigoProcesso": 1,
"dataCriacao": "2024-04-24T15:31:10.482",
"dataAlteracao": "2024-04-24T15:31:10.482",
"processado": false
} |
Image Removed Do contrário, caso algum campo obrigatório não tenha sido informado, o response irá informar HttpStatusCode 400 BAD REQUEST e o seguinte erro: - Após a escolha do tema, serão listadas as tabelas impactadas pelas integrações referentes ao tema. Escolha as tabelas que deseja para na sequencia definir quais colunas de data serão atualizadas.
 Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item4-2660 |
|---|
| - Nesta etapa, após a escolha das tabelas, são listadas em tela as colunas de data que a integração utiliza. Selecione quais colunas deseja atualizar os registros nulos.
 Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item5-2660 |
|---|
| - Após a escolha das colunas de data que deseja alterar, será apresentado um detalhamento da quantidade de registros nulos presentes em cada uma das colunas selecionadas, basta seguir para o próximo passo e definir a data que deseja inserir para esses registros.
 Image Added
- Caso não existam registros nulos, ao clicar no botão "Próximo passo", a seguinte mensagem será apresentada:
 Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item6-2660 |
|---|
| - Nesta última etapa, deverá ser definida a data que será inserida nos registros nulos:
 Image Added
- Opção "Inserir data/hora de forma automática"
- Define automaticamente a data 01/01/1900 00:00:00 aos registros nulos.
- Opção "Manual"
- Permitirá definir uma data específica nos campos de data e hora presentes em tela.
- Ao clicar em "Finalizar", será apresentada uma tela de confirmação da operação:
 Image Added
- Após a confirmação, o update será realizado em todos os registros nulos com a data definida. Ao finalizar, será apresentado em tela um resumo da quantidade de registros alterados, e nesse resumo será possível visualizar um log do que foi realizado em cada uma das colunas.
 Image Added
 Image Added
| | Bloco de código |
|---|
| {
"code": "WT-CONFIG-000032",
"message": "Erro ao receber evento",
"detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
"details": []
} |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item5-2660 |
|---|
| Casa respeitados os campos de envio da requisição, o response deverá apresentar a seguinte estrutura: - HttpStatusCode 201 CREATED;
- Um objeto contendo o evento inserido;
Ex: | Bloco de código |
|---|
| {
"origem": "ORIGEM",
"codigoOrigem": "CODIGOORIGEM",
"token": "bf602066-d434-47c6-9930-37fcd6891300",
"descricaoProcesso": "DESCRICAO",
"observacao": "OBSERVACAO",
"codigoProcesso": 1,
"dataCriacao": "2024-04-24T15:31:10.482",
"dataAlteracao": "2024-04-24T15:31:10.482",
"processado": false
} |
Image Removed Do contrário, caso algum campo obrigatório não tenha sido informado, o response irá informar HttpStatusCode 400 BAD REQUEST e o seguinte erro: | Bloco de código |
|---|
| {
"code": "WT-CONFIG-000032",
"message": "Erro ao receber evento",
"detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
"details": []
} |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | item6-2660 |
|---|
| Casa respeitados os campos de envio da requisição, o response deverá apresentar a seguinte estrutura: - HttpStatusCode 201 CREATED;
- Um objeto contendo o evento inserido;
Ex: | Bloco de código |
|---|
| {
"origem": "ORIGEM",
"codigoOrigem": "CODIGOORIGEM",
"token": "bf602066-d434-47c6-9930-37fcd6891300",
"descricaoProcesso": "DESCRICAO",
"observacao": "OBSERVACAO",
"codigoProcesso": 1,
"dataCriacao": "2024-04-24T15:31:10.482",
"dataAlteracao": "2024-04-24T15:31:10.482",
"processado": false
} |
Image Removed Do contrário, caso algum campo obrigatório não tenha sido informado, o response irá informar HttpStatusCode 400 BAD REQUEST e o seguinte erro: | Bloco de código |
|---|
| | {
"code": "WT-CONFIG-000032",
"message": "Erro ao receber evento",
"detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
"details": []
}
|
|
