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.
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. }

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.




    • Related Articles

    • Presence API ECOMMERCE - ECM-ESTOQUE-SKU-OMNI

      Atenção: Este método será descontinuado em 30/09/2025. Utilize o método ECM-ESTOQUE-SKU com a nova tag omni. 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 ...

    • Presence API - Página Inicial

      Essa API permite o consumo de informações disponíveis nos sistemas Presence através de chamadas de serviço, bem como a inserção de dados nos sistemas. Para ter acesso aos métodos já existentes, ou solicitação da criação de novos métodos, consulte as ...

    • Presence API ECOMMERCE - ECM-PRECOS-SKU

      Cadastro de Preços por Sku Este método é responsável por listar os preços do produtos/sku da base da dados. Parâmetros Nome Obrigatório Tipo Descrição id_webservice SIM Integer Id do webservice referencia_site SIM quando não informado data_at String ...

    • Presence API - INCLUIR_PRODUTO

      Inclusão de Produtos (Atualização e Inclusão) Este módulo é responsável por incluir produtos na base da dados. Parâmetros Campos Tipo Obrigatório Descrição codigo string(8) Não para inclusão, sim para alteração, quando codigoExterno ou codigoLegado ...

    • Presence API - ESTOQUE

      Saldo de Estoque Este módulo é responsável por listar o estoque do produto/sku da base da dados. Parâmetros Nome Obrigatório Tipo Descrição codigo SIM quando não informado data_at String  Código do sku(produto) loja SIM String Código da loja. data_at ...