Pular para o conteúdo principal

Atualizar um depósito

PUThttps://carchost.fieldcontrol.com.br/storages-v2/{id}

Atualiza um depósito. O corpo segue as mesmas regras da criação. Requer o módulo de controle de estoque.

Requer os headers X-Api-Key, User-Agent e Content-Type: application/json. Limite: 1 requisição por segundo (saiba mais).

Requisição​

Parâmetros de caminho

idstringobrigatório

Identificador do depósito.

Exemplo: MWY5ZGE5YzgtZDY3MC00NWJhLTk0MGUtNzQxYjk3ODI0MzllOjIyOTE1.

Headers

User-Agentstringobrigatório

Identificação da sua aplicação.

Exemplo: MinhaIntegracao/1.0.

Corpo da requisição

JSON, enviado com o header Content-Type: application/json.

namestringobrigatório

Nome do depósito. Deve ser único na conta.

Até 150 caracteres.

archivedbooleanobrigatório

Arquiva o depósito. Um depósito arquivado perde o colaborador responsável.

descriptionstring

Descrição do depósito.

Até 2000 caracteres.

employeeobject

Colaborador responsável pelo depósito.

Campos de employee
idstring ou number

Identificador do colaborador. Um valor que não é um identificador de colaborador remove o responsável.

allowItemRequestsboolean

Permite solicitações de itens ao depósito.

Padrão: false.

isTriageboolean

Define o depósito como de triagem.

Padrão: false.

externalobject
Campos de external
idstring

Identificador do depósito no seu sistema.

Até 100 caracteres.Aceita: null.

Respostas

  • 200

    Depósito atualizado. A resposta não inclui storageProducts.

  • 401

    Chave de API ausente (Missing API Key) ou inválida (Invalid API Key). Ver Autenticação.

  • 403

    Conta bloqueada (Account blocked), expirada (Account expired) ou com plano que não permite integração (Account plan not allowed). Ver Autenticação.

  • 422

    Identificador inválido ou de outra conta (uriValidationErr), depósito inexistente (resourceValidationErr com message: storage not found; não há 404), corpo inválido ou nome já usado. Conta sem o módulo de controle de estoque: resourceNotAllowed.

    resourceValidationErr →
  • 429

    Limite de 1 requisição por segundo excedido. Ver Limite de requisições.

  • 500

    Erro inesperado no servidor.