Catálogo de produtos com imagens

Por meio dos endpoints da API Supplier Catalogs, o fornecedor pode criar e gerenciar grupos de produtos, produtos, imagens desses produtos e também o contrato, permitindo que o comprador tenha acesso ao seu catálogo.

Ao integrar seus bancos de imagens à plataforma E-proc do ME, o fornecedor tem a facilidade de gerenciar as imagens de seus próprios catálogos de produtos e ainda atualizá-las diretamente no workflow do comprador de maneira rápida e massiva.

Endpoints relacionados às imagens dos produtos

Adicionar imagem ao produto

Para adicionar uma imagem ao produto e definir se a imagem é a principal diretamente no payload, use o endpoint: POST Add a picture to a product.

📘 Nota

• A imagem pode ter um tamanho máximo de 1MB;
• É permitido um máximo de 5 imagens por produto;
• Os tipos de arquivo permitidos são: .gif, .jpg, .jpeg, .png.

Definir imagem como principal (imagem de capa)

Para definir uma imagem como principal, use o endpoint: PATCH Update a product picture based on the productId and pictureId e informe o ID do produto e o ID da imagem.

Excluir imagem do produto

Para excluir uma imagem, use o endpoint: DELETE Delete a picture associated with a product e informe o ID do produto e o ID da imagem.

📘 Nota

• Realiza a exclusão física da imagem no OCI (Oracle Cloud Infrastructure) e na base de dados.
• Define automaticamente outra imagem como a principal, caso a imagem de capa seja excluída.

Consultar imagem

Para obter informações da imagem, como tamanho e tipo de arquivo, use o endpoint: GET Get product picture information e informe o ID do produto e o ID da imagem.

Fazer download da imagem

Para fazer o download da imagem, use o endpoint: GET Redirection link to download the picture e informe o ID do produto e o ID da imagem.

Consultar imagem principal

Para obter informações da imagem principal, use o endpoint: GET Get the primary product picture based on the productId e informe o ID do produto.

Consultar todas as imagens do produto

Para obter informações das imagens do produto, use o endpoint: GET Get all pictures associated with a product e informe o ID do produto.

Regras para Grupos de produtos

• Compradores:

  • Podem visualizar todos os grupos, incluindo aqueles criados por fornecedores;
  • Não têm permissão para editar ou excluir grupos criados por fornecedores, e isto também vale para os fornecedores em relação aos grupos dos compradores.

• Fornecedores:

  • Podem buscar, visualizar, editar ou excluir somente os grupos que criaram.

• Geral:

  • Um grupo não pode ser excluído se houver permissões ou pedidos vinculados a ele.

Regras para Produtos

• Compradores:

  • Podem visualizar todos os produtos, incluindo aqueles criados por fornecedores;
  • Não têm permissão para editar produtos criados por fornecedores, e isto também vale para os fornecedores em relação aos produtos dos compradores.

• Fornecedores:

  • Podem buscar, visualizar e editar apenas os produtos que criaram.

Regras para Contratos

• Compradores:

  • Podem visualizar todos os contratos, incluindo aqueles criados por fornecedores;
  • Não têm permissão para editar contratos criados por fornecedores, e isto também vale para os fornecedores em relação aos contratos dos compradores.

• Fornecedores:

  • Podem buscar, visualizar e editar apenas os contratos que criaram.