Versões comparadas

Chave

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

...

Informações
titleFerramentas

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:

Expandir
titleRotina 2660 - Atualização de Dados

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
titleATENÇÃO
  • 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'";

O objetivo da API é armazenar essa informação enviada no request na tabela PCINTEGRACAOEVENTORECEBIDO.

Totvs custom tabs box
tabsInicio, Temas, Tabelas, Colunas, Detalhes, Revisão
idsitem1-2660,item2-2660,item3-2660,item4-2660,item5-2660,item6-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:

Totvs custom tabs box items
defaultyes
referenciaitem1-2660
Bloco de código
languagejs
{
	"origem": "ORIGEM",
	"codigoOrigem": "CODIGOORIGEM",
	"token": "bf602066-d434-47c6-9930-37fcd6891300",
	"codigoProcesso": 1,
	"descricaoProcesso": "DESCRICAO",
    "observacao":"OBSERVACAO"
}
CampoTipoDescriçãoObrigatório
origemString (50)Origem do evento.Sim
codigoOrigemString (100)Código de identificação da origem do eventoSim
tokenStringToken de identificação da requisição;Não
codigoProcessoLong (10)Código do processo referente ao evento.Sim
descricaoProcessoString (200)Descrição do processo referente ao evento.Não
observacaoStringObservação sobre o evento.Não

Nesta etapa será apresentada uma descrição da funcionalidade. É importante ler atentamente e entender o que será feito em seguida.

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
defaultno
referenciaitem2-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

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:

totvs-custom-totvs-custom-tabs-box-items
defaultno
referenciaitem2item3-2660
Bloco de código
languagejs
{
    "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
languagejs
{
    "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
defaultno
referenciaitem3-2660
Bloco de código
languagejs
{
    "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
languagejs
{
    "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
defaultno
referenciaitem4-2660

Nesta etapa, após a escolha do tema, serão listadas as tabelas impactadas pelas integrações referentes ao tema. Nesse momento deverão ser escolhidas as tabelas cujas colunas de datas serão listadas no passo seguinte.

Image Added

Totvs custom tabs box items
defaultno
referenciaitem4-2660

Nesta etapa, após a escolha das tabelas, são listadas em tela todas as colunas do tipo "DATE" presentes nas tabelas escolhidas. Nessa tela selecione quais colunas é desejável que sejam preenchidos os registros nulos com uma data específica ou automática que será definida no passo seguinte.

Image Added

Totvs custom tabs box items
defaultno
referenciaitem5-2660

Após a escolha das colunas de data que deseja alterar, será apresentada nessa etapa um detalhamento da quantidade de registros nulos presentes em cada uma das colunas selecionadas.

Image Added

Caso não existam registros nulos, ao clicar no botão "Próximo passo", a seguinte mensagem será apresentada:

Image Added

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:

Totvs custom tabs box items
defaultno
referenciaitem6-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
languagejs
{
    "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
languagejs
{
    "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
defaultno
referenciaitem5-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
languagejs
{
    "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
languagejs
{
    "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
defaultno
referenciaitem6-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
languagejs
{
    "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
languagejs
{ "code": "WT-CONFIG-000032", "message": "Erro ao receber evento", "detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X", "details": [] }

Informações
titleAPI's
Expandir
titleIntegração de eventos

O objetivo é disponibilizar uma api de integração de eventos ao WSH;

Aviso
titleATENÇÃO
  • Para utilizar a api, deverá ser instalado o serviço winthor-integracao-config na versão 1.35.1.16 ou superior.
  • Antes de utilizar a API de integração de eventos é necessário realizar o Login no WTA.
Totvs custom tabs box
tabsRequest, Response
idsitem1-apiEvento,item2-apiEvento
Totvs custom tabs box items
defaultyes
referenciaitem1-apiEvento

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
languagejs
{
	"origem": "ORIGEM",
	"codigoOrigem": "CODIGOORIGEM",
	"token": "bf602066-d434-47c6-9930-37fcd6891300",
	"codigoProcesso": 1,
	"descricaoProcesso": "DESCRICAO",
    "observacao":"OBSERVACAO"
}
CampoTipoDescriçãoObrigatório
origemString (50)Origem do evento.Sim
codigoOrigemString (100)Código de identificação da origem do eventoSim
tokenStringToken de identificação da requisição;Não
codigoProcessoLong (10)Código do processo referente ao evento.Sim
descricaoProcessoString (200)Descrição do processo referente ao evento.Não
observacaoStringObservação sobre o evento.Não


O objetivo da API é armazenar essa informação enviada no request na tabela PCINTEGRACAOEVENTORECEBIDO.


Totvs custom tabs box items
defaultno
referenciaitem2-apiEvento

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
languagejs
{
    "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
}


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
languagejs
{
    "code": "WT-CONFIG-000032",
    "message": "Erro ao receber evento",
    "detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
    "details": []
}

...