Endpoint GET /prices/{product_id} - Preço do Produto por Id

GET /prices/{product_id}

Descrição

O endpoint GET /prices/{product_id}, este endpoint é utilizado para obter informações sobre os preços de um produto específico, identificado pelo seu ID. Com ele, você pode verificar o preço atual, preços de venda promocionais, e a validade dessas promoções.

Parâmetros

  • product_id (obrigatório): O ID do produto que você deseja consultar. Este é um identificador único para cada produto.

  • page_size (opcional): Define quantos registros de preço você deseja ver por página. Por exemplo, se você quiser ver 10 registros por página, defina este parâmetro como 10.

  • current_page (opcional): Indica a página que você deseja visualizar. Use este parâmetro para navegar entre diferentes páginas de resultados.

  • allowed_on_internet (opcional): Um filtro que indica se o produto está disponível para venda online. Use 1 para produtos que podem ser vendidos na internet e 0 para produtos que não podem.

Sucesso (200)


Json
{
  "Pagination": {
    "TotalCount": 1,
    "PageSize": 10,
    "CurrentPage": 1
  },
  "Items": [
    {
      "SkuId": "SKU123",
      "SkuIdAlt": "ALT123",
      "SkuIdUx": "SKU123UX",
      "PriceTableId": "PRICE123",
      "Barcode": [
        "1234567890123"
      ],
      "Price": 100.0,
      "SalePrice": 90.0,
      "SalePriceFromDate": "2024-07-22T18:40:44.476Z",
      "SalePriceToDate": "2024-08-22T18:40:44.476Z",
      "UpdateDate": "2024-07-22T18:40:44.476Z"
    }
  ]
}

A requisição foi bem-sucedida e o sistema retornou as informações sobre os preços do produto.

Erro de Autorização (401)

A requisição não tem autorização para acessar as informações do produto.

Erro Interno do Servidor (500)

Ocorreu um erro interno no servidor ao processar a requisição.

Json
{
  "erro": "string",
  "stackTrace": "string"
}

Para consultar os preços de um produto, substitua {product_id} na URL pelo ID do produto desejado. Se necessário, você pode adicionar parâmetros opcionais para ajustar a visualização dos resultados, como definir o número de registros por página, a página corrente ou aplicar um filtro para produtos disponíveis na internet. Envie a requisição e você receberá uma lista com os preços e detalhes relevantes para o produto especificado.

Endpoint GET /prices/transferDate/{date} - Preços do Produto por Data alteração (data_para_transferencia)

GET /prices/transferDate/{date}

Descrição

O endpoint GET /prices/transferDate/{date}, este endpoint é usado para obter informações sobre os preços dos produtos que foram alterados em uma data específica. Utilizando este recurso, você pode consultar os preços atuais, preços promocionais e a validade das promoções de produtos que tiveram alterações na data fornecida.




Parâmetros

  • date (obrigatório): A data na qual você deseja consultar as alterações nos preços. Este parâmetro deve ser fornecido no formato de data e hora padrão (por exemplo, 2024-07-22T00:00:00Z).

  • page_size (opcional): Define a quantidade de registros por página. Por exemplo, se você definir este parâmetro como 10, será retornada uma página com até 10 registros.

  • current_page (opcional): Indica a página que você deseja visualizar. Use este parâmetro para navegar entre diferentes páginas de resultados.

  • allowed_on_internet (opcional): Filtro para indicar se o produto pode ser vendido na internet. Use 1 para produtos que podem ser vendidos online e 0 para produtos que não podem.

  • wholesale_internet (opcional): Filtro para indicar se o produto está disponível para venda por atacado na internet. Use 1 para produtos de atacado disponíveis online e 0 para produtos que não estão.

  • is_default_barcode (opcional): Filtro para indicar se o produto possui um código de barras padrão. Use 1 para produtos com código de barras padrão e 0 para produtos sem.

  • v (opcional): Versão utilizada na consulta. Esse parâmetro pode ser usado para especificar a versão da consulta ou da API.

Respostas

Sucesso (200)


Json
{
  "Pagination": {
    "TotalCount": 0,
    "PageSize": 0,
    "CurrentPage": 0
  },
  "Items": [
    {
      "SkuId": "string",
      "SkuIdAlt": "string",
      "SkuIdUx": "string",
      "PriceTableId": "string",
      "Barcode": [
        "string"
      ],
      "Price": 0,
      "SalePrice": 0,
      "SalePriceFromDate": "2024-07-22T18:48:12.289Z",
      "SalePriceToDate": "2024-07-22T18:48:12.289Z",
      "UpdateDate": "2024-07-22T18:48:12.289Z"
    }
  ]
}

A requisição foi bem-sucedida e o sistema retornou as informações sobre os preços dos produtos alterados na data especificada.

Erro de Autorização (401)

A requisição não tem autorização para acessar as informações dos preços.

Erro Interno do Servidor (500)

Ocorreu um erro interno no servidor ao processar a requisição.

Json
{
  "erro": "string",
  "stackTrace": "string"
}

Para consultar os preços dos produtos alterados em uma data específica, substitua {date} na URL pela data e hora desejadas no formato AAAA-MM-DDTHH:MM:SSZ. Você pode incluir parâmetros adicionais para ajustar a quantidade de registros por página, a página corrente, e aplicar filtros para produtos vendidos online ou com códigos de barras padrão. Envie a requisição e você receberá uma lista com os preços e detalhes relevantes para os produtos alterados na data especificada.

Exemplo do Swagger: