Pular para o conteúdo principal

Upload de Imagens de Produtos via SFTP

Este guia descreve como utilizar as credenciais fornecidas para se conectar a um servidor SFTP, enviar múltiplos arquivos (imagens) e, em seguida, utilizar a API de storage para registrar as imagens nos SKUs.

Passo 1: Conexão com o Servidor SFTP​

Credenciais e Protocolo​

  • Protocolo: SFTP
  • Host: sftp.seudominio.com
  • Port: 22
  • Username: seu-usuario
  • Password: sua-senha

Observação: Substitua sftp.seudominio.com, seu-usuario e sua-senha com os valores recebidos nas credenciais de acesso.

Como Conectar​

  1. Utilize um cliente SFTP de sua preferência (por exemplo, FileZilla ou WinSCP) para estabelecer a conexão.
  2. Configure o cliente com as informações acima.
  3. Após autenticação bem-sucedida, você poderá navegar pelos diretórios do servidor.

Estrutura de Diretórios​

Para acessar a pasta que corresponde a integração de imagens de SKUs, siga o caminho abaixo:

  • Acesse a pasta "zonasul"
  • Acesse a pasta que contém o seu "contractAccountId" no nome (normalmente só uma pasta estará disponível)
  • Acesse a pasta "SKUs"
  • Acesse a pasta "Integracao"

Exemplo de SFTP

Passo 2: Upload de Múltiplos Arquivos​

  1. Dentro do cliente SFTP, selecione os arquivos de imagem na sua máquina local.
  2. Arraste e solte (ou selecione manualmente) esses arquivos para o diretório de destino no servidor (nesse caso, /zonasul/<contractAccountId>/SKUs/Integracao).
  3. Aguarde até que todos os arquivos sejam transferidos com sucesso.

Dica: Antes do envio, renomeie os arquivos de forma padronizada para facilitar a organização e futura referência (por exemplo, produto-123-frente.png, produto-123-verso.png etc.).

Passo 3: Registrar Imagens via API​

Após o upload via SFTP, utilize o endpoint de upload de imagens da API de integração para associar as imagens aos SKUs.

POST /v1/storages/image/upload​

Objetivo: Registrar e associar imagens aos SKUs.

Headers​

  • Authorization: Basic Auth contendo a chave pública e a chave secreta fornecidas para o cliente.
    • Exemplo: Basic <base64-encoded-credentials>
  • x-contractAccountId: Identificador da conta do contrato do cliente.
    • Exemplo: x-contractAccountId: 9f36a666-acd5-4987-a47f-3de247f65d82
  • Content-Type: multipart/form-data

Parâmetros​

  • externalIdentifier (string): Referência externa do SKU.

Corpo da Requisição​

Envie os arquivos de imagem como multipart/form-data com o campo files.

Respostas​

  • 200: Retorna sucesso da operação.
  • 400: Retorna erro de requisição inválida.
  • 500: Retorna erro interno do servidor.

Exemplo de Resposta para Sucesso (200)​

{ "operationId": "402fe685-2060-432b-ac57-223eb2e680f3" }

Para mais detalhes sobre os endpoints de gestão de imagens, consulte a documentação de imagens.