Preço

Um preço representa um valor de venda do produto. Contém informações básicas e essenciais, incluido o SKU, valor, moeda e normalizador.

Criar um novo preço

Cria um novo preço para a venda desse produto.

Aviso

Para atualizar, basta criar um novo preço para que este seja atualizado.

Escopo requerido

Valor	Descrição
`portfolio:write`	Permite gerenciar um inventário

Parâmetros da chamada

Propriedade	Tipo	Descrição	Obrigatório
`type`	string	Identifica o tipo do preço do SKU especificado. Valores permitidos list e sell	Sim
`sku`	string	O SKU exclusivo do item	Sim
`value`	int	Valor do SKU, desnormalizado em relação ao código da moeda	Sim
`currency`	string	Código da moeda, de acordo à ISO-4217	Sim
`normalizer`	int	Valor normalizador de value para unidade de currency. Valor padrão 100. Para maiores informações consulte	Sim
`extras`	object	Informações adicionais sobre o preço. Quando não houver um valor você poderá enviar .	Sim

Chamada:

curl -X 'POST' \
  'https://apps.eupreciso.com.br/v1.0/marketplace/portfolios/prices' \
  -H 'accept: application / json' \
  -H 'Authorization: Bearer `access_token`' \
  - d '{
    "sku": "XDZ4654",
    "type": "list",
    "value": 10000,
    "currency": "BRL",
    "normalizer": 100,
    "extras": {}

Resposta:

{
  "token": "1234",
  "id": "6712a312c37c38e9038fd9b6",
  "statusCode": 0,
  "statusMessage": "The price was imported and processed",
  "errors": [],
  "data": {
    "id": "6712a312c37c38e9038fd9b6",
    "sku": "XDZ4654",
    "type": "list",
    "value": 10000,
    "currency": "BRL",
    "normalizer": 100,
    "extras": {},
    "created_at": "2022-06-15T14:25:37Z"
  }
}

Recuperar um preço

Retorna um preço específico.

Escopo necessário

Valor do escopo	Descrição
`portfolio:read`	Permite acessar um SKU.

Parâmetros da URL

Campo	Tipo	Descrição	Obrigatório
`id`	ObjectId	Identificação gerada pelo Eu Preciso quando da criação do Preço.	Sim

Chamada:

GET /v1.0/marketplace/portfolios/prices/{id} \
Host: apps.eupreciso.com.br \
Authorization: Bearer {access_token} \
Content-Type: application/json \

Resposta:

{
  "id": "6712a312c37c38e9038fd9b6",
  "sku": "XDZ4654",
  "type": "list",
  "value": 10000,
  "currency": "BRL",
  "normalizer": 100,
  "extras": {},
  "priceHistory": [],
  "created_at": "2024-11-15T14:25:37Z"
}

Recuperar uma lista de preços

Retorna todos os registros de preços disponíveis.

Nota: Este endpoint implementa paginação, ordenação e filtros. Para saber mais, consulte Paginação, filtros e ordenação.

Escopo requerido

Valor do escopo	Descrição
`portfolio:read`	Permite listar os inventários.

Parâmetros de consulta

Campo	Tipo	Descrição	Obrigatório
`sku`	string	Retorna os preços do SKU especificado	Não
`type`	string	Retorna os tipos de preços do SKU especificado. Valores permitidos list e sell	Não

Parâmetros de ordenação

Campo	Descrição	Obrigatório
`created_at`	Ordenar por data de criação dos SKUs.	Não

Chamada:

GET /v1.0/marketplace/portfolios/prices?_limit=10&_offset=0 \
Host: apps.eupreciso.com.br \
Authorization: Bearer {access_token} \
Content-Type: application/json \

Resposta:

{
  "meta": {
    "page": {
      "limit": 10,
      "offset": 0,
      "count": 10,
      "max_limit": 50
    }
  },
  "results": [
    {
      "id": "6712a312c37c38e9038fd9b6",
      "sku": "XDZ4654",
      "type": "list",
      "value": 10000,
      "currency": "BRL",
      "normalizer": 100,
      "extras": {},
      "priceHistory": [],
      "created_at": "2024-11-15T14:25:37Z"
    }
  ]
}

Inventário Webhooks