Presence API ECOMMERCE - ECM-PRODUTOS

Presence API ECOMMERCE - ECM-PRODUTOS

Cadastro de Produtos

Este método é responsável por listar os produtos da base da dados.

Parâmetros

Nome
Obrigatório
Tipo
Descrição
id_webservice
SIM
Integer
ID do webservice
data_at
SIM quando não informado loja e código
Data (AAAA-MM-DDT00:00:00)
Data de atualização dos dados. Padrão ISO8601.
referencia_site
SIM quando não informado data_at
String
Código do produto no Presence Domain

BODY
  1. {
  2.   "id_webservice" : (Integer),
  3.   "data_at" : (Date, AAAA-MM-DD) ou (Date, AAAA-MM-DDT00:00:00)
  4.   "pending": "0" ou "1"
  5. }
OU
  1. {
  2.   "id_webservice" : (Integer),
  3.   "referencia_site" : (String)
  4. }

JSON de Retorno
  1. {
  2.     "status": (String),
  3.     "method": (String),
  4.     "data": [
  5. {
  6. "referencia": (String),
  7. "codigoExterno": (String),
  8. "descricao": (String),
  9. "narrativa" : (String),
  10. "status": (String),
  11.             "apresentarNaHome": (String),
  12. "unidadeMedida" : (String),
  13. "unidadeMedidaDesc" : (String),
  14. "unidadeMedidaFator" : (Integer),
  15. "composicao" : (String),
  16. "observacao" : (String),
  17. "fichaTecnica" : (String),
  18. "departamento" : (String),
  19. "departamentoDesc" : (String),
  20. "grupo" : (String),
  21. "grupoDesc" : (String),
  22. "subgrupo" : (String),
  23. "subgrupoDesc" : (String),
  24. "linha" : (String),
  25. "linhaDesc" : (String),
  26. "colecao" : (String),
  27. "colecaoDesc" : (String),
  28. "marcaCodInt" : (Integer),
  29. "marcaDesc" : (String),
  30. "marcaCodExt" : (String),
  31.             "fornecedor" : (String),
  32.             "fornecedorFantasia" : (String),
  33.             "referenciaFornecedor" : (String),
  34.     "altura" : (Double),
  35.     "largura" : (Double),
  36.     "comprimento" : (Double),
  37.     "peso" : (Double),
  38.     "dataCadastro" : (Date),
  39.     "dataAtualizacao" : (Date),
  40. "pk": (String),
  41. "idProcesso": (Integer),
  42. "name" : (String),
  43. "refid" : (String),
  44. "description" : (String),
  45. "shortDescription" : (String),
  46. "keywords" : (String),
  47. "title" : (String),
  48. "metatagdescription" : (String),
  49. "brand" : (String),
  50. "brandid" : (String),
  51. "textlink": (String)
  52. }
  53. ]
  54. }

BODY

  1. {
  2.   "id_webservice" : (Integer),
  3.   "data_at" : (Date, AAAA-MM-DD) ou (Date, AAAA-MM-DDT00:00:00)
  4. "Categorias" : true ou false,
  5. "Categorias_apenas_principal": "S" ou "N",
  6. "Categorias_hierarquia_completa": "S" ou "N",
  7. "SKUS" : true ou false,
  8. "Estoques" : true ou false,
  9. "Precos" : true ou false
  10. }

OU

  1. {
  2.   "id_webservice" : (Integer),
  3.   "referencia_site" : (String)
  4. "Categorias" : true ou false,
  5. "SKUS" : true ou false,
  6. "Estoques" : true ou false,
  7. "Precos" : true ou false
  8. }

JSON de Retorno

  1. {
  2.     "status": (String),
  3.     "method": (String),
  4.     "data": [
  5.         {
  6. "referencia": (String),
  7. "codigoExterno": (String),
  8. "descricao": (String),
  9. "narrativa" : (String),
  10. "status": (String),
  11.             "apresentarNaHome": (String),
  12. "unidadeMedida" : (String),
  13. "unidadeMedidaDesc" : (String),
  14. "unidadeMedidaFator" : (Integer),
  15. "composicao" : (String),
  16. "observacao" : (String),
  17. "fichaTecnica" : (String),
  18. "departamento" : (String),
  19. "departamentoDesc" : (String),
  20. "grupo" : (String),
  21. "grupoDesc" : (String),
  22. "subgrupo" : (String),
  23. "subgrupoDesc" : (String),
  24. "linha" : (String),
  25. "linhaDesc" : (String),
  26. "colecao" : (String),
  27. "colecaoDesc" : (String),
  28. "marcaCodInt" : (Integer),
  29. "marcaDesc" : (String),
  30. "marcaCodExt" : (String),
  31.             "fornecedor" : (String),
  32.             "fornecedorFantasia" : (String),
  33.             "referenciaFornecedor" : (String),
  34.     "altura" : (Double),
  35.     "largura" : (Double),
  36.     "comprimento" : (Double),
  37.     "peso" : (Double),
  38.     "dataCadastro" : (Date),
  39.     "dataAtualizacao" : (Date),
  40. "pk": (String),
  41. "idProcesso": (Integer),
  42. "name" : (String),
  43. "refid" : (String),
  44. "description" : (String),
  45. "shortDescription" : (String),
  46. "keywords" : (String),
  47. "title" : (String),
  48. "metatagdescription" : (String),
  49. "brand" : (String),
  50. "brandid" : (String),
  51. "textlink": (String)
  52.                 }
  53.             ],
  54.             "SKU": [
  55.                 {
  56.                     "referenciaSiteOut": (String),
  57.                     "sku": (String),
  58.                     "corpos": (String),
  59.                     "cor": (String),
  60.                     "tampos": (String),
  61.                     "tamanho": (String),
  62.                     "descricao": (String),
  63.                     "corCodigoExterno": (String),
  64.                     "tamanhoCodigoExterno": (String),
  65.                     "status": (String),
  66.                     "skuCodigoExterno": (String),
  67.                     "gtin": (String),
  68.                     "codigoAuxiliar": (String),
  69.                     "codigoEcommerce": (String)
  70.                 }
  71.             ],
  72.             "Estoques": [
  73.                 {
  74.                     "sku": (String),
  75.                     "codigoExterno": (String),
  76.                     "warehouse": (String),
  77.                     "warehouseCodigoExterno": (String),
  78.                     "quantidade": (Double),
  79.                     "dataAt": (Date)
  80.                 }
  81.             ],
  82.             "Precos": [
  83.                 {
  84.                     "sku": (String),
  85.                     "skuCodigoExterno": (String),
  86.                     "codigoProduto": (String),
  87.                     "tabela": (Integer),
  88.                     "tabelaCodExterno": (String),
  89.                     "precoCusto": (Double),
  90.                     "precoBase": (Double),
  91.                     "precoBasePromo": (Double),
  92.                     "dataInicio": (Date),
  93.                     "dataFim": (Date),
  94.                     "precoVarejo": (Double),
  95.                     "precoAtacado": (Double),
  96.                     "precoRepresentante": (Double),
  97.                     "promoVarejo": (Double),
  98.                     "promoAtacado": (Double),
  99.                     "promoRepresentante": (Double),
  100.                     "dataAt": (Date)
  101.                 }
  102.             ]
  103.         }
  104.     ]
  105. }


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.

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 - 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 - 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-PRODUTOS (completo)

      Cadastro de Produtos Este método é responsável por listar os produtos da base da dados. Para os dados retornarem corretamente, o Endpoint de chamada é diferente, deve-se utilizar a seguinte URL: ...

    • Presence API - PRODUTOS_CORES

      Produtos x Cores Este módulo é responsável por listar as cores do produtos da base da dados. Parâmetros Nome Obrigatório Tipo Descrição data_at SIM quando não informado codigo Data (AAAA-MM-DDT00:00:00) Data de atualização dos dados. Padrão ISO8601. ...

    • Presence API - PRODUTOS_CATEGORIAS

      Produtos x Categorias Este módulo é responsável por listar as categorias do produtos da base da dados. Parâmetros Nome Obrigatório Tipo Descrição data_at SIM quando não informado codigo Data (AAAA-MM-DDT00:00:00) Data de atualização dos dados. Padrão ...