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:
- O Ensemble realiza a requisição para obter os ajustes
- Os ajustes são enviados para o serviço do GERA
- 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 |