Introdução

Ocorre no UX um registro de posição de estoque seja manual via tela “Integração da Posição de Estoque - GERA”¹, ou via inventário (Criação de Inventario, Coleta, Buscar Saldo, Realizar Ajuste)² onde ambos alimentando a tabela “LX_STK.STK_ROMANEIO_AJUSTE_INTEGRACAO”.

De tempos em tempos o schedule configurado no ensemble busca os dados no UX para a integração com o sistema GERA, após este envio o UX é atualizado conforme a resposta do GERA.

Tabela envolvida:

  • LX_STK.STK_ROMANEIO_AJUSTE_INTEGRACAO
  • LX_STK.STK_ROMANEIO_AJUSTE_INTEGRACAO_ITEM

O Processo ocorre em 3 etapas:

  1. O Ensemble realiza a requisição para obter os ajustes
  2. Os ajustes são enviados para o serviço do GERA
  3. Após o envio o UX é atualizado com a informação se o GERA recebeu ou não a informação

 

Requisição 1: Obter ajust(s) de estoque
                /api/Estoque/ProcessarPosicao


Parâmetros

Nome

Tipo

Descrição

Requerido

sessionId

Integer

Id da sessão do Ensemble responsável pelo envio das informações

sim

codLoja

Integer

Codigo da loja, caso deseje filtrar as movimentações por loja

Não

 

 REQUEST

curl --location --request GET {local_api}/api/Estoque/ProcessarPosicao?sessionId=1&codLoja=XPTO' \

--header 'Content-Type: application/json' \

--header 'CurrentCompany: f27ffc4f-eb6e-4484-91ed-a318a4a394b0' \

--header 'AuthorizationToken: 703afc79-a58e-4c87-88a7-25b562e9cfe5' \

--header 'CurrentUser: 1445d056-d841-4d09-a9bf-ad50aa76ca6e' \

--header 'AccessGroup: 00000000-0000-0000-0000-000000000000' \

--header 'EconomicGroup: 057563a9-303c-40ab-a725-4a824cc71983' \

--header 'Environment: 190' \

--header 'Application: 2d606cc0-ea7e-470e-b535-23f3c7a29a18'

 

 RESPONSES


200 – Success

Nome

Tipo

Descrição

Mensagem

String

Caso a execução não seja ok (success = false), retorna a descrição do erro ocorrido seja por falha de negócio ou de sistema

Resultado

List<List<RetornoIntegracaoAjusteGera>>

 

 

 RetornoIntegracaoAjusteGera

Nome

Tipo

Descrição

IdRomaneioAjusteIntegracao

long

Id do ajuste

CodLoja

string

Codigo da loja do ajuste

CnpjFilial

string

Cnpj da filial

SessionId

long?

Id da sessão do ensemble

StatusIntegracao

short

Status do ajuste

DescStatusIntegracao

string

Descrição do status do ajuste

DataHoraInclusao

DateTime?

Data inclusão do ajuste

DataHoraProcessado

DateTime?

Data processamento do ajuste

Itens

List<RetornoIntegracaoAjusteGeraItens>

Itens do ajuste

RetornoIntegracaoAjusteGeraItens

Nome

Tipo

Descrição

IdRomaneioAjusteIntegracaoItem

long

Id do item do ajuste

IdSku

int

Id do Sku no UX

CodSku

string

Codigo do Sku

PosicaoEstoque

decimal

Quantidade da posição em estoque

StatusDoItem

short

Status do item do ajuste

DescStatusDoItem

string

Descrição do status do item do ajuste

DataHoraProcessamento

DateTime?

Data processamento do item do ajuste

 

 401 – UNAUTHORIZED

CONTEÚDO: VAZIO

CABEÇALHOS:

  • authorizationerror: Headers de autenticação inválidos.

400 – BAD REQUEST

Nome

Tipo

Descrição

Mensagem

String

Caso a execução não seja ok (success = false), retorna a descrição do erro ocorrido seja por falha de negócio ou de sistema

Resultado

Object[]

 Nulo


Requisição 2: Envia WS GERA
Não documentada 

Requisição 3: Atualizar processamento do(s) ajuste(s) de estoque
/api/Estoque/AtualizarPosicaoEstoque

 

Parâmetros

Nome

Tipo

Descrição

Requerido

ItensParaIntegrar

Integer[]

Id dos itens de ajustes enviados ao sistema GERA

sim

FoiIntegrado

boolean

Indica se o sistema GERA recebeu a informação

sim

MsgErro

String

Indica mensagem de erro caso o sistema GERA não consiga receber a informação

não

 

REQUEST
curl --location --request POST {local_api}/api/Estoque/AtualizarPosicaoEstoque' \

--header 'Content-Type: application/json' \

--header 'CurrentCompany: f27ffc4f-eb6e-4484-91ed-a318a4a394b0' \

--header 'AuthorizationToken: 703afc79-a58e-4c87-88a7-25b562e9cfe5' \

--header 'CurrentUser: 1445d056-d841-4d09-a9bf-ad50aa76ca6e' \

--header 'AccessGroup: 00000000-0000-0000-0000-000000000000' \

--header 'EconomicGroup: 057563a9-303c-40ab-a725-4a824cc71983' \

--header 'Environment: 190' \

--header 'Application: 2d606cc0-ea7e-470e-b535-23f3c7a29a18' \

--header 'Content-Type: application/json' \

--data-raw '{

  "ItensParaIntegrar": [

    0

  ],

  "FoiIntegrado": true,

  "MsgErro": "string"

}'

RESPONSES

200 – Success

Nome

Tipo

Descrição

success

Boolean

Indica se houve falha não tratada durante a execução

message

String

 

Caso a execução não seja ok (success = false), retorna a descrição do erro ocorrido seja por falha de negócio ou de sistema

 401 – UNAUTHORIZED

CONTEÚDO: VAZIO

CABEÇALHOS:

  • authorizationerror: Headers de autenticação inválidos.

400 – BAD REQUEST

Nome

Tipo

Descrição

Valor

success

Boolean

Indica se houve falha não tratada durante a execução

false

message

String

Descrição do erro ocorrido seja por falha de negócio ou de sistema

 

data

 

 

nulo

  • Sem rótulos