Presence API ECOMMERCE - ECM-ESTOQUE-SKU

Presence API ECOMMERCE - ECM-ESTOQUE-SKU

Saldo de Estoque

Este método é responsável por listar o estoque do produto/sku da base da dados.

Parâmetros


Nome
Obrigatório
Tipo
Descrição
id_webservice
SIM
Integer
Id do webservice
data_at
SIM 
Data (AAAA-MM-DDT00:00:00)
Data de atualização dos dados. Padrão ISO8601.
referencia_site
NAO, quando informada data_at
Texto(12)
Código da referência do produto no site
sku_site
NAO, quando informada data_at
Texto(12)
Código do SKU do produto no site
omni
NÃO
 Integer
Define o tipo de saldo a ser retornado:
 0 → Saldo de todas as Lojas
1 ou não informado → Saldo de Lojas do tipo Depósito e E-commerce (comportamento atual)
2 → Saldo de Lojas do tipo Loja (substitui ECM-ESTOQUE-SKU-OMNI)

Response

Campo
Tipo
Descrição
sku
String
Código SKU do produto.
codigoExterno
String
Código externo do SKU (quando integrado).
warehouse
String
Nome da loja/depósito/e-commerce que compõe o estoque.
warehouseCodigoExterno
String
Código externo da loja/depósito/e-commerce.
quantidade
Integer
Quantidade disponível em estoque (saldo disponível).
saldoFisico
Integer
Quantidade física em estoque (sem considerar reservas).
dataAt
Date, AAAA-MM-DD
Data da última atualização do estoque (ISO8601).
idProcesso
Integer
Identificador do processo de integração associado ao retorno.
pk
String
Chave primária única do registro retornado.


BODY

  1. {
  2.   "id_webservice" : (Integer),
  3.   "data_at" : (Date, AAAA-MM-DD) ou (Date, AAAA-MM-DDT00:00:00)
  4. }
Alert
Quando a consulta é  realizada por DATA_AT, são retornados produtos com alterações de estoque (LOJB017E) ou de produtos (LOJB006), apresentando no retorno a maior entre elas, na tag dataAt.

OU

  1. {
  2.   "id_webservice" : (Integer),
  3.   "sku_site" : (Texto)
  4. }

OU
  1. {
  2.   "id_webservice" : (Integer),
  3.   "sku_site" : (Texto),
  4.   "onmi" :  (Integer)
  5. }

JSON de Retorno
  1. {
  2.     "status": (String),
  3.     "method": (String),
  4.     "nextOffset": (Integer),
  5.     "data": [
  6.         {
  7.             "sku": (String), 
  8.             "codigoExterno": (String), 
  9.             "warehouse": (String), 
  10.             "warehouseCodigoExterno": (String), 
  11.             "quantidade": (Integer),
  12.             "saldoFisico":(Integer), 
  13.             "dataAt": (Date),
  14.             "idProcesso": (Integer),
  15.             "pk": (String)
  16.         }
  17.     ]
  18. }

Reporte de sucessos ou erros


Após consulta da informação e envio para a plataforma, é necessário:
  1. Informar o sucesso da operação ao ERP;
  2. Informar erro, para dar transparência ao cliente da integração, bem como alimentar o controle de erros.

Para reportar esse status, deverá ser utilizado o método ECM-RESULTADO-PROCESSAMENTO.

Alert
O envio dessa sinalização é obrigatório para vinculação dos códigos Presence com códigos Plataforma, bem como para funcionamento do painel de acompanhamento de erros de integração no ERP.